Home Search

DriveWorks Pro 21
Rectangular Crop Image

Send Feedback

Rectangular Crop Image

This Specification Macro Task will crop an image into a rectangular shape. You can choose where to crop by defining the position of the top left corner as well as the width and height of the rectangle to crop.

You will have to make sure that the rectangular shape you want to crop is within the boundary of the Source image.

Properties

Property NameDescription
TitleChanges the Title (not the name) of the task.
SourceThe Full File Path and Name of the Source image file to crop, including its extension.
DestinationThe Full File Path and Name of the image file to create, including its extension.
Constant NameThe 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.
OverwriteTRUE to overwrite an existing image, FALSE to keep the existing image.
Left PointThe left value of the rectangle to crop in pixels.
Top PointThe top value of the rectangle to crop in pixels.
WidthThe new width of the image in pixels.
HeightThe new height of the image in pixels.

Example

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 NameExample RuleExample ResultMeaning
Source"C:\MyDocuments\Content\Images\WorldGraphic.png"C:\MyDocuments\Content\Images\WorldGraphic.pngThis is the Full File Path and Name including extension to the source file to use.
DestinationFsGetFullPath("<Specification>\CroppedWorldGraphic.png")C:\MyDocuments\Projects\Specifications\Spec 9999\CroppedWorldGraphic.pngThis is the location where the new file will be created.
Constant Name"DWConstantReport"DWConstantReportThis is the name of the Constant that the Task will report to.
OverwriteTRUETRUETRUE will overwrite the file if it exists FALSE will not.
Left Point240240This is the distance in pixels from the left side of the image.
Top Point125125This is the distance down from the top side of the image.
Width255255This is the width in pixels of the new image.
Height320320this is the height in pixels of the new image.

The co-ordinates for the crop are indicated in the image below:

Source Image

This is the source image that will be used.

Source image that is used for the example

This image is 600 pixels wide by 450 pixels high.

Result

The image below shows the created image of the source image which was cropped.