[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPBDFM - Set Back Data Filtering Method

GPBDFM (minfm, magfm, boundu, boundv)

Purpose

Use GPBDFM to insert a Set Back Data Filtering Method structure element into the open structure following the element pointer, or to replace the element pointed at by the element pointer with a Set Data Filtering Method structure element, depending upon the current edit mode.

This element specifies the back data filtering method that the graPHIGS API uses to perform data mapping on back facing portions of subsequent area primitives.

If the face distinguish mode (GPFDMO) is 1=NONE , then the graPHIGS API uses the current data filtering method for data mapping on the front and back facing portions of area primitives. If the face distinguish mode is 2=COLOR_SURFACE_PROPERTIES , then the graPHIGS API uses the specified back data filtering method for data mapping on only back facing portions of area primitives. When the data mapping method is 2=SINGLE_VALUE_UNIFORM , the graPHIGS API ignores the boundv parameter.

The traversal default back data filtering methods are:

Minification:
1=SAMPLE_IN_BASE
Magnification:
1=SAMPLE_IN_BASE
U-dimension:
1=CLAMP
V-dimension:
1=CLAMP

If any specified value is not supported on the workstation, then the default value is used.

Parameters

minfm -- specified by user, fullword integer

Minification filtering method (1=SAMPLE_IN_BASE, 2=INTERP_IN_BASE, 3=SAMPLE_IN_SQUARE_MM, 4=SAMPLE_IN_AND_INTERP_BTWN_SQUARE_MM, 5=INTERP_IN_SQUARE_MM, 6=INTERP_IN_AND_BTWN_SQUARE_MM, 7=SAMPLE_IN_RECT_MM, 8=SAMPLE_IN_AND_INTERP_BTWN_RECT_MM, 9=INTERP_IN_RECT_MM ).

magfm -- specified by user, fullword integer

Magnification filtering method (1=SAMPLE_IN_BASE, 2=INTERP_IN_BASE ).

boundu -- specified by user, fullword integer

U-dimension bounding method (1=CLAMP, 2=REPEAT ).

boundv -- specified by user, fullword integer

V-dimension bounding method (1=CLAMP, 2=REPEAT ).

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
631
FILTERING METHOD IS INVALID
632
BOUNDING METHOD IS INVALID

Related Subroutines

GPDFM
Set Data Filtering Method
GPDMR
Set Data Mapping Representation

RCP code

201343516 (X'0C00421C')


[ Previous | Next | Contents | Glossary | Home | Search ]