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

GPDMI - Set Data Mapping Index

GPDMI (index)

Purpose

Use GPDMI to insert a Set Data Mapping Index 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 Mapping Index structure element, depending upon the current edit mode.

During traversal, the data mapping index specifies the entry in the data mapping table used to perform data mapping on subsequent primitives that are to be data mapped.

The data mapping table is zero based. Entry zero always contains a data mapping entry of 1=DM_METHOD_COLOR Use GPQWDT to determine the number of definable data mapping table entries.

The traversal default data mapping index is zero. If the specified index is not supported on the workstation, then graPHIGS API uses a default index of zero.

Parameters

index -- specified by user, fullword integer

Data mapping table index (>= 0).

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
630
DATA MAPPING INDEX < ZERO

Related Subroutines

GPBDMI
Set Back Data Mapping Index
GPDMR
Set Data Mapping Representation

RCP code

201343513 (X'0C004219')


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