Skip to main content

Latex

class Latex extends SVG

A node for animating equations with LaTeX.

Press play to preview the animation
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​

public override new Latexprops: LatexProps: Latex

Parameters

Overwrites SVG.constructor

Properties​

absolutePosition​

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.

Inherited from SVG.absolutePosition

absoluteRotation​

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.

Inherited from SVG.absoluteRotation

absoluteScale​

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.

Inherited from SVG.absoluteScale

alignContent​

Inherited from SVG.alignContent

alignItems​

Inherited from SVG.alignItems

alignSelf​

Inherited from SVG.alignSelf

antialiased​

readonly public antialiased: SimpleSignalbooleanLatex
Inherited from SVG.antialiased

basis​

Inherited from SVG.basis

bottom​

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 SVG.bottom

bottomLeft​

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 SVG.bottomLeft

bottomRight​

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 SVG.bottomRight

cache​

readonly public cache: SimpleSignalbooleanLatex
Inherited from SVG.cache

cachePadding​

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 SVG.cachePadding

children​

Inherited from SVG.children

clip​

readonly public clip: SimpleSignalbooleanLatex
Inherited from SVG.clip

composite​

readonly public composite: SimpleSignalbooleanLatex
Inherited from SVG.composite

compositeOperation​

readonly public compositeOperation: SimpleSignalGlobalCompositeOperationLatex
Inherited from SVG.compositeOperation

creationStack​

readonly public creationStack?: string
Inherited from SVG.creationStack

direction​

Inherited from SVG.direction

element​

Inherited from SVG.element

fill​

readonly public fill: CanvasStyleSignalLatex
Inherited from SVG.fill

filters​

readonly public filters: FiltersSignalLatex
Inherited from SVG.filters

fontFamily​

readonly public fontFamily: SimpleSignalstringLatex
Inherited from SVG.fontFamily

fontSize​

readonly public fontSize: SimpleSignalnumberLatex
Inherited from SVG.fontSize

fontStyle​

readonly public fontStyle: SimpleSignalstringLatex
Inherited from SVG.fontStyle

fontWeight​

readonly public fontWeight: SimpleSignalnumberLatex
Inherited from SVG.fontWeight

gap​

readonly public gap: Vector2LengthSignalLatex
Inherited from SVG.gap

grow​

readonly public grow: SimpleSignalnumberLatex
Inherited from SVG.grow

isClass​

public isClass: boolean
Inherited from SVG.isClass

justifyContent​

Inherited from SVG.justifyContent

key​

readonly public key: string
Inherited from SVG.key

layout​

Inherited from SVG.layout

left​

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 SVG.left

letterSpacing​

readonly public letterSpacing: SimpleSignalnumberLatex
Inherited from SVG.letterSpacing

lineCap​

readonly public lineCap: SimpleSignalCanvasLineCapLatex
Inherited from SVG.lineCap

lineDash​

readonly public lineDash: SimpleSignalnumber[]Latex
Inherited from SVG.lineDash

lineDashOffset​

readonly public lineDashOffset: SimpleSignalnumberLatex
Inherited from SVG.lineDashOffset

lineHeight​

Inherited from SVG.lineHeight

lineJoin​

readonly public lineJoin: SimpleSignalCanvasLineJoinLatex
Inherited from SVG.lineJoin

lineWidth​

readonly public lineWidth: SimpleSignalnumberLatex
Inherited from SVG.lineWidth

margin​

readonly public margin: SpacingSignalLatex
Inherited from SVG.margin

maxHeight​

Inherited from SVG.maxHeight

maxWidth​

Inherited from SVG.maxWidth

middle​

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 from SVG.middle

minHeight​

Inherited from SVG.minHeight

minWidth​

Inherited from SVG.minWidth

offset​

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
Inherited from SVG.offset

opacity​

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 from SVG.opacity

options​

readonly public options: SimpleSignalOptionListLatex

padding​

readonly public padding: SpacingSignalLatex
Inherited from SVG.padding

parent​

readonly public parent: SimpleSignalnullNodevoid = ...
Inherited from SVG.parent

position​

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

Examples

Inherited from SVG.position

properties​

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

ratio​

