Ellipse

An ellipse that fills its box (w, h). The start and end angle cut it into an arc or a pie slice, and the inner radius turns it into a ring.

In a formula, a node is called by its name in the layers panel: Ellipse1.startingAngle

Properties

startingAngleNumber#

Angle where the visible part of the ellipse begins.

In radians. 0 points right (the +x direction) and positive angles turn clockwise on screen. The ellipse is drawn from this angle to endingAngle.

Default 0 · radians · animatable

endingAngleNumber#

Angle where the visible part of the ellipse ends.

In radians, measured like startingAngle. The default 2π (about 6.283) makes a full ellipse. When the distance from startingAngle is 2π the shape is closed; below that it is a slice with a gap.

Default 6.2832 · radians · animatable

innerRadiusNumber#

Size of the hole in the middle, as a share of the ellipse: 0 has no hole, 1 leaves only the outline curve.

The hole is an ellipse of the same proportions as the box. At exactly 1 the shape has no inside, only the open arc, so a fill shows nothing and the stroke draws it. Values just under 1 give a thin ring.

Default 0 · 0 – 1 · animatable

cornerNumber#

Rounds the sharp corners of a slice or ring by this many pixels.

Only the corners count: where a straight edge meets the outer curve or the inner curve, and the tip of a slice. A full ellipse has none, so it does not change. The value is capped at what the corners can hold.

Default 0 · 0 – 4096 · pixels · animatable

Transform from Transform

xNumber#

Horizontal position of the node's origin, in pixels from its parent's origin.

The origin is the point the node turns and scales around (the small circle you can drag on the canvas). Setting x moves the whole node so that its origin lands there.

pixels · animatable

yNumber#

Vertical position of the node's origin, in pixels from its parent's origin. Larger values are lower.

pixels · animatable

wNumber#

Width of the node in pixels.

On a skewed node this is the width you see on screen, not the width of the box before the skew.

0 – ∞ · pixels · animatable

hNumber#

Height of the node in pixels.

0 – ∞ · pixels · animatable

rotationNumber#

How far the node is turned around its origin, in degrees. Positive values turn it clockwise.

degrees · animatable

skewNumber#

How far the node is slanted along its own horizontal axis, in degrees.

Accepted values are -89 to 89, and 0 means no slant. The node stays anchored at its origin. A skewed node reports a wider w, because w is the width you see on screen. Bones and skeletons ignore skew.

degrees

Fill from Fill

fillsPaint[]#

The list of paints that fill the inside of the shape.

Paints are drawn in list order, so each one covers the one before it. A new shape starts with one grey solid paint. An empty list leaves the shape unfilled. Read a single paint with fills[0].

animatable

Stroke from Stroke

strokesPaint[]#

The list of paints that colour the outline.

A new shape has no strokes, so no outline is drawn until you add one. Paints are drawn in list order.

animatable

strokeWeightStrokeWeight#

Thickness of the outline in pixels.

The default is 1. A weight of 0 draws no outline.

0 – ∞ · animatable

strokePositionString#

Where the outline sits relative to the edge of the shape: INSIDE, CENTER or OUTSIDE.

CENTER puts half of the weight on each side of the edge. INSIDE and OUTSIDE put all of it on one side.

Default 'CENTER' · 'INSIDE' | 'CENTER' | 'OUTSIDE' · animatable

strokeJoinString#

How the outline turns at a sharp corner: MITER (pointed), ROUND or BEVEL (cut flat).

A MITER corner sharper than strokeMiterAngle is cut flat like a BEVEL.

Default 'MITER' · 'MITER' | 'ROUND' | 'BEVEL' · animatable

strokeMiterAngleNumber#

The sharpest corner angle, in degrees, that still gets a pointed MITER join.

Corners sharper than this are cut flat. A larger value cuts more corners. The default is 26 and the lowest accepted value is 8. It has no effect when strokeJoin is ROUND or BEVEL.

Default 26 · 8 – 180 · animatable

dashCapString#

Shape of the ends of each dash in a dashed outline: butt (flat), round or square.

This is separate from strokeCap, which shapes the two ends of the whole path. It only shows when the outline is dashed.

Default 'butt' · 'butt' | 'round' | 'square' · animatable

Appearance from Appearance

opacityNumber#

How opaque the node is, from 0 (invisible) to 1 (solid).

It applies to the node and everything inside it. It multiplies with the opacity of each paint.

Default 1 · 0 – 1 · animatable

blendModeBlendMode#

How the node mixes its colours with what is behind it, for example MULTIPLY or SCREEN.

NORMAL just draws over the background. The other values are NORMAL, PASS_THROUGH, MULTIPLY, SCREEN, OVERLAY, DARKEN, LIGHTEN, COLOR_DODGE, COLOR_BURN, HARD_LIGHT, SOFT_LIGHT, DIFFERENCE, EXCLUSION, HUE, SATURATION, COLOR and LUMINOSITY.

Default 'NORMAL' · animatable

visibleBoolean#

Whether the node is drawn. Set it to false to hide the node and everything inside it.

A hidden node still exists, so formulas can read and change its properties.

Default true · animatable

Node methods every node has them

is(typeOrTag: String) → Booleanmethod#

True when the node is of this type or carries this tag.

  • typeOrTag A node type such as 'RECT', or a tag.

clone() → Nodemethod#

Makes a copy of the node and returns it, so code can place and change the copy.

destroy()method#

Marks the node for removal; it is taken out of the scene at the end of the frame.

appendChild(child: Node) → Nodemethod#

Moves child into this node as its last child and returns it.

insertBefore(newChild: Node, refChild: Node | null) → Nodemethod#

Moves newChild into this node, just before refChild, and returns it.

  • refChild The child to insert before; null appends at the end.

removeChild(child: Node) → Nodemethod#

Takes child out of this node and returns it.

replaceChildren(...nodes: Node)method#

Replaces all of this node's children with the given nodes, in that order.

insertAdjacentElement(position: 'afterbegin' | 'beforeend', element: Node) → Node | nullmethod#

Moves element into this node, as its first or last child.

  • position 'afterbegin' puts it first, 'beforeend' last. Any other position does nothing and returns null.

on(event: String, fn: Function)method#

Calls fn each time fire(event) is called on this node. These are the node's own messages, not the Events panel: a click does not reach on('click').

off(event: String, fn: Function)method#

Stops calling fn for event.

  • fn The same function that was passed to on.

fire(event: String, ...args: any)method#

Calls every function added with on(event) on this node, in the order they were added.

  • ...args Passed on to every listener.

Formo

The browser studio where drawings become animations, toys, and games. Your files, nothing to install.