ESCAPE -10(3P) — SUNPHIGS LIBRARY

NAME

ESCAPE -10 − set 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, WSOP, ∗, ∗)

DESCRIPTION

Purpose

ESCAPE -10 sets the fonts section of the extended text representation for codesets 1 through 3.

C Input Parameters

func_id
The function identifier for this escape is PUESC_SET_EXT_TEXT_REP_FONTS which is defined in phigs.h to be -10.

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

typedef struct {
Pintws;/∗ workstation identifier ∗/
Pintindex;/∗ text bundle index ∗/
Pefbundlrep;/∗ extended font representation ∗/
} Puesc0010_idatarec;

The fields in this record correspond to the input parameters to SET TEXT REPRESENTATION except that a different section of the extended text representation is set.

wsThe identifier of the workstation for which the extended text representation is being defined.

indexThe text index of the entry being defined.

repA structure containing the font values for the extended text representation. Pefbundl is defined in phigs.h as follows:

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

C Output Parameters

There is no output data record for this ESCAPE.

FORTRAN Input Parameters

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

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

IDR(LIDR)
An ESCAPE data record, packed by PACK DATA RECORD with the following arguments:

ILThe number of integers = 5.

IAContains five integer values.

Element 1 is the workstation identifier.

Element 2 is the text bundle index

Elements 3 through 5 set the fonts for codesets 1 through 3. See the Set Font for Codeset section of GENERALIZED STRUCTURE ELEMENT for the valid values.

RLThe number of real values = 0.

SLThe number of strings = 0.

FORTRAN Output Parameters

There is no output data record for this ESCAPE.

Execution

The Set Extended Text Representation Fonts escape sets the extension fonts fields of an extended text representation, leaving the other fields of the text representation unchanged. The complete text representation now contains the following fields:

font for codeset 0font in 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
text colour index

This escape is used to set only the new fields. The font for codeset 0 field is set by the font field in the normal text representation. The font for codeset 0, text precision, character expansion factor, character spacing and text colour index fields can only be set by SET TEXT REPRESENTATION. The font fields for codesets 1 thorough 3 are set only by this escape.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP ∗, ∗)

054Ignoring function, he specified workstation is not open

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

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

103Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation bundle table

106Ignoring function, the specified font is not available for the requested text precision on the specified workstation.

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

Museum