The Set Annotation Position by Distance Generation Task sets the XY position of an annotation.
We recommend applying this task in Post-Drive Tasks, Generation Sequence.
This ensures all views are resized and positioned before the Annotations are driven.
Property Name | Description |
---|---|
(Name) | The unique name for this task. |
Annotation Name | The name of the annotation to position. |
Axis | Specifies which axis to drive the annotation along. For example, specifying XOnly will only position the annotation along the X-axis and maintain the annotation's current Y position. |
Sheet or View Name | The name of the sheet (or view) the annotation belongs to. |
X Value | The relative distance between the anchor point and the annotation along the X axis. In document units, positive values = right, negative values = left. |
Y Value | The relative distance between the anchor point and the annotation along the Y axis. In document units, positive values = right, negative values = left. |
Reference | |
Reference Horizontal Anchor | The horizontal anchor of the view or sheet to position from. |
Reference Vertical Anchor | The vertical anchor of the view or sheet to position from. |
The following table shows examples of the ‘Annotation Name’ and ‘Sheet or View Name’ Properties for a range of possible SOLIDWORKS Drawing Annotations.
Type | SOLIDWORKS Address Style | DriveWorks 'Annotation Name' Property | DriveWorks 'Sheet or View Name' Property |
---|---|---|---|
Model Dimension (1) | D1@Sketch1@PartName.Part | D1@Sketch1@{Model File Name Result}.Part | Drawing View1@Sheet1 |
Reference Dimension (Model) | RD1@Annotations@PartName.Part | RD1@Annotations@{Model File Name Result}.Part | Drawing View1@Sheet1 |
Reference Dimension (Drawing) | RD1@Drawing View1@DrawingName.Drawing | RD1@Drawing View1@{Drawing File Name Result}.Drawing | Drawing View1@Sheet1 |
Balloon | DetailItem120 | DetailItem120 | Drawing View1@Sheet1 |
Balloon on a Magnetic Line | DetailItem120 | DetailItem120 | Drawing View1@Sheet1 |
Note (Attached to View) | DetailItem140 | DetailItem140 | Drawing View1@Sheet1 |
Note (Not Attached to View) | DetailItem140 | DetailItem140 | Sheet1 |
Note (Model) | DetailItem140 | DetailItem140 | Drawing View1@Sheet1 |
Weld Symbol (Drawing) | DetailItem150 | DetailItem150 | Drawing View1@Sheet1 |
Weld Symbol (Model) | DetailItem150 | DetailItem150 | Drawing View1@Sheet1 |
Hole Callout (Drawing) | RD1@Drawing View1@DrawingName.Drawing | RD1@Drawing View1@{Drawing File Name Result}.Drawing | Drawing View1@Sheet1 |
Geometric Tolerance (Drawing) | DetailItem160 | DetailItem160 | Drawing View1@Sheet1 |
Geometric Tolerance (Model) | DetailItem160 | DetailItem160 | Drawing View1@Sheet1 |
Datum Feature (Drawing) | DetailItem170 | DetailItem170 | Drawing View1@Sheet1 |
Datum Feature (Model) | DetailItem170 | DetailItem170 | Drawing View1@Sheet1 |
Surface Finish (Drawing) | DetailItem180 | DetailItem180 | Drawing View1@Sheet1 |
Surface Finish (Model) | DetailItem180 | DetailItem180 | Drawing View1@Sheet1 |
Datum Target (Drawing) | DetailItem190 | DetailItem190 | Drawing View1@Sheet1 |
Datum Target (Model) | DetailItem190 | DetailItem190 | Drawing View1@Sheet1 |
Revision Symbol | DetailItem200 | DetailItem200 | Drawing View1@Sheet1 |
Location Label | DetailItem210 | DetailItem210 | Drawing View1@Sheet1 |
(1) The SOLIDWORKS Address Style for Model Dimensions linked to Assemblies will take the form D1@Distance1@AssemblyName.Assembly.
The PartName or AssemblyName in this address refers to the file name of the part or subassembly that contains the Model Dimension.
Detail and Section Views
When Annotations are linked to a Detail or Section view, the following applies:
The View number (not the View name) is required in the address of the annotation.
For example:
RD1@Drawing View2@<DrawingName>.Drawing
The View number can be found by right clicking the View name from the SOLIDWORKS feature manager.
Alternatively to see the exact address, refer to How To Find The Annotation Name below.
The View Name is required.
For example:
Section View A-A@Sheet1
The above examples of the ‘Annotation Name’ and ‘Sheet or View Name’ Properties will work for single sheet or multi sheet SOLIDWORKS Drawings.
To find out the ‘Annotation Name’ of an Annotation you can use the DriveWorks Capture Pane inside SOLIDWORKS;
You do not need to Capture the Annotation to use the Set Annotation Position Generation Task
The Annotation Name Property can also end in .Assembly (if the Annotation is an Assembly dimension, such as a Distance Mate value) or .Drawing (if the annotation is a Reference Dimension).
The Part names in the Annotation Name Property need to be the final generated models file names, not the Master file names.
For example:
By default, DriveWorks gives each model the File Name Rule DWSpecification meaning that your models will generate with the following naming structure;
MasterName ProjectName 9999.SLDPRT
This means the Rule for the Annotation Name property would be;
"D1@Sketch1@MasterName " & DWSpecification &".Part"
The following are two further examples of potential Annotation Name property rules in combination with the related Model File Name Rules:
Example 1
Model File Name Rule => "*PartName-" & OrderNumberReturn
Annotation Name Property Rule => "D1@Sketch1@PartName-" & OrderNumberReturn &".Part"
Example 2
Model File Name Rule => "*" & DWSpecificationId & "*"
Annotation Name Property Rule => "D1@Sketch1@" & DWSpecificationId & " MasterName.Part"
For more information on Model File Name Rules: Concept: File Naming
The following is a description of DriveWorks behavior for each ‘Annotation Name’ Property value possibility.
Example 1
Annotation Name Property Rule Result = D1@Sketch1@{Model File Name Result}.Part
DriveWorks will use the full result to select the required Annotation.
Example 2
Annotation Name Property Rule Result = DetailItem110
DriveWorks will use the full result to select the required Annotation.
Example 3
Annotation Name Property Rule Result = RD1
DriveWorks will compare this with the name component of the address to select the required Annotation.
Example 4
Annotation Name Property Rule Result = RD1@Drawing View1@{Drawing File Name Result}.Drawing
DriveWorks will use the full result to select the required Annotation.
Once you have defined which Annotation you wish to position, you will need to define where to position the Annotation on the generated Drawing. You define this using the ‘X Value’ and the ‘Y Value’ properties.
The ‘Axis’ property determines which of the ‘X Value’ and ‘Y Value’ properties are used to position the Annotation.
Property Value | Result |
---|---|
Both | Will use both the ‘X Value’ and the ‘Y Value’ properties to position the Annotation |
XOnly | Will ignore the ‘Y Value’ property and will only position the Annotation in the X Axis |
YOnly | Will ignore the ‘X Value’ property and will only position the Annotation in the Y Axis |
The ‘X Value’ and ‘Y Value’ are expressed as a distance in the document units. For example, X Value = 50, this will position the Annotation 50mm from the anchor.
The ‘X Value’ and ‘Y Value’ properties accept negative values.
If an Annotation is not attached to a Drawing View, the ‘X Value’ and ‘Y Value’ are in relation to the entire sheet.
If an Annotation is attached to a Drawing View the ‘X Value’ and ‘Y Value’ are in relation to the Bounding box of the Drawing View.
This Task works best when placed in Post-Drive Tasks. All views will have been resized and repositioned before the Annotations are positioned.
This Task can be added to the following Generation Sequence(s):