Action Image
Text in Image
Draws a line of text onto an image at an anchored position and saves the result.
Node IDTextInImageAction
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Source File Path sourceFilePath | file_picker | Yes | — | The full path to the source image to draw text onto. |
Output File Path (Optional) outputFilePath | file_picker | No | — | The full path to save the result. If blank, saves next to source with "_text" suffix. |
Text text | string | Yes | — | The text to draw onto the image. Single line; newlines are not supported. |
Anchor anchor | enum | No | Center | Where to anchor the text box on the image. Offsets are applied relative to this position. |
Offset X offsetX | integer | No | 0 | Horizontal offset in pixels from the anchor position. Negative moves left. |
Offset Y offsetY | integer | No | 0 | Vertical offset in pixels from the anchor position. Negative moves up. |
Font Size fontSize | integer | No | 32 | Font size in pixels. |
Text Color color | color | No | [255,255,255] | The RGB color of the text (e.g., [255, 255, 255] for white). |
Opacity opacity | range min 0 , max 1 | No | 1 | Text opacity from 0.0 (invisible) to 1.0 (opaque). Useful for watermarks. |
Font File (Optional) fontFilePath | file_picker | No | — | Path to a TTF/OTF font file. If blank, a bundled sans-serif font (DejaVu Sans) is used. |
Overwrite overwrite | boolean | No | false | If true, overwrites an existing file at the output path. |
Create Directory createDirectory | boolean | No | true | If true, creates the parent directory for the output file if it doesn't exist. |
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
Execute input0 | object | Yes | Triggers drawing the text. |
Outputs
| Output | Type | Identifier | Description |
|---|---|---|---|
On Success output0 | object | outputFilePath | Fires on success and contains the output file path. |