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

GPWDO - Workstation-Dependent Output

GPWDO (length, data)

Purpose

Use GPWDO to insert a Workstation-Dependent Output structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Workstation-Dependent Output structure element depending on the current edit mode.

During structure traversal, the workstation performing the traversal outputs the data directly. The graPHIGS API does not check the validity of the data. It is the application's responsibility to ensure that the data is valid (e.g., proper length(s), identifiers, padding, etc.) When character encoding, floating-point, and/or byte ordering differences exist between the target workstation and the application environment, the application must ensure the validity of this data also. For information on how the application can ensure the validity of this data, see the Convert Data (GPCVD) subroutine.

Currently, this subroutine is only supported by CGM workstations. This subroutine is ignored on all other workstations. For more information on CGM data, see "CGM Workstation" in The graPHIGS Programming Interface: Technical Reference

GPWDO is identified as GSE 1010.

Note:

Not all GSEs are supported on all workstations. Use the Inquire List of Generalized Structure Elements (GPQGSE) inquiry subroutine to determine the GSEs supported by an open workstation. See also the workstation descriptors in The graPHIGS Programming Interface: Technical Reference

Parameters

length -- specified by user, fullword integer

Length of output data in bytes (>=0)

data -- specified by user, variable length data

Data that the application sends as output to the workstation.

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
509
DATA LENGTH VALUE < ZERO OR REQUIRED LENGTH
2050
INSUFFICIENT DATA LEN n1 FOR CGM WDO
2051
DATA LEN n1 > 32771 FOR CGM WDO
2052
DATA LEN n1 <> ENCODED LEN n2 + HDRSZ n3 IN CGM WDO - USING ENCODED LEN

Related Subroutines

GPCVD
Convert Data
GPQNCE
Inquire Nucleus Environment

RCP code

201331722 (X'0C00140A')



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