Formo docs
Articles explain how things work: formulas, events, clips, components and shaders. The reference lists every node with its properties and methods, generated from the editor itself, so it always matches the version you use.
Articles
- Formulas — A formula is an expression bound to one property. Instead of a number, the field holds a rule, and the property follows it: when anything the rule reads chan…
- Events and methods — An event is a piece of code that runs when something happens to a node: it is clicked, the pointer enters it, a frame passes, it hits another body. A method …
- delay() — delay(expr, ms) gives you the value expr had ms milliseconds ago. Animate one thing, and everything that should follow it with a lag follows on its own.
- Clips and timeline control — A clip is one named animation of a thing: main, walk, idle, jump. All clips of a component, a frame or a rig share the same layers. A clip only changes value…
- Components — A component is a thing you draw once and place many times. The drawing is the definition, each placed copy is an instance. Change the definition and every in…
- Shaders — A shader paints a shape pixel by pixel on the graphics card. In Formo a shader is a fill (or a stroke) like a colour or a gradient: pick one of about 100 bui…
Formulas
- Formula functions — Functions and constants every formula can use without importing anything. Angles are in radians unless a property says degrees.
Shapes
- Rectangle — A rectangle that fills its box (w, h). Its corners can be rounded, all together or one by one.
- 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.
- Polygon — A regular polygon with straight sides, inscribed in its box (w, h). The number of corners and how round they are belong to the polygon.
- Star — A closed shape with pointy ends spaced evenly around its centre. It fills its box (w, h); the number of points, how deep the dents between them go and how ro…
- Line — An open line between two points, drawn as a stroke with no fill. It can be bent with tangents and each end can have an ending such as an arrow.
- Vector — A free-form shape made of points joined by straight or curved segments. It can be open or closed and can hold several paths.
- Mirrored vector — A vector shape drawn once and repeated by symmetry. Edit one source piece and every copy follows, either rotated around the centre (radial) or flipped across…
- Boolean — Combines the shapes inside it into one shape: union, subtract, intersect or exclude. Its children are not drawn. The result is drawn with the boolean's own f…
Drawing
- Brush layer — A layer you draw on with the brush. Strokes are merged into coloured regions, one set per frame, instead of staying separate shapes. Its width and height com…
- Brush stroke — One line drawn with the brush: a filled outline built from the pointer path and the nib. The brush settings can be changed after drawing, and the outline is …
Containers
- Frame — A rectangular container with its own fill, stroke and rounded corners. It clips its children to its box unless clipContent is off, and can arrange them in a …
- Group — Moves, rotates and scales its children together. It has no fill or stroke and no surface of its own: its box is the bounds of its children, and resizing it s…
- Section — A top-level frame for organising the canvas. It shows its name above it, always clips its children, and can only sit at the top level or inside another section.
- Component — An instance of a component: a reusable definition with its own children and timeline clips. Each instance plays one of the definition's clips.
- List — A container that builds its content from a template. push() clones the template node into the list, and the list lines the clones up in a row, a column or a …
- Laptop — A top-level frame sized to a laptop screen. Choose a resolution preset to set its size. It always clips its children.
- Mobile — A top-level frame sized to a phone or tablet screen. Choose a resolution preset to set its size. It always clips its children.
- SVG Canvas — The canvas for editing an .svg file. It is a top-level frame that cannot be rotated; its fill is the canvas background.
Text and media
- Text — A block of text set in one font. The box (w, h) holds the lines; with auto width the box grows to fit the text, otherwise it keeps its size and the text can …
- Audio — A sound that plays during playback. It has no picture; its position only matters for stereo Auto. Call its play, pause and stop from formulas and events.
Animation and rigging
- Skeleton — A rig: it holds bones and the art they move. Posing a bone moves the art bound to it, and the skeleton plays its own animation clips. Its width and height fo…
- Bone — One bone of a skeleton. It turns around its pivot, carries its child bones and attached art, and can bend the shapes bound to it. Its w and h set the bone's …
Scene
- Camera — A frame that decides what the viewer sees. Play and export look through the camera; it can follow a node and run post-process effects over its picture.
- Light — An invisible light source. A shader with a Light parameter can point at it and take its position, colour and strength.
- Perspective — An invisible tilted plane, like a floor or a wall. Shaders with a Perspective parameter can point at it, and shapes cast shadows onto it. The node position i…
Mixins
- Transform — Where the node is, how big it is and how far it is turned. Every node on the canvas has these. Positions are relative to the parent, so moving a frame moves …
- Fill — The paints that colour the inside of a shape. A shape can have several, drawn one over the other.
- Stroke — The outline of a shape: its paints, thickness, position on the edge and how corners are joined.
- Appearance — How the whole node blends into what is behind it: opacity, blend mode and visibility.
- Shape animation — The outline of a vector as an animatable value, so a timeline can change one shape into another.
- Endings — The decoration at each end of an open line, such as an arrowhead. It exists only for a single open path.