Skip to main content

CubicBezier

class CubicBezier extends Bezier

A node for drawing a cubic Bézier curve.

Loading preview…
import ...

export default makeScene2D(function* (view) {
  const bezier = createRef<CubicBezier>();

  view.add(
    <CubicBezier
      ref={bezier}
      lineWidth={4}
      stroke={'lightseagreen'}
      p0={[-200, -100]}
      p1={[100, -100]}
      p2={[-100, 100]}
      p3={[200, 100]}
      end={0}
    />
  );

  yield* bezier().end(1, 1);
  yield* bezier().start(1, 1).to(0, 1);
});

Constructors​

constructor​

public override new CubicBezierprops: CubicBezierProps: CubicBezier

Parameters

Overwrites Bezier.constructor

Properties​

absolutePosition​

readonly public absolutePosition: SimpleVector2SignalCubicBezier

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.

Deprecated

Use position.abs instead.

Inherited from Bezier.absolutePosition

absoluteRotation​

readonly public absoluteRotation: SimpleSignalnumberCubicBezier

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.

Deprecated

Use rotation.abs instead.

Inherited from Bezier.absoluteRotation

absoluteScale​

readonly public absoluteScale: SimpleVector2SignalCubicBezier

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.

Deprecated

Use scale.abs instead.

Inherited from Bezier.absoluteScale

alignContent​

readonly public alignContent: SimpleSignalFlexContentCubicBezier
Inherited from Bezier.alignContent

alignItems​

readonly public alignItems: SimpleSignalFlexItemsCubicBezier
Inherited from Bezier.alignItems

alignSelf​

readonly public alignSelf: SimpleSignalFlexItemsCubicBezier
Inherited from Bezier.alignSelf

anchor​

readonly public anchor: Vector2SignalCubicBezier

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 anchors:

  • [-1, -1] or Vector2.topLeft - top left corner
  • [1, -1] or Vector2.topRight - top right corner
  • [0, 1] or Vector2.bottom - bottom edge
  • [-1, 1] or Vector2.bottomLeft - bottom left corner
Inherited from Bezier.anchor

antialiased​

readonly public antialiased: SimpleSignalbooleanCubicBezier
Inherited from Bezier.antialiased

arrowSize​

readonly public arrowSize: SimpleSignalnumberCubicBezier

Controls the size of the end and start arrows.

To make the arrows visible make sure to enable startArrow and/or endArrow.

Inherited from Bezier.arrowSize

basis​

readonly public basis: SimpleSignalFlexBasisCubicBezier
Inherited from Bezier.basis

bottom​

readonly public bottom: LayoutPositionSignalCubicBezier

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 from Bezier.bottom

bottomLeft​

readonly public bottomLeft: LayoutPositionSignalCubicBezier

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 from Bezier.bottomLeft

bottomRight​

readonly public bottomRight: LayoutPositionSignalCubicBezier

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 from Bezier.bottomRight

bowing​

readonly public bowing: SimpleSignalnumberCubicBezier

Controls the curve deviation from a straight line.

A value of 0 will cause lines to be perfectly straight. Higher values introduce more curvature.

Inherited from Bezier.bowing

cache​

readonly public cache: SimpleSignalbooleanCubicBezier
Inherited from Bezier.cache

cachePadding​

readonly public cachePadding: SpacingSignalCubicBezier

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.

Inherited from Bezier.cachePadding

children​

readonly public children: SignalComponentChildrenNode[]CubicBezier
Inherited from Bezier.children

clip​

readonly public clip: SimpleSignalbooleanCubicBezier
Inherited from Bezier.clip

closed​

readonly public closed: SimpleSignalbooleanCubicBezier

Whether the curve should be closed.

Closed curves have their start and end points connected.

Inherited from Bezier.closed

composite​

readonly public composite: SimpleSignalbooleanCubicBezier
Inherited from Bezier.composite

compositeOperation​

readonly public compositeOperation: SimpleSignalGlobalCompositeOperationCubicBezier
Inherited from Bezier.compositeOperation

creationStack​

readonly public creationStack?: string
Inherited from Bezier.creationStack

direction​

readonly public direction: SimpleSignalFlexDirectionCubicBezier
Inherited from Bezier.direction

end​

readonly public end: SimpleSignalnumberCubicBezier

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).

Inherited from Bezier.end

