# Synopsis

PDX_MSGT gcr_Arc(long option, MDA_PTR orig_db_ptr, MTH_2DPNT xy_center, double z_depth, double radius, double start_angle, double end_angle, GDX_MATRIX gdx_matrix, int gdx_model, MDA_PTR *gdx_arc_ptr)

# Purpose

Create a GDX Parametric Circular Arc.

# Description

This function given a 2D xy_center, z depth, GDX rotation matrix, the radius of the arc, and the start and end angles in radians measured counterclockwise relative to a positive Z plane normal (ie. before the arc is rotated based on the plane normal), creates a GDX Parametric Circular Arc entity.

The orig_db_ptr argument should contain the database pointer of the entity that the new entity was created from (usually this should be obtained by the calling routine via mda_GetOrigDbptr) or MDA_NULL_PTR. See the mda_intro man page for more information about predecessor entities.

\fBRules\fR .IP • 3 radius > 0.0 .IP • 3 Angles measured counterclockwise in radians. .IP • 3 0 <= start_angle < MTH_2_PI .IP • 3 start_angle < end_angle <= start_angle + MTH_2_PI .LP

# Input

## option

### GCR_NOVALIDATE

No validation will occur on the input data

## orig_db_ptr

The original entities orig_db_ptr as obtained from the mda_GetOrigDbptr call, or MDA_NULL_PTR

## xy_center

The 2D XY arc center, or NULL

## z_depth

The depth of the arc along the Z axis

## radius

The radius of the arc

## start_angle

The start angle of the arc in radians

## end_angle

The end angle of the arc in radians

## gdx_matrix

GDX rotation matrix, or NULL

## gdx_model

The GDX model for entity creation

# Output

## gdx_arc_ptr

Entity database pointer of the GDX Parametric Circular Arc

# Tolerances

          GDX ZERO_TOL
          GDX ANGLE_TOL
          .fi

# Return

          GCR_NOERR
          GCR_INVALID_MODEL
          GCR_ARC_END_ANGLE
          GCR_ARC_ANGLE_DIFF
          GCR_ARC_RADIUS
          GCR_ARC_START_ANGLE
          Low level error return
          .fi