1. ultrafast
  2. Docs
  3. Ops

Docs

70 ops

Every op with its ports, params, types and defaults. uf ops prints the same as JSON.

Params marked animatable take a constant, {"keys": [...]}, {"expr": "..."} or a driver (see params and animation). Ports are the node's inputs.

Sources

solid

flat color

colorcolorfill color · default #000000

gradient

linear, radial or conic gradient

kindenum(linear | radial | conic)gradient shape · default linear
acolorstart color (with b: a two-stop gradient)
bcolorend color
stopstext | number[]"0:#ff0000, 1:#0000ff" or [pos,r,g,b,a,...], up to 8
spaceenum(linear | srgb)interpolation space; srgb matches CSS/Figma · default linear
startvec2linear: start point px · default [0,0]
endvec2linear: end point px · default [0,h]
centervec2radial/conic center px · default frame center
radiusnumberradial radius px · default max(w,h)/2
anglenumberconic start angle, degrees · default 0

shape

analytic rectangle / rounded rect / ellipse (SDF, antialiased)

kindenum(rect | ellipse | circle)shape · default rect
colorcolorfill (or stroke) color · default #ffffff
centervec2center px · default frame center
sizevec2width and height px · default [w/4,w/4]
radiusnumbercorner radius px · default 0
rotationnumberdegrees · default 0
scalenumber | vec2scale about the center (size, corners and stroke) · default 1
opacitynumber0..1, fades the shape · default 1
strokenumberoutline width px; 0 fills · default 0
softnessnumberedge softness in output pixels · default 1

checker

checkerboard

acolorfirst cell · default #333333
bcolorsecond cell · default #666666
sizenumbercell px · default 32

noise

fractal simplex noise between two colors

acolorlow color · default #000000
bcolorhigh color · default #ffffff
scalevec2 | numberpx per noise cell · default [200,200]
offsetvec2pan px · default [0,0]
evolutionnumberthird noise dimension; animate it · default 0
octavesnumber1..8 · default 4

image

still image or image sequence

srctextfile path relative to the document; {frame} / {frame:05} for sequences
fitenum(contain | cover | fill | none)placement in the frame, or in `rect` (cover there by default); only fill stretches · default contain
rectvec4[x,y,w,h] px box the picture goes in, by `fit`; it keeps its aspect ratio
opacitynumber0..1 · default 1
spaceenum(linear | srgb)interpolation space when scaled; srgb filters the encoded values as browsers do · default linear
fpsnumbersequence frame rate · default document fps
first_framenumbersequence frame number at local time 0 · default 0

video

video clip, hardware decoded

srctextfile path
fitenum(contain | cover | fill | none)placement in the frame, or in `rect` (cover there by default); only fill stretches · default contain
rectvec4[x,y,w,h] px box the footage goes in, by `fit`; it keeps its aspect ratio
opacitynumber0..1 · default 1
spaceenum(linear | srgb)interpolation space when scaled; srgb filters the encoded values as browsers do · default linear
startnumbersource seconds at local time 0 · default 0
speednumberplayback rate · default 1
loopboolwrap at the clip's end (else hold the last frame) · default false
timenumberexplicit source time (animate for time remapping)

path

vector path (SVG data or preset), GPU exact-coverage raster

totextSVG path data to morph toward; several separated by | to morph through each in turn
morphnumber0 = this path, 1 = `to` (with several targets, 2 = the second, ...); animate it · default 0
dtextSVG path data
kindenum(star | polygon | circle | line | polyline | polygon_points)preset instead of d
centervec2preset center · default frame center
radiusnumberpreset radius · default h/4
sidesnumberstar points / polygon sides · default 5 / 6
inner_radiusnumberstar inner radius · default 0.45 r
pointsnumber[]flat [x0,y0,x1,y1,...] for line/polyline/polygon_points
colorcolorpaint · default #ffffff
opacitynumber0..1, fades the whole node (animate for fades) · default 1
fill_ruleenum(nonzero | evenodd)fill rule · default nonzero
trim_startnumber0..1 of length · default 0
trim_endnumber0..1 of length (animate for draw-on) · default 1
strokenumberstroke width px; 0 fills · default 0
joinenum(miter | round | bevel)stroke joins · default miter
capenum(butt | round | square)stroke caps · default butt
dashnumber[]dash pattern [on, off, ...] px
dash_offsetnumberdash phase px · default 0
positionvec2where the anchor lands, px · default [0,0]
anchorvec2pivot in the node's own space, px · default [0,0]
scalevec2 | numberscale around the anchor · default [1,1]
rotationnumberdegrees, clockwise · default 0