endArrow​

readonly public endArrow: SimpleSignalbooleanCubicBezier

Whether to display an arrow at the end of the visible curve.

Use arrowSize to control the size of the arrow.

Inherited from Bezier.endArrow

endOffset​

readonly public endOffset: SimpleSignalnumberCubicBezier

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.

Inherited from Bezier.endOffset

fill​

readonly public fill: CanvasStyleSignalCubicBezier
Inherited from Bezier.fill

fillShaders​

readonly public fillShaders: SignalPossibleShaderConfigShaderConfig[]CubicBezier
Experimental
This is an experimental feature. The behavior and API may change drastically between minor releases.
Inherited from Bezier.fillShaders

filters​

readonly public filters: FiltersSignalCubicBezier
Inherited from Bezier.filters

fontFamily​

readonly public fontFamily: SimpleSignalstringCubicBezier
Inherited from Bezier.fontFamily

fontSize​

readonly public fontSize: SimpleSignalnumberCubicBezier
Inherited from Bezier.fontSize

fontStyle​

readonly public fontStyle: SimpleSignalstringCubicBezier
Inherited from Bezier.fontStyle

fontWeight​

readonly public fontWeight: SimpleSignalnumberCubicBezier
Inherited from Bezier.fontWeight

gap​

readonly public gap: Vector2LengthSignalCubicBezier
Inherited from Bezier.gap

grow​

readonly public grow: SimpleSignalnumberCubicBezier
Inherited from Bezier.grow

isClass​

public isClass: boolean
Inherited from Bezier.isClass

justifyContent​

readonly public justifyContent: SimpleSignalFlexContentCubicBezier
Inherited from Bezier.justifyContent

key​

readonly public key: string
Inherited from Bezier.key

layout​

readonly public layout: SimpleSignalLayoutModeCubicBezier
Inherited from Bezier.layout

layoutChildren​

readonly public layoutChildren: SimpleSignalLayoutModeCubicBezier

Whether this node lays out its own children with flex. Use canLayoutChildren to read the resolved mode.

Inherited from Bezier.layoutChildren

layoutSelf​

readonly public layoutSelf: SimpleSignalLayoutModeCubicBezier

Whether this node participates in its parent's flex layout. Use layoutEnabled to read the resolved mode.

Inherited from Bezier.layoutSelf

left​

readonly public left: LayoutPositionSignalCubicBezier

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 from Bezier.left

letterSpacing​

readonly public letterSpacing: SimpleSignalnumberCubicBezier
Inherited from Bezier.letterSpacing

lineCap​

readonly public lineCap: SimpleSignalCanvasLineCapCubicBezier
Inherited from Bezier.lineCap

lineDash​

readonly public lineDash: SimpleSignalnumber[]CubicBezier
Inherited from Bezier.lineDash

lineDashOffset​

readonly public lineDashOffset: SimpleSignalnumberCubicBezier
Inherited from Bezier.lineDashOffset

lineHeight​

readonly public lineHeight: SimpleSignalLengthCubicBezier
Inherited from Bezier.lineHeight

lineJoin​

readonly public lineJoin: SimpleSignalCanvasLineJoinCubicBezier
Inherited from Bezier.lineJoin

lineWidth​

readonly public lineWidth: SimpleSignalnumberCubicBezier
Inherited from Bezier.lineWidth

margin​

readonly public margin: SpacingSignalCubicBezier
Inherited from Bezier.margin

maxHeight​

readonly public maxHeight: SimpleSignalLengthLimitCubicBezier
Inherited from Bezier.maxHeight

maxWidth​

readonly public maxWidth: SimpleSignalLengthLimitCubicBezier
Inherited from Bezier.maxWidth

middle​

readonly public middle: LayoutPositionSignalCubicBezier

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 anchor 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 from Bezier.middle

minHeight​

readonly public minHeight: SimpleSignalLengthLimitCubicBezier
Inherited from Bezier.minHeight

minWidth​

readonly public minWidth: SimpleSignalLengthLimitCubicBezier

The smallest width flex may shrink this node to. Left unset, a flex item of a row keeps room for its narrowest content, capped by its own width and maxWidth; 0 lets it shrink past that, as CSS min-width: 0 does.

Examples

Inherited from Bezier.minWidth

opacity​

readonly public opacity: SimpleSignalnumberCubicBezier

