Mapping tables for outline fonts
This topic contains
two PSF tables:
- APSRGTNM, which maps global resource identifiers (GRIDs) to font
names (for either raster fonts or outline fonts)
- APSRNTGM, which maps font names to GRIDs
For information about using these tables, see Using the font mapping tables.
The following fields are in the font mapping tables:
- FGID
- Font global identifier
- FW
- Font width (1440ths of an inch)
- GCSGID
- Graphic character set global identifier
- FLAGS
- Reserved
- TEKID
- The technology identifier for the font character set is:
- X'05'
- Raster
- X'1F'
- Single-byte outline
- VFS
- Vertical font size for the font character set (1440ths of an inch).
To find the VFS, multiply the point size of the raster font, 1/72 of an
inch, by 20.
- FCS NAME
- The member name of the code page or font character set
Tables Table 44 and Table 43 give samples of the information in the tables:
Table 43. GRID-to-font-name table, APSRGTNM| FGID | GCSGID | FW | FLAGS | TEKID | VFS | FCS NAME |
|---|
| 416 | 1261 | 120 | 0 | X'05' | 200 | C0420200 | | 416 | 2039 | 120 | 0 | X'05' | 200 | C0420000 | | 416 | 2039 | 0 | 0 | X'1F' | 0 | CZ4200 | | X'FFFF' | X'FFFF' | X'FFFF' | X'FF' | X'FF' | 0 | FFFFFFFF |
Table 44. Font-name-to-GRID table, APSRNTGM| FCS NAME | FLAGS | TEKID | FGID¹ | GCSGID | FW | VFS |
|---|
| C0D0GT10 | 0 | X'05' | 0040 | 0000 | 000 | 000 | | CZN200 | 0 | X'1F' | 2308 | 2039 | 0 | 0 | | C0N200B0 | 0 | X'05' | 2308 | 2039 | 80 | 240 | | FFFFFFFF | X'FF' | X'FF' | X'FFFF' | X'FFFF' | X'FFFF' | X'FFFF' | | ¹Specifying
zeros (0) for FGID means do not map fonts. | Figure 104 maps GRIDs to font names (for either raster fonts
or outline fonts). Use this module to add mapping entries to PSF’s
default GRID-to-member-names tables, to change entries, or to disable
entries.
Figure 104. GRIDs mapped to font names
APSRGTNM - GRID PARTS TO FONT MEMBER NAMES TABLES
*/****START OF SPECIFICATIONS********************EXTPROC**************/
*/* */
*/* MODULE NAME: APSRGTNM */
*/* */
*/* DESCRIPTIVE NAME: GRID-TO-NAMES USER MAPPING TABLE */
*/* */
*/* FUNCTION: THIS MODULE PROVIDES THE ABILITY FOR THE USER */
*/* TO ADD ENTRIES FOR CODE PAGE AND CHARACTER SET */
*/* GRID-TO-MEMBER-NAME MAPPING. @01C*/
*/* */
*/* NOTES: */
*/* DEPENDENCIES: NONE */
*/* RESTRICTIONS: NONE */
*/* REGISTER CONVENTIONS: NONE */
*/* PATCH LABEL: NONE */
*/* */
*/* MODULE TYPE: PROCEDURE */
*/* PROCESSOR: OS ASSEMBLER H */
*/* ATTRIBUTES: NO EXECUTABLE CODE */
*/* */
*/* ENTRY POINT: APSRGTFN */
*/* PURPOSE: THIS TABLE MAPS GRID PARTS (FGID, */
*/* GCSGID, FW) AND VERTICAL FONT SIZE TO THEIR */
*/* CORRESPONDING MEMBER NAMES. EACH ENTRY ALSO */
*/* HAS A TECHNOLOGY ID ASSOCIATED WITH IT. THE */
*/* TABLE IS TERMINATED BY A STRING OF XL2'FFFF'. */
*/* @01C*/
*/* THE FORMAT OF EACH ENTRY IS AS FOLLOWS. */
*/* BYTES 0-1 FONT GLOBAL ID (FGID) */
*/* BYTES 2-3 GRAPHIC CHARACTER SET GLOBAL ID */
*/* (GCSGID) @01C*/
*/* BYTES 4-5 FONT WIDTH */
*/* BYTES 6 FLAGS - RESERVED, MUST BE ZERO @01A*/
*/* BYTES 7 TECHNOLOGY ID */
*/* VALID TECHNOLOGY IDS ARE: */
*/* X'05' RASTER (SINGLE-BYTE) */
*/* X'1F' TYPE 1 OUTLINE (SINGLE-BYTE) */
*/* BYTES 8-9 VERTICAL FONT SIZE */
*/* BYTES 10-17 FONT CHARACTER SET NAME */
*/* LINKAGE: NONE */
*/* */
*/* ENTRY POINT: APSRGTCP */
*/* PURPOSE: THIS TABLE MAPS GRID PARTS (CPGID @01C*/
*/* AND GCSGID) TO THEIR CORRESPONDING CODE PAGE */
*/* MEMBER NAMES. THE TABLE IS TERMINATED BY A */
*/* STRING OF XL2'FFFF'. THE FORMAT OF EACH */
*/* ENTRY IS AS FOLLOWS. */
*/* BYTES 0-1 CODE PAGE GLOBAL ID (CPGID) */
*/* BYTES 2-3 CODE PAGE GRAPHIC CHARACTER SET */
*/* GLOBAL ID (GCSGID) */
*/* BYTES 4-11 CODE PAGE NAME */
*/* LINKAGE: NONE */
*/* */
*/* MESSAGES: NONE */
*/* */
*/* CHANGE ACTIVITY */
*/* */
*/* $00=LASP0006,HPRF220, 930903, BJ13ATF: RELEASE 2.2.0 @00A*/
*/* $01=OW08340, HPRF220, 941020, BJ13DDA: Outline Font D-APAR @01A*/
*/* $DU=LAPS0007,HPRF310,980604,BDKURLB: Version 3.1.0 @DUA*/
*/* $DX=LAPS0008,HPRF320,991117,BUQ4RLB: Version 3.2.0 @DXA*/
*/* $EV=LAPS0009,HPRF330,010530,BUQ4RLB: Version 3.3.0 @EVA*/
*/* $FC=LAPS0010,HPRF340,020612,BDKULD : Version 3.4.0 @FCA*/
*/* $FM=LAPS0011,HPRF410,040220,BDKURDD: Version 4.1.0 @FMA*/
*/* $FU=LAPS0012,HPRF420,060630,BDKURDD: Version 4.2.0 @FUA*/
*/* $GD=LAPS0013,HPRF430,080514,BDKURDD: Version 4.3.0 @GDA*/
*/* */
*/**********************END OF SPECIFICATIONS*************************/
*/********************************************************************/
*/* */
*/* BAL CODE FOLLOWS */
*/* */
*/********************************************************************/
APSRGTNM CSECT ENTRY POINT OF THIS MODULE
APSRGTNM AMODE 31 DO NOT REMOVE/CHANGE
APSRGTNM RMODE ANY DO NOT REMOVE/CHANGE
GTFN@ DC V(APSRGTFN) DO NOT REMOVE/CHANGE
GTCP@ DC V(APSRGTCP) DO NOT REMOVE/CHANGE
******************************************************************
* THE FOLLOWING IS THE GRID-PARTS-TO-CHARACTER-SET TABLE. *
******************************************************************
ENTRY APSRGTFN DO NOT REMOVE/CHANGE
APSRGTFN DS 0D DO NOT REMOVE/CHANGE
******************************************************************
**THE FOLLOWING 6 LINES ARE FOR FGID 2308 (X'0904'). *
**THIS ENTRY PROVIDED TO ILLUSTRATE THE FORMAT OF A TABLE ENTRY. *
******************************************************************
** DC H'2308' FGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'2039' GCSGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'0080' FONT WIDTH AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC XL1'00' RESERVED, MUST BE ZERO.
** DC XL1'05' TECHNOLOGY ID
** DC H'0240' VERTICAL FONT SIZE AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC CL8'C0N200B0' FONT CHARACTER SET NAME
******************************************************************
**THE FOLLOWING 6 LINES MARK THE END OF APSRFNTG. *
******************************************************************
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL1'FF' DO NOT REMOVE/CHANGE
DC XL1'FF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC CL8'FFFFFFFF' DO NOT REMOVE/CHANGE
******************************************************************
* THE FOLLOWING IS THE CODE-PAGE-TO-GRID PARTS TABLE. *
******************************************************************
ENTRY APSRGTCP DO NOT REMOVE/CHANGE
APSRGTCP DS 0D DO NOT REMOVE/CHANGE
******************************************************************
**THE FOLLOWING 3 LINES ARE FOR CPGID 500 (X'01F4'). *
**THIS ENTRY PROVIDED TO ILLUSTRATE THE FORMAT OF A TABLE ENTRY. *
******************************************************************
** DC H'0500' CPGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'0697' CODE PAGE GCSGID AS DECIAML NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC CL8'T1V10500' CODE PAGE NAME
******************************************************************
**THE FOLLOWING 3 LINES MARK THE END OF APSRCPTG. *
******************************************************************
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC CL8'FFFFFFFF' DO NOT REMOVE/CHANGE
******************************************************************
**THE FOLLOWING LINE MARKS THE END OF APSRGTNM. *
******************************************************************
END APSRGTNM DO NOT REMOVE/CHANGE
Figure 105 maps font names to GRIDs. Use this module to
add mapping entries to PSF’s default member-names-to-GRID tables,
change entries, or disable entries.
Figure 105. Font names mapped to GRIDs
APSRNTGM - FONT MEMBER NAMES TO GRID PARTS TABLES
*/****START OF SPECIFICATIONS********************EXTPROC**************/
*/* */
*/* MODULE NAME: APSRNTGM */
*/* */
*/* DESCRIPTIVE NAME: NAMES-TO-GRID USER MAPPING TABLE */
*/* */
*/* FUNCTION: THIS TABLES PROVIDES THE ABILITY FOR THE USER */
*/* TO ADD ENTRIES FOR CODE PAGE AND CHARACTER SET */
*/* MEMBER NAME-TO-GRID MAPPING. @01C*/
*/* */
*/* NOTES: */
*/* DEPENDENCIES: NONE */
*/* RESTRICTIONS: NONE */
*/* REGISTER CONVENTIONS: NONE */
*/* PATCH LABEL: NONE */
*/* */
*/* MODULE TYPE: PROCEDURE */
*/* PROCESSOR: OS ASSEMBLER H */
*/* MODULE SIZE: 900 */
*/* ATTRIBUTES: READ ONLY, NO EXECUTABLE CODE */
*/* */
*/* ENTRY POINT: APSRFNTG */
*/* PURPOSE: THIS TABLE MAPS FONT CHARACTER SET */
*/* MEMBER NAMES TO THE CORRESPONDING GRID PARTS */
*/* (FGID, GCSGID, FW) AND A VERTICAL FONT SIZE. */
*/* A TECHNOLOGY ID IS ALSO ASSOCIATED WITH EACH */
*/* ENTRY. @01C*/
*/* THE FORMAT OF EACH ENTRY IS AS FOLLOWS: */
*/* BYTES 0-7 FONT CHARACTER SET MEMBER NAME */
*/* BYTE 8 FLAGS -RESERVED, MUST BE ZERO. @01A*/
*/* BYTE 9 TECHNOLOGY ID */
*/* VALID TECHNOLOGY IDS ARE: */
*/* X'05' RASTER (SINGLE-BYTE) */
*/* X'1F' TYPE 1 OUTLINE (SINGLE-BYTE)*/
*/* BYTES 10-11 FONT GLOBAL ID (FGID) */
*/* BYTES 12-13 GRAPHIC CHARACTER SET GLOBAL ID */
*/* (GCSGID) @01C*/
*/* BYTES 14-15 FONT WIDTH */
*/* BYTES 16-17 VERTICAL FONT SIZE */
*/* THE TABLE IS TERMINATED BY A STRING OF */
*/* CL8'FFFFFFFF'. */
*/* LINKAGE: NONE */
*/* ENTRY POINT: APSRCPTG */
*/* PURPOSE: THIS TABLE MAPS CODE PAGES TO */
*/* THE CORRESPONDING GRID PARTS(CPGID AND GCSGID).*/
*/* THE FORMAT OF EACH ENTRY IS AS FOLLOWS */
*/* BYTES 0-7 CODE PAGE NAME */
*/* BYTES 8-9 CODE PAGE GLOBAL ID (CPGID) */
*/* BYTES 10-11 CODE PAGE GRAPHIC CHARACTER SET */
*/* GLOBAL ID (GCSGID) */
*/* THE TABLE IS TERMINATED BY A STRING OF */
*/* CL8'FFFFFFFF'. */
*/* LINKAGE: NONE */
*/* */
*/* MESSAGES: NONE */
*/* */
*/* CHANGE ACTIVITY */
*/* */
*/* $00=LAPS0006,HPRF220, 090393, BJ13ATF: RELEASE 2.2.0 @00A*/
*/* $01=OW08340, HPRF220, 102094, BJ13DDA: Outline Font D-APAR @01A*/
*/* $DU=LAPS0007,HPRF310,980604,BDKURLB: Version 3.1.0 @DUA*/
*/* $DX=LAPS0008,HPRF320,991117,BUQ4RLB: Version 3.2.0 @DXA*/
*/* $EV=LAPS0009,HPRF330,010530,BUQ4RLB: Version 3.3.0 @EVA*/
*/* $FC=LAPS0010,HPRF340,020612,BDKULD : Version 3.4.0 @FCA*/
*/* $FM=LAPS0011,HPRF410,040220,BDKURDD: Version 4.1.0 @FMA*/
*/* $FU=LAPS0012,HPRF420,060630,BDKURDD: Version 4.2.0 @FUA*/
*/* $GD=LAPS0013,HPRF430,080514,BDKURDD: Version 4.3.0 @GDA*/
*/* */
*/**********************END OF SPECIFICATIONS*************************/
*/********************************************************************/
*/* */
*/* BAL CODE FOLLOWS */
*/* */
*/********************************************************************/
APSRNTGM CSECT ENTRY POINT OF THIS MODULE
APSRNTGM AMODE 31 DO NOT REMOVE/CHANGE
APSRNTGM RMODE ANY DO NOT REMOVE/CHANGE
FNTG@ DC V(APSRFNTG) DO NOT REMOVE/CHANGE
CPTG@ DC V(APSRCPTG) DO NOT REMOVE/CHANGE
******************************************************************
* THE FOLLOWING IS THE CHARACTER-SET-TO-GRID-PARTS TABLE. *
******************************************************************
ENTRY APSRFNTG DO NOT REMOVE/CHANGE
APSRFNTG DS 0D DO NOT REMOVE/CHANGE
******************************************************************
**CORE TIMES NEW ROMAN - MEDIUM - RASTER 12 POINT *
**THE FOLLOWING 6 LINES ARE FOR LATIN. THIS ENTRY IS PROVIDED *
**TO ILLUSTRATE THE FORMAT OF EACH ENTRY. *
******************************************************************
** DC CL8'C0N200B0' FONT CHARACTER SET NAME
** DC XL1'00' RESERVED, MUST BE ZERO
** DC XL1'05' TECHNOLOGY ID
** DC H'2308' FGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'2039' GCSGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'0080' FONT WIDTH AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'0240' VERTICAL FONT SIZE AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
******************************************************************
**CORE TIMES NEW ROMAN - MEDIUM - OUTLINE FONT *
**THE FOLLOWING 6 LINES ARE FOR LATIN. THIS ENTRY IS PROVIDED *
**TO ILLUSTRATE THE FORMAT OF EACH ENTRY. *
******************************************************************
** DC CL8'CZN200 ' FONT CHARACTER SET NAME
** DC XL1'00' RESERVED, MUST BE ZERO
** DC XL1'1F' TECHNOLOGY ID
** DC H'2308' FGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'1269' GCSGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'0000' FONT WIDTH AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'0000' VERTICAL FONT SIZE AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
******************************************************************
**THE FOLLOWING 6 LINES MARK THE END OF APSRFNTG. *
******************************************************************
DC CL8'FFFFFFFF' DO NOT REMOVE/CHANGE
DC XL1'FF' DO NOT REMOVE/CHANGE
DC XL1'FF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
***********************************************************************
* THE FOLLOWING IS THE CODE-PAGE-TO-GRID PARTS TABLE. *
***********************************************************************
ENTRY APSRCPTG DO NOT REMOVE/CHANGE
APSRCPTG DS 0D DO NOT REMOVE/CHANGE
******************************************************************
**THE FOLLOWING 3 LINES ARE FOR EBCDIC INTERNATIONAL CODE PAGE *
**THIS ENTRY IS PROVIDED TO ILLUSTRATE THE FORMAT OF ONE ENTRY. *
******************************************************************
** DC CL8'T1V10500' CODE PAGE NAME
** DC H'0500' CPGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
** DC H'0697' CODE PAGE GCSGID AS DECIMAL NUMBER
** (OR USE " DC XL2'NNNN' " FOR HEX NUM)
******************************************************************
**THE FOLLOWING 3 LINES MARK THE END OF APSRCPTG. *
******************************************************************
DC CL8'FFFFFFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
DC XL2'FFFF' DO NOT REMOVE/CHANGE
******************************************************************
**THE FOLLOWING LINE MARKS THE END OF APSRNTGM. *
******************************************************************
END APSRNTGM DO NOT REMOVE/CHANGE
|
PSF for z/OS: Customization
Copyright IBM Corporation 1990, 2014