Keying, blurs and pins
The everyday work on footage: take out a green screen, hide a face or a screen, put a recording into a screen filmed at an angle, and add a camera look or a texture. Each is an <Effect> child of a clip, and runs as a shader, the same in the preview and the export.
Green screen
colorKey makes the key colour transparent, so the tracks beneath show through. Put the background on a track below the keyed clip:
<Track id="background">
<Clip id="studio" src="asset:studio" />
</Track>
<Track id="presenter">
<Clip id="talk" src="asset:greenscreen">
<Effect id="key" type="colorKey" params={{ color: "#18c43a", tolerance: 0.3, softness: 0.1, spill: 0.6 }} />
</Clip>
</Track>To tune a key:
- Pick
colorfrom the screen in the footage, not pure green. - Raise
toleranceuntil the screen is gone. - Raise
softnessuntil hair and edges stop looking cut out. - Set
spill(0 to 1) to remove the green light the screen bounces onto the subject.
It compares colour, not brightness, so the shadowed and lit parts of the screen go together.
Hiding a face, a plate or a screen
regionBlur blurs inside a box. Keyframe the box to follow what it hides:
<Clip id="street" src="asset:street">
<Effect id="plate" type="regionBlur" params={{ box: [0.42, 0.66, 0.12, 0.06], radius: 10, roundness: 0.3 }}>
<Keyframe id="p1" param="box" at={0} value={[0.42, 0.66, 0.12, 0.06]} />
<Keyframe id="p2" param="box" at={2.5} value={[0.3, 0.7, 0.14, 0.07]} />
</Effect>
</Clip>| Param | Does |
|---|---|
box | [x, y, width, height], as fractions of the frame from its top left. |
radius | The blur: the Gaussian's standard deviation in pixels, as CSS blur() reads it. |
feather | Fades the blur in over that many pixels inside the edge. |
roundness | 0 to 1: rounds the corners up to a circle or a pill. |
inverted | Blurs everything except the box. |
TIP
To hide something, make the box larger than it, so nothing recognisable sits in the feathered edge.
For a coarse mosaic instead of a blur, use pixelate with a box.
A recording in a screen
cornerPin maps the picture onto four corners, so a screen recording sits in a screen filmed at an angle. Put the recording on a track above the shot of the device:
<Track id="shot">
<Clip id="laptop" src="asset:laptop-on-desk" />
</Track>
<Track id="screen">
<Clip id="demo" src="asset:screen-recording">
<Effect
id="pin"
type="cornerPin"
params={{ topLeft: [0.31, 0.22], topRight: [0.68, 0.25], bottomRight: [0.66, 0.6], bottomLeft: [0.33, 0.58] }}
/>
</Clip>
</Track>The corners are topLeft, topRight, bottomRight and bottomLeft, each [x, y] as fractions of the frame. The picture is warped in perspective, as a flat screen seen at an angle is, and outside its four corners it is transparent. When the camera moves, keyframe each corner.
Follow something that moves
Every param can be animated by a <Keyframe> inside the effect, lists included. A box or a corner moves smoothly between two keys, which is how a blur follows a face or a pin follows a screen.
Camera looks
These imitate what a lens or a fast camera move does to the picture.
zoomBlur smears the picture toward center ([x, y]), more the further from it.
| Param | Does |
|---|---|
center | [x, y]: the point it smears toward. |
length | Up to that many pixels of smear at the corners. Keyframe it down from a high value for a punch-in. |
samples | Up to 64: trades smoothness for speed. |
chromaticAberration splits red and blue apart, as a lens fringes.
| Param | Does |
|---|---|
distance | How far apart, in pixels. |
angle | The direction, in degrees clockwise from up. The default 90 is across. |
radial | Splits outward from center instead, growing toward the edges. |
Stylize
These turn footage into print, mosaic or an old screen.
halftone prints the picture as dots on a screen of size-pixel cells turned by angle. amount mixes the print over the picture.
mode | Prints |
|---|---|
"mono" | ink on paper, by brightness. |
"cmyk" | Four inks, each on its own screen at the classic angles, as a magazine page is printed. |
pixelate turns the picture into a mosaic of size-pixel cells. Give it a box and only that part is pixelated, so it hides a face or a plate the way regionBlur does, but as a coarse mosaic:
<Clip id="street" src="asset:street">
<Effect id="hide" type="pixelate" params={{ size: 18, box: [0.62, 0.1, 0.2, 0.35], feather: 6 }} />
</Clip>scanlines lays dark bands over the picture, for an old screen.
| Param | Does |
|---|---|
spacing | A band every that many pixels. |
thickness | How wide each dark band is, as a fraction of spacing. |
intensity | How dark a band is. |
speed | Rolls the bands by that many pixels a second. |
angle | Turns them. |
Light and texture
These lay light or moving texture over the picture.
lightLeak washes soft blooms of color over the picture, wandering as the video plays and only ever lightening it. evolution sets how fast they wander; change seed for another pattern. On an <Adjustment> it covers everything beneath, cuts and titles included:
<Track id="look" layout="free">
<Adjustment id="leak" start={0} duration={12}>
<Effect id="l" type="lightLeak" params={{ intensity: 0.5, color: "#ff9a4d" }} />
</Adjustment>
</Track>fractalNoise draws clouds of noise that change in place over time: about size pixels across, with octaves layers of finer detail. blend and opacity set how they meet the picture:
blend | Gives |
|---|---|
screen | Mist or smoke over footage. |
overlay or softLight | A texture. |
normal, on a full-frame <Shape> | A moving background. |
Export cost
These looks change the picture's pixels, so they cost more to export without a GPU than a colour effect does. A CMYK halftone and fractalNoise with many octaves are the heaviest.
Where there is no WebGL
These effects need WebGL, which every browser the player runs in has, and the export always has. Where it is missing they are left out, with a warning.
Next
- Colour and grading: correct and grade the picture.
- Transitions: blend one clip into the next.
- Effects and transitions: every effect and its params.