Represents the opacity of this node in the range 0-1.

The value is clamped to the range 0-1.

Inherited from Bezier.opacity

p0​

readonly public p0: Vector2SignalCubicBezier

The start point of the Bézier curve.

p1​

readonly public p1: Vector2SignalCubicBezier

The first control point of the Bézier curve.

p2​

readonly public p2: Vector2SignalCubicBezier

The second control point of the Bézier curve.

p3​

readonly public p3: Vector2SignalCubicBezier

The end point of the Bézier curve.

padding​

readonly public padding: SpacingSignalCubicBezier
Inherited from Bezier.padding

parent​

readonly public parent: SimpleSignalNodenullvoid = ...
Inherited from Bezier.parent

position​

readonly public position: PositionSignalCubicBezier

Represents the position of this node in local space of its parent.

Examples

Inherited from Bezier.position

properties​

readonly public properties: RecordstringPropertyMetadataany = ...
Inherited from Bezier.properties

ratio​

readonly public ratio: SimpleSignalnumbernullCubicBezier
Inherited from Bezier.ratio
readonly public right: LayoutPositionSignalCubicBezier

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 from Bezier.right

rotation​

readonly public rotation: RotationSignalCubicBezier

Represents the rotation (in degrees) of this node relative to its parent.

Inherited from Bezier.rotation

rough​

readonly public rough: SimpleSignalbooleanCubicBezier

Enable rough.js rendering.

Inherited from Bezier.rough

roughDisableMultiStroke​

readonly public roughDisableMultiStroke: SimpleSignalbooleanCubicBezier

Whether to disable multi-stroke rendering.

By default, Rough.js renders strokes with multiple lines for a more sketchy appearance. Set to true to use a single stroke.

Inherited from Bezier.roughDisableMultiStroke

roughDisableMultiStrokeFill​

readonly public roughDisableMultiStrokeFill: SimpleSignalbooleanCubicBezier

Whether to disable multi-stroke fill.

By default, Rough.js renders fills with multiple passes. Set to true to use a single fill pass.

Inherited from Bezier.roughDisableMultiStrokeFill

roughFillStyle​

readonly public roughFillStyle: SimpleSignalRoughFillStyleCubicBezier

Fill style for the shape.

Inherited from Bezier.roughFillStyle

roughFillWeight​

readonly public roughFillWeight: SimpleSignalnumberundefinedCubicBezier

Thickness of the lines used for filling.

Only applicable for hachure, cross-hatch, and similar fill styles.

Inherited from Bezier.roughFillWeight

roughHachureAngle​

readonly public roughHachureAngle: SimpleSignalnumberCubicBezier

Angle of the hachure lines in degrees.

Only applicable for hachure and cross-hatch fill styles.

Inherited from Bezier.roughHachureAngle

roughHachureGap​

readonly public roughHachureGap: SimpleSignalnumberCubicBezier

Gap between hachure lines in pixels.

Only applicable for hachure, cross-hatch, and similar fill styles.

Inherited from Bezier.roughHachureGap

roughness​

readonly public roughness: SimpleSignalnumberCubicBezier

Numerical value indicating how rough the drawing is.

A value of 0 will produce a smooth shape, while higher values introduce more irregularity. Typical range is 0-10.

Inherited from Bezier.roughness

roughSeed​

readonly public roughSeed: SimpleSignalnumberundefinedCubicBezier

Seed for the random number generator.

Using the same seed produces consistent results, which is useful for reproducible animations.

Inherited from Bezier.roughSeed

scale​

readonly public scale: ScaleSignalCubicBezier

Represents the scale of this node in local space of its parent.

Examples

Inherited from Bezier.scale

shaders​

readonly public shaders: SignalPossibleShaderConfigShaderConfig[]CubicBezier
Experimental
This is an experimental feature. The behavior and API may change drastically between minor releases.
Inherited from Bezier.shaders

shadowBlur​

readonly public shadowBlur: SimpleSignalnumberCubicBezier
Inherited from Bezier.shadowBlur

shadowColor​

readonly public shadowColor: ColorSignalCubicBezier
Inherited from Bezier.shadowColor

shadowOffset​

readonly public shadowOffset: Vector2SignalCubicBezier
Inherited from Bezier.shadowOffset

shrink​

readonly public shrink: SimpleSignalnumberCubicBezier
Inherited from Bezier.shrink