readonly public ratio: SimpleSignalnullnumberLatex
Inherited from SVG.ratio

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 SVG.right

rotation​

readonly public rotation: SimpleSignalnumberLatex

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

Inherited from SVG.rotation

scale​

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

Examples

Inherited from SVG.scale

shaders​

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

shadowBlur​

readonly public shadowBlur: SimpleSignalnumberLatex
Inherited from SVG.shadowBlur

shadowColor​

readonly public shadowColor: ColorSignalLatex
Inherited from SVG.shadowColor

shadowOffset​

Inherited from SVG.shadowOffset

shrink​

readonly public shrink: SimpleSignalnumberLatex
Inherited from SVG.shrink

size​

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 from SVG.size

skew​

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

Examples

Inherited from SVG.skew

stroke​

Inherited from SVG.stroke

strokeFirst​

readonly public strokeFirst: SimpleSignalbooleanLatex
Inherited from SVG.strokeFirst

styles​

Inherited from SVG.styles

svg​

readonly public svg: SimpleSignalstringLatex

SVG string to be rendered

Inherited from SVG.svg

tex​

readonly public tex: Signalstringstring[]string[]LatexSignalContextstringstring[]string[]Latex

textAlign​

readonly public textAlign: SimpleSignalCanvasTextAlignLatex
Inherited from SVG.textAlign

textDirection​

readonly public textDirection: SimpleSignalCanvasDirectionLatex
Inherited from SVG.textDirection

textWrap​

Inherited from SVG.textWrap

top​

readonly public top: SimpleVector2SignalLatex

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 SVG.top

topLeft​

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 SVG.topLeft

topRight​

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 SVG.topRight

wrap​

Inherited from SVG.wrap

wrapper​

public wrapper: Node

Child to wrap all SVG node

Inherited from SVG.wrapper

zIndex​

readonly public zIndex: SimpleSignalnumberLatex
Inherited from SVG.zIndex

Accessors​

columnGap​

public get columnGap(): SignalLengthnumberthisSignalContextLengthnumberthis
Inherited from SVG.columnGap

height​

public get height(): SignalLengthnumberthisSignalContextLengthnumberthis
Inherited from SVG.height

rowGap​

public get rowGap(): SignalLengthnumberthisSignalContextLengthnumberthis
Inherited from SVG.rowGap

width​

public get width(): SignalLengthnumberthisSignalContextLengthnumberthis
Inherited from SVG.width

x​

public get x(): SimpleSignalnumberthis
Inherited from SVG.x

y​

public get y(): SimpleSignalnumberthis
Inherited from SVG.y

Methods​

[iterator]​

public [iterator](): Generatorkey: stringmeta: PropertyMetadataanysignal: SimpleSignalanyvoidvoidunknown
Inherited from SVG.[iterator]

absoluteOpacity​

public absoluteOpacity(): number
Inherited from SVG.absoluteOpacity

add​

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

Inherited from SVG.add

anchorPosition​

public anchorPosition(): Vector2
Inherited from SVG.anchorPosition

applyState​

public applyStatestate: NodeState: void

Apply the given state to the node, setting all matching signal values to the provided values.

Parameters

Inherited from SVG.applyState

cacheBBox​

public cacheBBox(): BBox

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

Inherited from SVG.cacheBBox

cardinalPoint​

Get the cardinal point corresponding to the given origin.

Parameters

Inherited from SVG.cardinalPoint

childAs​

public childAsT extends NodeT = Nodeindex: number: nullT

Get the nth children cast to the specified type.

Type Parameters

Parameters

  • index: number

    The index of the child to retrieve.

Inherited from SVG.childAs

childrenAs​

public childrenAsT extends NodeT = Node(): T[]

Get the children array cast to the specified type.

Type Parameters

Inherited from SVG.childrenAs

clone​

public clonecustomProps: NodeState = {}: Latex

Create a copy of this node.

Parameters

Inherited from SVG.clone

compositeToLocal​

public compositeToLocal(): DOMMatrix
Inherited from SVG.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 SVG.compositeToWorld

computedPosition​

public computedPosition(): Vector2
Inherited from SVG.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 SVG.dispose

drawOverlay​

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 SVG.drawOverlay

