dotsDrawableTargets Class Reference

Overview

Draw one or multiple polygon target at once.

Inheritance diagram for dotsDrawableTargets:

Properties and Events
Property	xCenter = 0
	an x-coordinate for each target (degrees visual angle, centered)
Property	yCenter = 0
	a y-coordinate for each target (degrees visual angle, centered)
Property	width = 1
	the width of each target (degrees visual angle)
Property	height = 1
	the height of each target (degrees visual angle)
Property	nSides = 30
	the number of sides for each target polygon (at least 3)
Property	isInscribed = true
	whether polygons are inscribed(true) or circumscribed(false)
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	verticesPerTarget
	how many vertices make up each target (same for all targets)
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	dotsDrawableTargets ()
	Constructor takes no arguments.
	set_xCenter (self, xCenter)
	Keep track of polygon changes.
	set_yCenter (self, yCenter)
	Keep track of polygon changes.
	set_width (self, width)
	Keep track of polygon changes.
	set_height (self, height)
	Keep track of polygon changes.
	set_nSides (self, nSides)
	Keep track of polygon changes.
	set_isInscribed (self, isInscribed)
	Keep track of polygon 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
	updatePolygons (self)
	Calculate triangle vertex positions to make up polygons.
groupIndices	getVertexGroupIndices (self)
	Get a 1-based target-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:

• dotsDrawableTargets.m