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

MESSAGE (PHOP,WSOP,*,*)

Purpose

Use Message to display a message on the specified workstation.

The message text appears in the lower left corner of the workstation viewport and the graPHIGS API clips the message text to this viewport.

Deferral state settings do not affect the message. The message remains displayed until removed by another message. Clear the message by calling Message with a length of zero.

The appearance (size and color) of the message text is workstation dependent. The graPHIGS API uses the workstation's primary character set to convert the text if necessary.

For more details, refer to the specificc device-support information in The graPHIGS Programming Interface: Technical Reference.

Language Bindings

C

pmessage (ws_id, message);

Input Parameters
Pint ws_id
Workstation identifier

const char *message
Message string to be displayed.

FORTRAN

pmsg (wkid, mess)

Input Parameters

integer wkid
Workstation identifier

character*(*) mess
Message string to be displayed.

FORTRAN Subset

pmsgs (wkid, lstr, mess)

Input Parameters

integer wkid
Workstation identifier

integer lstr
Length of the message string in characters.

character*(*) mess
Message string to be displayed.

Errors

3
FUNCTION REQUIRES STATE (PHOP,WSOP,*,*)
54
SPECIFIED WORKSTATION IS NOT OPEN

Related Subroutines

None


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