Search documentation

Find a vivid-layer page or product.

Print Halftone

CMYK print screening with configurable dots, inks, paper, and registration.

API reference

The component applies Shader Lab's CMYK Halftone effect to an image. It does not animate or add a text overlay.

PropTypeDefaultDescription
imagestringrequiredA project image URL, data URL, or local blob URL. Remote servers must allow anonymous CORS image loading.
width / heightnumber | string"100%"CSS dimensions. Give the parent an explicit height.
className / stylestring / CSSPropertiesStyles the outer image container.
fit"cover" | "contain""cover"Fits and centers the image within the container.
scalenumber1Image zoom. The playground provides a range of 0.1–4.
onError(error: Error) => voidReports initialization or image-loading failure. The component hides the failed canvas and supplies no replacement image.
shape"circle" | "square" | "diamond" | "line""circle"Shape of each print dot.
spacingnumber5Logical grid spacing, 2–48.
dotSizenumber1Ink-dot size multiplier, 0.1–3.
contrastnumber1Tonal contrast, 0–2.
softnessnumber0.25Dot-edge softness, 0–1.
dotGainnumber0Ink expansion, 0–1.
gcrnumber0.5Black generation relative to the color plates, 0–1.
cmykBlend"subtractive" | "overprint""subtractive"Ink blending method.
cyanAnglenumber15Screen angle in degrees, 0–90.
magentaAnglenumber75Screen angle in degrees, 0–90.
yellowAnglenumber0Screen angle in degrees, 0–90.
keyAnglenumber45Screen angle in degrees, 0–90.
inkCyanstring"#00AEEF"Hexadecimal ink or paper color.
inkMagentastring"#EC008C"Hexadecimal ink or paper color.
inkYellowstring"#FFF200"Hexadecimal ink or paper color.
inkKeystring"#1a1a1a"Hexadecimal ink or paper color.
paperColorstring"#F5F5F0"Hexadecimal ink or paper color.
paperGrainnumber0.15Paper texture intensity, 0–0.5.
registrationnumber0Plate misalignment, 0–5.

Process uses the same CMYK settings as the reviewed sample, including the upstream default process inks. The light paper can make bright areas unsuitable for white text; adjust paper and ink controls for your composition.

Credits

Rendering uses the unmodified Shader Lab 3.0.2 runtime by basement.studio, licensed under Apache-2.0. Vivid Layer's adapter and examples use the Vivid Layer Community License; the upstream implementation retains its own license.

The default photograph is Jeremy Bishop's Monument Valley, used under the Unsplash License.