Synopsis
Creates an angular dimension object. The positioning of dimensions is based on the local X-Y plane. The AngularDimension itself can be positioned, or it can rely on its parent. The points that are referenced need not be in the dimension plane. Placement of text, arrows, dimension and extension lines is currently automatic. Text will be placed inside the extension lines if possible, and arrows will also be placed inside if possible. When things don't fit, the location parameter can be used to control on which side the dimension falls.
Note: Note that many of the controls for dimensions are part of DimensionTextMixin and InkDimensionMixin.
Mixins
DimensionTextMixin
InkDimensionMixin
Canonicals
| Name | Type | Description |
|---|---|---|
| vertexPoint | point | Angle vertex point |
| fromPoint | point | Starting point of the angle |
| toPoint | point | Ending point of the angle |
| location | point | Point used to determine a radial distance at which to locate the dimension; cannot be coincident with fromPoint or toPoint. |
Parameters
| Name | Type | Description |
|---|---|---|
| fromLine | part | Starting line from which to measure the angle |
| fromLineEnd? | boolean | Specifies if the end of the fromLine should be used to position the starting extension line; the default value is True. |
| toLine | part | Ending line for measuring the angle |
| toLineEnd? | boolean | Specifies if the end of the toLine should be used to position the ending extension line; the default value is True. |
| freePointDirection | vector | Direction from the toPoint or fromPoint to establish the second line. |
| charHeight | number | Height of the dimension text. Default is 0.25 |
| textLocation | name | Determines where the text is located with respect to the extension lines. Default is :Auto. Choices include :Auto, :Inside, :Outside, and :UseLocation. |
| textSide | name | Determines to which side the text will be placed when textLocation is :Outside. Default is :ToSide. Choices include :FromSide, :ToSide. |
| dimLineLocation | name | Determines whether the dimension lines are inside or outside the extension lines. Default is :Auto. Choices include :Auto, :Inside, :Outside. |
| dimLineFrom? | boolean | Specifies whether to show the from-side dimension line. Default is True. |
| dimLineTo? | boolean | Specifies whether to show the to-side dimension line. Default is True. |
| extLineFrom? | boolean | Specifies whether to show the from-side extension line. Default is True. |
| extLineTo? | boolean | Specifies whether to show the to-side extension line. Default is True. |
| useExtraLine? | boolean | Controls whether a dimension line appears between the extension lines when the dimension text is outside the extension line. Default is True. |
Rules
| Name | Type | Description |
|---|---|---|
| measurement | number | Calculated value for the dimension. This is an unrounded, double precision number. |
| dimCircle | part | An arc with its origin at the projectedVertexPoint and radius equal to the locationRadius. The arc starts at the dimCenter and lies in the XY (Z=0) plane with a topDirection of the local unitZ vector. |
| dimCenter | point | A point midway between the toLine and fromLine at distance from the projectedVertexPoint equal to the locationRadius. |
| dimCenterVector | vector | Vector from the projectedVertexPoint to the dimCenter point. |
| dimCenterTangent | vector | Vector tangent to the dimCircle at the dimCenter point. |
| extLineToVector | vector | Vector from the projectedVertexPoint towards the toPoint. |
| extLineFromVector | vector | Vector from the projectedVertexPoint towards the fromPoint. |
| projectedFromPoint | point | The fromPoint projected into the XY (Z=0) plane. |
| projectedToPoint | point | The toPoint projected into the XY (Z=0) plane. |
| projectedLocation | point | The location point projected into the XY (Z=0) plane. |
| projectedVertexPoint | point | The vertexPoint projected into the XY (Z=0) plane. |
| locationRadius | number | Distance from the projectedVertexPoint to the projectedLocation. |
| extLineFromStart | point | Start point on the extension line associated with the fromPoint. |
| extLineToStart | point | Start point on the extension line associated with the toPoint. |
| extLineFromEnd | point | End point on the extension line associated with the fromPoint. |
| extLineToEnd | point | End point on the extension line associated with the toPoint. |
| dimLineFromEnd | point | End point on the dimension line nearest the fromPoint. |
| dimLineToEnd | point | End point on the dimension line nearest the toPoint. |
| dimLineFromStart | point | Start point on the dimension line nearest the toPoint. |
| dimTextCenter | point | Actual center of the dimension text. |
| dimAlternateCenter | point | Actual center of the dimension text. If the alternate dimension text is on the same line as the dimension text, then this will be the same point as dimTextCenter. |
| dimLinesOutside? | boolean | Returns True if the dimension lines are actually on the outside of the extension lines. |
Group Rules
<<fromLine fromLineEnd? toPoint freePointDirection>>
<<toLine toLineEnd? fromPoint freePointDirection>>
<<fromLine toLine fromLineEnd? toLineEnd?>> The vertexPoint is determined from the intersection of the fromLine and toLine and the toPoint and fromPoint are determined using either the start or end of each line depending on the fromLineEnd? and toLineEnd? values.
see DimensionTextMixin , and InkDimensionMixin for a complete set of Canonicals, Parameters, Rules, Methods, and Group Rules.
See Also: DimensionTextMixin
and InkDimensionMixin
Example 1
| Name: | angularDimension_Ex01 |
| Design: | Annotations AcDrawingDocument |
| Child Name: | triangle | |
| Child Design: | :Polygon | |
| Name | Type | Supplied |
| pointList | list | {point(0,0,0), point(0,4,0), point(-3,5,0)} |
| color | string | "blue" |
| lineWidth | string | "Heavy" |
| Child Name: | AngularDimension_1 | |
| Child Design: | :AngularDimension | |
| Name | Type | Supplied |
| fromLine | part | first(triangle.lines) |
| location | point | third(triangle.pointList) + unitY * 1 |
| toLine | part | third(triangle.lines) |
| toLineEnd? | boolean | False |
Example 2
| Name: | AngularDimension_Ex02 |
| Design: | Annotations AcDrawingDocument |
| Child Name: | triangle | |
| Child Design: | :Polygon | |
| Name | Type | Supplied |
| pointList | list | {point(0,0,0), point(0,4,0), point(-3,5,0)} |
| color | string | "blue" |
| lineWidth | string | "Heavy" |
| Child Name: | AngularDimension_1 | |
| Child Design: | :AngularDimension | |
| Name | Type | Supplied |
| fromPoint | point | second(triangle.pointList) |
| location | point | third(triangle.pointList) + unitY * 1 |
| toPoint | point | third(triangle.pointList) |
| vertexPoint | point | first(triangle.pointList) |
Example 3
| Name: | AngularDimension_Ex03 |
| Design: | Annotations AcDrawingDocument |
| Child Name: | triangle | |
| Child Design: | :Polygon | |
| Name | Type | Supplied |
| pointList | list | {point(0,0,0), point(0,4,0), point(-3,5,0)} |
| color | string | "blue" |
| lineWidth | string | "Heavy" |
| Child Name: | AngularDimension_1 | |
| Child Design: | :AngularDimension | |
| Name | Type | Supplied |
| fromLine | part | first(triangle.lines) |
| location | point | third(triangle.pointList) + unitY * 1 |
| toLine | part | third(triangle.lines) |
| toLineEnd? | boolean | False |
| textAlignment | name | :Horizontal |
| textLocation | name | :Outside |
| textSide | name | :FromSide |
| ArrowSize | number | child.charHeight |