Previous Next Up Title Contents Index Functions Index Top Library

OPEN (NON-RETAINED) STRUCTURE

PXOPEN_NR_STRUCT


CALL SEQUENCE

void pxopen_nr_struct ()

EFFECT

Open the non-retained structure.

The non-retained structure is opened and the structure state becomes STNOP (non-retained structure open).

The non-retained structure inherits its attribute values from the PHIGS state list. When the non-retained structure is opened, these values correspond to the defaults stored in the PHIGS description table.

Consider the following example. When the non-retained structure is first opened, the polyline color index is 1, corresponding to color white. If the application changes the polyline color index to 2, that value is stored in the PHIGS state list and subsequent polylines will be red. If the application closes the non-retained structure and later re-opens it, subsequent polylines will be white again.

The non-retained structure cannot be edited, except to add new structure elements at the end. Conceptually, the element pointer always points to the last element in the non-retained structure.

Non-retained primitives are never displayed unless the non-retained structure is posted to one or more workstations. If HLHSR is not in use, these primitives are displayed immediately and are removed by regeneration. If HLHSR is in use, primitives may be stored for some time prior to display, depending on the HLHSR mode. See Set HLHSR Mode (routine pset_hlhsr_mode) for details.

ERRORS

6
Ignoring function, function requires state STCL.

SEE ALSO

Close non-retained structure, see pxclose_nr_struct

Close retained structure, see pclose_struct

Open retained structure, see popen_struct

Post/unpost non-retained structure, see pxpost_nr_struct, pxunpost_nr_struct

Post/unpost retained structure, see ppost_struct, punpost_struct

Inquire open structure, see pinq_open_struct

Inquire structure identifiers, see pinq_struct_ids

Inquire structure state value, see pinq_struct_st

Inquire structure status, see pinq_struct_status


Previous Next Up Title Contents Index Functions Index Top Library