This Specification Macro Task will crop an image by removing as much whitespace or transparency as possible around the Source image.
Please note that only pure white is considered as whitespace and that only a transparency level between 80 and 100% will be considered as transparent.
Property Name | Description |
---|---|
Title | Changes the Title (not the name) of the Task. |
Source | The Full File Path and Name of the Source image file to transform, including its extension |
Destination | The Full File Path and Name of the image file to create, including its extension. |
Constant Name | The name of the Constant used to report on the success of the Task. If it is a success this will be used to store the Path of the generated image. |
Overwrite | TRUE to overwrite an existing image, FALSE to keep the existing image. |
Sides To Crop | Define which sides to crop with a pipebar delimited list of sides, for example:
"LEFT|RIGHT|TOP|BOTTOM" Leave empty or use "ALL" to crop all sides. |
When this Task is added the properties are static. To be able to build rules on a static properties see How To: Change A Static Property To A Dynamic Property.
Property Name | Example Rule | Example Result | Meaning |
---|---|---|---|
Source | "C:\MyDocuments\Content\Images\WorldGraphic.png" | C:\MyDocuments\Content\Images\WorldGraphic.png | This is the Full File Path and Name including extension to the source file to use. |
Destination | FsGetFullPath("<Specification>\ConvertedWorldGraphic.png") | C:\MyDocuments\Projects\Specifications\Spec 9999\ConvertedWorldGraphic.png | This is the location where the new file will be created. |
Constant Name | "DWConstantReport" | DWConstantReport | This is the name of the Constant that the Task will report to. |
Overwrite | TRUE | TRUE | TRUE will overwrite the file if it exists FALSE will not. |
Sides To Crop | "ALL" | ALL | Will crop all sides of the source image. |
The source image is 600 pixels wide by 450 pixels high.
This image is now 221 pixels wide by 221 pixels high.