VMTech Edit Image icon

VMTech Edit Image

Edit images with a sharp-based Parity+ pipeline and robust text rendering

Actions19

Text

AI-generated

Summary

Render text onto an input image within a positioned text box, with configurable typography, alignment, wrapping, and overflow handling. The operation requires an image in the selected binary property and returns the edited image as binary data.

Inputs

  • Input Property Name (required) — Binary property containing the source image; defaults to data.
  • Text — Text content to render; defaults to an empty string.
  • Width and Height — Dimensions of the text box in pixels; each defaults to 512. If omitted or zero at runtime, the box extends from its position to the corresponding image edge.
  • Position X and Position Y — Top-left position of the text box in pixels; both default to 0 and are clamped to nonnegative values.
  • Font Size — Font size in pixels; defaults to 32.
  • Font Family, Font Weight, Font Style — Select a discovered font family or auto, plus requested weight and normal or italic style. Defaults are auto, 400, and normal. Fonts are resolved from the node's font registry.
  • Font Color — Text color, including optional alpha; defaults to opaque black.
  • Background Color — Optional text-box background color, including alpha; defaults to transparent.
  • Line Height — Line spacing multiplier or pixel value; defaults to 1.2. Values above 3 are treated as pixels; other values scale with font size.
  • Horizontal Align and Vertical Align — Alignment within the text box: left, center, or right, and top, middle, or bottom. Defaults to left and top.
  • Auto Wrap — Wrap text within the box automatically; defaults to enabled.
  • Overflow — Choose wrap, shrink-to-fit, clip, or ellipsis when text exceeds the box; defaults to wrap.
  • Show Text Box Helper — Draw a thin red dashed rectangle over the image to show the text area; defaults to disabled.
  • Options: Output Binary Property Name — Optional binary key for the processed image. When unset, the edited image replaces the input image's binary property.
  • Options: File Name — Optional output filename; the extension is set to match the output format.
  • Options: Output Format Override, Quality, Opaque Background Color — Set the output format (inherit, AVIF, GIF, JPEG, PNG, TIFF, or WebP), encoder quality, and background used for JPEG export. Defaults are inherit, 100, and white. A later Format operation takes precedence over the format override.

Output shape

One n8n item per input item, with the rendered image in binary data and the input JSON retained.

The output binary key defaults to the input property name unless a different key is specified. The node requires an input image for this operation; failures are thrown unless Continue On Fail is enabled.

Links

Discussion