INQUIRE TEXT FACILITIES(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE TEXT FACILITIES − inquire list of workstation text facilities

SYNOPSIS

C Syntax

void
pinqtextfacil ( type, length, start, error_ind, total_length, facilities )
Pwstypetype;workstation type
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint∗total_length;OUT length of list in PHIGS
Ptxfac∗facilities;OUT text facilities

FORTRAN Syntax

SUBROUTINE pqtxf ( WTYPE, N, ERRIND, NFPP, FONT, PREC, NCHH, MINCHH, MAXCHH,
NCHX, MINCHX, MAXCHX, NPTXI )
INTEGERWTYPEworkstation type
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNFPPOUT number of text font and precision pairs
INTEGERFONTOUT Nth element of list of text fonts
INTEGERPRECOUT Nth element of list of text precisions
INTEGERNCHHOUT number of available character heights
REALMINCHHOUT minimum character height (DC)
REALMAXCHHOUT maximum character height (DC)
INTEGERNCHXOUT number of available character expansion factors
REALMINCHXOUT minimum character expansion factor
REALMAXCHXOUT maximum character expansion factor
INTEGERNPTXIOUT number of predefined text indices

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE TEXT FACILITIES to obtain a list of the text facilities available on the specified workstation type.

C Input Parameters

typeWorkstation type.

lengthThe length is the number of text font and precision (fps) pairs which the facilities output parameter can return in the allocated memory space. A length of zero may be specified in order to have total_length return the total number of elements in the workstation list of available font and precision pairs.

startStarting position in the list of font and precision pairs in the workstation description table at which to begin the inquiry.

C Output Parameters

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

total_length
An integer pointer in which the system returns the total number of items in the list of available font and precision pairs on the workstation description table. This is the value required for length if all the items in the workstation list are to be returned.

facilities
A pointer to a Ptxfac data structure in which the system returns a listing of the text facilities available on this type of workstation. Ptxfac is defined in phigs.h as:

typedef struct {
Pintn_fps;/∗ number of fonts and precisions ∗/
Ptxfp∗fps;/∗ list of fonts and precisions ∗/
Pintheights;/∗ number of character heights ∗/
Pfloatmin_ht;/∗ minimum height ∗/
Pfloatmax_ht;/∗ maximum height ∗/
Pintexpansions;/∗ number of character expansion factors ∗/
Pfloatmin_exp;/∗ minimum expansion factor ∗/
Pfloatmax_exp; /∗ maximum expansion factor ∗/
Pintpredefined;/∗ number of predefined bundles ∗/

} Ptxfac;

The application must allocate memory for the text facilities list of fonts and precisions.

FORTRAN Input Parameters

WTYPE
Get the polymarker facilities for this workstation type.

NGet the Nth element from the list of font and precision pairs.

FORTRAN Output Parameters

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

NFPPThe number of available font and precision pairs.

FONTThe Nth font from the list of available font and precision pairs.

PRECThe Nth precision from the list of available font and precision pairs.

NCHHThe number of available character heights.

MINCHH
The minimum character height, in Device Coordinates (DC).

MAXCHH
The maximum character height, in (DC).

NCHXThe number of available character expansion factors.

MINCHX
The minimum character expansion factor.

MAXCHX
The maximum character expansion factor.

NPTXI
The number of predefined text indices.

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

Museum