POST STRUCTURE

PPOST_STRUCT

CALL SEQUENCE

void ppost_struct(

Pint	ws_id	/* workstation identifier	*/
Pint	struct_id	/* structure identifier	*/
Pfloat	priority	/* priority	*/

)

PHIGS STATE

EFFECT

The POST STRUCTURE function associates the struct_id structure and its network to a workstation.

The priority value defines the priority of the structures during display. The smaller priority's value is, the greater the display priority. Predefined values are described as follow :

#define PSTRUCT_LOWEST_PRIORITY 0.0

#define PSTRUCT_HIGHEST_PRIORITY 1.0

struct_id is added to the table of posted structures in the workstation state list.

If the structure does not exist, it is automatically created.

Depending on the update states (SET DISPLAY UPDATE STATE), the specified network can be displayed immediately using a device dependent technique. See the device description manual for more details.

ERRORS

3

Ignoring function, function requires state (PHOP, WSOP,*,*)

54

Ignoring function, the specified workstation is not open

59

Ignoring function, the specified workstation does not have output capability (i.e. the workstation category is neither OUTPUT, OUTIN, nor MO)

208

Ignoring function, the display priority is out of range

SEE ALSO

unpost structure, unpost all structures, update workstation, redraw all structures, set display update state, inquire structure identifiers, inquire structure status, inquire posted structures, post structure on view (ext)