findAll​

public findAllT extends NodeTpredicate: node: any => node is T: T[]
public findAllT extends NodeT = Nodepredicate: node: any => boolean: T[]

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

Type Parameters

Parameters

  • predicate: node: any => node is T

    A function that returns true if the node matches.

Inherited from SVG.findAll

findAncestor​

public findAncestorT extends NodeTpredicate: node: Node => node is T: nullT
public findAncestorT extends NodeT = Nodepredicate: node: Node => boolean: nullT

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

Type Parameters

Parameters

Inherited from SVG.findAncestor

findFirst​

public findFirstT extends NodeTpredicate: node: Node => node is T: nullT
public findFirstT extends NodeT = Nodepredicate: node: Node => boolean: nullT

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

Type Parameters

Parameters

Inherited from SVG.findFirst

findLast​

public findLastT extends NodeTpredicate: node: Node => node is T: nullT
public findLastT extends NodeT = Nodepredicate: node: Node => boolean: nullT

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

Type Parameters

Parameters

Inherited from SVG.findLast

getChildrenById​

public getChildrenByIdid: string: Node[]

Get all SVG nodes with the given id.

Parameters

  • id: string

    An id to query.

Inherited from SVG.getChildrenById

getOriginDelta​

public getOriginDeltaorigin: Origin: Vector2

Parameters

Inherited from SVG.getOriginDelta

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 SVG.getState

hit​

public hitposition: Vector2: nullNode

Try to find a node intersecting the given position.

Parameters

Inherited from SVG.hit

insert​

public insertnode: ComponentChildrenindex: number = 0: Latex

Insert the given node(s) at the specified index in the children list.

Examples

Parameters

Inherited from SVG.insert

instantiate​

public instantiateprops: NodeProps = {}: Latex

Create an instance of this node's class.

Parameters

Inherited from SVG.instantiate

isLayoutRoot​

public isLayoutRoot(): boolean
Inherited from SVG.isLayoutRoot

layoutEnabled​

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

Inherited from SVG.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 SVG.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 SVG.localToWorld

lockSize​

public lockSize(): void
Inherited from SVG.lockSize

move​

public moveby: number = 1: Latex

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 SVG.move

moveAbove​

public moveAbovenode: NodedirectlyAbove: boolean = false: Latex

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 SVG.moveAbove

moveBelow​

public moveBelownode: NodedirectlyBelow: boolean = false: Latex

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 SVG.moveBelow

moveDown​

public moveDown(): Latex

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 SVG.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 SVG.moveOffset

moveTo​

public moveToindex: number: Latex

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 SVG.moveTo

moveToBottom​

public moveToBottom(): Latex

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 SVG.moveToBottom

moveToTop​

public moveToTop(): Latex

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 SVG.moveToTop

moveUp​

public moveUp(): Latex

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 SVG.moveUp

parentAs​

public parentAsT extends NodeT = Node(): nullT

Get the parent cast to the specified type.

Type Parameters

Inherited from SVG.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 SVG.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 SVG.peekChildren

reactiveClone​

public reactiveClonecustomProps: NodeState = {}: Latex

Create a reactive copy of this node.

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

Parameters

Inherited from SVG.reactiveClone

releaseSize​

public releaseSize(): void
Inherited from SVG.releaseSize

remove​

public remove(): Latex

Remove this node from the tree.

Inherited from SVG.remove

removeChildren​

public removeChildren(): Latex

Remove all children of this node.

Inherited from SVG.removeChildren

render​

public rendercontext: CanvasRenderingContext2D: void

Render this node onto the given canvas.

Parameters

Inherited from SVG.render

reparent​

public reparentnewParent: Node: Latex

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 SVG.reparent

restore​

public restore(): void

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 SVG.restore

ripple​

public rippleduration: number = 1: GeneratorvoidThreadGeneratorPromiseanyPromisableanyvoidany

Parameters

Inherited from SVG.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 SVG.save

snapshotClone​

public snapshotClonecustomProps: NodeState = {}: Latex

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 SVG.snapshotClone

toPromise​

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 from SVG.toPromise

view​

public view(): View2D
Inherited from SVG.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 SVG.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 SVG.worldToParent