INQUIRE PREDEFINED TEXT REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE PREDEFINED TEXT REPRESENTATION − inquire a predefined text representation for a workstation type

SYNOPSIS

C Syntax

void
pinqpredtextrep ( type, index, error_ind, bundle )
Pwstypetype;workstation type
Pintindex;predefined index
Pint∗error_ind;OUT error indicator
Ptxbundl∗bundle;OUT predefined text rep

FORTRAN Syntax

SUBROUTINE pqptxr ( WTYPE, PTXI, ERRIND, FONT, PREC, CHXP, CHSP, COLI )
INTEGERWTYPEworkstation type
INTEGERPTXIpredefined text index
INTEGERERRINDOUT error indicator
INTEGERFONTOUT text font
INTEGERPRECOUT text precision (PSTRP, PCHARP, PSTRKP)
REALCHXPOUT character expansion factor
REALCHSPOUT character spacing
INTEGERCOLIOUT text colour index

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE PREDEFINED TEXT REPRESENTATION to determine the predefined text representation for a specified workstation type at a given text index.

C Input Parameters

type
Type of workstation.

index
Entry to be returned from the workstation table of predefined text representations.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

bundleA pointer to a Ptxbundl structure, in which the system returns the text representation at index in the workstation table of predefined text representations. Ptxbundl is defined in phigs.h as:

typedef struct {
Pintfont;/∗ text font ∗/
Ptxprecprecision;/∗ text precision ∗/
Pfloatexp;/∗ character expansion factor ∗/
Pfloatspace;/∗ character spacing ∗/
Pintcolour;/∗ text colour index ∗/
} Ptxbundl;

Ptxprec is defined in phigs.h as:

typedef enum {
PPSTRING,
PPCHAR,
PPSTROKE
} Ptxprec;

FORTRAN Input Parameters

WTYPE
Type of workstation.

PTXI
Entry to be returned from the workstation table of predefined text representations.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

FONTThe text font at index PTXI in the workstation table of predefined interior representations.

PRECThe text precision at index PTXI in the workstation table of predefined interior representations. Valid values for the interior style are defined in phigs77.h as:

0PSTRPString
1PCHARPCharacter
2PSTRKPStroke

CHXPThe character expansion factor at index PTXI in the workstation table of predefined interior representations.

CHSPThe character spacing at index PTXI in the workstation table of predefined interior representations.

COLIThe text colour index at index PTXI in the workstation table of predefined interior representations.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

052Ignoring function, workstation type not recognized by the implementation

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

062Ignoring function, this information is not available for this MO workstation type

100Ignoring function, the bundle index value is less than one

102Ignoring function, the specified representation has not be predefined on this workstation

Museum