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

GPEPPK - Set Element Pointer at Pick Identifier

GPEPPK (pickid)

Purpose

Use GPEPPK to set the element pointer to the specified Set Pick Identifier structure element within the open structure.

Starting with the position following the element pointer, the graPHIGS API searches for the first occurrence of the specified pickid If the end of the structure is reached, the system continues the search at element 1. If the specified pickid is not found, an error is generated.

Note: This subroutine is not processed by the nucleus right away. It is processed by the nucleus when the next subroutine call is issued that forces requests to be sent to the nucleus. See The graPHIGS Programming Interface: Understanding Concepts for a discussion on when requests are sent to the nucleus for processing.

Parameters

pickid -- specified by user, fullword integer

Pick identifier.

Error Codes

4
FUNCTION REQUIRES STATE STOP
566
PICK IDENTIFIER DOES NOT EXIST IN THE OPEN STRUCTURE

Related Subroutines

GPEPPG
Generalized Set Element Pointer at Pick Identifier
GPPKID
Set Pick Identifier

RCP code

201332228 (X'0C001604')


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