ESCAPE -12(3P) — SUNPHIGS LIBRARY

NAME

ESCAPE -12 − inquire predefined extended text representation fonts

SYNOPSIS

C Syntax

void
pescape ( func_id, in, out )
Pintfunc_id;escape function identifier
Pescapein∗in;input data for the function
Pescapeout∗out;OUT output data of the function

FORTRAN Syntax

SUBROUTINE pesc ( FCTID, LIDR, IDR, MLODR, LODR, ODR )
INTEGERFCTIDfunction identification
INTEGERLIDRdimension of input data record array
CHARACTER∗80IDR(LIDR) input data record
INTEGERMLODRmaximum length of output data record
INTEGERLODROUT number of array elements used in ODR
CHARACTER∗80ODR(MLODR) OUT output data record

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

ESCAPE -12 returns the fonts for codesets 1 through 3 of a predefined extended text representation.

C Input Parameters

func_id
The function identifier for this escape is PUESC_INQ_PRE_EXT_TEXT_REP_FONTS, which is defined in phigs.h to be -12.

in
A pointer to a Pescapein union containing the input data record uesc12_idatarec. It is defined as:

typedef struct {
Pwstypewst;/∗ workstation type identifier ∗/
Pintindex;/∗ text bundle index ∗/
} Puesc0012_idatarec;

wstThe identifier of the workstation type for which the text representation is being inquired.

indexThe text index of the entry being inquired.

The fields in this record correspond to the input parameters to INQUIRE PREDEFINED TEXT REPRESENTATION.

C Output Parameters

outA pointer to a Pescapeout union containing the output data record, uesc12_odatarec. It is defined as:

typedef struct {
Pinterror_ind;/∗ error indicator ∗/
Pefbundlrep;/∗ extended fonts text representation ∗/
} Puesc0012_odatarec;

error_ind
The error indicator. See the Errors section below for possible values.

repA structure containing the attribute values defining the multiple text representation. Pefbundl is defined as:

typedef struct {
Pintfont[3];/∗ Fonts for codesets 1 to 3 ∗/
} Pefbundl;

The fields in this record correspond to the output parameters to INQUIRE PREDEFINED TEXT REPRESENTATION except that a different part of the representation is being returned.

FORTRAN Input Parameters

FCTID
The function identifier of this escape is PUESCQPREXTXRPFT which is defined in phigs77.h to be -12.

LIDR
The dimension of IDR (returned by PACK DATA RECORD).

IDR(LIDR)
An ESCAPE data record packed by PACK DATA RECORD called with these arguments:

ILThe number of integers = 2.

IAContains two integer values.

Element 1 is the workstation type identifier.

Element 2 is the text bundle index.

RLThe number of real values = 0.

SLThe number of strings = 0.

MLODR
The maximum length of the output data record, ODR.

FORTRAN Output Parameters

LODRThe length used in the output data record array, ODR.

ODR(MLODR)
The output data record is stored in this array. It may unpacked using UNPACK DATA RECORD, the resulting fields should be returned:

ILThe number of integers = 3.

IAContains three integer values.

Elements 1 through 3 are the fonts for codesets 1 through 3.

RLThe number of real values = 0.

SLThe number of strings = 0.

Execution

The Inquire Predefined Extended Fonts Text Representation escape returns the extended fonts section of a predefined extended text representation on the specifed workstation type. The complete text representation has the following fields:

font for codeset 0font in the normal text representation
font for codeset 1an internationalization extension
font for codeset 2an internationalization extension
font for codeset 3an internationalization extension
text precision
character expansion factor
character spacing
color index

This escape returns the extended fonts section of this representation. The other values can be inquired using INQUIRE PREDEFINED TEXT REPRESENTATION.

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

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

351Ignoring function, one of the fields within the escape data record is in error

Museum