dotsDrawableLines Class Reference

Overview

Draw one or multiple lines at once.

Inheritance diagram for dotsDrawableLines:

Properties and Events
Property	xFrom = 0
	a starting x-coordinate for each line (degrees visual angle, centered)
Property	xTo = 1
	an ending x-coordinate for each line (degrees visual angle, centered)
Property	yFrom = 0
	a starting y-coordinate for each line (degrees visual angle, centered)
Property	yTo = 1
	an ending y-coordinate for each line (degrees visual angle, centered)
Properties and Events inherited from dotsDrawableVertices
Property	x = 0
	vertex x-positions (x, y, and z must be scalar or match sizes)
Property	y = 0
	vertex y-positions (x, y, and z must be scalar or match sizes)
Property	z = 0
	vertex z-positions (x, y, and z must be scalar or match sizes)
Property	colors = [1 1 1]
	color map to use for vertices [r g b a; r g b a; etc. More...
Property	isColorByVertexGroup = false
	whether to color vertices in groups(true) or individually(false)
Property	indices = []
	array of indices for selecting, reusing, and reordering vertices More...
Property	pixelSize = 1
	width in pixels for points or lines
Property	isSmooth = false
	whether to use anti-aliasing for primitives
Property	primitive = 0
	index to choose OpenGL vertex drawing mode More...
Property	usageHint = 3
	index to choose usage "hint" for OpenGL buffers More...
Property	translation = []
	optional translation to apply to vertex positions [tX tY tZ] More...
Property	rotation = []
	optional rotation of vertices about coordinate axes [rX rY rZ] More...
Property	scaling = []
	optional scaling to apply to vertex positions [sX sY sZ] More...
Properties and Events inherited from dotsDrawable
Property	isVisible = true
	true or false, whether to draw() this object

Protected Properties
Property	verticesPerLine = 2
	how many vertices make up each line (same for all arcs)
Protected Properties inherited from dotsDrawableVertices
Property	attribBufferInfo = []
	identifier and other info for the OpenGL vertex attribute buffer
Property	isAttribBufferStale = true
	whether or not the attribute buffer is out of date
Property	indexBufferInfo = []
	identifier and other info for the OpenGL vertex index buffer
Property	isIndexBufferStale = true
	whether or not the index buffer is out of date
Property	colorBufferInfo = []
	identifier and other info for the OpenGL vertex color buffer
Property	isColorBufferStale = true
	whether or not the color buffer is out of date
Property	smoothMap
	map primitive integers to dotsMglSmoothness() switches

Methods
self	dotsDrawableLines ()
	Constructor takes no arguments.
	set_xFrom (self, xFrom)
	Keep track of line changes.
	set_xTo (self, xTo)
	Keep track of line changes.
	set_yFrom (self, yFrom)
	Keep track of line changes.
	set_yTo (self, yTo)
	Keep track of line changes.
Methods inherited from dotsDrawableVertices
self	dotsDrawableVertices ()
	Constructor takes no arguments.
	delete (self)
	Release OpenGL resources. More...
	set_x (self, x)
	Keep track of required buffer updates.
	set_y (self, y)
	Keep track of required buffer updates.
	set_z (self, z)
	Keep track of required buffer updates.
	set_indices (self, indices)
	Keep track of required buffer updates.
	set_colors (self, colors)
	Keep track of required buffer updates.
	set_isColorByVertexGroup (self, isColorByVertexGroup)
	Keep track of required buffer updates.
nVertices	getNVertices (self)
	Calculate number of vertices from x, y, and z.
	prepareToDrawInWindow (self)
	Create fresh OpenGL buffer objects.
	draw (self)
	Draw vertices from OpenGL buffer objects.
Methods inherited from dotsDrawable
self	dotsDrawable ()
	Constructor takes no arguments.
	prepareToDrawInWindow (self)
	Do any pre-draw setup that requires an OpenGL drawing window.
	mayDrawNow (self)
	Draw() or not, depending on isVisible and possibly other factors.
	draw (self)
	Subclass must redefine draw() to draw graphics.
	show (self)
	Shorthand to set isVisible=true.
	hide (self)
	Shorthand to set isVisible=false.

Protected Methods
	updateLines (self)
	Arrange line vertex positions to approximate disks.
groupIndices	getVertexGroupIndices (self)
	Get a 1-based line-specific index for each vertex.
Protected Methods inherited from dotsDrawableVertices
	deleteBuffers (self)
	Release OpenGL buffer handles and memory.
	updateBuffers (self)
	Write attribute, color, and index data to buffers, as needed.
	deleteAttribBuffer (self)
	Release OpenGL vertex attribute resources.
	updateAttribBuffer (self)
	Write new vertex attributes to OpenGL buffer(s).
	deleteIndexBuffer (self)
	Release OpenGL vertex index resources.
	updateIndexBuffer (self)
	Write new vertex indices to OpenGL buffer(s).
	deleteColorBuffer (self)
	Release OpenGL vertex color resources.
	updateColorBuffer (self)
	Write new vertex colors to OpenGL buffer(s).
groupIndices	getVertexGroupIndices (self)
	Get an arbitrary 1-based group index for each vertex.
buffer	overwriteOrReplaceBuffer (self, oldBuffer, data, target, elementsPerVertex)
	Modify or replace a buffer with new data.
	selectBuffers (self)
	Bind buffers for drawing.
	deselectBuffers (self)
	Unbind buffers for drawing.
	flagAllBuffersAsStale (self)
	Mark all OpenGL buffers as stale.

Additional Inherited Members
Static Methods inherited from dotsDrawable
static frameInfo	drawFrame (drawables, doClear)
	draw() several drawable objects and show the next Screen frame. More...
static ensemble	makeEnsemble (name, objects)
	Convenient utility for combining a bunch of drawables into an ensemble. More...
static frameInfo	drawEnsemble (ensemble, args, prepareFlag, showDuration, pauseDuration)
	Convenient utility for drawing an ensemble either locally or remotely. More...

---

The documentation for this class was generated from the following file:

• dotsDrawableLines.m