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

GPDFM - Set Data Filtering Method

GPDFM (minfm, magfm, boundu, boundv)

Purpose

Use GPDFM to insert a Set 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 filtering methods that the graPHIGS API uses to perform data mapping on subsequent area primitives. When the data mapping method is 2=SINGLE_VALUE_UNIFORM , the boundv parameter is ignored.

The traversal default 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

GPBDFM
Set Back Data Filtering Method
GPDMR
Set Data Mapping Representation

RCP code

201343515 (X'0C00421B')


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