PDF4me

Overview

This node operation "Add Text Watermark To Image" allows users to add a customizable text watermark onto an image. It supports multiple input methods for the source image, including binary data from a previous node, a base64 encoded string, or a direct URL to the image file.

Common scenarios where this node is beneficial include:

• Branding images by adding company logos or copyright text.
• Marking images as drafts or confidential by overlaying specific text.
• Adding watermarks for digital rights management or content protection.

Practical example: A marketing team can automatically watermark all product images with their brand name before publishing them online, ensuring consistent branding and discouraging unauthorized use.

Properties

Output

The node outputs the processed image with the text watermark applied. The output includes:

• A JSON object containing metadata about the resulting image.
• The image itself is provided as binary data under a specified binary property.
• The output file name corresponds to the configured "Output File Name" property.

If the input was binary or base64, the output will be binary data representing the watermarked image. If the input was a URL, the output similarly provides the watermarked image as binary data.

Dependencies

• This node requires access to an image processing service or library capable of rendering text onto images.
• No explicit external API keys or credentials are indicated in the provided code snippet.
• The node may require proper configuration of binary data handling within n8n workflows.
• Asynchronous processing option suggests that the node can handle large files efficiently, possibly leveraging background tasks or external services.

Troubleshooting

• Common Issues:

  • Incorrect input data type selected: Ensure the "Input Image Data Type" matches the actual input (binary, base64, or URL).
  • Missing or incorrect binary property name when using binary input.
  • Invalid base64 string or malformed URL leading to failure in loading the image.
  • Unsupported font family or invalid color codes causing rendering issues.
  • Large image files might cause timeouts or slow processing if asynchronous processing is disabled.

• Error Messages:

  • Errors related to image loading failures usually indicate problems with the input image source.
  • Text rendering errors may occur if font settings are invalid.
  • Timeout or memory errors suggest enabling "Use Async Processing" for better handling of large files.

• Resolutions:

  • Double-check input properties and ensure they align with the actual data.
  • Validate URLs and base64 strings before running the node.
  • Use standard fonts and valid hex color codes.
  • Enable asynchronous processing for large images.

Links and References

• Watermarking Images - General Concepts
• Base64 Encoding Explained
• Hexadecimal Color Codes
• n8n Documentation - Working with Binary Data