# 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