Latex
class Latex extends SVG
A node for animating equations with LaTeX.
import ...
export default makeScene2D(function* (view) {
const tex = createRef<Latex>();
view.add(<Latex ref={tex} tex="{{y=}}{{a}}{{x^2}}" fill="white" />);
yield* waitFor(0.2);
yield* tex().tex('{{y=}}{{a}}{{x^2}} + {{bx}}', 1);
yield* waitFor(0.2);
yield* tex().tex(
'{{y=}}{{\\left(}}{{a}}{{x^2}} + {{bx}}{{\\over 1}}{{\\right)}}',
1,
);
yield* waitFor(0.2);
yield* tex().tex('{{y=}}{{a}}{{x^2}}', 1);
});
Constructors
constructor
Parameters
props: LatexProps
SVG.constructorProperties
absolutePosition
readonly public absolutePosition: SimpleVector2SignalLatex
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.
SVG.absolutePositionabsoluteRotation
readonly public absoluteRotation: SimpleSignalnumberLatex
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.
SVG.absoluteRotationabsoluteScale
readonly public absoluteScale: SimpleVector2SignalLatex
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.
SVG.absoluteScalealignContent
readonly public alignContent: SimpleSignalFlexContentLatex
SVG.alignContentalignItems
readonly public alignItems: SimpleSignalFlexItemsLatex
SVG.alignItemsalignSelf
readonly public alignSelf: SimpleSignalFlexItemsLatex
SVG.alignSelfanchor
readonly public anchor: Vector2SignalLatex
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]orVector2.topLeft- top left corner[1, -1]orVector2.topRight- top right corner[0, 1]orVector2.bottom- bottom edge[-1, 1]orVector2.bottomLeft- bottom left corner
SVG.anchorantialiased
readonly public antialiased: SimpleSignalbooleanLatex
SVG.antialiasedbasis
readonly public basis: SimpleSignalFlexBasisLatex
SVG.basisbottom
readonly public bottom: LayoutPositionSignalLatex
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 fromSVG.bottombottomLeft
readonly public bottomLeft: LayoutPositionSignalLatex
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 fromSVG.bottomLeftbottomRight
readonly public bottomRight: LayoutPositionSignalLatex
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 fromSVG.bottomRightbowing
readonly public bowing: SimpleSignalnumberLatex
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 fromSVG.bowingcache
readonly public cache: SimpleSignalbooleanLatex
SVG.cachecachePadding
readonly public cachePadding: SpacingSignalLatex
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.
SVG.cachePaddingchildren
Inherited from SVG.childrenclip
readonly public clip: SimpleSignalbooleanLatex
SVG.clipcomposite
readonly public composite: SimpleSignalbooleanLatex
SVG.compositecompositeOperation
readonly public compositeOperation: SimpleSignalGlobalCompositeOperationLatex
SVG.compositeOperationcreationStack
readonly public creationStack?: string
SVG.creationStackdebugFragments
readonly public debugFragments: SimpleSignalbooleanLatex
Outline and label each fragment with the index it has in map.
direction
readonly public direction: SimpleSignalFlexDirectionLatex
SVG.directionfill
readonly public fill: CanvasStyleSignalLatex
SVG.fillfillShaders
readonly public fillShaders: SignalPossibleShaderConfigShaderConfig[]Latex
SVG.fillShadersfilters
readonly public filters: FiltersSignalLatex
SVG.filtersfontFamily
readonly public fontFamily: SimpleSignalstringLatex
SVG.fontFamilyfontSize
readonly public fontSize: SimpleSignalnumberLatex
SVG.fontSizefontStyle
readonly public fontStyle: SimpleSignalstringLatex
SVG.fontStylefontWeight
readonly public fontWeight: SimpleSignalnumberLatex
SVG.fontWeightfragmentTransition
readonly public fragmentTransition: SimpleSignalLatexTransitionLatex
How a fragment animates into the fragment that replaced it.
Can be changed between tweens to animate one step differently from the
next. edit overrides it per fragment.
gap
readonly public gap: Vector2LengthSignalLatex
SVG.gapgrow
readonly public grow: SimpleSignalnumberLatex
SVG.growisClass
public isClass: boolean
SVG.isClassjustifyContent
readonly public justifyContent: SimpleSignalFlexContentLatex
SVG.justifyContentkey
readonly public key: string
SVG.keylayout
readonly public layout: SimpleSignalLayoutModeLatex
SVG.layoutlayoutChildren
readonly public layoutChildren: SimpleSignalLayoutModeLatex
Whether this node lays out its own children with flex. Use
canLayoutChildren to read the resolved mode.
SVG.layoutChildrenlayoutSelf
readonly public layoutSelf: SimpleSignalLayoutModeLatex
Whether this node participates in its parent's flex layout. Use
layoutEnabled to read the resolved mode.
SVG.layoutSelfleft
readonly public left: LayoutPositionSignalLatex
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 fromSVG.leftletterSpacing
readonly public letterSpacing: SimpleSignalnumberLatex
SVG.letterSpacinglineCap
readonly public lineCap: SimpleSignalCanvasLineCapLatex
SVG.lineCaplineDash
readonly public lineDash: SimpleSignalnumber[]Latex
SVG.lineDashlineDashOffset
readonly public lineDashOffset: SimpleSignalnumberLatex
SVG.lineDashOffsetlineHeight
readonly public lineHeight: SimpleSignalLengthLatex
SVG.lineHeightlineJoin
readonly public lineJoin: SimpleSignalCanvasLineJoinLatex
SVG.lineJoinlineWidth
readonly public lineWidth: SimpleSignalnumberLatex
SVG.lineWidthmargin
readonly public margin: SpacingSignalLatex
SVG.marginmaxHeight
readonly public maxHeight: SimpleSignalLengthLimitLatex
SVG.maxHeightmaxWidth
readonly public maxWidth: SimpleSignalLengthLimitLatex
SVG.maxWidthmiddle
readonly public middle: LayoutPositionSignalLatex
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 fromSVG.middleminHeight
readonly public minHeight: SimpleSignalLengthLimitLatex
SVG.minHeightminWidth
readonly public minWidth: SimpleSignalLengthLimitLatex
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 fromSVG.minWidthopacity
readonly public opacity: SimpleSignalnumberLatex
Represents the opacity of this node in the range 0-1.
The value is clamped to the range 0-1.
Inherited fromSVG.opacityoptions
readonly public options: SimpleSignalOptionListLatex
padding
readonly public padding: SpacingSignalLatex
SVG.paddingparent
readonly public parent: SimpleSignalNodenullvoid = ...
SVG.parentposition
readonly public position: PositionSignalLatex
Represents the position of this node in local space of its parent.
Examples
Inherited fromSVG.positionproperties
readonly public properties: RecordstringPropertyMetadataany = ...
SVG.propertiesratio
readonly public ratio: SimpleSignalnumbernullLatex
SVG.ratioright
readonly public right: LayoutPositionSignalLatex
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 fromSVG.rightrotation
readonly public rotation: RotationSignalLatex
Represents the rotation (in degrees) of this node relative to its parent.
Inherited fromSVG.rotationrough
readonly public rough: SimpleSignalbooleanLatex
Enable rough.js rendering.
Inherited fromSVG.roughroughDisableMultiStroke
readonly public roughDisableMultiStroke: SimpleSignalbooleanLatex
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 fromSVG.roughDisableMultiStrokeroughDisableMultiStrokeFill
readonly public roughDisableMultiStrokeFill: SimpleSignalbooleanLatex
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 fromSVG.roughDisableMultiStrokeFillroughFillStyle
readonly public roughFillStyle: SimpleSignalRoughFillStyleLatex
Fill style for the shape.
Inherited fromSVG.roughFillStyleroughFillWeight
readonly public roughFillWeight: SimpleSignalnumberundefinedLatex
Thickness of the lines used for filling.
Only applicable for hachure, cross-hatch, and similar fill styles.
Inherited fromSVG.roughFillWeightroughHachureAngle
readonly public roughHachureAngle: SimpleSignalnumberLatex
Angle of the hachure lines in degrees.
Only applicable for hachure and cross-hatch fill styles.
Inherited fromSVG.roughHachureAngleroughHachureGap
readonly public roughHachureGap: SimpleSignalnumberLatex
Gap between hachure lines in pixels.
Only applicable for hachure, cross-hatch, and similar fill styles.
Inherited fromSVG.roughHachureGaproughness
readonly public roughness: SimpleSignalnumberLatex
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 fromSVG.roughnessroughSeed
readonly public roughSeed: SimpleSignalnumberundefinedLatex
Seed for the random number generator.
Using the same seed produces consistent results, which is useful for reproducible animations.
Inherited fromSVG.roughSeedscale
readonly public scale: ScaleSignalLatex
Represents the scale of this node in local space of its parent.
Examples
Inherited fromSVG.scaleshaders
SVG.shadersshadowBlur
readonly public shadowBlur: SimpleSignalnumberLatex
SVG.shadowBlurshadowColor
readonly public shadowColor: ColorSignalLatex
SVG.shadowColorshadowOffset
readonly public shadowOffset: Vector2SignalLatex
SVG.shadowOffsetshrink
readonly public shrink: SimpleSignalnumberLatex
SVG.shrinksize
readonly public size: Vector2LengthSignalLatex
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 fromSVG.sizeskew
readonly public skew: Vector2SignalLatex
Represents the skew of this node in local space of its parent.
Examples
Inherited fromSVG.skewstroke
readonly public stroke: CanvasStyleSignalLatex
SVG.strokestrokeFirst
readonly public strokeFirst: SimpleSignalbooleanLatex
SVG.strokeFirststrokeShaders
readonly public strokeShaders: SignalPossibleShaderConfigShaderConfig[]Latex
SVG.strokeShaderssvg
readonly public svg: SimpleSignalstringLatex
SVG string to be rendered
Inherited fromSVG.svgtex
textAlign
readonly public textAlign: SimpleSignalTextAlignLatex
SVG.textAligntextDirection
readonly public textDirection: SimpleSignalCanvasDirectionLatex
SVG.textDirectiontextWrap
readonly public textWrap: SimpleSignalTextWrapLatex
SVG.textWraptop
readonly public top: LayoutPositionSignalLatex
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 fromSVG.toptopLeft
readonly public topLeft: LayoutPositionSignalLatex
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 fromSVG.topLefttopRight
readonly public topRight: LayoutPositionSignalLatex
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 fromSVG.topRighttranslate
readonly public translate: Vector2SignalLatex
A visual offset applied to this node's rendering, analogous to CSS
transform: translate(). Does not affect layout.
SVG.translateverticalAlign
readonly public verticalAlign: SimpleSignalVerticalAlignLatex
SVG.verticalAlignwordBreak
readonly public wordBreak: SimpleSignalWordBreakLatex
SVG.wordBreakwrap
readonly public wrap: SimpleSignalFlexWrapLatex
SVG.wrapwrapper
public wrapper: Node
Child to wrap all SVG node
Inherited fromSVG.wrapperyogaNode
Inherited from SVG.yogaNodezIndex
readonly public zIndex: SimpleSignalnumberLatex
SVG.zIndexAccessors
columnGap
public get columnGap(): SignalLengthnumberthis
SVG.columnGapheight
public get height(): SignalLengthnumberthis
SVG.heightrowGap
public get rowGap(): SignalLengthnumberthis
SVG.rowGapwidth
public get width(): SignalLengthnumberthis
SVG.widthx
public get x(): PositionComponentSignalthis
SVG.xy
public get y(): PositionComponentSignalthis
SVG.yMethods
[iterator]
public [iterator](): Generatorkey: stringmeta: PropertyMetadataanysignal: SimpleSignalanyvoidunknown
SVG.[iterator]absoluteOpacity
public absoluteOpacity(): number
SVG.absoluteOpacityadd
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
SVG.addanchorPosition
public anchorPosition(): Vector2
SVG.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.
SVG.applyStatecacheBBox
public cacheBBox(): BBox
Get a bounding box for the contents rendered by this node as well as its children.
Inherited fromSVG.cacheBBoxcanLayoutChildren
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.
SVG.canLayoutChildrencanvasFont
public canvasFont(): string
SVG.canvasFontcardinalPoint
Get the cardinal point corresponding to the given origin.
Parameters
Inherited fromSVG.cardinalPointchildAs
public childAsindex: number: Tnull
Get the nth children cast to the specified type.
Parameters
index: numberThe index of the child to retrieve.
SVG.childAschildrenAs
public childrenAs(): T[]
Get the children array cast to the specified type.
Inherited fromSVG.childrenAsclone
public clonecustomProps: NodeState = {}: this
Create a copy of this node.
Parameters
customProps: NodeState = {}Properties to override.
SVG.clonecompositeToLocal
public compositeToLocal(): DOMMatrix
SVG.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 fromSVG.compositeToWorldcomputedPosition
public computedPosition(): Vector2
SVG.computedPositiondispose
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 fromSVG.disposedrawOverlay
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.
SVG.drawOverlayedit
public edittime: number = 0.6timingFunction: TimingFunction = easeInOutCubic: LatexEditGenerator
Animate between two formulas written as one template.
Each hole of the template is a fragment that knows both of its states, so the correspondence comes from where you wrote it rather than from a list of indices. Everything outside a hole is a fragment that stays as it is.
The template is read raw, so LaTeX commands need no extra escaping. The
{{}} syntax is not recognised here; the holes take its place.
Examples
Parameters
time: number = 0.6The duration of the animation.
timingFunction: TimingFunction = easeInOutCubicThe timing function.
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
this: TLayoutduration: numbermutator: node: TLayout => voidtiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp
SVG.editLayoutfindAll
Find all descendants of this node that match the given predicate.
Parameters
Inherited fromSVG.findAllfindAncestor
Find the closest ancestor of this node that matches the given predicate.
Parameters
Inherited fromSVG.findAncestorfindFirst
Find the first descendant of this node that matches the given predicate.
Parameters
Inherited fromSVG.findFirstfindLast
Find the last descendant of this node that matches the given predicate.
Parameters
Inherited fromSVG.findLastfreezeLayout
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.
SVG.freezeLayoutgetChildrenById
public getChildrenByIdid: string: Node[]
Get all SVG nodes with the given id.
Parameters
id: stringAn id to query.
SVG.getChildrenByIdgetOriginDelta
Parameters
Inherited fromSVG.getOriginDeltagetState
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 fromSVG.getStatehit
Try to find a node intersecting the given position.
Parameters
Inherited fromSVG.hitinsert
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 fromSVG.insertinstantiate
public instantiateprops: NodeProps = {}: this
Create an instance of this node's class.
Parameters
props: NodeProps = {}Properties to pass to the constructor.
SVG.instantiateisLayoutRoot
public isLayoutRoot(): boolean
SVG.isLayoutRootlayoutEnabled
public layoutEnabled(): boolean
Whether this node participates in its parent's flex layout. Resolves
layoutSelf, then layout, then the parent's
canLayoutChildren.
SVG.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 fromSVG.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 fromSVG.localToWorldlockLayout
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.
SVG.lockLayoutmap
public mapvalue: stringstring[]mapping: number[][]time: numbertimingFunction?: TimingFunction: GeneratorvoidThreadGeneratorPromiseanyPromisableanyvoidany
Animate from the current tex to a new value using a fragment-to-fragment mapping.
Prefer edit unless you need one fragment to feed several others;
it describes the same correspondence without the indices.
Parameters
value: stringstring[]The new tex value.
mapping: number[][]A mapping from source fragment indices to target fragment indices. For example,
[[0], [1, 2]]maps source fragment 0 to target fragment 0, and source fragment 1 to both target fragments 1 and 2.time: numberThe duration of the animation.
timingFunction?: TimingFunctionThe timing function.
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
other: Nodeduration: numbertiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp
SVG.morphTomove
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 = 1Number of places by which the node should be moved.
SVG.movemoveAbove
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: NodeThe sibling node below which to move.
directlyAbove: boolean = falseWhether the node should be positioned directly above the sibling. When true, will move the node even if it is already positioned above the sibling.
SVG.moveAbovemoveBelow
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: NodeThe sibling node below which to move.
directlyBelow: boolean = falseWhether the node should be positioned directly below the sibling. When true, will move the node even if it is already positioned below the sibling.
SVG.moveBelowmoveDown
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 fromSVG.moveDownmoveOffset
Update the offset of this node and adjust the position to keep it in the same place.
Parameters
Inherited fromSVG.moveOffsetmoveTo
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: numberThe index to move the node to.
SVG.moveTomoveToBottom
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 fromSVG.moveToBottommoveToTop
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 fromSVG.moveToTopmoveUp
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 fromSVG.moveUpparentAs
public parentAs(): Tnull
Get the parent cast to the specified type.
Inherited fromSVG.parentAsparentToWorld
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 fromSVG.parentToWorldpeekChildren
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.
SVG.peekChildrenreactiveClone
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
customProps: NodeState = {}Properties to override.
SVG.reactiveClonereleaseLayout
public releaseLayout(): void
Decrement the layout lock counter.
Inherited fromSVG.releaseLayoutremove
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.
SVG.removeremoveChildren
public removeChildren(): this
Remove all children of this node.
Inherited fromSVG.removeChildrenrender
public rendercontext: CanvasRenderingContext2D: void
Render this node onto the given canvas.
Parameters
context: CanvasRenderingContext2DThe context to draw with.
SVG.renderreparent
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
newParent: NodeThe new parent of this node.
SVG.reparentreplace
public replacetime: number...replacements: LatexEditFragment[]: GeneratorvoidThreadGeneratorPromiseanyPromisableanyvoidany
Animate a change to part of the current formula, leaving the rest alone.
Each replacement's before is matched against the current formula and
swapped for its after, so only the parts that change have to be written
out. Matches are claimed left to right, one per replacement, so repeat a
replacement to change more than one occurrence of the same sub-tex.
A match may not span two sub-tex parts. Splitting a part is fine - matching
x inside x^2 turns it into the parts x and ^2 - but a match that
begins in one part and ends in another is ignored, with a warning. The
animation uses easeInOutCubic; reach for edit to choose the
timing function.
Examples
Parameters
time: numberThe duration of the animation.
...replacements: LatexEditFragment[]The changes to make.
resolvedLineHeight
public resolvedLineHeight(): number
SVG.resolvedLineHeightrestore
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 fromSVG.restoreripple
public rippleduration: number = 1: GeneratorvoidThreadGeneratorPromiseanyPromisableanyvoidany
Parameters
duration: number = 1
SVG.ripplesave
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.
SVG.savesnapshotClone
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
customProps: NodeState = {}Properties to override.
SVG.snapshotClonethawLayout
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
duration: numbertiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp
SVG.thawLayouttoPromise
public toPromise(): PromiseLatex
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 fromSVG.toPromisetransitionTo
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
newParent: NodeindexOrDuration: numberdurationOrTiming?: numberTimingFunctiontiming: TimingFunction = easeInOutCubicinterpolation: InterpolationFunctionVector2 = Vector2.lerp
SVG.transitionToview
public view(): View2D
SVG.viewworldToLocal
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 fromSVG.worldToLocalworldToParent
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 fromSVG.worldToParent