See the dojox/gfx3d/_base.Viewport reference documentation for more information.
returns the cumulative ('real') transformation matrix by combining the shape's matrix with its parent's matrix
moves a shape to back of the list of shapes
Parameter | Type | Description |
---|---|---|
shape | dojox/gfx/shape.Shape | one of the child shapes to move to the front |
moves a shape to back of the list of shapes
moves a shape to front of the list of shapes
Parameter | Type | Description |
---|---|---|
shape | dojox/gfx/shape.Shape | one of the child shapes to move to the front |
moves a shape to front of the list of shapes
renderer-specific hook, see dojox/gfx/shape.Shape.moveToFront()
renderer-specific hook, see dojox/gfx/shape.Shape.moveToFront()
sets a parent
Parameter | Type | Description |
---|---|---|
parent | Object | a parent or null (see dojox/gfx/shape.Surface, or dojox/gfx.Group) |
matrix | dojox/gfx/matrix.Matrix2D | a 2D matrix or a matrix-like object |
updates the parent matrix with new matrix
Parameter | Type | Description |
---|---|---|
matrix | dojox/gfx/Matrix2D | a 2D matrix or a matrix-like object |
removes a shape from the list
Parameter | Type | Description |
---|---|---|
obj | undefined | |
silently | Boolean |
Optional if true, do not redraw a picture yet |
removes a shape from the list
adds a shape to the list
Parameter | Type | Description |
---|---|---|
shape | dojox/gfx/shape.Shape | the shape to add to the list |
add new light/lights to the viewport.
Parameter | Type | Description |
---|---|---|
lights | Array | Object | light object(s) |
adds a shape to the list
Parameter | Type | Description |
---|---|---|
obj | undefined |
adds a shape to the list
multiplies the existing matrix with an argument on left side (matrix * this.matrix)
Parameter | Type | Description |
---|---|---|
matrix | dojox.gfx3d.matrix.Matrix | a matrix or a matrix-like object (see an argument of dojox.gfx3d.matrix.Matrix constructor for a list of acceptable arguments) |
multiplies the existing matrix with an argument on left side (matrix * this.matrix)
multiplies the existing matrix with an argument on right side (this.matrix * matrix)
Parameter | Type | Description |
---|---|---|
matrix | dojox.gfx3d.matrix.Matrix | a matrix or a matrix-like object (see an argument of dojox.gfx3d.matrix.Matrix constructor for a list of acceptable arguments) |
multiplies the existing matrix with an argument on right side (this.matrix * matrix)
a shortcut for dojox.gfx3d.Object.applyRightTransform
Parameter | Type | Description |
---|---|---|
matrix | dojox.gfx3d.matrix.Matrix | a matrix or a matrix-like object (see an argument of dojox.gfx3d.matrix.Matrix constructor for a list of acceptable arguments) |
multiplies the existing matrix with an argument on left side (matrix * this.matrix)
Parameter | Type | Description |
---|---|---|
matrix | dojox/gfx/matrix.Matrix2D | a matrix or a matrix-like object (see an argument of dojox/gfx/matrix.Matrix2D constructor for a list of acceptable arguments) |
multiplies the existing matrix with an argument on left side (matrix * this.matrix)
multiplies the existing matrix with an argument on right side (this.matrix * matrix)
Parameter | Type | Description |
---|---|---|
matrix | dojox/gfx/matrix.Matrix2D | a matrix or a matrix-like object (see an argument of dojox/gfx/matrix.Matrix2D constructor for a list of acceptable arguments) |
multiplies the existing matrix with an argument on right side (this.matrix * matrix)
a shortcut for dojox/gfx/shape.Shape.applyRightTransform
Parameter | Type | Description |
---|---|---|
matrix | dojox/gfx/matrix.Matrix2D | a matrix or a matrix-like object (see an argument of dojox/gfx/matrix.Matrix2D constructor for a list of acceptable arguments) |
a shortcut for dojox/gfx/shape.Shape.applyRightTransform
removes all shapes from a group/surface.
Parameter | Type | Description |
---|---|---|
destroy | Boolean |
Optional Indicates whether the children should be destroyed. Optional. |
removes all shapes from a group/surface.
submits the current batch, append all pending child shapes to DOM
On canvas, this method flushes the pending redraws queue.
submits the current batch, append all pending child shapes to DOM
connects a handler to an event on this shape
Parameter | Type | Description |
---|---|---|
name | undefined | |
object | undefined | |
method | undefined |
creates an instance of the passed objectType class
Parameter | Type | Description |
---|---|---|
objectType | Function | a class constructor to create an instance of |
rawObject | Object | properties to be passed in to the classes "setShape" method |
style | undefined |
creates a circle shape
Parameter | Type | Description |
---|---|---|
circle | Object | a circle object (see dojox/gfx.defaultCircle) |
creates an cube object
Parameter | Type | Description |
---|---|---|
cube | undefined |
creates an cylinder object
Parameter | Type | Description |
---|---|---|
cylinder | undefined |
creates an edge object
Parameter | Type | Description |
---|---|---|
edges | undefined | |
style | undefined |
creates an ellipse shape
Parameter | Type | Description |
---|---|---|
ellipse | Object | an ellipse object (see dojox/gfx.defaultEllipse) |
creates a image shape
Parameter | Type | Description |
---|---|---|
image | Object | an image object (see dojox/gfx.defaultImage) |
creates a line shape
Parameter | Type | Description |
---|---|---|
line | Object | a line object (see dojox/gfx.defaultLine) |
creates an instance of the passed shapeType class
Parameter | Type | Description |
---|---|---|
shapeType | Function | a class constructor to create an instance of |
rawShape | Object | properties to be passed in to the classes 'setShape' method |
creates an Orbit object
Parameter | Type | Description |
---|---|---|
orbit | undefined |
creates a path shape
Parameter | Type | Description |
---|---|---|
path | Object | a path object (see dojox/gfx.defaultPath) |
creates an 3d path object
Parameter | Type | Description |
---|---|---|
path | undefined |
creates an polygon object
Parameter | Type | Description |
---|---|---|
points | Points[] | Object |
creates a polyline/polygon shape
Parameter | Type | Description |
---|---|---|
points | Object | a points object (see dojox/gfx.defaultPolyline) or an Array of points |
creates an quads object
Parameter | Type | Description |
---|---|---|
quads | undefined | |
style | undefined |
creates a rectangle shape
Parameter | Type | Description |
---|---|---|
rect | Object | a path object (see dojox/gfx.defaultRect) |
creates a shape object based on its type; it is meant to be used by group-like objects
Parameter | Type | Description |
---|---|---|
shape | Object | a shape descriptor object |
dojox/gfx/shape.Shape | Null a fully instantiated surface-specific Shape object
creates a text shape
Parameter | Type | Description |
---|---|---|
text | Object | a text object (see dojox/gfx.defaultText) |
creates a text shape
Parameter | Type | Description |
---|---|---|
text | Object | a textpath object (see dojox/gfx.defaultTextPath) |
creates an triangle object
Parameter | Type | Description |
---|---|---|
tris | undefined | |
style | undefined |
Releases all internal resources owned by this shape. Once this method has been called, the instance is considered destroyed and should not be used anymore.
connects a handler by token from an event on this shape
Parameter | Type | Description |
---|---|---|
token | undefined |
returns a Node, which is used as a source of events for this shape
Returns the current fill object or null (see dojox/gfx.defaultLinearGradient, dojox/gfx.defaultRadialGradient, dojox/gfx.defaultPattern, or dojo/Color)
Different graphics rendering subsystems implement shapes in different ways. This method provides access to the underlying graphics subsystem object. Clients calling this method and using the return value must be careful not to try sharing or using the underlying node in a general way across renderer implementation. Returns the underlying graphics Node, or null if no underlying graphics node is used by this shape.
Returns the parent Shape, Group or null if this Shape is unparented. (see dojox/gfx/shape.Surface, or dojox/gfx.Group)
returns the current Shape object or null (see dojox/gfx.defaultPath, dojox/gfx.defaultPolyline, dojox/gfx.defaultRect, dojox/gfx.defaultEllipse, dojox/gfx.defaultCircle, dojox/gfx.defaultLine, or dojox/gfx.defaultImage)
Returns the current stroke object or null (see dojox/gfx.defaultStroke)
Returns the current transformation matrix applied to this Shape or null
returns an array of four points or null four points represent four corners of the untransformed bounding box
moves a shape to back of its parent's list of shapes
moves a shape to back of its parent's list of shapes
moves a shape to front of its parent's list of shapes
moves a shape to front of its parent's list of shapes
Connects an event to this shape.
Parameter | Type | Description |
---|---|---|
type | undefined | |
listener | undefined |
starts a new batch, subsequent new child shapes will be held in the batch instead of appending to the container directly.
Because the canvas renderer has no DOM hierarchy, the canvas implementation differs such that it suspends the repaint requests for this container until the current batch is closed by a call to closeBatch().
starts a new batch, subsequent new child shapes will be held in the batch instead of appending to the container directly.
removes a shape from the list
Parameter | Type | Description |
---|---|---|
shape | dojox/gfx/shape.Shape | the shape to remove |
silently | Boolean | if true, do not redraw a picture yet |
removes a shape from the list
removes the shape from its parent's list of shapes
Parameter | Type | Description |
---|---|---|
silently | Boolean | if true, do not redraw a picture yet |
removes the shape from its parent's list of shapes
iterate all children and call their render callback function.
sets a transformation matrix
Parameter | Type | Description |
---|---|---|
matrix | dojox.gfx3d.matrix.Matrix | a matrix or a matrix-like object (see an argument of dojox.gfx.matrix.Matrix constructor for a list of acceptable arguments) |
sets a transformation matrix
sets the clipping area of this shape.
The clipping area defines the shape area that will be effectively visible. Everything that would be drawn outside of the clipping area will not be rendered. The possible clipping area types are rectangle, ellipse, polyline and path, but all are not supported by all the renderers. vml only supports rectangle clipping, while the gfx silverlight renderer does not support path clipping. The clip parameter defines the clipping area geometry, and should be an object with the following properties:
The clip geometry coordinates are expressed in the coordinate system used to draw the shape. In other words, the clipping area is defined in the shape parent coordinate system and the shape transform is automatically applied.
Parameter | Type | Description |
---|---|---|
clip | undefined |
The following example shows how to clip a gfx image with all the possible clip geometry: a rectangle, an ellipse, a circle (using the ellipse geometry), a polyline and a path:
surface.createImage({src:img, width:200,height:200}).setClip({x:10,y:10,width:50,height:50}); surface.createImage({src:img, x:100,y:50,width:200,height:200}).setClip({cx:200,cy:100,rx:20,ry:30}); surface.createImage({src:img, x:0,y:350,width:200,height:200}).setClip({cx:100,cy:425,rx:60,ry:60}); surface.createImage({src:img, x:300,y:0,width:200,height:200}).setClip({points:[350,0,450,50,380,130,300,110]}); surface.createImage({src:img, x:300,y:350,width:200,height:200}).setClip({d:"M 350,350 C314,414 317,557 373,450.0000 z"});
sets a fill object (the default implementation simply ignores it)
Parameter | Type | Description |
---|---|---|
fill | Object | a fill object (see dojox/gfx.defaultLinearGradient, dojox/gfx.defaultRadialGradient, dojox/gfx.defaultPattern, or dojo/_base/Color) |
sets a fill object (the default implementation simply ignores it)
set the lights
Parameter | Type | Description |
---|---|---|
lights | Array | an array of light object or lights object |
ambient | Color |
Optional an ambient object |
specular | Color |
Optional an specular object |
set the lights
Parameter | Type | Description |
---|---|---|
scheduler | undefined |
sets a shape object (the default implementation simply ignores it)
Parameter | Type | Description |
---|---|---|
shape | Object | a shape object (see dojox/gfx.defaultPath, dojox/gfx.defaultPolyline, dojox/gfx.defaultRect, dojox/gfx.defaultEllipse, dojox/gfx.defaultCircle, dojox/gfx.defaultLine, or dojox/gfx.defaultImage) |
sets a shape object (the default implementation simply ignores it)
sets a stroke object (the default implementation simply ignores it)
Parameter | Type | Description |
---|---|---|
stroke | Object | a stroke object (see dojox/gfx.defaultStroke) |
sets a stroke object (the default implementation simply ignores it)
sets a transformation matrix
Parameter | Type | Description |
---|---|---|
matrix | dojox/gfx/matrix.Matrix2D | a matrix or a matrix-like object (see an argument of dojox/gfx/matrix.Matrix2D constructor for a list of acceptable arguments) |