Text to Image — Reference
Render text onto a loaded image using the configured font.
Render text onto a loaded image using the configured font.
Before you begin
Section titled “Before you begin”- A supported image-processing runtime and a disposable test image. Load the named processing instance before effect, transform or Save steps.
Text to Image
Section titled “Text to Image”Render text onto a loaded image using the configured font.
Settings
Section titled “Settings”| Setting | Meaning |
|---|---|
| Image | Select the named Load Image instance available earlier in this action. It is not a filename or an App Connect page component. |
| X | Horizontal placement in the current image. Start with a positive pixel coordinate such as 10. Alignment keywords and percentages have operation-specific semantics. |
| Y | Vertical placement in the current image. Start with a positive pixel coordinate. Text coordinates involve font baseline behavior and differ from a crop rectangle. |
| Text | The text to render into the image. This is image content, not a markup block placed on a webpage. |
| Font | Node.js uses a font name available to its rendering environment. PHP selects an installed font file under the server’s configured fonts folder. |
| Size | Font size, with runtime default 24. Check the rendered text at the output image’s actual pixel dimensions. |
| Color | Text color. The default is white (#FFFFFF); choose a value that remains readable over the underlying pixels. |
Worked example
Section titled “Worked example”Load a test image, choose X 10 and Y 30, enter Sample, choose an available font, Size 24 and a contrasting Color. Save to a new file and verify readability and placement.
Check the result
Section titled “Check the result”Font controls are context-dependent: Node.js takes a server-available font name, while PHP selects a font file from its configured fonts folder. Installing a font on the author’s desktop alone does not install it on the server. Positive pixel positions are the simplest portable starting point; text baseline/alignment behavior can differ.
Load, transform and save
Section titled “Load, transform and save”Image Processor operations run on the server. For transformations, use a named Load Image, apply the intended operations to that instance, and Save it to a deliberate path. A page image component will not automatically update just because an in-memory server instance changed. Return or persist the saved path and update the page’s source as needed.
Check your result
Section titled “Check your result”You can configure the selected image operation and inspect a saved result for the intended dimensions or visual effect.