Previous Next Up Title Contents Index Functions Index Top Library

LABEL

PLABEL


CALL SEQUENCE

void plabel(
)

PHIGS STATE

(PHOP, *, STOP, *).

EFFECT

A LABEL element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on edit mode. Element pointer then points to the LABEL element. The value specified by label_id is associated with the element.

The labels are used to mark positions in the structure. The functions which use labels are SET ELEMENT POINTER AT LABEL and DELETE ELEMENTS BETWEEN LABELS.

This type of element is not interpreted during traversal.

EXTENSION TO THE PHIGS STANDARD

If GPHIGS is in NRS mode, the effect of this function is different from the effect described in the standard.

In NRS mode, (see OPEN PIPE), the element is not stored in a structure. It is sent to the workstation on which the pipe is opened.

ERRORS

5
Ignoring function, function requires state (PHOP,*, STOP,*)

SEE ALSO

open structure, set edit mode, set element pointer, set element pointer at label, delete element between labels, offset element pointer, delete element, open pipe (ext), inquire current element content, inquire current element type and size


Previous Next Up Title Contents Index Functions Index Top Library