size​

readonly public size: Vector2LengthSignalCubicBezier

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 partials.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 nearest ancestor that has a size or a layout, which is the entire scene when no other ancestor does.

Examples

Inherited from Bezier.size

skew​

readonly public skew: Vector2SignalCubicBezier

Represents the skew of this node in local space of its parent.

Examples

Inherited from Bezier.skew

start​

readonly public start: SimpleSignalnumberCubicBezier

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).

Inherited from Bezier.start

startArrow​

readonly public startArrow: SimpleSignalbooleanCubicBezier

Whether to display an arrow at the start of the visible curve.

Use arrowSize to control the size of the arrow.

Inherited from Bezier.startArrow

startOffset​

readonly public startOffset: SimpleSignalnumberCubicBezier

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.

Inherited from Bezier.startOffset

stroke​

readonly public stroke: CanvasStyleSignalCubicBezier
Inherited from Bezier.stroke

strokeFirst​

readonly public strokeFirst: SimpleSignalbooleanCubicBezier
Inherited from Bezier.strokeFirst

strokeShaders​

readonly public strokeShaders: SignalPossibleShaderConfigShaderConfig[]CubicBezier
Experimental
This is an experimental feature. The behavior and API may change drastically between minor releases.
Inherited from Bezier.strokeShaders

textAlign​

readonly public textAlign: SimpleSignalTextAlignCubicBezier
Inherited from Bezier.textAlign

textDirection​

readonly public textDirection: SimpleSignalCanvasDirectionCubicBezier
Inherited from Bezier.textDirection

textWrap​

readonly public textWrap: SimpleSignalTextWrapCubicBezier
Inherited from Bezier.textWrap

top​

readonly public top: LayoutPositionSignalCubicBezier

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 from Bezier.top

topLeft​

readonly public topLeft: LayoutPositionSignalCubicBezier

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 from Bezier.topLeft

topRight​

readonly public topRight: LayoutPositionSignalCubicBezier

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 from Bezier.topRight

translate​

readonly public translate: Vector2SignalCubicBezier

A visual offset applied to this node's rendering, analogous to CSS transform: translate(). Does not affect layout.

Inherited from Bezier.translate

verticalAlign​

readonly public verticalAlign: SimpleSignalVerticalAlignCubicBezier
Inherited from Bezier.verticalAlign

wordBreak​

readonly public wordBreak: SimpleSignalWordBreakCubicBezier
Inherited from Bezier.wordBreak

wrap​

readonly public wrap: SimpleSignalFlexWrapCubicBezier
Inherited from Bezier.wrap

yogaNode​

public yogaNode: Node
Inherited from Bezier.yogaNode

zIndex​

readonly public zIndex: SimpleSignalnumberCubicBezier
Inherited from Bezier.zIndex

Accessors​

columnGap​

public get columnGap(): SignalLengthnumberthis
Inherited from Bezier.columnGap

height​

public get height(): SignalLengthnumberthis
Inherited from Bezier.height

rowGap​

public get rowGap(): SignalLengthnumberthis
Inherited from Bezier.rowGap

width​

public get width(): SignalLengthnumberthis
Inherited from Bezier.width

x​

public get x(): PositionComponentSignalthis
Inherited from Bezier.x

y​

public get y(): PositionComponentSignalthis
Inherited from Bezier.y

Methods​

[iterator]​

public [iterator](): Generatorkey: stringmeta: PropertyMetadataanysignal: SimpleSignalanyvoidunknown
Inherited from Bezier.[iterator]

absoluteOpacity​

public absoluteOpacity(): number
Inherited from Bezier.absoluteOpacity

add​

public addnode: ComponentChildren: this
public addnode: ComponentChildrenduration: numbertiming?: TimingFunctionanimate?: LayoutAnimateCallback: ThreadGenerator

Append a child. With a duration, the call returns a ThreadGenerator that scales the child into its slot while the surrounding flex layout reflows; without one, it behaves like Node.add and returns this.

Parameters

  • node: ComponentChildren
Inherited from Bezier.add

anchorPosition​

public anchorPosition(): Vector2
Inherited from Bezier.anchorPosition

applyState​

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: NodeState

    The state to apply to the node.

Inherited from Bezier.applyState

arcLength​

public arcLength(): number

The visible arc length of this curve.

