Actions19
Composite
AI-generatedSummary
Composite overlays a second binary image onto the source image at the specified X/Y position, using the selected blend operator. The result is returned as a processed binary image.
Inputs
- Input Property Name (required) — Binary property containing the source image; defaults to
data. - Position X — Horizontal overlay position in pixels; defaults to 0.
- Position Y — Vertical overlay position in pixels; defaults to 0.
- Composite Image Property (required) — Binary property containing the overlay image; defaults to
data2. - Operator — Blend mode for combining the images; defaults to
Over. Legacy modes may map to the nearest sharp/libvips equivalent. - Output Binary Property Name — Optionally write the processed image to a different binary property; if unset, it replaces the source property.
- File Name — Optional output file name; its extension is set to match the output format.
- Output Format Override — Optional final format override. Defaults to inheriting the source format; a later Format operation in a multi-step pipeline takes precedence.
- Quality — Output quality for formats that support it; defaults to 100.
- Opaque Background Color — Background used when exporting to a format without alpha support, such as JPEG; defaults to white.
Output shape
One item per input item, with the processed image in binary data.
The output preserves the input JSON and other binary properties, adds or replaces the selected output binary property, and includes paired-item linkage. Composite requires both the source and overlay binary properties to exist.