Conveniently set the first translation of the element's transform.
x coordinate or full point definition
y coordinate if pointOrX is just the x coordinate (0)
Conveniently set the first rotation of the element's transform.
Conveniently set the first scale of the element's transform.
horizontal scale - either
define as full x-y point, or as a number. If scaleOrX is a number and
y is null, then both x and y will be equally scaled
y coordinate if scaleOrX is a number (null)
Set transform of element. Setting through this method will ensure
setTransfrom subscription will publish, and transform will be
appropriately clipped.
Set element color.
RGBA color from 0 to 1
OptionalsetDefault: boolean = truealso set the default color to this color
Set element color to dimColor
Set element color to defaultColor
Set transform, color and/or visibility to a predefined scenario.
Save the current transform, color and/or visibility to a scenario.
Return figure path of element
path of element relative to figure
Pulse element.
An element can be pulsed in scale, a rotation or a translation.
The scale pulse can either be a single pulse, or a number of copies with a range of scales - which has the effect of making regular polygons thick.
Either pass in a callback, or an options object defining the pulse and callback.
Transform a point between 'draw', 'local', 'figure', 'gl' and 'pixel' spaces.
plane is only needed when converting from pixel space (a 2D space) to
'figure', 'local' or 'draw' spaces (a 3D space). A ray from the pixel is
drawn into the screen
and the intersection with the defined plane is returned.
'pixel' to 'gl' is also a 2D to 3D transformation, but in this case the XY plane at z = 0 is used in gl space.
space to convert point from
space to convert point to
Return a matrix that can transform from one coordinate space to another.
Get the border or touchBorder of a FigureElementPrimitive in a defined coordinate space.
('local)
('border')
Return the first scale in the element's transform. Will return
[1, 1] if element's transform doesn't have a scale.
scale
Return the first rotation in the element's transform.
how to normalize the
returned angle where '' returns the raw angle
scale
Get position of element
By default the first translation of the element's transform is returned. This is effectively the element's location in 'local' coordinates.
The position of the element relative to its horizontal and vertical bounds
can also be returned. Use xAlign to find the x coordinate of the left,
center, right or percentage width from left of the element. Use yAlign
to find the bottom, middle, top or percentage height from bottom of the
element.
the space to return the position in
horizontal alignment of position. Use a number to define the horizontal
position in percentage width from the left.
vertical alignment of position. Use a number to define the vertical
position in percentage height from the bottom.
Set the element's position in local space such that it lines up with a figure space target.
Align element position in local space such that it is in the same position as the target element (even if that element is in a different local space)
Show element.
true set this element as touchable and configures all parent elements
to accept touches for their children
false makes this element not touchable.
Configure all parents to make this element touchable, and make this element touchable and movable
true to make movable, false to not
Hide element
Toggle hide/show of element
Get current transform of element.
true if element is moving
true if element is animating
Figure Element base class
The set of properties and methods shared by all figure elements
A figure element has several color related properties. Color is defined as an RGBA array with values between 0 and 1. The alpha channel defines the transparency or opacity of the color where 1 is fully opaque and 0 is fully transparent.
The
colorproperty stores the element's current color, while thedefaultColorproperty stores the element's color when not dimmed or dissolving. Color should only be set using thesetColormethod.An element can be "dimmed" or "undimmed". For instance, a red element might turn grey when dimmed. The property
dimColorstores the desired color to dim to and should be set withsetDimColor()An element can be dissolved in or out with animation. Dissolving an element out transitions its opacity from its current value to 0. The
opacityproperty is used when dissolving. The opacity is multiplied by the alpha channel ofcolorto net a final opacity. Opacity should not be set directly as it will be overwritten by dissolve animations.Notifications - The notification manager property
notificationswill publish the following events:beforeSetTransform: published just before thetransformproperty is changedsetTransform: published whenever thetransformproperty is changedstartBeingMoved: published when the element starts being moved by touchstopBeingMoved: published when the element stops being moved by touchstartMovingFreelystopMovingFreelyshow: published when element is shownhide: published when element is hiddenvisibility: published when element element is shown or hiddenonClick: published when element is clicked oncolor: published whenever color is setbeforeDrawafterDrawsetState: state of element has been set