This arc length accounts for both the offset and the start and end properties.

Inherited from Bezier.arcLength

baseArcLength​

public baseArcLength(): number

The base arc length of this curve.

This is the entire length of this curve, not accounting for the offsets.

Inherited from Bezier.baseArcLength

cacheBBox​

public cacheBBox(): BBox

Get a bounding box for the contents rendered by this node as well as its children.

Inherited from Bezier.cacheBBox

canLayoutChildren​

public canLayoutChildren(): boolean

Whether this node lays out its own children with flex. Resolves layoutChildren, then layout, then the parent's canLayoutChildren.

Overridden by Txt (and similar leaves) that must not host yoga children.

Inherited from Bezier.canLayoutChildren

canvasFont​

public canvasFont(): string
Inherited from Bezier.canvasFont

cardinalPoint​

public cardinalPointorigin: OriginDirection: LayoutPositionSignalCubicBezier

Get the cardinal point corresponding to the given origin.

Parameters

Inherited from Bezier.cardinalPoint

childAs​

public childAsindex: number: Tnull

Get the nth children cast to the specified type.

Parameters

  • index: number

    The index of the child to retrieve.

Inherited from Bezier.childAs

childrenAs​

public childrenAs(): T[]

Get the children array cast to the specified type.

Inherited from Bezier.childrenAs

clone​

public clonecustomProps: NodeState = {}: this

Create a copy of this node.

Parameters

Inherited from Bezier.clone

completion​

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.

Inherited from Bezier.completion

compositeToLocal​

public compositeToLocal(): DOMMatrix
Inherited from Bezier.compositeToLocal

compositeToWorld​

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 from Bezier.compositeToWorld

computedPosition​

public computedPosition(): Vector2
Inherited from Bezier.computedPosition

dispose​

public 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.

Inherited from Bezier.dispose

distanceToPercentage​

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: number

    The distance along the curve.

Inherited from Bezier.distanceToPercentage

drawOverlay​

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

Inherited from Bezier.drawOverlay

editLayout​

public editLayoutthis: TLayoutduration: numbermutator: node: TLayout => voidtiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp: ThreadGenerator

Animate a batch of layout-property changes. Children tween from their pre-mutation positions to wherever the post-mutation layout puts them.

Examples

Parameters

Inherited from Bezier.editLayout

findAll​

public findAllpredicate: node: any => node is T: T[]
public findAllpredicate: node: any => boolean: T[]

Find all descendants of this node that match the given predicate.

Parameters

  • predicate: node: any => node is T

    A function that returns true if the node matches.

Inherited from Bezier.findAll

findAncestor​

public findAncestorpredicate: node: Node => node is T: Tnull
public findAncestorpredicate: node: Node => boolean: Tnull

Find the closest ancestor of this node that matches the given predicate.

Parameters

  • predicate: node: Node => node is T

    A function that returns true if the node matches.

Inherited from Bezier.findAncestor

findFirst​

public findFirstpredicate: node: Node => node is T: Tnull
public findFirstpredicate: node: Node => boolean: Tnull

Find the first descendant of this node that matches the given predicate.

Parameters

  • predicate: node: Node => node is T

    A function that returns true if the node matches.

Inherited from Bezier.findFirst

findLast​

public findLastpredicate: node: Node => node is T: Tnull
public findLastpredicate: node: Node => boolean: Tnull

Find the last descendant of this node that matches the given predicate.

Parameters

  • predicate: node: Node => node is T

    A function that returns true if the node matches.

Inherited from Bezier.findLast

freezeLayout​

public freezeLayout(): void

Snap each laid-out child to its current visual position, then disable layoutChildren. Pair with thawLayout to bring children back under flex.

Inherited from Bezier.freezeLayout

getOriginDelta​

public getOriginDeltaorigin: Origin: Vector2

Parameters

Inherited from Bezier.getOriginDelta

getPointAtPercentage​

public getPointAtPercentagevalue: number: CurvePoint

Parameters

Inherited from Bezier.getPointAtPercentage

getState​

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 from Bezier.getState

hit​

public hitposition: Vector2: Nodenull

Try to find a node intersecting the given position.

Parameters

Inherited from Bezier.hit

insert​

public insertnode: ComponentChildrenindex?: number: this
public insertnode: ComponentChildrenindex: numberduration: numbertiming?: TimingFunctionanimate?: LayoutAnimateCallback: ThreadGenerator

