Dimension Arc Functions

Functions to create, modify, and query dimension arc objects, including origin, radius, sweep, and text attributes.

MTK_Object_DimensionArc_GetAttributes()

Get the attributes of a dimension arc object.

Signature 
int MTK_Object_DimensionArc_GetAttributes(
    MTK_Object* obj,
    char* label, double* tickGap,
    double* tickOffset, double* tickExtentSize,
    double* arrowLength, double* arrowWidth
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • label: Buffer of length MTK_BUFFER_SIZE to receive the label of the dimension arc.
  • tickGap: Tick gap.
  • tickOffset: Tick offset.
  • tickExtentSize: Tick extent size.
  • arrowLength: Length of the arrow head.
  • arrowWidth: Width of the arrow head.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_GetOrigin()

Get the origin location of a dimension arc object (the center of the arc).

Signature 
int MTK_Object_DimensionArc_GetOrigin(
    MTK_Object* obj,
    double* x, double* y, double* z
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • x: Origin x value.
  • y: Origin y value.
  • z: Origin z value.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_GetRadius()

Get the radius location of a dimension arc object (the start of the arc).

Signature 
int MTK_Object_DimensionArc_GetRadius(
    MTK_Object* obj,
    double* x, double* y, double* z
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • x: Radius x value.
  • y: Radius y value.
  • z: Radius z value.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_GetSweep()

Get the sweep location of a dimension arc object (the end of the arc).

Signature 
int MTK_Object_DimensionArc_GetSweep(
    MTK_Object* obj,
    double* x, double* y, double* z
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • x: Sweep x value.
  • y: Sweep y value.
  • z: Sweep z value.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_GetTextAttributes()

Get the attributes of the text on a dimension arc object.

Signature 
int MTK_Object_DimensionArc_GetTextAttributes(
    MTK_Object* obj,
    char* font, char* scale,
    double* height,
    MTK_Object_TextVertPos* textLocation
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • font: Buffer of length MTK_BUFFER_SIZE to receive the font of the text.
  • scale: Buffer of length MTK_BUFFER_SIZE to receive the scale of the text.
  • height: Height of the text.
  • textLocation: Location of the text relative to the dimension arc.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_SetAttributes()

Set the attributes of a dimension arc object.

Signature 
int MTK_Object_DimensionArc_SetAttributes(
    MTK_Object* obj,
    const char* label, const double& tickGap,
    const double& tickOffset, const double& tickExtentSize,
    const double& arrowLength, const double& arrowWidth
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • label: Label of the dimension arc.
  • tickGap: Tick gap.
  • tickOffset: Tick offset.
  • tickExtentSize: Tick extent size.
  • arrowLength: Length of the arrow head.
  • arrowWidth: Width of the arrow head.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_SetOrigin()

Set the origin location of a dimension arc object (the center of the arc).

Signature 
int MTK_Object_DimensionArc_SetOrigin(
    MTK_Object* obj,
    const double& x,
    const double& y,
    const double& z
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • x: Origin x value.
  • y: Origin y value.
  • z: Origin z value.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_SetRadius()

Set the radius location of a dimension arc object (the start of the arc).

Signature 
int MTK_Object_DimensionArc_SetRadius(
    MTK_Object* obj,
    const double& x,
    const double& y,
    const double& z
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • x: Radius x value.
  • y: Radius y value.
  • z: Radius z value.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_SetSweep()

Set the sweep location of a dimension arc object (the end of the arc).

Signature 
int MTK_Object_DimensionArc_SetSweep(
    MTK_Object* obj,
    const double& x,
    const double& y,
    const double& z
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • x: Sweep x value.
  • y: Sweep y value.
  • z: Sweep z value.
Returns

0 on success; any other value indicates failure.

MTK_Object_DimensionArc_SetTextAttributes()

Set the attributes of the text on a dimension arc object.

Signature 
int MTK_Object_DimensionArc_SetTextAttributes(
    MTK_Object* obj,
    const char* font, const char* scale,
    const double& height,
    const MTK_Object_TextVertPos& textLocation
    );
Parameters
  • obj: Pointer to an MTK_Object struct.
  • font: Font of the text on the dimension arc.
  • scale: Scale of the text on the dimension arc.
  • height: Height of the text on the dimension arc.
  • textLocation: Location of the text relative to the dimension arc.
Returns

0 on success; any other value indicates failure.