Overview
The Edit Image+ node's "Shear" operation allows you to apply a shear transformation to an image along the X and/or Y axes. This is useful for skewing images horizontally, vertically, or both, which can be helpful in graphic design, automated image processing, or preparing images for further manipulation.
Common scenarios:
- Skewing product photos for creative effects.
- Correcting perspective distortions.
- Generating stylized images for marketing materials.
Example:
You have a scanned document that appears slightly slanted. By applying a shear transformation, you can correct its alignment or create a dynamic visual effect.
Properties
Display Name | Type | Description |
---|---|---|
Property Name | String | Name of the binary property in which the image data can be found. |
Degrees X | Number | X (horizontal) shear degrees. Specifies how much to skew the image on X axis. |
Degrees Y | Number | Y (vertical) shear degrees. Specifies how much to skew the image on Y axis. |
Options | Collection | Additional options for output formatting and file naming. See below. |
Options collection fields:
- File Name (String): File name to set in binary data.
- Format (Options: bmp, gif, jpeg, png, tiff, webp): Set the output image format.
- Quality (Number, 0–100): Sets the compression level for jpeg, png, or tiff formats.
Output
The node outputs an item with the following structure:
{
"json": { ...original input json... },
"binary": {
"<Property Name>": {
"data": "<base64 image data>",
"mimeType": "image/<format>",
"fileExtension": "<format>",
"fileName": "<custom or original file name>"
}
},
"pairedItem": { "item": <input item index> }
}
- The processed image is returned in the
binary
field under the property name specified by Property Name. - The
mimeType
,fileExtension
, and optionallyfileName
reflect the chosen output format and options. - The
json
field contains the original item's JSON data, unchanged.
Dependencies
- External Libraries:
- gm (GraphicsMagick/ImageMagick) for image processing.
- tmp-promise for temporary file handling.
- n8n Requirements:
- The n8n instance must have access to the underlying GraphicsMagick or ImageMagick binaries.
- No external API keys are required.
Troubleshooting
Common issues:
Missing Binary Data:
If the specified Property Name does not exist in the input item's binary data, the node will throw an error like:ERROR: No binary data property "..." exists on item!
Resolution: Ensure the input item contains the expected binary property.
Invalid Shear Values:
Non-numeric or extreme values for Degrees X/Y may result in unexpected image distortion or errors.
Resolution: Use reasonable numeric values for shearing.Unsupported Format:
If an unsupported format is specified in Options, the node may fail to process the image.
Resolution: Choose from the supported formats: bmp, gif, jpeg, png, tiff, webp.GraphicsMagick/ImageMagick Not Installed:
If the underlying system lacks these tools, image processing will fail.
Resolution: Install GraphicsMagick or ImageMagick.