Composite
Stack up to four layers over a base at the base's size with blend mode, opacity, position and scale per layer.
- Video
- Since 0.2.0
- composite
- layers
- blend
Composite stacks up to four layers over a base, with blend mode, opacity, position and scale for each layer.
What it does#
The output is the size of the base. Each layer, layer1 to layer4, is placed over the base in order. Per layer, Blend picks how it combines (0 to 3), Opacity fades it, X and Y move it and Scale resizes it. Each input takes exactly one stream.
When to use it#
Use it to put a keyed camera over a backdrop, overlay text or paint, or build picture-in-picture.
Ports#
| Port | Direction | Signal | Lanes |
|---|---|---|---|
base | Input | Video | 1 |
layer1 | Input | Video | 1 |
layer2 | Input | Video | 1 |
layer3 | Input | Video | 1 |
layer4 | Input | Video | 1 |
video | Output | Video | 1 |
Parameters#
| Parameter | Label | Range | Default | Unit | Scale | Notes |
|---|---|---|---|---|---|---|
blend1 | Blend 1 | 0 to 3 | 0 | linear | Blend mode of layer 1 over what is below. Choices: 0 Over, 1 Add, 2 Multiply, 3 Screen. | |
opacity1 | Opacity 1 | 0 to 1 | 1 | linear | Opacity of layer 1. | |
x1 | X 1 | -1 to 1 | 0 | linear | Horizontal offset of layer 1 as a fraction of the base width. | |
y1 | Y 1 | -1 to 1 | 0 | linear | Vertical offset of layer 1 as a fraction of the base height. | |
scale1 | Scale 1 | 0.05 to 8 | 1 | × | log | Scale of layer 1 about its centre. |
blend2 | Blend 2 | 0 to 3 | 0 | linear | Blend mode of layer 2 over what is below. Choices: 0 Over, 1 Add, 2 Multiply, 3 Screen. | |
opacity2 | Opacity 2 | 0 to 1 | 1 | linear | Opacity of layer 2. | |
x2 | X 2 | -1 to 1 | 0 | linear | Horizontal offset of layer 2 as a fraction of the base width. | |
y2 | Y 2 | -1 to 1 | 0 | linear | Vertical offset of layer 2 as a fraction of the base height. | |
scale2 | Scale 2 | 0.05 to 8 | 1 | × | log | Scale of layer 2 about its centre. |
blend3 | Blend 3 | 0 to 3 | 0 | linear | Blend mode of layer 3 over what is below. Choices: 0 Over, 1 Add, 2 Multiply, 3 Screen. | |
opacity3 | Opacity 3 | 0 to 1 | 1 | linear | Opacity of layer 3. | |
x3 | X 3 | -1 to 1 | 0 | linear | Horizontal offset of layer 3 as a fraction of the base width. | |
y3 | Y 3 | -1 to 1 | 0 | linear | Vertical offset of layer 3 as a fraction of the base height. | |
scale3 | Scale 3 | 0.05 to 8 | 1 | × | log | Scale of layer 3 about its centre. |
blend4 | Blend 4 | 0 to 3 | 0 | linear | Blend mode of layer 4 over what is below. Choices: 0 Over, 1 Add, 2 Multiply, 3 Screen. | |
opacity4 | Opacity 4 | 0 to 1 | 1 | linear | Opacity of layer 4. | |
x4 | X 4 | -1 to 1 | 0 | linear | Horizontal offset of layer 4 as a fraction of the base width. | |
y4 | Y 4 | -1 to 1 | 0 | linear | Vertical offset of layer 4 as a fraction of the base height. | |
scale4 | Scale 4 | 0.05 to 8 | 1 | × | log | Scale of layer 4 about its centre. |
Blend 1 (blend1)#
Blend mode of layer 1, 0 to 3.
Opacity 1 (opacity1)#
Opacity of layer 1.
X 1 (x1)#
Horizontal position of layer 1, -1 to 1.
Y 1 (y1)#
Vertical position of layer 1, -1 to 1.
Scale 1 (scale1)#
Size of layer 1, logarithmic.
Blend 2 (blend2)#
Blend mode of layer 2.
Opacity 2 (opacity2)#
Opacity of layer 2.
X 2 (x2)#
Horizontal position of layer 2.
Y 2 (y2)#
Vertical position of layer 2.
Scale 2 (scale2)#
Size of layer 2.
Blend 3 (blend3)#
Blend mode of layer 3.
Opacity 3 (opacity3)#
Opacity of layer 3.
X 3 (x3)#
Horizontal position of layer 3.
Y 3 (y3)#
Vertical position of layer 3.
Scale 3 (scale3)#
Size of layer 3.
Blend 4 (blend4)#
Blend mode of layer 4.
Opacity 4 (opacity4)#
Opacity of layer 4.
X 4 (x4)#
Horizontal position of layer 4.
Y 4 (y4)#
Vertical position of layer 4.
Scale 4 (scale4)#
Size of layer 4.
Tips#
- Unconnected layers are ignored.
- Use Transform to prepare a layer's size first.
- Video needs the browser's WebGPU video engine. The Player and exports do not run video yet and report it unavailable. To see a video output, bind a live Screen in the Frame to it.
See also#
Chroma key, Video crossfade, Image, Video, Control lanes.
Help patches
Each help patch is an ordinary Toy that teaches one idea. The diagram shows the Patch; the preview shows its Frame. Open it in TuneToys to play and edit it.
1. Stack two layers
intermediate Teaches: opacity1, x1, y1, scale1, blend1, opacity2
A camera base with a text and a paint layer on top.
Video1 stream
Flip the image horizontally so the person sees themselves as in a mirror. Range: 0–1. Default: 1. Linear scale. Units: unitless.
FieldsAuto
Video1 stream
Font size in pixels of the rendered frame. Range: 8–400 px. Default: 64 px. Logarithmic scale. Units: px.
px
Horizontal anchor position across the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Vertical anchor position down the frame. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Text alignment at the anchor. Range: 0–2. Default: 1. Linear scale. Units: unitless.
Red component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Green component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Blue component of the text colour. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Opacity of the text. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Strength of the drop shadow behind the text. Range: 0–1. Default: 0.5. Linear scale. Units: unitless.
Decimal places shown for lane values. Range: 0–4. Default: 0. Linear scale. Units: unitless.
Width of the rendered frame. Range: 64–3840 px. Default: 1280 px. Linear scale. Units: px.
px
Height of the rendered frame. Range: 64–2160 px. Default: 720 px. Linear scale. Units: px.
px
Video1 stream
Rising to 1 wipes the surface. Range: 0–1. Default: 0. Linear scale. Units: unitless.
Base1 stream
Layer 11 stream
Layer 21 stream
Layer 31 stream
Layer 41 stream
Video1 stream
Blend mode of layer 1 over what is below. Range: 0–3. Default: 0. Linear scale. Units: unitless.
Opacity of layer 1. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Horizontal offset of layer 1 as a fraction of the base width. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Vertical offset of layer 1 as a fraction of the base height. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Scale of layer 1 about its centre. Range: 0.05–8 ×. Default: 1 ×. Logarithmic scale. Units: ×.
×
Blend mode of layer 2 over what is below. Range: 0–3. Default: 0. Linear scale. Units: unitless.
Opacity of layer 2. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Horizontal offset of layer 2 as a fraction of the base width. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Vertical offset of layer 2 as a fraction of the base height. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Scale of layer 2 about its centre. Range: 0.05–8 ×. Default: 1 ×. Logarithmic scale. Units: ×.
×
Blend mode of layer 3 over what is below. Range: 0–3. Default: 0. Linear scale. Units: unitless.
Opacity of layer 3. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Horizontal offset of layer 3 as a fraction of the base width. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Vertical offset of layer 3 as a fraction of the base height. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Scale of layer 3 about its centre. Range: 0.05–8 ×. Default: 1 ×. Logarithmic scale. Units: ×.
×
Blend mode of layer 4 over what is below. Range: 0–3. Default: 0. Linear scale. Units: unitless.
Opacity of layer 4. Range: 0–1. Default: 1. Linear scale. Units: unitless.
Horizontal offset of layer 4 as a fraction of the base width. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Vertical offset of layer 4 as a fraction of the base height. Range: -1–1. Default: 0. Linear scale. Units: unitless.
Scale of layer 4 about its centre. Range: 0.05–8 ×. Default: 1 ×. Logarithmic scale. Units: ×.
×
Audio2ch
Connections as text
- Camera video output connected to Composite base input
- Text layer video output connected to Composite layer1 input
- Paint surface video output connected to Composite layer2 input
- The output is the size of the base.
- Layer 1 is the text; each layer has its own blend, opacity, position and scale.
Related nodes
- Chroma key Turn one colour transparent with tolerance, softness and spill suppression: the green screen.
- Video crossfade Blend two streams with one mix control.
- Image A declared image asset as a still video stream, for logos, backgrounds and keys.