class View2D extends Rect
Constructors
constructor
Parameters
props: View2DProps
Rect.constructorProperties
absolutePosition
readonly public absolutePosition: SimpleVector2SignalView2D
A helper signal for operating on the position in world space.
Retrieving the position using this signal returns the position in world space. Similarly, setting the position using this signal transforms the new value to local space.
If the new value is a function, the position of this node will be continuously updated to always match the position returned by the function. This can be useful to "pin" the node in a specific place or to make it follow another node's position.
Unlike position, this signal is not compound - it doesn't contain
separate signals for the x and y components.
Rect.absolutePositionabsoluteRotation
readonly public absoluteRotation: SimpleSignalnumberView2D
A helper signal for operating on the rotation in world space.
Retrieving the rotation using this signal returns the rotation in world space. Similarly, setting the rotation using this signal transforms the new value to local space.
If the new value is a function, the rotation of this node will be continuously updated to always match the rotation returned by the function.
Inherited fromRect.absoluteRotationabsoluteScale
readonly public absoluteScale: SimpleVector2SignalView2D
A helper signal for operating on the scale in world space.
Retrieving the scale using this signal returns the scale in world space. Similarly, setting the scale using this signal transforms the new value to local space.
If the new value is a function, the scale of this node will be continuously updated to always match the position returned by the function.
Unlike scale, this signal is not compound - it doesn't contain
separate signals for the x and y components.
Rect.absoluteScalealignContent
readonly public alignContent: SimpleSignalFlexContentView2D
Rect.alignContentalignItems
readonly public alignItems: SimpleSignalFlexItemsView2D
Rect.alignItemsalignSelf
readonly public alignSelf: SimpleSignalFlexItemsView2D
Rect.alignSelfantialiased
readonly public antialiased: SimpleSignalbooleanView2D
Rect.antialiasedarrowSize
readonly public arrowSize: SimpleSignalnumberView2D
Controls the size of the end and start arrows.
To make the arrows visible make sure to enable startArrow and/or
endArrow.
Rect.arrowSizeassetHash
readonly public assetHash: SimpleSignalstringView2D
basis
readonly public basis: SimpleSignalFlexBasisView2D
Rect.basisbottom
readonly public bottom: SimpleVector2SignalView2D
The position of the bottom edge of this node.
When set, this shortcut property will modify the node's position so that the bottom edge ends up in the given place.
When retrieved, it will return the position of the bottom edge in the parent space.
Inherited fromRect.bottombottomLeft
readonly public bottomLeft: SimpleVector2SignalView2D
The position of the bottom left corner of this node.
When set, this shortcut property will modify the node's position so that the bottom left corner ends up in the given place.
When retrieved, it will return the position of the bottom left corner in the parent space.
Inherited fromRect.bottomLeftbottomRight
readonly public bottomRight: SimpleVector2SignalView2D
The position of the bottom right corner of this node.
When set, this shortcut property will modify the node's position so that the bottom right corner ends up in the given place.
When retrieved, it will return the position of the bottom right corner in the parent space.
Inherited fromRect.bottomRightcache
readonly public cache: SimpleSignalbooleanView2D
Rect.cachecachePadding
readonly public cachePadding: SpacingSignalView2D
Controls the padding of the cached canvas used by this node.
By default, the size of the cache is determined based on the bounding box
of the node and its children. That includes effects such as stroke or
shadow. This property can be used to expand the cache area further.
Usually used to account for custom effects created by shaders.
Rect.cachePaddingchildren
readonly public children: SignalComponentChildrenNode[]View2DSignalContextComponentChildrenNode[]View2D
Rect.childrenclip
readonly public clip: SimpleSignalbooleanView2D
Rect.clipclosed
readonly public closed: SimpleSignalbooleanView2D
Whether the curve should be closed.
Closed curves have their start and end points connected.
Inherited fromRect.closedcomposite
readonly public composite: SimpleSignalbooleanView2D
Rect.compositecompositeOperation
readonly public compositeOperation: SimpleSignalGlobalCompositeOperationView2D
Rect.compositeOperationcornerSharpness
readonly public cornerSharpness: SimpleSignalnumberView2D
Controls the sharpness of smoothCorners.
This property only affects the way rounded corners are drawn. To control
the corner radius use the radius property.
Requires smoothCorners to be enabled to have any effect.
By default, corner sharpness is set to 0.6 which represents a smooth,
circle-like rounding. At 0 the edges are squared off.
Examples
Inherited fromRect.cornerSharpnesscreationStack
readonly public creationStack?: string
Rect.creationStackdirection
readonly public direction: SimpleSignalFlexDirectionView2D
Rect.directionelement
public element: HTMLElement
Rect.elementend
readonly public end: SimpleSignalnumberView2D
A percentage from the start after which the curve should be clipped.
The portion of the curve that comes after the given percentage will be made invisible.
This property is usefully for animating the curve appearing on the screen.
The value of 0 means the very start of the curve (accounting for the
startOffset) while 1 means the very end (accounting for the
endOffset).
Rect.endendArrow
readonly public endArrow: SimpleSignalbooleanView2D
Whether to display an arrow at the end of the visible curve.
Use arrowSize to control the size of the arrow.
Rect.endArrowendOffset
readonly public endOffset: SimpleSignalnumberView2D
The offset in pixels from the end of the curve.
This property lets you specify where along the defined curve the actual
visible portion ends. For example, setting it to 20 will make the last
20 pixels of the curve invisible.
This property is useful for trimming the curve using a fixed distance.
If you want to animate the curve appearing on the screen, use end
instead.
Rect.endOffsetfill
readonly public fill: CanvasStyleSignalView2D
Rect.fillfilters
readonly public filters: FiltersSignalView2D
Rect.filtersfontFamily
readonly public fontFamily: SimpleSignalstringView2D
Rect.fontFamilyfontSize
readonly public fontSize: SimpleSignalnumberView2D
Rect.fontSizefontStyle
readonly public fontStyle: SimpleSignalstringView2D
Rect.fontStylefontWeight
readonly public fontWeight: SimpleSignalnumberView2D
Rect.fontWeightgap
readonly public gap: Vector2LengthSignalView2D
Rect.gapglobalTime
readonly public globalTime: SimpleSignalnumberView2D
grow
readonly public grow: SimpleSignalnumberView2D
Rect.growisClass
public isClass: boolean
Rect.isClassjustifyContent
readonly public justifyContent: SimpleSignalFlexContentView2D
Rect.justifyContentkey
readonly public key: string
Rect.keylayout
readonly public layout: SimpleSignalLayoutModeView2D
Rect.layoutleft
readonly public left: SimpleVector2SignalView2D
The position of the left edge of this node.
When set, this shortcut property will modify the node's position so that the left edge ends up in the given place.
When retrieved, it will return the position of the left edge in the parent space.
Inherited fromRect.leftletterSpacing
readonly public letterSpacing: SimpleSignalnumberView2D
Rect.letterSpacinglineCap
readonly public lineCap: SimpleSignalCanvasLineCapView2D
Rect.lineCaplineDash
readonly public lineDash: SimpleSignalnumber[]View2D
Rect.lineDashlineDashOffset
readonly public lineDashOffset: SimpleSignalnumberView2D
Rect.lineDashOffsetlineHeight
readonly public lineHeight: SimpleSignalLengthView2D
Rect.lineHeightlineJoin
readonly public lineJoin: SimpleSignalCanvasLineJoinView2D
Rect.lineJoinlineWidth
readonly public lineWidth: SimpleSignalnumberView2D
Rect.lineWidthmargin
readonly public margin: SpacingSignalView2D
Rect.marginmaxHeight
readonly public maxHeight: SimpleSignalLengthLimitView2D
Rect.maxHeightmaxWidth
readonly public maxWidth: SimpleSignalLengthLimitView2D
Rect.maxWidthmiddle
readonly public middle: SimpleVector2SignalView2D
The position of the center of this node.
When set, this shortcut property will modify the node's position so that the center ends up in the given place.
If the offset has not been changed, this will be the same as the
position.
When retrieved, it will return the position of the center in the parent space.
Inherited fromRect.middleminHeight
readonly public minHeight: SimpleSignalLengthLimitView2D
Rect.minHeightminWidth
readonly public minWidth: SimpleSignalLengthLimitView2D
Rect.minWidthoffset
readonly public offset: Vector2SignalView2D
Represents the offset of this node's origin.
By default, the origin of a node is located at its center. The origin serves as the pivot point when rotating and scaling a node, but it doesn't affect the placement of its children.
The value is relative to the size of this node. A value of 1 means as far
to the right/bottom as possible. Here are a few examples of offsets:
[-1, -1]- top left corner[1, -1]- top right corner[0, 1]- bottom edge[-1, 1]- bottom left corner
Rect.offsetopacity
readonly public opacity: SimpleSignalnumberView2D
Represents the opacity of this node in the range 0-1.
The value is clamped to the range 0-1.
Inherited fromRect.opacitypadding
readonly public padding: SpacingSignalView2D
Rect.paddingparent
readonly public parent: SimpleSignalnullNodevoid = ...
Rect.parentplaybackState
readonly public playbackState: SimpleSignalPlaybackStateView2D
position
readonly public position: Vector2SignalView2D
Represents the position of this node in local space of its parent.
Examples
Inherited fromRect.positionproperties
readonly public properties: RecordstringPropertyMetadataany = ...
Rect.propertiesradius
readonly public radius: SpacingSignalView2D
Rounds the corners of this rectangle.
The value represents the radius of the quarter circle that is used to round the corners. If the value is a number, the same radius is used for all corners. Passing an array of two to four numbers will set individual radii for each corner. Individual radii correspond to different corners depending on the number of values passed:
// top-left-and-bottom-right | top-right-and-bottom-left
[10, 30]
// top-left | top-right-and-bottom-left | bottom-right
[10, 20, 30]
// top-left | top-right | bottom-right | bottom-left
[10, 20, 30, 40]
Examples
Inherited fromRect.radiusratio
readonly public ratio: SimpleSignalnullnumberView2D
Rect.ratioright
readonly public right: SimpleVector2SignalView2D
The position of the right edge of this node.
When set, this shortcut property will modify the node's position so that the right edge ends up in the given place.
When retrieved, it will return the position of the right edge in the parent space.
Inherited fromRect.rightrotation
readonly public rotation: SimpleSignalnumberView2D
Represents the rotation (in degrees) of this node relative to its parent.
Inherited fromRect.rotationscale
readonly public scale: Vector2SignalView2D
Represents the scale of this node in local space of its parent.
Examples
Inherited fromRect.scaleshaders
readonly public shaders: SignalPossibleShaderConfigShaderConfig[]View2DSignalContextPossibleShaderConfigShaderConfig[]View2D
Rect.shadersshadowBlur
readonly public shadowBlur: SimpleSignalnumberView2D
Rect.shadowBlurshadowColor
readonly public shadowColor: ColorSignalView2D
Rect.shadowColorshadowOffset
readonly public shadowOffset: Vector2SignalView2D
Rect.shadowOffsetshrink
readonly public shrink: SimpleSignalnumberView2D
Rect.shrinksize
readonly public size: Vector2LengthSignalView2D
Represents the size of this node.
A size is a two-dimensional vector, where x represents the width, and y
represents the height.
The value of both x and y is of type Length which is
either:
number- the desired length in pixels${number}%- a string with the desired length in percents, for example'50%'null- an automatic length
When retrieving the size, all units are converted to pixels, using the
current state of the layout. For example, retrieving the width set to
'50%', while the parent has a width of 200px will result in the number
100 being returned.
When the node is not part of the layout, setting its size using percents refers to the size of the entire scene.
Examples
Inherited fromRect.sizeskew
readonly public skew: Vector2SignalView2D
Represents the skew of this node in local space of its parent.
Examples
Inherited fromRect.skewsmoothCorners
readonly public smoothCorners: SimpleSignalbooleanView2D
Enables corner smoothing.
This property only affects the way rounded corners are drawn. To control
the corner radius use the radius property.
When enabled, rounded corners are drawn continuously using Bézier curves
rather than quarter circles. The sharpness of the curve can be controlled
with cornerSharpness.
You can read more about corner smoothing in this article by Nick Lawrence.
Examples
Inherited fromRect.smoothCornersstart
readonly public start: SimpleSignalnumberView2D
A percentage from the start before which the curve should be clipped.
The portion of the curve that comes before the given percentage will be made invisible.
This property is usefully for animating the curve appearing on the screen.
The value of 0 means the very start of the curve (accounting for the
startOffset) while 1 means the very end (accounting for the
endOffset).
Rect.startstartArrow
readonly public startArrow: SimpleSignalbooleanView2D
Whether to display an arrow at the start of the visible curve.
Use arrowSize to control the size of the arrow.
Rect.startArrowstartOffset
readonly public startOffset: SimpleSignalnumberView2D
The offset in pixels from the start of the curve.
This property lets you specify where along the defined curve the actual
visible portion starts. For example, setting it to 20 will make the first
20 pixels of the curve invisible.
This property is useful for trimming the curve using a fixed distance.
If you want to animate the curve appearing on the screen, use start
instead.
Rect.startOffsetstroke
readonly public stroke: CanvasStyleSignalView2D
Rect.strokestrokeFirst
readonly public strokeFirst: SimpleSignalbooleanView2D
Rect.strokeFirststyles
public styles: CSSStyleDeclaration
Rect.stylestextAlign
readonly public textAlign: SimpleSignalCanvasTextAlignView2D
Rect.textAligntextDirection
readonly public textDirection: SimpleSignalCanvasDirectionView2D
Rect.textDirectiontextWrap
readonly public textWrap: SimpleSignalTextWrapView2D
Rect.textWraptop
readonly public top: SimpleVector2SignalView2D
The position of the top edge of this node.
When set, this shortcut property will modify the node's position so that the top edge ends up in the given place.
When retrieved, it will return the position of the top edge in the parent space.
Inherited fromRect.toptopLeft
readonly public topLeft: SimpleVector2SignalView2D
The position of the top left corner of this node.
When set, this shortcut property will modify the node's position so that the top left corner ends up in the given place.
When retrieved, it will return the position of the top left corner in the parent space.
Inherited fromRect.topLefttopRight
readonly public topRight: SimpleVector2SignalView2D
The position of the top right corner of this node.
When set, this shortcut property will modify the node's position so that the top right corner ends up in the given place.
When retrieved, it will return the position of the top right corner in the parent space.
Inherited fromRect.topRightwrap
readonly public wrap: SimpleSignalFlexWrapView2D
Rect.wrapzIndex
readonly public zIndex: SimpleSignalnumberView2D
Rect.zIndexshadowRoot
static public shadowRoot: ShadowRoot
Accessors
columnGap
public get columnGap(): SignalLengthnumberthisSignalContextLengthnumberthis
Rect.columnGapheight
public get height(): SignalLengthnumberthisSignalContextLengthnumberthis
Rect.heightrowGap
public get rowGap(): SignalLengthnumberthisSignalContextLengthnumberthis
Rect.rowGapwidth
public get width(): SignalLengthnumberthisSignalContextLengthnumberthis
Rect.widthx
public get x(): SimpleSignalnumberthis
Rect.xy
public get y(): SimpleSignalnumberthis
Rect.yMethods
[iterator]
public [iterator](): Generatorkey: stringmeta: PropertyMetadataanysignal: SimpleSignalanyvoidunknown
Rect.[iterator]absoluteOpacity
public absoluteOpacity(): number
Rect.absoluteOpacityadd
public addnode: ComponentChildren: View2D
Add the given node(s) as the children of this node.
The nodes will be appended at the end of the children list.
Examples
Parameters
node: ComponentChildrenA node or an array of nodes to append.
Rect.addanchorPosition
public anchorPosition(): Vector2
Rect.anchorPositionapplyState
public applyStatestate: NodeState: void
public applyStatestate: NodeStateduration: numbertiming?: TimingFunction: ThreadGenerator
Apply the given state to the node, setting all matching signal values to the provided values.
Parameters
state: NodeStateThe state to apply to the node.
Rect.applyStatearcLength
public arcLength(): number
The visible arc length of this curve.
This arc length accounts for both the offset and the start and
end properties.
Rect.arcLengthbaseArcLength
public baseArcLength(): number
The base arc length of this curve.
This is the entire length of this curve, not accounting for
the offsets.
Rect.baseArcLengthcacheBBox
public cacheBBox(): BBox
Get a bounding box for the contents rendered by this node as well as its children.
Inherited fromRect.cacheBBoxcardinalPoint
public cardinalPointorigin: OriginDirection: SimpleVector2SignalView2D
Get the cardinal point corresponding to the given origin.
Parameters
Inherited fromRect.cardinalPointchildAs
Get the nth children cast to the specified type.
Type Parameters
Parameters
index: numberThe index of the child to retrieve.
Rect.childAschildrenAs
Get the children array cast to the specified type.
Type Parameters
Inherited fromRect.childrenAsclone
public clonecustomProps: NodeState = {}: View2D
Create a copy of this node.
Parameters
customProps: NodeState = {}Properties to override.
Rect.clonecompletion
public completion(): number
The percentage of the curve that's currently visible.
The returned value is the ratio between the visible length (as defined by
start and end) and the offset length of the curve.
Rect.completioncompositeToLocal
public compositeToLocal(): DOMMatrix
Rect.compositeToLocalcompositeToWorld
public compositeToWorld(): DOMMatrix
A matrix mapping composite space to world space.
Certain effects such as blur and shadows ignore the current transformation. This matrix can be used to transform their parameters so that the effect appears relative to the closest composite root.
Inherited fromRect.compositeToWorldcomputedPosition
public computedPosition(): Vector2
Rect.computedPositiondispose
public override dispose(): void
Prepare this node to be disposed of.
This method is called automatically when a scene is refreshed. It will be called even if the node is not currently attached to the tree.
The goal of this method is to clean any external references to allow the node to be garbage collected.
OverwritesRect.disposedistanceToPercentage
public distanceToPercentagevalue: number: number
Convert a distance along the curve to a percentage.
The distance should be given in relation to the full curve, not
accounting for startOffset and endOffset.
Parameters
value: numberThe distance along the curve.
Rect.distanceToPercentagedrawOverlay
public drawOverlaycontext: CanvasRenderingContext2Dmatrix: DOMMatrix: void
Draw an overlay for this node.
The overlay for the currently inspected node is displayed on top of the canvas.
The provided context is in screen space. The local-to-screen matrix can be used to transform all shapes that need to be displayed. This approach allows to keep the line widths and gizmo sizes consistent, no matter how zoomed-in the view is.
Parameters
context: CanvasRenderingContext2DThe context to draw with.
matrix: DOMMatrixA local-to-screen matrix.
Rect.drawOverlayfindAll
Find all descendants of this node that match the given predicate.
Type Parameters
Parameters
Inherited fromRect.findAllfindAncestor
Find the closest ancestor of this node that matches the given predicate.
Type Parameters
Parameters
Inherited fromRect.findAncestorfindFirst
Find the first descendant of this node that matches the given predicate.
Type Parameters
Parameters
Inherited fromRect.findFirstfindKey
Find a node by its key.
Type Parameters
Parameters
key: stringThe key of the node.
findLast
Find the last descendant of this node that matches the given predicate.
Type Parameters
Parameters
Inherited fromRect.findLastgetOriginDelta
Parameters
Inherited fromRect.getOriginDeltagetPointAtPercentage
public getPointAtPercentagevalue: number: CurvePoint
Parameters
value: number
Rect.getPointAtPercentagegetState
public getState(): NodeState
Return a snapshot of the node's current signal values.
This method will calculate the values of any reactive properties of the node at the time the method is called.
Inherited fromRect.getStatehit
Try to find a node intersecting the given position.
Parameters
Inherited fromRect.hitinsert
Insert the given node(s) at the specified index in the children list.
Examples
Parameters
node: ComponentChildrenA node or an array of nodes to insert.
index: number = 0An index at which to insert the node(s).
Rect.insertinstantiate
public instantiateprops: NodeProps = {}: View2D
Create an instance of this node's class.
Parameters
props: NodeProps = {}Properties to pass to the constructor.
Rect.instantiateisLayoutRoot
public isLayoutRoot(): boolean
Rect.isLayoutRootlayoutEnabled
public layoutEnabled(): boolean
Get the resolved layout mode of this node.
When the mode is null, its value will be inherited from the parent.
Use layout to get the raw mode set for this node (without
inheritance).
Rect.layoutEnabledlocalToParent
public localToParent(): DOMMatrix
Get the local-to-parent matrix for this node.
This matrix transforms vectors from local space of this node to local space of this node's parent.
Inherited fromRect.localToParentlocalToWorld
public localToWorld(): DOMMatrix
Get the local-to-world matrix for this node.
This matrix transforms vectors from local space of this node to world space.
Examples
Inherited fromRect.localToWorldlockSize
public lockSize(): void
Rect.lockSizemove
public moveby: number = 1: View2D
Rearrange this node in relation to its siblings.
Children are rendered starting from the beginning of the children list. We can change the rendering order by rearranging said list.
A positive by arguments move the node up (it will be rendered on top of
the elements it has passed). Negative values move it down.
Parameters
by: number = 1Number of places by which the node should be moved.
Rect.move