How to add your knowledge

Angular Dimension <AngularDimension>

    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.

    NoteNote 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
    NameTypeSupplied
    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
    NameTypeSupplied
    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
    NameTypeSupplied
    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
    NameTypeSupplied
    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
    NameTypeSupplied
    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
    NameTypeSupplied
    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