Insert a child at a specific index. With a duration, the call returns a ThreadGenerator that scales the child into its slot while the surrounding flex layout reflows; without one, it behaves like Node.insert and returns this.

Parameters

Inherited from Bezier.insert

instantiate​

public instantiateprops: NodeProps = {}: this

Create an instance of this node's class.

Parameters

  • props: NodeProps = {}

    Properties to pass to the constructor.

Inherited from Bezier.instantiate

isLayoutRoot​

public isLayoutRoot(): boolean
Inherited from Bezier.isLayoutRoot

layoutEnabled​

public layoutEnabled(): boolean

Whether this node participates in its parent's flex layout. Resolves layoutSelf, then layout, then the parent's canLayoutChildren.

Inherited from Bezier.layoutEnabled

localToParent​

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 from Bezier.localToParent

localToWorld​

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 from Bezier.localToWorld

lockLayout​

public lockLayout(): void

Increment the layout lock counter. While positive, this node's flexGrow / flexShrink are forced to 0, holding its slot in the parent's flex layout. Pair every call with releaseLayout.

Inherited from Bezier.lockLayout

morphTo​

public morphToother: Nodeduration: numbertiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp: ThreadGenerator

Cross-fade this Layout into another node. Detaches from the parent's flex layout for the duration of the tween so the slot collapses immediately and siblings glide via FLIP.

Parameters

Inherited from Bezier.morphTo

move​

public moveby: number = 1: this

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 = 1

    Number of places by which the node should be moved.

Inherited from Bezier.move

moveAbove​

public moveAbovenode: NodedirectlyAbove: boolean = false: this

Move the node above the provided node in the parent's layout.

The node will be moved above the provided node and from then on will be rendered on top of it. By default, if the node is already positioned higher than the sibling node, it will not get moved.

Parameters

  • node: Node

    The sibling node below which to move.

  • directlyAbove: boolean = false

    Whether the node should be positioned directly above the sibling. When true, will move the node even if it is already positioned above the sibling.

Inherited from Bezier.moveAbove

moveBelow​

public moveBelownode: NodedirectlyBelow: boolean = false: this

Move the node below the provided node in the parent's layout.

The node will be moved below the provided node and from then on will be rendered below it. By default, if the node is already positioned lower than the sibling node, it will not get moved.

Parameters

  • node: Node

    The sibling node below which to move.

  • directlyBelow: boolean = false

    Whether the node should be positioned directly below the sibling. When true, will move the node even if it is already positioned below the sibling.

Inherited from Bezier.moveBelow

moveDown​

public moveDown(): this

Move the node down in relation to its siblings.

The node will exchange places with the sibling right below it (if any) and from then on will be rendered under it.

Inherited from Bezier.moveDown

moveOffset​

public moveOffsetoffset: Vector2: void

Update the offset of this node and adjust the position to keep it in the same place.

Parameters

Inherited from Bezier.moveOffset

moveTo​

public moveToindex: number: this

Move the node to the provided position relative to its siblings.

If the node is getting moved to a lower position, it will be placed below the sibling that's currently at the provided index (if any). If the node is getting moved to a higher position, it will be placed above the sibling that's currently at the provided index (if any).

Parameters

  • index: number

    The index to move the node to.

Inherited from Bezier.moveTo

moveToBottom​

public moveToBottom(): this

Move the node to the bottom in relation to its siblings.

The node will be placed at the beginning of the children list and from then on will be rendered below all of its siblings.

Inherited from Bezier.moveToBottom

moveToTop​

public moveToTop(): this

Move the node to the top in relation to its siblings.

The node will be placed at the end of the children list and from then on will be rendered on top of all of its siblings.

Inherited from Bezier.moveToTop

moveUp​

public moveUp(): this

Move the node up in relation to its siblings.

The node will exchange places with the sibling right above it (if any) and from then on will be rendered on top of it.

Inherited from Bezier.moveUp

offsetArcLength​

public offsetArcLength(): number

The offset arc length of this curve.

This is the length of the curve that accounts for the offsets.

Inherited from Bezier.offsetArcLength

parentAs​

public parentAs(): Tnull

Get the parent cast to the specified type.

Inherited from Bezier.parentAs

parentToWorld​

public parentToWorld(): DOMMatrix

