Image Transforms
Table of Contents
 | Set Alpha Mask | This node adds or modifies the alpha channel of an image. |
 | Size Relative | This node scales an image. Scaling parameters are relative to the original image size. |
| Size Absolute | This node scales an image. Scaling parameters must be specified in pixels. |
 | Crop Relative | This node crops an image. Cropping parameters are relative to the original image size. |
| Crop Absolute | This node crops an image. Cropping parameters must be specified in pixels. |
The Image Transforms nodes provide some common transformations to manipulate loaded images. The transformation has to be done before the image is converted to a texture via the Image To Texture Node. It is possible to link one transformation to another in order to create transformation chains.
These nodes are not real-time capable! Changing any input parameters will cause the renderer to stall! Use these nodes only during the load/initialization phase of a Scene.
All transform nodes have an ImageSource and ImageResult property. The Active property makes it possible to deactivate the node. In that case the source image is just passed through without any manipulations.
Set Alpha Mask
The Set Alpha Node Mask adds an alpha channel to an image or manipulates the existing one. The property AlphaMaskSource takes the image that will control the transparency. This image should be an 8-bit gray-scale image. Images in other formats will be converted. The property Merge defines how the resulting alpha channel is calculated from the source image and the already existing alpha channel. Merge can have the following values:
| Replace | The old alpha channel is replaced by the new alpha channel. |
| UseMostOpaque | Alpha values are compared pixel-wise and the higher value is used. |
| UseMostTransparent | Alpha values are compared pixel-wise and the lower value is used. |
| Add | The alpha values are summed. The maximum value is 255. |
| Subtract | The alpha values are subtracted. The minimum value is 0. |
| LogicalAnd | Performs a bitwise logical AND operation on the old and new alpha values. |
| LogicalOR | Performs a bitwise logical OR operation on the old and new alpha values. |
| LogicalXOR | Performs a bitwise logical XOR operation on the old and new alpha values. |
| UseOriginal | The new alpha channel will be ignored and the old one remains. |
If the property Resize is active, the image that provides the new alpha channel will be resized to fit the original image. The properties PositionX and PositionY can be used to change the position of the alpha image within the alpha channel of the source image.
Size Relative
The Node Size Relative is used to scale an image. The properties Width and Height define the new size of the image. These values are percentage relative to the original size.
Size Absolute
The Node Size Absolute is used to scale an image. The properties Width and Height define the new size of the image. These values specify the new size in pixel.
Crop Relative
The Node Crop Relative creates a new image from a rectangular selection in the source image. The properties PositionX and PositionY define relative to the image size the upper left corner of the selection. The properties Width and Height define the size of the selection. These values are percentage relative to the original image size.
Crop Absolute
The Node Crop Absolute creates a new image from a rectangular selection in the source image. The properties PositionX and PositionY define the upper left corner of the selection. The Properties Width and Height define the size of the selection. These values specify the selection in pixel.