This Specification Macro Task will draw lines in a new image.
| Property Name | Description |
|---|---|
| Title | Changes the Title (not the name) of the task. |
| 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. |
| Width | The new width of the image in pixels. |
| Height | The new height of the image in pixels. |
| An Array Of Lines | A Table of lines (start and end points, color, line weight and styles). |
| Texture File | Texture file used to infill the lines (sketch must be closed to apply). |
| Background Texture File | Background texture file. If left blank the background will be transparent. |
| Line Data Has Headers | TRUE to ignore the first data row, FALSE to include it. |
This property requires a Table Array with the different parameters for information about the line(s) to create. The information required relies on specific formatting. The Table items are:
| Table Item | Description |
|---|---|
| Start X | This is the start X coordinate. |
| Start Y | This is the start Y coordinate. |
| End X | This is the end X coordinate. |
| End Y | This is the end Y coordinate. |
| Color | This is the color of the lines to be created. |
| Style | 'Dashes' or 'Dots'. Use any other value, including leaving blank for a solid line. |
| Line weight | The thickness of the line(s) 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 |
|---|---|---|---|
| Destination | FsGetFullPath("<Specification>\LinesAddedWorldGraphic.png") | C:\MyDocuments\Projects\Specifications\Spec 9999\LinesAddedWorldGraphic.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. |
| Width | 600 | 600 | This is the width of the new image that will be created. |
| Height | 450 | 450 | This is the height of the new image that will be created. |
| An Array Of Lines | DwLookupAnArrayOfLines | DwLookupAnArrayOfLines | This is a Simple Table containing the data needed to create the different lines. |
| Texture File | "C:\MyDocuments\Content\WhiteBlank.PNG" | C:\MyDocuments\Content\WhiteBlank.PNG | This is the file to use as the background if the lines are closed into a polygon. Leaving this blank will make the fill transparent so the background will be shown. |
| Background Texture File | "C:\MyDocuments\Content\Images\MyPicture.png" | C:\MyDocuments\Content\Images\MyPicture.png | This is the file that will be used to create the background of the new image. |
| Line Data Has Headers | TRUE | TRUE | TRUE will ignore the Headers in your Points Of The Line(s) Table. Use FALSE for Tables with no headers. |
| Start X | Start Y | End X | End Y | Color | Style | Line Weight |
|---|---|---|---|---|---|---|
| 100 | 100 | 150 | 150 | #f70018 | Dot | 4 |
| 200 | 100 | 300 | 400 | #0014f7 | 8 |
This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.
Outputs are only available within Specification Macros. Currently Outputs are not available for Specification Flow.
This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs in the Task Node Outputs section of Specification Macros Task Node.
The status output navigation is as follows:
Success
Success with Warnings
Failed
See the Image PowerPack page for further Tasks.