The Set Annotation by Percentage Position Generation Task sets the XY position of an annotation.
Prior to DriveWorks 20, this appeared in the Toolbox as Set Annotation Position.
Existing implementations that use this Task will not be affected by this rename.
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 cause DriveWorks to 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, or the address if the view is not on the active sheet (for example Drawing View2@Sheet4). |
X Value | The new position of the annotation along the X axis (expressed as a percentage). |
Y Value | The new position of the annotation along the Y axis (expressed as a percentage). |
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 percentages. For example, X Value = 50, this will position the Annotation half way along the Drawing View or Sheet.
The ‘X Value’ and ‘Y Value’ properties accept negative values and values greater than 100.
The image below shows how positive and negative percentage values relate to a Drawing View.
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):