Synopsis

PDX_MSGT gcr_RectTrimSurf(long option, MDA_PTR orig_db_ptr, PDX_BOOL u_sense, PDX_BOOL v_sense, double u0, double u1, double v0, double v1, MDA_PTR surf_ptr, int gdx_model, MDA_PTR *gdx_RTS_ptr)

Purpose

Create a GDX Rectangular Trimmed Surface.

Description

Given the GDX surface entity database pointers and the UV trim parameters, creates the GDX Rectangular Trimmed Surface entity.

The GDX surface entity (gdx_db_ptr_surf) must be a valid GDX surface entity.

The UV trim parameters must be within the parametric bounds of the GDX surface.

The parametric range of the GDX trim is the parametric range of the subordinate GDX surface 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 this routine only sets original database pointer of the resulting GDX Rectangular Trimmed Surface and does not set the original database pointer for the GDX Surface surf_ptr. It is assumed that the original database pointer for the GDX Surface entity has already been properly set.

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

u_sense

PDX_TRUE

directions agree

PDX_FALSE

directions disagree

v_sense

PDX_TRUE

directions agree

PDX_FALSE

directions disagree

u0

The starting U parameter value (Must be in the U parametric domain)

u1

The ending U parameter value (Must be in the U parametric domain and > U0)

v0

The starting U parameter value (Must be in the V parametric domain)

v1

The ending U parameter value (Must be in the V parametric domain and > V0)

surf_ptr

The database pointer of the GDX surface entity to be trimmed

gdx_model

The GDX Rectangular Trimmed Surface entity model for creation

Output

gdx_RTS_ptr

The database pointer of the resulting GDX Rectangular Trimmed Surface entity

Tolerances

      PARM_SPACE_PNT_TOL
      .fi

Return

      GCR_NOERR
      GCR_INVALID_MODEL
      GCR_TRIM_SURF_U_PARMS
      GCR_TRIM_SURF_V_PARMS
      Low level error return
      .fi