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
Error Codes
Related Subroutines
RCP code
201331722 (X'0C00140A')