Get the parent-to-world matrix for this node.

This matrix transforms vectors from local space of this node's parent to world space.

Inherited from Bezier.parentToWorld

peekChildren​

public peekChildren(): readonly Node[]

Get the current children of this node.

Unlike children, this method does not have any side effects. It does not register the children signal as a dependency, and it does not spawn any children. It can be used to safely retrieve the current state of the scene graph for debugging purposes.

Inherited from Bezier.peekChildren

percentageToDistance​

public percentageToDistancevalue: number: number

Convert a percentage along the curve to a distance.

The returned distance is given in relation to the full curve, not accounting for startOffset and endOffset.

Parameters

  • value: number

    The percentage along the curve.

Inherited from Bezier.percentageToDistance

profile​

public profile(): CurveProfile
Inherited from Bezier.profile

reactiveClone​

public reactiveClonecustomProps: NodeState = {}: this

Create a reactive copy of this node.

A reactive copy has all its properties dynamically updated to match the source node.

Parameters

Inherited from Bezier.reactiveClone

releaseLayout​

public releaseLayout(): void

Decrement the layout lock counter.

Inherited from Bezier.releaseLayout

remove​

public remove(): this
public removeduration: numbertiming?: TimingFunctionanimate?: LayoutAnimateCallback: ThreadGenerator

Remove this node from its parent. With a duration and a Layout parent, the call returns a ThreadGenerator that scales the node out as its slot collapses; without one (or with a non-Layout parent), it behaves like Node.remove and returns this.

Inherited from Bezier.remove

removeChildren​

public removeChildren(): this

Remove all children of this node.

Inherited from Bezier.removeChildren

render​

public rendercontext: CanvasRenderingContext2D: void

Render this node onto the given canvas.

Parameters

Inherited from Bezier.render

reparent​

public reparentnewParent: Node: this

Change the parent of this node while keeping the absolute transform.

After performing this operation, the node will stay in the same place visually, but its parent will be changed.

Parameters

Inherited from Bezier.reparent

resolvedLineHeight​

public resolvedLineHeight(): number
Inherited from Bezier.resolvedLineHeight

restore​

public restore(): void
public restoreduration: numbertiming?: TimingFunction: ThreadGenerator

Restore the node to its last saved state.

This method can be used together with the save method to restore a node to a previously saved state. Restoring a node to a previous state removes that state from the state stack.

Examples

Inherited from Bezier.restore

ripple​

public rippleduration: number = 1: GeneratorvoidThreadGeneratorPromiseanyPromisableanyvoidany

Parameters

Inherited from Bezier.ripple

save​

public save(): void

Push a snapshot of the node's current state onto the node's state stack.

This method can be used together with the restore method to save a node's current state and later restore it. It is possible to store more than one state by calling save method multiple times.

Inherited from Bezier.save

snapshotClone​

public snapshotClonecustomProps: NodeState = {}: this

Create a copy of this node.

Unlike clone, a snapshot clone calculates any reactive properties at the moment of cloning and passes the raw values to the copy.

Parameters

Inherited from Bezier.snapshotClone

thawLayout​

public thawLayoutduration: numbertiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp: ThreadGenerator

Re-enable layoutChildren and animate each child from its manual position to wherever the flex layout now places it.

Parameters

Inherited from Bezier.thawLayout

toPromise​

public toPromise(): PromiseCubicBezier

Wait for any asynchronous resources that this node or its children have.

Certain resources like images are always loaded asynchronously. Awaiting this method makes sure that all such resources are done loading before continuing the animation.

Inherited from Bezier.toPromise

transitionTo​

public transitionTonewParent: NodeindexOrDuration: numberdurationOrTiming?: numberTimingFunctiontiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp: ThreadGenerator

Move this Layout into a new parent, smoothly shrinking the slot in the old parent and growing the slot in the new parent.

Parameters

Inherited from Bezier.transitionTo

view​

public view(): View2D
Inherited from Bezier.view

worldToLocal​

public worldToLocal(): DOMMatrix

Get the world-to-local matrix for this node.

This matrix transforms vectors from world space to local space of this node.

Examples

Inherited from Bezier.worldToLocal

worldToParent​

public worldToParent(): DOMMatrix

Get the world-to-parent matrix for this node.

This matrix transforms vectors from world space to local space of this node's parent.

Inherited from Bezier.worldToParent