text

shaped text, GPU exact-coverage raster

texttextcontent; \n breaks lines; *word* is emphasis (em_ params), [words]{color=#ffd23f highlight=#ff4d6d} styles a span
fonttextfamily name or font file path · default Helvetica Neue
weightnumber100..900 · default 400
styleenum(normal | italic)style · default normal
sizenumberpx · default 64
colorcolorpaint · default #ffffff
opacitynumber0..1, fades the whole node (animate for fades) · default 1
alignenum(left | center | right)horizontal anchor of each line · default left
valignenum(top | middle | baseline | bottom)vertical anchor of the block · default top
widthnumberwrap width px
line_heightnumbermultiple of size · default 1.2
trackingnumberextra px between glyphs · default 0
featurestextOpenType features, e.g. "liga=0,ss01"
variationstextvariable-font axes, e.g. "wdth=80, opsz=144" (weight drives wght; opsz follows size unless set)
axis_<tag>numberone variable-font axis, animatable: axis_wdth, axis_SOFT · default axis default
staggernumberseconds between glyphs for the glyph_* animators · default 0
stagger_orderenum(forward | reverse | center | random)which glyphs go first · default forward
glyph_offsetvec2per-glyph offset px, keyed in glyph time (t - stagger * order) · default [0,0]
glyph_scalevec2per-glyph scale about the glyph's center, glyph time · default [1,1]
glyph_rotationnumberper-glyph rotation degrees, glyph time · default 0
glyph_opacitynumberper-glyph opacity, glyph time · default 1
revealnumberglyphs visible (fractional fades) · default all
reveal_softnessnumberglyphs the reveal fade spans · default 1
reveal_offsetvec2offset of not-yet-revealed glyphs px · default [0,0]
fill_ruleenum(nonzero | evenodd)fill rule · default nonzero
skimboolglanced at, not read (code, data labels): ultrafast review skips its reading-time check · default false
markupboolparse inline styling in text: *emphasis* and [words]{color=#ffd23f weight=800 font="ultrafast:serif" style=italic size=80 highlight=#ff4d6d underline=4 underline_color=#fff rise=10 draw=1} · default true
em_colorcolorcolor of *emphasis* · default text color
em_fonttextface of *emphasis* (e.g. ultrafast:serif for a serif accent) · default font
em_weightnumberweight of *emphasis* · default weight
em_styleenum(normal | italic)style of *emphasis* (italic is synthesized for faces without one) · default italic when no em_ param is set
em_sizenumbersize px of *emphasis* · default size
em_highlightcolormarker box behind *emphasis* · default none
em_underlinenumberunderline thickness px under *emphasis* · default 0
em_underline_colorcolorunderline color · default em_color
em_risenumberbaseline shift px of *emphasis* (up) · default 0
em_drawnumbershare of the emphasis highlights and underlines drawn, 0..1, one stroke across lines in reading order (animate it) · default 1
on_pathtextSVG path data the text follows (closed paths wrap: circular badges); align picks start, middle or end
path_offsetnumberpx along the path; animate it to run text along · default 0
numbernumbershow this value instead of text (animate it: counters)
decimalsnumberdigits after the point for number · default 0
thousandstextgroup separator for number ("" for none) · default ,
prefixtextbefore number, e.g. $
suffixtextafter number, e.g. % or k
scramblenumberdecoding text: animate 0 (all random) to 1 (the text)
scramble_charstextcharacters the undecoded ones cycle through · default A-Z, 0-9, symbols
strokenumberstroke width px; 0 fills · default 0
joinenum(miter | round | bevel)stroke joins · default miter
capenum(butt | round | square)stroke caps · default butt
dashnumber[]dash pattern [on, off, ...] px
dash_offsetnumberdash phase px · default 0
positionvec2where the anchor lands, px · default [0,0]
anchorvec2pivot in the node's own space, px · default [0,0]
scalevec2 | numberscale around the anchor · default [1,1]
rotationnumberdegrees, clockwise · default 0

svg

an SVG file (logo, icon, illustration) as vector paths: fills, strokes, gradients, text as outlines; `ultrafast import-svg` gives the same as editable nodes

srctext.svg file (relative to the document)
sizevec2 | numberfit inside [w, h] px, keeping its aspect · default the SVG's own size
positionvec2where the anchor lands, px · default [0,0]
anchorvec2pivot in the artwork's px (after size) · default [0,0]
scalevec2 | numberscale around the anchor (stays vector-sharp) · default [1,1]
rotationnumberdegrees, clockwise · default 0
opacitynumber0..1 · default 1

lottie

a Lottie (Bodymovin) animation as editable ultrafast nodes: shape layers become paths with Lottie's keyframes, transforms stay vector; loops by default

srctextLottie .json file
sizevec2 | numberfit it into this box px · default the animation's size
loopboolrepeat over its duration · default true
positionvec2where its top-left (or anchor) lands px · default [0,0]
anchorvec2pivot px in its fitted space · default [0,0]
scalevec2 | numberscale · default [1,1]
rotationnumberdegrees · default 0
opacitynumber0..1 · default 1

code

source code in a panel: syntax-highlighted, optionally typed on with a caret, line numbers, highlighted lines, window chrome

codetextthe source (\n between lines; tabs become 4 spaces)
languageenum(rust | python | js | ts | json | bash | go | swift | c | cpp | slang | sql | css | html | text)how to color it · default text
themeenum(ultrafast | paper | mono)colors (paper is light) · default ultrafast
titletextfile name in the title bar
windowbooltitle bar with three dots · default true
backgroundboolthe panel and its shadow · default true
line_numbersboolgutter numbers · default true
highlighttextlines to mark, e.g. "3" or "2,5-7"
highlight_atnumberwhen the marked lines light up · default 0
type_speednumbercharacters per second typed on (0: all shown) · default 0
atnumberwhen typing starts · default 0
caretboola blinking caret while and after typing · default true
fonttexta monospaced face · default ultrafast:mono
sizenumberpx · default 30 at 1080p
line_heightnumbermultiple of size · default 1.55
paddingnumberpx inside the panel · default 1.4 x size
radiusnumberpanel corner radius px · default 0.55 x size
widthnumberpanel width px · default fits the longest line
positionvec2top-left of the panel · default centered
opacitynumber0..1 · default 1

marble

flowing marble/ink generator (half resolution by default)

filamentsnumberdefault 0.8
resolutionnumberdefault 0.5
veinsnumberdefault 1.0

starfield

drifting starfield generator

speednumberdefault 0.3
travelnumberdefault 0.0

Compositing

over (fg, bg)

fg over bg (Porter-Duff)

opacitynumberfg opacity · default 1
spaceenum(linear | srgb)blend space · default linear

blend (fg, bg)

blend modes (W3C)

modeenum(normal | multiply | screen | overlay | darken | lighten | color_dodge | color_burn | hard_light | soft_light | difference | exclusion | hue | saturation | color | luminosity | add | subtract | divide)mode · default normal
opacitynumberfg opacity · default 1
spaceenum(linear | srgb)blend space · default linear

composite (fg, bg)

Porter-Duff operators

operatorenum(in | out | atop | xor | plus | over)operator · default over

mask (source, matte)

track matte

modeenum(alpha | alpha_inverted | luma | luma_inverted)matte channel · default alpha

mix (a, b)

crossfade

tnumber0 = a, 1 = b · default 0.5

opacity (source)

multiply alpha

opacitynumber0..1 · default 1

stack (in0, in1, in2, in3, in4, in5, in6, in7, in8, in9, in10, in11, in12, in13, in14, in15)

lays its inputs (in0, in1, ...: text, path, shape, svg or stack) out in a column or row by their measured bounds

directionenum(column | row)stack downward or rightward · default column
atnumberseconds at which children are measured (when their entrances have landed) · default 0
gapnumberpx between children · default 24
alignenum(start | center | end)children across the stack · default start
positionvec2where the block's anchor goes · default [0,0]
anchorenum(top_left | top | top_right | left | center | right | bottom_left | bottom | bottom_right)which point of the block sits at position · default top_left

transition (a, b)

from shot `a` to shot `b` over `duration` s starting `at`: only a renders before, only b after

kindenum(crossfade | dip | wipe | push | slide | iris | zoom | dissolve | glitch | blur)how: dip goes through `color`; wipe/push/slide move along `direction`; iris opens from `center`; dissolve burns through noise · default crossfade
atnumberstart, seconds · default 0
durationnumberseconds · default 0.8
directionnumberdegrees: 0 moves rightward, 90 downward · default 0
softnessnumberedge softness (blur: strength) · default per kind
colorcolordip color; wipe and dissolve edge glow color (dissolve: ember #ff9a4a) · default #000000
glownumberedge glow strength · default 0 (dissolve 2)
centervec2iris and zoom center px · default frame center
grainnumberdissolve noise size px · default 160
easetext | number[]progress easing: a name (in_out_cubic) or [x1, y1, x2, y2] · default per kind

Color

adjust (source)

exposure, contrast, saturation, hue, brightness, gamma

exposurenumberstops (linear light) · default 0
contrastnumberaround mid grey · default 1
saturationnumber0 = grey · default 1
huenumberdegrees · default 0
brightnessnumberoffset · default 0
gammanumbergamma · default 1

levels (source)

input/output levels with gamma

in_blacknumberdefault 0
in_whitenumberdefault 1
gammanumberdefault 1
out_blacknumberdefault 0
out_whitenumberdefault 1

color_matrix (source)

4x5 matrix on straight linear RGBA

matrixnumber[]20 numbers, row-major · default identity

lut (source)

3D LUT color grade (.cube)

srctext.cube file (3D LUT)
amountnumber0..1 mix with the ungraded image · default 1
spaceenum(srgb | linear)what the LUT expects as input (most grading LUTs: srgb) · default srgb

invert (source)

invert colors

amountnumber0..1 · default 1

tint (source)

map luminance between two colors

darkcolorshadows · default #000000
lightcolorhighlights · default #ffffff

threshold (source)

luminance threshold

levelnumberdefault 0.5
softnessnumberdefault 0.01

grade (source)

color grade looks 0..4 (look, amount)

amountnumberdefault 1.0
looknumberdefault 0.0

Geometry and warps

crop (source)

keep a rectangle

rectvec4[x,y,w,h] px · default frame
softnessnumberedge px · default 1

transform (source)

2D transform (absorbed into paths/text for sharpness)

positionvec2where the anchor lands · default frame center
anchorvec2pivot · default frame center
scalevec2 | numberscale · default [1,1]
rotationnumberdegrees · default 0
skewnumberdegrees · default 0

corner_pin (source)

perspective: map the frame (or source_rect) to four corners

cornersnumber[][tl, tr, br, bl] as 8 numbers · default frame corners
source_rectvec4[x,y,w,h] of the source mapped · default frame

wave (source)

sine displacement

amplitudenumberpx · default 10
wavelengthnumberpx · default 100
phasenumberdegrees · default 0
directionnumberdegrees · default 0

twirl (source)

swirl around a center

centervec2default frame center
radiusnumberdefault min(w,h)/2
anglenumberdegrees · default 90

tile (source)

repeat a region

originvec2default [0,0]
sizevec2default frame

displace (source, map)

displace source by a map's red/green

amountvec2px · default [20,20]

blur (source)

gaussian blur

radiusnumbersigma px · default 8

3D

mesh (texture)

3D mesh (scene object for render3d)

primitiveenum(cube | plane | sphere | cylinder | cone | torus | text | path)unit-sized primitive, or extruded text / SVG path · default cube
texttextprimitive text: content
fonttextprimitive text: family or file · default Helvetica Neue
weightnumberprimitive text: weight · default 400
styleenum(normal | italic)primitive text: style · default normal
sizenumberprimitive text: size in world units · default 1
alignenum(left | center | right)primitive text: alignment · default center
trackingnumberprimitive text: extra spacing (px at 100 px/unit) · default 0
line_heightnumberprimitive text: multiple of size · default 1.2
dtextprimitive path: SVG path data
unitsnumberprimitive path: path px per world unit · default 100
depthnumberextrusion depth, world units · default 0.25
bevelnumbertext/path: 45-degree chamfer on both rims, world units · default 0
srctext.gltf/.glb file instead of a primitive
segmentsnumbertessellation · default 32
positionvec3default [0,0,0]
rotationvec3degrees, X then Y then Z · default [0,0,0]
scalevec3 | numberdefault [1,1,1]
colorcolorbase color · default #cccccc
metallicnumber0..1 · default 0
roughnessnumber0..1 · default 0.5
emissivecoloremitted light · default #000000
transmissionnumberglass: 0..1 of the scene behind seen through it (refracted) · default 0
iornumberglass: index of refraction (water 1.33, glass 1.5, diamond 2.4) · default 1.45
thicknessnumberglass: how far refracted rays travel inside, world units (more bends more) · default 0.5
dispersionnumberglass: color splitting (try 1..2) · default 0
opacitynumber0..1 · default 1

light

3D light (scene object)

kindenum(directional | point)default directional
directionvec3toward the light (directional) · default [0.4,0.8,0.6]
positionvec3point light position · default [0,2,2]
colorcolordefault #ffffff
intensitynumberdefault 3

camera

3D camera (scene object)

positionvec3default [0,0,5]
orbitvec3[azimuth, elevation, distance] around target (overrides position)
targetvec3default [0,0,0]
upvec3default [0,1,0]
fovnumbervertical, degrees · default 45
nearnumberdefault 0.1
farnumberdefault 1000

render3d (*)

renders connected meshes/lights/camera (any port names; camera on `camera`)

ambientnumberhemisphere light intensity · default 0.35
skycolorambient from above · default #e6f2ff
groundcolorambient from below · default #5a4d47
backgroundcolorclear color · default transparent
shadowsboolthe first directional light casts a shadow map · default true
shadow_strengthnumber0 = no darkening, 1 = full · default 0.85
shadow_biasnumberdepth bias in shadow-map texels (raise if surfaces self-shadow) · default 1
environment_intensitynumberscale of the image on the `environment` port (equirectangular; lights and reflects) · default 1
environment_rotationnumberturns the environment around +y, degrees · default 0
fogvec2[start, end] distance from the camera where surfaces fade into fog_color
fog_colorcolorfog color · default background
aperturenumberdepth of field: blur radius px far from focus (0 = off) · default 0
focusnumberdepth of field: in-focus distance, world units · default camera to target

raymarch (in0, in1, in2, in3)

3D as a signed-distance scene marched per pixel: write float2 map(float3 p) -> (distance, material id); soft shadows, occlusion, a reflection bounce, environment and antialiasing come with it

scenetextSlang: float2 map(float3 p) (+ optional void material(float id, float3 p, float3 n, inout float3 albedo, inout float metallic, inout float roughness)); helpers sdSphere, sdBox, sdCylinder, sdTorus, sdCapsule, sdBand, sdPlane, smin, opU, rotX/Y/Z, fbm3, knob(i), layerDistance + extrude (any ultrafast layer as a 3D solid), presetMaterial (ids 0 matte, 1 brass, 2 polished brass, 3 steel, 4 gold, 5 copper, 6 black lacquer, 7 ceramic, 8 rubber, 9 clear glass, 10 chrome; metallic < 0 makes glass); input(i, px) reads in0..in3
orbitvec3camera [azimuth, elevation, distance] around target, degrees and world units · default [30,20,8]
targetvec3what the camera looks at · default [0,0,0]
fovnumbervertical, degrees · default 35
lightvec3point light position (casts soft shadows) · default [-4,5,4]
light_colorcolorlight color · default #fff2e0
light_intensitynumberinverse-square intensity · default 40
environmentenum(studio | room | night | sky | lightbox | horizon)what reflections and ambient light see (lightbox: bars of light, made for glass and chrome) · default studio
backgroundtextenvironment, transparent (to composite over 2D), or a color · default environment
background_levelnumberbrightness of an environment background · default 0.35
exposurenumberbefore tone mapping · default 1
samplesnumberrays per pixel (1..8), jittered · default 2
bouncebooltrace one reflection bounce for glossy surfaces · default true
iornumberglass index of refraction (materials with metallic < 0, preset 9) · default 1.5
dispersionnumberglass color splitting (0 none, 2 strong) · default 1
max_distancenumberrays stop here · default 80
k0numberk0..k4: free knobs read as knob(0..4) in the scene (animatable)
resolutionnumberrender scale · default 1

Simulation and particles

swarm

particles that assemble into text (or a path) and scatter: progress 0..1

texttextwhat the particles form (or `d`)
dtextSVG path data to form instead of text (offset by position)
fonttextfont family or file · default Helvetica Neue
weightnumberfont weight · default 400
styleenum(normal | italic)font style · default normal
trackingnumberextra px between glyphs · default 0
variationstextvariable-font axes, as on text
axis_<tag>numberone variable-font axis, as on text · default axis default
sizenumbertext size px · default 64
positionvec2text position (as `text`) · default [0,0]
alignenum(left | center | right)text alignment · default left
valignenum(top | middle | baseline | bottom)vertical alignment · default top
countnumberparticles · default 4000
progressnumber0 scattered, 1 formed; animate it · default 1
staggernumberspread of arrival times (fraction of progress) · default 0.5
scatternumberhow far particles start from home, px · default 700
originvec2start every particle from this point instead
turbulencenumberdrift amplitude while away from home, px · default 40
particle_sizevec2size scattered and formed, px · default [2,3]
colorcolorcolor when formed · default #ffffff
color_scattercolorcolor when scattered · default color
shimmernumber0..1 twinkle · default 0
stretchnumberstreak along travel while moving · default 0
seednumberrandom seed · default 1
blendenum(over | add)how particles combine · default over

particles (sprite)

deterministic particle system (closed form: scrub anywhere), drawn as sprites

seednumberrandom seed · default 1
ratenumberparticles emitted per second · default 60
maxnumbercap on particles alive · default 5000
lifevec2lifetime range, s · default [1.5,2.5]
positionvec2emitter center px · default [960,540]
emitter_sizevec2emitter rectangle px · default [0,0]
directionnumberdegrees (-90 = up) · default -90
spreadnumbercone angle, degrees · default 30
speedvec2initial speed range, px/s · default [200,400]
gravityvec2px/s^2 · default [0,300]
dragnumberlinear drag, 1/s · default 0
sizevec2size at birth and death, px · default [8,2]
size_jitternumber0..1 random size reduction · default 0.3
spinvec2rotation speed range, deg/s · default [0,0]
color_startcolorcolor at birth · default #ffffff
color_endcolorcolor at death · default color_start
fade_innumberfraction of life fading in · default 0.1
fade_outnumberfraction of life fading out · default 0.3
shapeenum(circle | square | spark | sprite)sprite uses the `sprite` input · default circle
stretchnumberspark stretch along velocity · default 0
blendenum(over | add)how particles combine · default over
emit_startnumberemission start, s (negative pre-warms) · default 0
emit_endnumberemission end, s · default forever

fluid (dye, stir)

ink/smoke simulation: `dye` pours color in, `stir` pushes it around; stepped once per frame (exact on export, seekable)

startnumberlocal time the simulation starts (blank before) · default 0
emitnumberhow fast `dye` replaces the fluid where it is, per s · default 6
dissipationnumberdye fade per s · default 0.15
velocity_dissipationnumbermotion fade per s · default 0.4
vorticitynumberkeeps eddies curling (0 = silky, 10+ = churning) · default 4
turbulencenumbercurl-noise stirring, px/s^2 (try 400..3000) · default 0
turbulence_scalenumbersize of the noise eddies, px · default 260
windvec2drift of everything, px/s · default [0,0]
buoyancynumberdye rises (smoke), px/s^2 per unit alpha · default 0
stirnumberpush away from the edges of the `stir` image · default 2500
swirlnumberspin around the edges of the `stir` image · default 0
resolutionnumbervelocity grid, fraction of the frame · default 0.25
dye_resolutionnumberdye grid, fraction of the frame · default 0.5
pressure_iterationsnumberincompressibility solver iterations · default 24
substepsnumbersteps per frame (1..8) · default 1
seednumberturbulence pattern · default 1

feedback (in0, in1, in2, in3)

agent Slang stepped once per frame on its own previous result: float4 update(float2 pos, float px) with prev(pos), input(i,pos), dt(), step_index()

codetextSlang source defining update()
startnumberlocal time the simulation starts (blank before) · default 0
resolutionnumberstate grid, fraction of the frame · default 1
substepsnumberupdates per frame (1..64) · default 1
unumber[]up to 16 values, param(i)
u0numberu0..u15 individually (animatable)

Footage, sound and captions

clip_camera

video framed on its speaker: faces are tracked from the footage (or given), then a follow camera with dead zone and eased pans, cuts on shots and speaker changes, scope zoom, protect mode (blurred cover behind the contained frame)

srctextsource video
facestextface tracks, inline as JSON text or a file: {sourceWidth, sourceHeight, fps, frames: [{frame, faces: [{id, x, y, w, h, talk, focus}]}], shots: [{startFrame, endFrame, protect, cinematicScope}]}; omit it and the clip's faces, who is talking and its cuts are tracked from the footage (`ultrafast faces` writes the same) · default tracked from src
startnumbersource seconds where the clip begins · default 0
durationnumberclip seconds · default document duration
tuningtextcamera tuning overrides as JSON
opacitynumber0..1 · default 1

captions

animated captions from word timings (karaoke, pop, reveal): pages laid out to fit, every word its own text node

srctexttranscript: Whisper/word JSON, .srt or .vtt
wordstextinline instead: lines of `start end word`, SRT text or JSON
styleenum(karaoke | pop | reveal | plain)karaoke lights the spoken word; pop pops each word on; reveal fades them on · default karaoke
fonttextfamily or file · default Helvetica Neue
sizenumberpx · default 6.5% of the short side
weightnumber100..900 · default 800
colorcolorwords not yet spoken · default #ffffff
highlightcolorthe word being spoken · default #ffd23f
spokencolorwords already spoken · default color
highlight_backgroundcolora rounded pill behind the spoken word
backgroundcolora rounded box behind each page
uppercaseboolset in capitals · default false
trackingnumberextra px between glyphs · default 0
widthnumberline width px · default 82% of the width
max_linesnumberlines per page · default 2
line_heightnumbermultiple of size · default 1.18
positionvec2center of the caption block (moved into `safe` if it would cross it) · default [w/2, 0.72 h]
alignenum(left | center | right)line alignment · default center
safeenum(auto | social | margin | none)area pages stay inside: auto is clear of the social apps' buttons and captions on a vertical frame (what `review --safe social` checks) and a 4% margin otherwise; none places them exactly at position · default auto
lingernumberseconds a page stays after its last word · default 0.6
opacitynumber0..1 · default 1

audio

sound mixed into exports

srctextany media file with audio
startnumbersource seconds playing at local time `from` · default 0
gainnumberlinear, animatable · default 1
fromnumberlocal seconds the sound starts at (silent before) · default 0
durationnumberseconds it plays from `from` (0: until the source ends) · default 0
ratenumberplayback speed with the pitch kept (time stretched) · default 1

chroma_key (source)

keys out a green (or any) screen: key color r, g, b (sRGB 0..1), tolerance, softness, spill

bnumberdefault 0.25
gnumberdefault 0.69
rnumberdefault 0.0
softnessnumberdefault 0.08
spillnumberdefault 0.8
tolerancenumberdefault 0.12

Blocks

block

a ready-made animated block in one house style: title, lower_third, quote, stat, chapter, end_card, and charts: bar_chart, line_chart, donut (place it in time with a timing offset)

kindenum(title | lower_third | quote | stat | chapter | end_card | bar_chart | line_chart | donut)which block · default title
titletexttitle / chapter / end_card / charts (above the chart)
kickertexttitle, charts: small line above
subtitletexttitle: line below
numbertextchapter: its number, e.g. 01
nametextlower_third
roletextlower_third
quotetextquote
authortextquote
valuenumberstat: counts up to it · default 0
prefixtextstat, bar and line values
suffixtextstat, bar and line values
decimalsnumberstat, bar and line values · default 0
labeltextstat
taglinetextend_card
ctatextend_card: a pill button
logotextend_card: SVG file
valuesnumber[]charts: the data, e.g. [24, 31, 58, 265]
labelstextcharts: one per value, comma separated (or | when labels hold commas)
highlightnumbercharts: index of the value set in the accent and called out (-1: none) · default bar, donut: the largest; line: the last
heightnumbercharts: plot height px · default 34% of the height
maxnumberbar, line: the value at the top of the plot · default largest value
minnumberline: the value at the baseline · default 0 or the smallest
colorcolorbar: other bars; line: the line · default muted (line: accent)
areaboolline: fill under the line · default true
draw_timenumberline: seconds the line takes to draw · default 1.6
colorstextdonut: segment colors, comma separated · default accent, then a palette
radiusnumberdonut: outer radius px · default fits the plot
thicknessnumberdonut: ring thickness px · default 30% of radius
number_fonttextstat, donut: the big number's face · default ultrafast:wide
durationnumberseconds before it exits (end_card stays) · default 3.5 (lower_third 4, quote 5, chapter 2.5, charts 5)
inkcolortype color · default #f6f3ee
mutedcolorsecondary type · default ink at 72%
accentcolorrules, bars, quote mark, pill · default #ff5c7a
display_fonttextheadline face · default ultrafast:display
text_fonttextbody face · default ultrafast:sans
mono_fonttextlabels · default ultrafast:mono
alignenum(left | center)alignment (end_card is centered) · default left
positionvec2title/quote/stat: top of the block; lower_third: bottom-left; end_card: center · default per kind
widthnumberwrap width px · default 80% of the width
scalenumbersize multiplier (sizes follow the frame) · default 1
opacitynumber0..1 · default 1

Shaders

shader (in0, in1, in2, in3)

agent-written Slang: float4 shade(float2 pos, float px)

resolutionnumberrender at this fraction of the frame size and upscale (soft, costly looks; write shaders with pos/size()) · default 1
codetextSlang source defining shade(); `static const` tables of 64+ numbers are read from the params (editing their values compiles nothing)
unumber[]up to 16 values, param(i)
u0numberu0..u15 individually (animatable)
motion_blurbooltrue: the format's motion blur samples its clock and animated u values (a shader that moves things); otherwise it holds at the frame's time · default false

Looks

drop_shadow (source)

soft shadow under the source (color, opacity, offset, radius)

colorcolordefault #000000
offsetvec2default [8.0,8.0]
opacitynumberdefault 0.6
radiusnumberdefault 12.0

glow (source)

soft colored glow around the source

intensitynumberdefault 1.0
radiusnumberdefault 16.0

vignette (source)

darkened edges (inner, outer colors)

innercolordefault #00000000
outercolordefault #000000b0

stroke_outline (source)

solid outline around the source's shape (color, width px)

colorcolordefault #ffffff
widthnumberdefault 4.0

bloom (source)

light bleeding from bright areas (threshold, radius, intensity, wide)

intensitynumberdefault 0.6
radiusnumberdefault 32.0
thresholdnumberdefault 0.75
widenumberdefault 0.3

grain (source)

animated film grain (amount)

amountnumberdefault 0.07

aberration (source)

chromatic fringes toward the edges

amountnumberdefault 8.0

repeater (source)

count copies, each moved by (dx, dy), turned by rotate degrees and scaled by scale about (cx, cy), fading by fade: trails, radial arrays, tunnels

countnumberdefault 6.0
cxnumberdefault 0.0
cynumberdefault 0.0
dxnumberdefault 0.0
dynumberdefault 0.0
fadenumberdefault 1.0
rotatenumberdefault 0.0
scalenumberdefault 1.0

halftone (source)

riso halftone dots of one ink (cell, angle, r, g, b): sized by the source's coverage, or with tone 1 by how dark it is (to screen footage)

anglenumberdefault 15.0
bnumberdefault 0.69
cellnumberdefault 9.0
gnumberdefault 0.28
rnumberdefault 1.0
seednumberdefault 1.0
tonenumberdefault 0.0

glitch (source)

digital glitch: slices, offsets, color splits

amountnumberdefault 0.5
rollnumberdefault 0.35
trackingnumberdefault 0.3

crt (source)

CRT screen: curvature, scanlines, aperture grille

phosphornumberdefault 0.9

dot_matrix (source)

LED dot-matrix resampling

bnumberdefault 0.61
cellnumberdefault 11.0
gnumberdefault 1.0
rnumberdefault 0.49

glass_pane (source)

frosted, refracting glass pane over what is beneath

bendnumberdefault 36.0
bevelnumberdefault 34.0
frostnumberdefault 26.0
gainnumberdefault 0.92
heightnumberdefault 400.0
liftnumberdefault 0.06
lightnumberdefault 1.0
radiusnumberdefault 48.0
widthnumberdefault 600.0
xnumberdefault 540.0
ynumberdefault 540.0

lens_flare (source)

lens flare from a light at (x, y)

bnumberdefault 0.6
gnumberdefault 0.82
intensitynumberdefault 1.0
rnumberdefault 1.0
xnumberdefault 1400.0
ynumberdefault 300.0

light_leak (source)

warm film light leaks drifting over the frame

bnumberdefault 0.18
gnumberdefault 0.45
intensitynumberdefault 0.6
rnumberdefault 1.0
speednumberdefault 1.0

film_look (source)

lens and film over the source: red halation, a hair of softness, grit, lifted blacks, grade, fringes, vignette, grain (hides the tells of plain 3D)

aberrationnumberdefault 0.8
grainnumberdefault 0.09
gritnumberdefault 0.35
halationnumberdefault 0.9
liftnumberdefault 0.03
saturationnumberdefault 0.82
softnessnumberdefault 0.55
vignettecolordefault #000000b0

engrave (source)

copperplate engraving: tone to hatching, contours inked, dark backdrop left as paper (spacing, backdrop, ink_*, paper_*)

backdropnumberdefault 0.3
ink_bnumberdefault 0.04
ink_gnumberdefault 0.07
ink_rnumberdefault 0.12
paper_bnumberdefault 0.76
paper_gnumberdefault 0.88
paper_rnumberdefault 0.93
spacingnumberdefault 6.0