See the dojox/gfx/canvasWithEvents.Group reference documentation for more information.
returns the cumulative ('real') transformation matrix by combining the shape's matrix with its parent's matrix
| Parameter | Type | Description |
|---|---|---|
| ctx | undefined | |
| x | undefined | |
| y | undefined |
| Parameter | Type | Description |
|---|---|---|
| ctx | Object | |
| pos | Array |
renderer-specific hook, see dojox/gfx/shape.Shape.moveToFront()
renderer-specific hook, see dojox/gfx/shape.Shape.moveToFront()
| Parameter | Type | Description |
|---|---|---|
| ctx | undefined | |
| apply | undefined |
render fill for the shape
| Parameter | Type | Description |
|---|---|---|
| ctx | Object | a canvas context object |
| apply | Boolean | whether ctx.stroke() shall be called |
render stroke for the shape
| Parameter | Type | Description |
|---|---|---|
| ctx | Object | a canvas context object |
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 |
| Parameter | Type | Description |
|---|---|---|
| ctx | Object | |
| pos | Array |
updates the parent matrix with new matrix
| Parameter | Type | Description |
|---|---|---|
| matrix | dojox/gfx/Matrix2D | a 2D matrix or a matrix-like object |
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
submits the current batch.
On canvas, this method flushes the pending redraws queue.
submits the current batch.
Deprecated. Connects a handler to an event on this shape. Use on instead.
| Parameter | Type | Description |
|---|---|---|
| name | undefined | |
| object | undefined | |
| method | undefined |
creates a circle shape
| Parameter | Type | Description |
|---|---|---|
| circle | Object | a circle object (see dojox/gfx.defaultCircle) |
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 a path shape
| Parameter | Type | Description |
|---|---|---|
| path | Object | a path object (see dojox/gfx.defaultPath) |
creates a polyline/polygon shape
| Parameter | Type | Description |
|---|---|---|
| points | Object | a points object (see dojox/gfx.defaultPolyline) or an Array of points |
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) |
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.
Deprecated. Disconnects an event handler. Use handle.remove instead.
| Parameter | Type | Description |
|---|---|---|
| handle | undefined |
Returns the bounding box Rectangle for this shape or null if a BoundingBox cannot be calculated for the shape on the current renderer or for shapes with no geometric area (points). A bounding box is a rectangular geometric region defining the X and Y extent of the shape. (see dojox/gfx.defaultRect) Note that this method returns a direct reference to the attribute of this instance. Therefore you should not modify its value directly but clone it instead.
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.
| Parameter | Type | Description |
|---|---|---|
| shape | undefined | |
| silently | undefined |
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
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)
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) |