Synopsis

PDX_MSGT gcr_EllipticalConic(long option, MDA_PTR orig_db_ptr, MTH_2DPNT xy_trans, double z_depth, double radius_1, double radius_2, double t0, double t1, double angle, GDX_MATRIX gdx_matrix, int gdx_model, MDA_PTR *gdx_conic_ptr)

Purpose

Create a GDX Conic (ellipse).

Description

This function given a 2D xy translation point, a z depth, two radii, a parametric start value (t0), and a parametric end value (t1) creates an elliptical GDX Conic 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. Note that illegal values for t0 are allowed and will be corrected (using periodicity) to satisfy the rules below.

\fBRules\fR .IP • 3 0.0 < radius_1 .IP • 3 0.0 < radius_2 .IP • 3 Parameter values measured counterclockwise .IP • 3 0 <= t0 < MTH_2_PI .IP • 3 t0 < t1 <= t0 + 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_trans

The 2D XY translation, or NULL.

z_depth

The depth of the ellipse along the Z axis.

radius_1

The first radius of the ellipse (along x axis in definition space)

radius_2

The second radius of the ellipse.

t0

The start parameter value (0.0 <= t0 <= MTH_2_PI)

t1

The end parameter value (t0 < t1 <= t0 + MTH_2_PI)

angle

The rotation angle, in radians, of the GDX Conic relative to standard position.

gdx_matrix

GDX rotation matrix, or NULL.

gdx_model

The GDX model for entity creation

Output

gdx_conic_ptr

Entity database pointer of the GDX Conic (ellipse)

Tolerances

      GDX ZERO_TOL
      GDX PARM_SPACE_PNT_TOL
      .fi

Return

      GCR_NOERR
      GCR_INVALID_MODEL
      GCR_ELLIPSE_RADIUS_1
      GCR_ELLIPSE_RADIUS_2
      GCR_ELLIPSE_T0
      GCR_ELLIPSE_T1
      Low level error return
      .fi