AcDbDiametricDimension::AcDbDiametricDimension

C++

AcDbDiametricDimension(
    const AcGePoint3d& chordPoint, 
    const AcGePoint3d& farChordPoint, 
    double leaderLength, 
    const ACHAR * dimText = NULL, 
    AcDbObjectId dimStyle = AcDbObjectId::kNull
);

Description

This constructor uses the parameters passed in to initialize the dimension. In addition, the rest of the AcDbDimension, AcDbEntity, and other default constructor initializations are performed.

If the text is inside the curve being dimensioned, then the dimension line will be drawn from the farChordPoint to the chordPoint, with a break for the annotation text.

If the dimension text is outside the curve being dimensioned, then the dimension line is drawn from the farChordPoint, on through the chordPoint, and out the leaderLength distance past the chordPoint, where it will do a short horizontal dogleg (if appropriate) to the annotation text.

A copy of the dimText string will be used by the dimension.

The dimText string will need to contain any desired multiline text formatting characters. The substring "<>" may be used anywhere within the string as a marker to indicate that the default text should be displayed there in place of the "<>". (It is possible to have more than one set of "<>" in the text string, but only the first set will be interpreted as the default text place holder.)

If dimText is NULL, then when the dimension is closed, the dimension text string will be set to an empty string and the default dimension text (that is, a text string automatically generated based on the dimStyle, dimVar settings, and the actual measurement of the angle) will be used.

If dimStyle is left as AcDbObjectId::kNull, then the object ID of the current default dimStyle within the AutoCAD editor will be used.

chordPoint (one diametrical chord point on the curve) is used for DXF group code 15.

farChordPoint (the curve center point) is used for DXF group code 10.

leaderLength is used for DXF group code 40.

dimText (the dimension annotation text) is used for DXF group code 1.

The name string within the dimension style specified by dimStyle is used for DXF group code 3.

Parameters

Links

AcDbDiametricDimension