Circular Crop Image (DriveWorks Documentation)

Circular Crop Image

This Specification Macro Task will crop an image into a circular shape for which you can control the radius.

You can control the radius of the circle but you will have to make sure that this circle is within the boundary of the source image.

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 crop, 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.
Radius	The Radius of the circle to crop in pixels.

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>\CroppedWorldGraphic.png")	C:\MyDocuments\Projects\Specifications\Spec 9999\CroppedWorldGraphic.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.
Radius	255	255	This will crop the image to the radius of 255.

This is the source image that will be used.

This image is 600 pixels wide by 450 pixels high.

The maximum radius we can use to crop the image while still being in the image boundary is 450/2 = 225 pixels.

The cropped image can be seen below.