home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / XLFD / xlfd.tbl.ms < prev    next >
Encoding:
Text File  |  1991-08-27  |  63.7 KB  |  2,222 lines
  1. .\" Use tbl and -ms and macros.t
  2. .\" $XConsortium: xlfd.tbl.ms,v 1.13 91/08/27 11:00:42 rws Exp $
  3. .EH ''''
  4. .OH ''''
  5. .EF ''''
  6. .OF ''''
  7. .ps 11
  8. .nr PS 11
  9. \&
  10. .sp 8
  11. .ce 4
  12. \s+2\fBX Logical Font Description Conventions\fP\s-2
  13.  
  14. \fBVersion 1.4\fP
  15.  
  16. \fBMIT X Consortium Standard\fP
  17.  
  18. \fBX Version 11, Release 5\fP
  19. .sp 6
  20. .ce 2
  21. \s+1Jim Flowers\s-1
  22. .sp 6p
  23. \s+1Digital Equipment Corporation\s-1
  24. .bp
  25. \&
  26. .ps 9
  27. .nr PS 9
  28. .sp 8
  29. .LP
  30. X Window System is a trademark of M.I.T.
  31. .LP             
  32. Helvetica and Times are registered trademarks of Linotype Company.
  33. .LP
  34. ITC Avant Garde Gothic is a registered trademark of International 
  35. Typeface Corporation.
  36. .LP
  37. Times Roman is a registered trademark of Monotype Corporation.
  38. .LP
  39. Bitstream Amerigo is a registered trademark of Bitstream Inc.
  40. .LP             
  41. Stone is a registered trademark of Adobe Systems Inc.
  42. .LP
  43. Copyright \(co 1988 
  44. Massachusetts Institute of Technology, 
  45. Cambridge, MA USA.
  46. .LP
  47. Copyright \(co 1988, 1989 
  48. Digital Equipment Corporation, Maynard MA. All rights reserved.
  49. .LP 
  50. Permission to use, copy, modify, and distribute this documentation 
  51. for any purpose and without fee is hereby granted, provided 
  52. that the above copyright notice and this permission 
  53. notice appear in all copies.
  54. MIT and Digital Equipment Corporation make no representations about the 
  55. suitability for any purpose of the information in this document. 
  56. This documentation is provided as is without express or implied warranty. 
  57. .ps 11
  58. .nr PS 11
  59. .bp 3
  60. .EH '\fBX Logical Font Description Conventions\fP''\fBX11, Release 5'
  61. .OH '\fBX Logical Font Description Conventions\fP''\fBX11, Release 5'
  62. .EF ''\fB % \fP''
  63. .OF ''\fB % \fP''
  64. .NH 1 
  65. Introduction
  66. .XS
  67. \*(SN Introduction
  68. .XE
  69. .LP 
  70. It is a requirement that X client applications must be portable across server
  71. implementations, with very different file systems, naming conventions, and 
  72. font libraries.
  73. However, font access requests, 
  74. as defined by the \fIX Window System Protocol\fP,
  75. neither specify server-independent conventions for font names 
  76. nor provide adequate font properties for logically describing typographic fonts.
  77. .LP
  78. X clients must be able to dynamically determine the fonts available 
  79. on any given server so that understandable information can be presented 
  80. to the user or that intelligent font fallbacks can be chosen.
  81. It is desirable for the most common queries to be accomplished 
  82. without the overhead of opening each font and inspecting font properties, 
  83. by means of simple 
  84. .PN ListFonts 
  85. requests.
  86. For example, if a user selected a Helvetica typeface family, 
  87. a client application should be able to query the server 
  88. for all Helvetica fonts and present only those setwidths, weights, slants, 
  89. point sizes, and character sets available for that family.
  90. .LP
  91. This document gives a standard logical font description 
  92. (hereafter referred to as XLFD) and the conventions to be used 
  93. in the core protocol so that clients can query and access screen type libraries
  94. in a consistent manner across all X servers.
  95. In addition to completely specifying a given font by means of its 
  96. .PN FontName ,
  97. the XLFD also provides for a standard set of key 
  98. .PN FontProperties
  99. that describe the font in more detail. 
  100. .LP
  101. The XLFD provides an adequate set of typographic font properties, 
  102. such as \s-1CAP_HEIGHT\s+1, \s-1X_HEIGHT\s+1, \s-1RELATIVE_SETWIDTH\s+1, 
  103. for publishing and other applications to do intelligent font matching 
  104. or substitution when handling documents created on some foreign server 
  105. that use potentially unknown fonts.
  106. In addition, 
  107. this information is required by certain clients 
  108. to position subscripts automatically and determine small capital heights, 
  109. recommended leading, word-space values, and so on.
  110. .NH 1
  111. Requirements and Goals
  112. .XS
  113. \*(SN Requirements and Goals
  114. .XE
  115. .LP 
  116. The XLFD meets the short and long-term goals to have a 
  117. standard logical font description that:
  118. .IP \(bu 5
  119. Provides unique, descriptive font names that support simple pattern matching
  120. .IP \(bu 5
  121. Supports multiple font vendors, arbitrary character sets, and encodings
  122. .IP \(bu 5
  123. Supports naming and instancing of scalable fonts
  124. .IP \(bu 5
  125. Is independent of X server and operating or file system implementations
  126. .IP \(bu 5
  127. Supports arbitrarily complex font matching or substitution
  128. .IP \(bu 5
  129. Is extensible
  130. .NH 2
  131. Provide Unique and Descriptive Font Names
  132. .XS
  133. \*(SN Provide Unique and Descriptive Font Names
  134. .XE
  135. .LP
  136. It should be possible to have font names that are long enough and 
  137. descriptive enough to have a reasonable probability of being unique 
  138. without inventing a new registration organization.
  139. Resolution and size-dependent font masters, multivendor font libraries, 
  140. and so on must be anticipated and handled by the font name alone.
  141. .LP
  142. The name itself should be structured to be amenable to simple pattern 
  143. matching and parsing, thus, allowing X clients to restrict font queries to 
  144. some subset of all possible fonts in the server.
  145. .NH 2
  146. Support Multiple Font Vendors and Character Sets
  147. .XS
  148. \*(SN Support Multiple Font Vendors and Character Sets
  149. .XE
  150. .LP
  151. The font name and properties should distinguish between fonts 
  152. that were supplied by different font vendors 
  153. but that possibly share the same name. 
  154. We anticipate a highly competitive font market where users will be able to 
  155. buy fonts from many sources according to their particular requirements.
  156. .LP
  157. A number of font vendors deliver each font with all glyphs designed for that
  158. font, where charset mappings are defined by encoding vectors.
  159. Some server implementations may force these mappings to proprietary 
  160. or standard charsets statically in the font data. 
  161. Others may desire to perform the mapping dynamically in the server.
  162. Provisions must be made in the font name 
  163. that allows a font request to specify or identify specific charset mappings 
  164. in server environments where multiple charsets are supported.
  165. .NH 2
  166. Support Scalable Fonts
  167. .XS
  168. \*(SN Support Scalable Fonts
  169. .XE
  170. .LP
  171. If a font source can be scaled to arbitrary size, it should be possible
  172. for an application to determine that fact from the font name, and the
  173. application should be able to construct a font name for any specific size.
  174. .NH 2
  175. Be Independent of X Server and Operating or File System Implementations
  176. .XS
  177. \*(SN Be Independent of X Server and Operating or File System Implementations
  178. .XE
  179. .LP
  180. X client applications that require a particular font should be able to use 
  181. the descriptive name without knowledge of the file system or other 
  182. repository in use by the server.
  183. However, 
  184. it should be possible for servers to translate a given font name 
  185. into a file name syntax that it knows how to deal with,
  186. without compromising the uniqueness of the font name.
  187. This algorithm should be reversible (exactly how this translation is done is 
  188. implementation dependent).
  189. .NH 2
  190. Support Arbitrarily Complex Font Matching and Substitution
  191. .XS
  192. \*(SN Support Arbitrarily Complex Font Matching and Substitution
  193. .XE
  194. .LP
  195. In addition to the font name, 
  196. the XLFD should define a standard list of descriptive font properties,
  197. with agreed upon fallbacks for all fonts.
  198. This allows client applications to derive font-specific formatting 
  199. or display data and to perform font matching or substitution 
  200. when asked to handle potentially unknown fonts, as required.
  201. .NH 2
  202. Be Extensible
  203. .XS
  204. \*(SN Be Extensible
  205. .XE
  206. .LP
  207. The XLFD must be extensible so that new and/or private descriptive font 
  208. properties can be added to conforming fonts without making existing 
  209. X client or server implementations obsolete.
  210. .NH 1
  211. X Logical Font Description
  212. .XS
  213. \*(SN X Logical Font Description
  214. .XE
  215. .LP
  216. XLFD is divided into two basic components: 
  217. the 
  218. .PN FontName , 
  219. which gives all font information needed to uniquely identify a font 
  220. in X protocol requests (for example,
  221. .PN OpenFont , 
  222. .PN ListFonts , 
  223. and so on) and a variable list of optional 
  224. .PN FontProperties ,
  225. which describe a font in more detail.
  226. .LP
  227. The 
  228. .PN FontName 
  229. is used in font queries and is returned as data in certain X protocol requests.
  230. It is also specified as the data value for the 
  231. .PN FONT
  232. item in the X Consortium Character Bitmap Distribution Format Standard
  233. (BDF V2.1).
  234. .LP
  235. The 
  236. .PN FontProperties 
  237. are supplied on a font-by-font basis and are returned 
  238. as data in certain X protocol requests as part of the 
  239. .PN XFontStruct
  240. data structure.
  241. The names and associated data values for each of the 
  242. .PN FontProperties 
  243. may also appear as items of the 
  244. \s-1\fBSTARTPROPERTIES\fP\s+1...\s-1\fBENDPROPERTIES\fP\s+1 list 
  245. in the BDF V2.1 specification.
  246. .NH 2
  247. FontName
  248. .XS
  249. \*(SN FontName
  250. .XE
  251. .LP
  252. Each 
  253. .PN FontName 
  254. is logically composed of two strings: a 
  255. .PN FontNameRegistry
  256. prefix that is followed by a 
  257. .PN FontNameSuffix . 
  258. The 
  259. .PN FontNameRegistry
  260. is an x-registered-name (a name that has been registered with the X Consortium)
  261. that identifies the registration authority that owns the specified 
  262. .PN FontNameSuffix
  263. syntax and semantics.
  264. .LP
  265. All font names that conform to this specification are to use a 
  266. .PN FontNameRegistry
  267. prefix, which is defined to be the string ``\-'' 
  268. (that is, ISO 8859-1 HYPHEN -- Column/Row 02/13). 
  269. All 
  270. .PN FontNameRegistry 
  271. prefixes of the form: +\fIversion\fP\-,
  272. where the specified version indicates some future XLFD specification, 
  273. are reserved by the X Consortium for future extensions to XLFD font names.
  274. If required, extensions to the current XLFD font name shall be constructed 
  275. by appending new fields to the current structure, 
  276. each delimited by the existing field delimiter.
  277. The availability of other 
  278. .PN FontNameRegistry
  279. prefixes or fonts that support other registries 
  280. is server implementation dependent.
  281. .LP
  282. In the X protocol specification, 
  283. the 
  284. .PN FontName 
  285. is required to be a string; 
  286. hence, numeric field values are represented in the name as string equivalents.
  287. All 
  288. .PN FontNameSuffix 
  289. fields are also defined as 
  290. .PN FontProperties ; 
  291. numeric property values are represented as signed or unsigned integers,
  292. as appropriate.
  293. .NH 3
  294. FontName Syntax
  295. .XS
  296. \*(SN FontName Syntax
  297. .XE
  298. .LP
  299. The
  300. .PN FontName 
  301. is a structured, parsable string (of type STRING8) 
  302. whose Backus-Naur Form syntax description is as follows:
  303. .IN "FontName Syntax"
  304. .ps 9
  305. .nr PS 9
  306. .TS 
  307. rw(1.5i) lw(3.75i).
  308. .sp 6p
  309. T{
  310. FontName ::=
  311. T}    T{
  312. XFontNameRegistry XFontNameSuffix | 
  313. PrivFontNameRegistry PrivFontNameSuffix
  314. T}
  315. T{
  316. XFontNameRegistry ::=
  317. T}    T{
  318. XFNDelim | XFNExtPrefix Version XFNDelim
  319. T}
  320. T{
  321. XFontNameSuffix ::=
  322. T}    T{
  323. FOUNDRY XFNDelim FAMILY_NAME XFNDelim WEIGHT_NAME
  324. XFNDelim SLANT XFNDelim SETWIDTH_NAME XFNDelim ADD_
  325. STYLE_NAME XFNDelim PIXEL_SIZE XFNDelim POINT_SIZE 
  326. XFNDelim RESOLUTION_X XFNDelim RESOLUTION_Y XFNDelim 
  327. SPACING XFNDelim AVERAGE_WIDTH XFNDelim CHARSET_REGISTRY
  328. XFNDelim CHARSET_ENCODING
  329. T}
  330. T{
  331. Version ::=
  332. T}    T{
  333. STRING8 \- the XLFD version that defines an extension 
  334. to the font name syntax (for example, ``1.4'')
  335. T}
  336. T{
  337. XFNExtPrefix ::=
  338. T}    T{
  339. OCTET \- the value of ISO8859-1 PLUS (Column/Row 02/11)
  340. T}
  341. T{
  342. XFNDelim ::=
  343. T}    T{
  344. OCTET \- the value of ISO8859-1 HYPHEN (Column/Row 02/13)
  345. T}
  346. T{
  347. PrivFontNameRegistry ::=
  348. T}    T{
  349. STRING8 \- other than those strings reserved by XLFD
  350. T}
  351. PrivFontNameSuffix ::=    STRING8
  352. .TE
  353. .ps 11
  354. .nr PS 11
  355. .LP
  356. Field values are constructed as strings of ISO8859-1 graphic characters, 
  357. excluding the following:
  358. .IP \(bu 5
  359. HYPHEN (02/13), the XLFD font name delimiter character
  360. .IP \(bu 5
  361. QUESTION MARK (03/15) and ASTERISK (02/10), the X protocol 
  362. fontname wildcard characters
  363. .LP
  364. Alphabetic case distinctions are allowed but are for human readability 
  365. concerns only.
  366. Conforming X servers will perform matching on font name query or open requests 
  367. independent of case.
  368. The entire font name string must have no more than 255 characters.
  369. It is recommended that clients construct font name query patterns 
  370. by explicitly including all field delimiters to avoid unexpected results.
  371. Note that SPACE is a valid character of a 
  372. .PN FontName 
  373. field; for example, the string "ITC Avant Garde Gothic" might be a FAMILY_NAME.
  374. .NH 3
  375. FontName Field Definitions
  376. .XS
  377. \*(SN FontName Field Definitions
  378. .XE
  379. .LP
  380. This section discusses the
  381. .PN FontName :
  382. .IP \(bu 5
  383. FOUNDRY field
  384. .IP \(bu 5
  385. FAMILY_NAME field
  386. .IP \(bu 5
  387. WEIGHT_NAME field
  388. .IP \(bu 5
  389. SLANT field
  390. .IP \(bu 5
  391. SETWIDTH_NAME field
  392. .IP \(bu 5
  393. ADD_STYLE_NAME field
  394. .IP \(bu 5
  395. PIXEL_SIZE field
  396. .IP \(bu 5
  397. POINT_SIZE field
  398. .IP \(bu 5
  399. RESOLUTION_X and RESOLUTION_Y fields
  400. .IP \(bu 5
  401. SPACING field
  402. .IP \(bu 5
  403. AVERAGE_WIDTH field
  404. .IP \(bu 5
  405. CHARSET_REGISTRY and CHARSET_ENCODING fields
  406. .NH 4
  407. FOUNDRY Field
  408. .XS
  409. \*(SN FOUNDRY Field
  410. .XE
  411. .LP
  412. FOUNDRY is an x-registered-name,
  413. the name or identifier of the digital type foundry 
  414. that digitized and supplied the font data, 
  415. or if different, the identifier of the organization that last modified 
  416. the font shape or metric information.
  417. .LP
  418. The reason this distinction is necessary is 
  419. that a given font design may be licensed from one source (for example, ITC) 
  420. but digitized and sold by any number of different type suppliers.
  421. Each digital version of the original design, in general, will be somewhat 
  422. different in metrics and shape from the idealized original font data, 
  423. because each font foundry, for better or for worse, has its own standards 
  424. and practices for tweaking a typeface for a particular generation 
  425. of output technologies or has its own perception of market needs. 
  426. .LP
  427. It is up to the type supplier to register with the X Consortium a 
  428. suitable name for this 
  429. .PN FontName 
  430. field according to the registration procedures defined by the Consortium.
  431. .LP
  432. The X Consortium shall define procedures for registering foundry 
  433. and other names and shall maintain and publish, 
  434. as part of its public distribution, 
  435. a registry of such registered names for use in XLFD font names and properties.
  436. .LP
  437. .NH 4
  438. FAMILY_NAME Field
  439. .XS
  440. \*(SN FAMILY_NAME Field
  441. .XE
  442. .LP
  443. FAMILY_NAME is a string that identifies the range or ``family'' of 
  444. typeface designs that are all variations of one basic typographic style. 
  445. This must be spelled out in full,
  446. with words separated by spaces, as required. 
  447. This name must be human-understandable and suitable for presentation to a 
  448. font user to identify the typeface family.
  449. .LP
  450. It is up to the type supplier to supply and maintain a suitable string for 
  451. this field and font property, to secure the proper legal title to a given 
  452. name, and to guard against the infringement of other's copyrights or 
  453. trademarks.
  454. By convention, FAMILY_NAME is not translated.
  455. FAMILY_NAME may include an indication of design ownership 
  456. if considered a valid part of the 
  457. typeface family name.
  458. .LP
  459. The following are examples of FAMILY_NAME:
  460. .IP \(bu 5
  461. Helvetica
  462. .IP \(bu 5
  463. ITC Avant Garde Gothic 
  464. .IP \(bu 5
  465. Times
  466. .IP \(bu 5
  467. Times Roman
  468. .IP \(bu 5
  469. Bitstream Amerigo
  470. .IP \(bu 5
  471. Stone
  472. .NH 4
  473. WEIGHT_NAME Field
  474. .XS
  475. \*(SN WEIGHT_NAME Field
  476. .XE
  477. .LP
  478. WEIGHT_NAME is a string that identifies the font's typographic weight, 
  479. that is, the nominal blackness of the font, 
  480. according to the FOUNDRY's judgment.
  481. This name must be human-understandable and suitable for presentation to a 
  482. font user.
  483. .LP 
  484. The interpretation of this field is somewhat problematic 
  485. because the typographic judgment of weight has traditionally 
  486. depended on the overall design of the typeface family in question;
  487. that is, it is possible that the DemiBold weight of one font could be 
  488. almost equivalent in typographic feel to a Bold font from another family.
  489. .LP
  490. WEIGHT_NAME is captured as an arbitrary string 
  491. because it is an important part of a font's complete human-understandable name.
  492. However, it should not be used for font matching or substitution.
  493. For this purpose,
  494. X client applications should use the weight-related font properties 
  495. (RELATIVE_WEIGHT and WEIGHT) that give the coded relative weight 
  496. and the calculated weight, respectively.
  497. .NH 4
  498. SLANT Field
  499. .XS
  500. \*(SN SLANT Field
  501. .XE
  502. .LP
  503. SLANT is a code-string that indicates the overall posture of the 
  504. typeface design used in the font.
  505. The encoding is as follows:
  506. .TS H
  507. lw(.5i) lw(1.25i) lw(3.5i).
  508. _
  509. .sp 6p
  510. .B
  511. Code    English Translation    Description
  512. .sp 6p
  513. _
  514. .sp 6p
  515. .TH
  516. .R
  517. ``R''    Roman    Upright design
  518. ``I''    Italic    T{
  519. Italic design, slanted clockwise from the vertical
  520. T}
  521. ``O''    Oblique    T{
  522. Obliqued upright design, slanted clockwise from the vertical
  523. T}
  524. ``RI''    Reverse Italic    T{
  525. Italic design, slanted counterclockwise from the vertical
  526. T}
  527. ``RO''    Reverse Oblique    T{
  528. Obliqued upright design, slanted counterclockwise from the vertical
  529. T}
  530. ``OT''    Other    Other
  531. .sp 6p
  532. _
  533. .TE
  534. .LP
  535. The SLANT codes are for programming convenience only and usually are 
  536. converted into their equivalent human-understandable form before being 
  537. presented to a user.
  538. .NH 4
  539. SETWIDTH_NAME Field
  540. .XS
  541. \*(SN SETWIDTH_NAME Field
  542. .XE
  543. .LP 
  544. SETWIDTH_NAME is a string that gives the font's typographic 
  545. proportionate width, that is, the nominal width per horizontal unit of the 
  546. font, according to the FOUNDRY's judgment.
  547. .LP
  548. As with WEIGHT_NAME, the interpretation of this field or font property is 
  549. somewhat problematic, because the designer's judgment of setwidth has 
  550. traditionally depended on the overall design of the typeface family in 
  551. question.
  552. For purposes of font matching or substitution,
  553. X client applications should either use the RELATIVE_SETWIDTH font property 
  554. that gives the relative coded proportionate width or calculate 
  555. the proportionate width.
  556. .LP
  557. The following are examples of SETWIDTH_NAME:
  558. .IP \(bu 5
  559. Normal 
  560. .IP \(bu 5
  561. Condensed 
  562. .IP \(bu 5
  563. Narrow 
  564. .IP \(bu 5
  565. Double Wide
  566. .NH 4
  567. ADD_STYLE_NAME Field
  568. .XS
  569. \*(SN ADD_STYLE_NAME Field
  570. .XE
  571. .LP
  572. ADD_STYLE_NAME is a string that identifies additional typographic 
  573. style information that is not captured by other fields but is needed 
  574. to identify the particular font.
  575. .LP
  576. ADD_STYLE_NAME is not a typeface classification field 
  577. and is only used for uniqueness. 
  578. Its use, as such, is not limited to typographic style distinctions.
  579. .LP
  580. The following are examples of ADD_STYLE_NAME:
  581. .IP \(bu 5
  582. Serif
  583. .IP \(bu 5
  584. Sans Serif
  585. .IP \(bu 5
  586. Informal
  587. .IP \(bu 5
  588. Decorated
  589. .NH 4
  590. PIXEL_SIZE Field
  591. .XS
  592. \*(SN PIXEL_SIZE Field
  593. .XE
  594. .LP 
  595. PIXEL_SIZE is an unsigned integer-string typographic metric in 
  596. device pixels that gives the body size of the font at a particular 
  597. POINT_SIZE and RESOLUTION_Y.
  598. PIXEL_SIZE usually incorporates additional vertical spacing 
  599. that is considered part of the font design.
  600. (Note, however, that this value is not necessarily equivalent to the height 
  601. of the font bounding box.)
  602. PIXEL_SIZE is in the range zero to a very large number.
  603. Zero is used to indicate a scalable font; see section 4.
  604. .LP
  605. PIXEL_SIZE usually is used by X client applications that need to 
  606. query fonts according to device-dependent size, 
  607. regardless of the point size or vertical resolution 
  608. for which the font was designed.
  609. .NH 4
  610. POINT_SIZE Field
  611. .XS
  612. \*(SN POINT_SIZE Field
  613. .XE
  614. .LP 
  615. POINT_SIZE is an unsigned integer-string typographic metric in 
  616. device-independent units that gives the body size 
  617. for which the font was designed.
  618. This field usually incorporates additional vertical spacing 
  619. that is considered part of the font design.
  620. (Note, however, that POINT_SIZE is not necessarily equivalent to the height 
  621. of the font bounding box.) 
  622. POINT_SIZE is expressed in decipoints (where points are as defined 
  623. in the X protocol or 72.27 points equal 1 inch) in the range zero to a 
  624. very large number.
  625. Zero is used to indicate a scalable font; see section 4.
  626. .LP
  627. POINT_SIZE and RESOLUTION_Y are used by X clients to query fonts 
  628. according to device-independent size to maintain constant text 
  629. size on the display regardless of the PIXEL_SIZE used for the font.
  630. .NH 4
  631. RESOLUTION_X and RESOLUTION_Y Fields
  632. .XS
  633. \*(SN RESOLUTION_X and RESOLUTION_Y Fields
  634. .XE
  635. .LP 
  636. RESOLUTION_X and RESOLUTION_Y are unsigned integer-strings that give 
  637. the horizontal and vertical resolution,
  638. measured in pixels or dots per inch (dpi),
  639. for which the font was designed.
  640. Horizontal and vertical values are required 
  641. because a separate bitmap font must be designed 
  642. for displays with very different aspect ratios
  643. (for example, 1:1, 4:3, 2:1, and so on).
  644. .LP 
  645. The separation of pixel or point size and resolution is necessary 
  646. because X allows for servers with very different video characteristics 
  647. (for example, horizontal and vertical resolution, screen and pixel size, 
  648. pixel shape, and so on) to potentially access the same font library.
  649. The font name, for example, must differentiate between a 14 point font designed
  650. for 75 dpi (body size of about 14 pixels) or a 14 point font designed 
  651. for 150 dpi (body size of about 28 pixels).
  652. Further, in servers that implement some or all fonts as continuously scaled 
  653. and scan-converted outlines,
  654. POINT_SIZE and RESOLUTION_Y will help the server to differentiate 
  655. between potentially separate font masters for text, title,
  656. and display sizes or for other typographic considerations.
  657. .NH 4 
  658. SPACING Field
  659. .XS
  660. \*(SN SPACING Field
  661. .XE
  662. .LP 
  663. SPACING is a code-string that indicates the escapement class of the font, 
  664. that is, monospace (fixed pitch), proportional (variable pitch), 
  665. or charcell (a special monospaced font that conforms to the traditional 
  666. data processing character cell font model).
  667. The encoding is as follows:
  668. .ps 9
  669. .nr PS 9
  670. .TS H
  671. lw(.5i) lw(1.25i) lw(3.5i).
  672. _
  673. .sp 6p
  674. .B
  675. Code    English Translation    Description
  676. .sp 6p
  677. _
  678. .sp 6p
  679. .TH
  680. .R
  681. ``P''    Proportional    T{
  682. A font whose logical character widths vary for each glyph.
  683. Note that no other restrictions are placed on the metrics 
  684. of a proportional font.
  685. T}
  686. ``M''    Monospaced    T{
  687. A font whose logical character widths are constant 
  688. (that is, every glyph in the font has the same logical width).
  689. No other restrictions are placed on the metrics of a monospaced font.
  690. T}
  691. ``C''    CharCell    T{
  692. A monospaced font that follows the standard typewriter character cell model
  693. (that is, the glyphs of the font can be modeled by X clients as ``boxes'' 
  694. of the same width and height that are imaged side-by-side 
  695. to form text strings or top-to-bottom to form text lines.
  696. By definition, 
  697. all glyphs have the same logical character width, 
  698. and no glyphs have ``ink'' outside of the character cell.
  699. There is no kerning (that is, on a per character basis with positive metrics: 
  700. 0 <= left-bearing <= right-bearing <= width; 
  701. with negative metrics: width <= left-bearing <= right-bearing <= zero).
  702. Also, the vertical extents of the font do not exceed the vertical spacing 
  703. (that is, on a per character basis: 
  704. ascent <= font-ascent and descent <= font-descent). 
  705. The cell height = font-descent + font-ascent, and the width = AVERAGE_WIDTH.
  706. T}
  707. .sp 6p
  708. _
  709. .TE
  710. .ps 11
  711. .nr PS 11
  712. .NH 4
  713. AVERAGE_WIDTH Field
  714. .XS
  715. \*(SN AVERAGE_WIDTH Field
  716. .XE
  717. .LP 
  718. AVERAGE_WIDTH is an unsigned integer-string typographic metric value 
  719. that gives the unweighted arithmetic mean width of all glyphs in the font 
  720. (measured in tenths of pixels).
  721. For monospaced and character cell fonts, 
  722. this is the width of all glyphs in the font.
  723. AVERAGE_WIDTH is in the range zero to a very large number.
  724. Zero is used to indicate a scalable font; see section 4.
  725. .NH 4
  726. CHARSET_REGISTRY and CHARSET_ENCODING Fields
  727. .XS
  728. \*(SN CHARSET_REGISTRY and CHARSET_ENCODING Fields
  729. .XE
  730. .LP
  731. The character set used to encode the glyphs of the font (and implicitly 
  732. the font's glyph repertoire), as maintained by the X Consortium character
  733. set registry.
  734. CHARSET_REGISTRY is an x-registered-name that identifies 
  735. the registration authority that owns the specified encoding.
  736. CHARSET_ENCODING is a registered-name that identifies the coded character set 
  737. as defined by that registration authority.
  738. .LP
  739. Although the X protocol does not explicitly have any knowledge about 
  740. character set encodings, 
  741. it is expected that server implementers will prefer to embed knowledge 
  742. of certain proprietary or standard charsets into their font library 
  743. for reasons of performance and convenience. 
  744. The CHARSET_REGISTRY and CHARSET_ENCODING fields or properties allow 
  745. an X client font request to specify a specific charset mapping 
  746. in server environments where multiple charsets are supported.
  747. The availability of any particular 
  748. character set is font and server implementation dependent.
  749. .LP
  750. To prevent collisions when defining character set names, 
  751. it is recommended that CHARSET_REGISTRY and CHARSET_ENCODING name pairs 
  752. be constructed according to the following conventions:
  753. .IN "CHARSET Syntax"
  754. .ps 9
  755. .nr PS 9
  756. .TS
  757. rw(1.5i) lw(3.75i).
  758. .sp 6p
  759. CharsetRegistry ::=    T{
  760. StdCharsetRegistryName | PrivCharsetRegistryName
  761. T}
  762. CharsetEncoding ::=    T{
  763. StdCharsetEncodingName | PrivCharsetEncodingName
  764. T}
  765. StdCharsetRegistryName ::=    T{
  766. StdOrganizationId StdNumber | StdOrganizationId StdNumber Dot Year
  767. T}
  768. PrivCharsetRegistryName ::=    OrganizationId STRING8
  769. StdCharsetEncodingName ::=    T{
  770. STRING8\-numeric part number of referenced standard
  771. T}
  772. PrivCharsetEncodingName ::=    STRING8
  773. StdOrganizationId ::=    T{
  774. STRING8\-the registered name or acronym of the referenced standard organization
  775. T}
  776. StdNumber ::=    STRING8\-referenced standard number
  777. OrganizationId ::=    T{
  778. STRING8\-the registered name or acronym of the organization
  779. T}
  780. Dot ::=    ``\.''\-ISO 8859-1 FULL STOP (Column/Row 2/14)
  781. Year ::=    STRING8\-numeric year (for example, 1989)
  782. .TE
  783. .ps 11
  784. .nr PS 11
  785. .LP
  786. The X Consortium shall maintain and publish a registry 
  787. of such character set names for use in X protocol font names and properties 
  788. as specified in XLFD.
  789. .LP
  790. The ISO Latin-1 character set shall be registered by the X Consortium as the 
  791. CHARSET_REGISTRY-CHARSET_ENCODING value pair: ``ISO8859-1''.
  792. .NH 3
  793. Examples
  794. .XS
  795. \*(SN Examples
  796. .XE
  797. .LP
  798. The following examples of font names are derived from the screen fonts 
  799. shipped with the MIT X distribution.
  800. .ps 9
  801. .nr PS 9
  802. .TS H
  803. lw(1.45i) lw(4.45i).
  804. _
  805. .sp 6p
  806. .B
  807. Font    X FontName
  808. .sp 6p
  809. _
  810. .sp 6p
  811. .TH
  812. .R
  813. \fB75 dpi Fonts\fP
  814. .sp 3p
  815. T{
  816. Charter 12 pt
  817. T}    T{
  818. -Bitstream-Charter-Medium-R-Normal--12-120-75-75-P-68-ISO8859-1
  819. T}
  820. T{
  821. Charter Bold 12 pt
  822. T}    T{
  823. -Bitstream-Charter-Bold-R-Normal--12-120-75-75-P-76-ISO8859-1
  824. T}
  825. T{
  826. Charter Bold Italic 12 pt
  827. T}    T{
  828. -Bitstream-Charter-Bold-I-Normal--12-120-75-75-P-75-ISO8859-1
  829. T}
  830. T{
  831. Charter Italic 12 pt
  832. T}    T{
  833. -Bitstream-Charter-Medium-I-Normal--12-120-75-75-P-66-ISO8859-1
  834. T}
  835. Courier 8 pt    -Adobe-Courier-Medium-R-Normal--8-80-75-75-M-50-ISO8859-1
  836. Courier 10 pt    -Adobe-Courier-Medium-R-Normal--10-100-75-75-M-60-ISO8859-1
  837. Courier 12 pt    -Adobe-Courier-Medium-R-Normal--12-120-75-75-M-70-ISO8859-1
  838. Courier 14 pt    -Adobe-Courier-Medium-R-Normal--14-140-75-75-M-90-ISO8859-1
  839. Courier 18 pt    -Adobe-Courier-Medium-R-Normal--18-180-75-75-M-110-ISO8859-1
  840. Courier 24 pt    -Adobe-Courier-Medium-R-Normal--24-240-75-75-M-150-ISO8859-1
  841. T{
  842. Courier Bold 10 pt
  843. T}    T{
  844. -Adobe-Courier-Bold-R-Normal--10-100-75-75-M-60-ISO8859-1
  845. T}
  846. T{
  847. Courier Bold Oblique 10 pt
  848. T}    T{
  849. -Adobe-Courier-Bold-O-Normal--10-100-75-75-M-60-ISO8859-1
  850. T}
  851. T{
  852. Courier Oblique 10 pt
  853. T}    T{
  854. -Adobe-Courier-Medium-O-Normal--10-100-75-75-M-60-ISO8859-1
  855. T}
  856. .sp 3p
  857. \fB100 dpi Fonts\fP
  858. .sp 3p
  859. T{
  860. Symbol 8 pt
  861. T}    T{
  862. -Adobe-Symbol-Medium-R-Normal--11-80-100-100-P-61-Adobe-FONTSPECIFIC
  863. T}
  864. T{
  865. Symbol 10 pt
  866. T}    T{
  867. -Adobe-Symbol-Medium-R-Normal--14-100-100-100-P-85-Adobe-FONTSPECIFIC
  868. T}
  869. T{
  870. Symbol 12 pt
  871. T}    T{
  872. -Adobe-Symbol-Medium-R-Normal--17-120-100-100-P-95-Adobe-FONTSPECIFIC
  873. T}
  874. T{
  875. Symbol 14 pt
  876. T}    T{
  877. -Adobe-Symbol-Medium-R-Normal--20-140-100-100-P-107-Adobe-FONTSPECIFIC
  878. T}
  879. T{
  880. Symbol 18 pt
  881. T}    T{
  882. -Adobe-Symbol-Medium-R-Normal--25-180-100-100-P-142-Adobe-FONTSPECIFIC
  883. T}
  884. T{
  885. Symbol 24 pt
  886. T}    T{
  887. -Adobe-Symbol-Medium-R-Normal--34-240-100-100-P-191-Adobe-FONTSPECIFIC
  888. T}
  889. T{
  890. Times Bold 10 pt
  891. T}    T{
  892. -Adobe-Times-Bold-R-Normal--14-100-100-100-P-76-ISO8859-1
  893. T}
  894. T{
  895. Times Bold Italic 10 pt
  896. T}    T{
  897. -Adobe-Times-Bold-I-Normal--14-100-100-100-P-77-ISO8859-1
  898. T}
  899. T{
  900. Times Italic 10 pt
  901. T}    T{
  902. -Adobe-Times-Medium-I-Normal--14-100-100-100-P-73-ISO8859-1
  903. T}
  904. T{
  905. Times Roman 10 pt
  906. T}    T{
  907. -Adobe-Times-Medium-R-Normal--14-100-100-100-P-74-ISO8859-1
  908. T}
  909. _
  910. .TE
  911. .ps 11
  912. .nr PS 11
  913. .NH 2
  914. FontProperties
  915. .XS
  916. \*(SN FontProperties
  917. .XE
  918. .LP
  919. All font properties are optional but will generally include the 
  920. font name fields and, on a font-by-font basis, any other useful font 
  921. descriptive and use information that may be required to use the font 
  922. intelligently.
  923. The XLFD specifies an extensive set of standard X font properties,
  924. their interpretation, and fallback rules when the property is not defined 
  925. for a given font.
  926. The goal is to provide client applications with enough font information 
  927. to be able to make automatic formatting and display decisions 
  928. with good typographic results.
  929. .LP
  930. Additional standard X font property definitions may be defined in the 
  931. future and private properties may exist in X fonts at any time.
  932. Private font properties should be defined to conform to the general mechanism 
  933. defined in the X protocol to prevent overlap of name space and ambiguous 
  934. property names, that is, private font property names are of the form: 
  935. ISO8859-1 UNDERSCORE (Column/Row 05/15), 
  936. followed by the organizational identifier, followed by UNDERSCORE, 
  937. and terminated with the property name.
  938. .LP
  939. The Backus-Naur Form syntax description of X font properties is as follows:
  940. .IN "Font Properties" "BNF Syntax"
  941. .ps 9
  942. .nr PS 9
  943. .TS
  944. rw(1.5i) lw(3.75i).
  945. .sp 6p
  946. Properties ::=    OptFontPropList
  947. OptFontPropList ::=    NULL | OptFontProp OptFontPropList
  948. OptFontProp ::=    PrivateFontProp | XFontProp
  949. PrivateFontProp ::=    T{
  950. STRING8 | Underscore OrganizationId Underscore STRING8
  951. T}
  952. XFontProp ::=    T{
  953. FOUNDRY | FAMILY_NAME | WEIGHT_NAME | SLANT | SETWIDTH_NAME | ADD_STYLE_NAME 
  954. | PIXEL_SIZE | POINT_SIZE | RESOLUTION_X | RESOLUTION_Y | SPACING | 
  955. AVERAGE_WIDTH | CHARSET_REGISTRY | CHARSET_ENCODING | QUAD_WIDTH | 
  956. RESOLUTION | MIN_SPACE | NORM_SPACE | MAX_SPACE | END_SPACE | SUPERSCRIPT_X | 
  957. SUPERSCRIPT_Y | SUBSCRIPT_X | SUBSCRIPT_Y | UNDERLINE_POSITION | 
  958. UNDERLINE_THICKNESS | STRIKEOUT_ASCENT | STRIKEOUT_DESCENT | ITALIC_ANGLE 
  959. | X_HEIGHT | WEIGHT | FACE_NAME | COPYRIGHT | AVG_CAPITAL_WIDTH | 
  960. AVG_LOWERCASE_WIDTH | RELATIVE_SETWIDTH | RELATIVE_WEIGHT | CAP_HEIGHT | 
  961. SUPERSCRIPT_ SIZE | FIGURE_WIDTH | SUBSCRIPT_SIZE | SMALL_CAP_SIZE | 
  962. NOTICE | DESTINATION
  963. T}
  964. Underscore ::=    T{
  965. OCTET\-the value of ISO8859-1 UNDERSCORE character (Column/Row 05/15)
  966. T}
  967. OrganizationId ::=    T{
  968. STRING8\-the registered name of the organization
  969. T}
  970. .TE
  971. .ps 11
  972. .nr PS 11
  973. .NH 3
  974. FOUNDRY
  975. .XS
  976. \*(SN FOUNDRY
  977. .XE
  978. .LP
  979. FOUNDRY is as defined in the
  980. .PN FontName 
  981. except that the property type is ATOM. 
  982. .LP
  983. FOUNDRY cannot be calculated or defaulted if not supplied as a font property.
  984. .NH 3
  985. FAMILY_NAME
  986. .XS
  987. \*(SN FAMILY_NAME
  988. .XE
  989. .LP
  990. FAMILY_NAME is as defined in the 
  991. .PN FontName
  992. except that the property type is ATOM. 
  993. .LP
  994. FAMILY_NAME cannot be calculated or defaulted if not supplied as a font 
  995. property.
  996. .NH 3
  997. WEIGHT_NAME
  998. .XS
  999. \*(SN WEIGHT_NAME
  1000. .XE
  1001. .LP
  1002. WEIGHT_NAME is as defined in the 
  1003. .PN FontName
  1004. except that the property type is ATOM. 
  1005. .LP
  1006. WEIGHT_NAME can be defaulted if not supplied as a font property, as follows:
  1007. .LP
  1008. .DS
  1009. if (WEIGHT_NAME undefined) then 
  1010.    WEIGHT_NAME = ATOM(``Medium'')
  1011. .DE
  1012. .NH 3
  1013. SLANT
  1014. .XS
  1015. \*(SN SLANT
  1016. .XE
  1017. .LP
  1018. SLANT is as defined in the 
  1019. .PN FontName
  1020. except that the property type is ATOM. 
  1021. .LP
  1022. SLANT can be defaulted if not supplied as a font property, as follows:
  1023. .LP
  1024. .DS
  1025. if (SLANT undefined) then 
  1026.    SLANT = ATOM(``R'')
  1027. .DE
  1028. .NH 3
  1029. SETWIDTH_NAME
  1030. .XS
  1031. \*(SN SETWIDTH_NAME
  1032. .XE
  1033. .LP
  1034. SETWIDTH_NAME is as defined in the 
  1035. .PN FontName
  1036. except that the property type is ATOM.
  1037. .LP
  1038. SETWIDTH_NAME can be defaulted if not supplied as a font property, as follows:
  1039. .LP
  1040. .DS
  1041. if (SETWIDTH_NAME undefined) then
  1042.    SETWIDTH_NAME = ATOM(``Normal'')
  1043. .DE
  1044. .NH 3
  1045. ADD_STYLE_NAME
  1046. .XS
  1047. \*(SN ADD_STYLE_NAME
  1048. .XE
  1049. .LP
  1050. ADD_STYLE_NAME is as defined in the 
  1051. .PN FontName
  1052. except that the property type is ATOM.
  1053. .LP
  1054. ADD_STYLE_NAME can be defaulted if not supplied as a font property, as follows:
  1055. .LP
  1056. .DS
  1057. if (ADD_STYLE_NAME undefined) then
  1058.    ADD_STYLE_NAME = ATOM(``'')
  1059. .DE
  1060. .NH 3
  1061. PIXEL_SIZE
  1062. .XS
  1063. \*(SN PIXEL_SIZE
  1064. .XE
  1065. .LP
  1066. PIXEL_SIZE is as defined in the 
  1067. .PN FontName
  1068. except that the property type is CARD32.
  1069. .LP
  1070. X clients requiring pixel values for the various typographic fixed 
  1071. spaces (em space, en space and thin space), can use the following 
  1072. algorithm for computing these values from other properties specified 
  1073. for a font:
  1074. .LP
  1075. .DS
  1076. DeciPointsPerInch = 722.7
  1077. EMspace = ROUND ((RESOLUTION_X * POINT_SIZE) / DeciPointsPerInch)
  1078. ENspace = ROUND (EMspace / 2)
  1079. THINspace = ROUND (EMspace / 3)\fP
  1080. .DE
  1081. .LP
  1082. where a slash ``/'' denotes real division, 
  1083. the asterisk ``*'' denotes real multiplication,
  1084. and ``ROUND'' denotes a function that rounds its real argument 'a' up or down
  1085. to the next integer. 
  1086. This rounding is done according to X = FLOOR (a + O.5),
  1087. where FLOOR is a function that rounds its real argument down to the
  1088. nearest integer.
  1089. .LP
  1090. PIXEL_SIZE can be approximated if not supplied as a font property, 
  1091. according to the following algorithm:
  1092. .LP
  1093. .DS
  1094. DeciPointsPerInch = 722.7
  1095. if (PIXEL_SIZE undefined) then
  1096.    PIXEL_SIZE = ROUND ((RESOLUTION_Y * POINT_SIZE) / DeciPointsPerInch)
  1097. .DE
  1098. .NH 3
  1099. POINT_SIZE
  1100. .XS
  1101. \*(SN POINT_SIZE
  1102. .XE
  1103. .LP
  1104. POINT_SIZE is as defined in the 
  1105. .PN FontName
  1106. except that the property type is CARD32.
  1107. .LP
  1108. X clients requiring device-independent values for em space, 
  1109. en space, and thin space can use the following algorithm:
  1110. .LP
  1111. .DS I
  1112. EMspace = ROUND (POINT_SIZE / 10)
  1113. ENspace = ROUND (POINT_SIZE / 20)
  1114. THINspace = ROUND (POINT_SIZE / 30)
  1115. .DE
  1116. .LP
  1117. Design POINT_SIZE cannot be calculated or approximated.
  1118. .NH 3
  1119. RESOLUTION_X
  1120. .XS
  1121. \*(SN RESOLUTION_X
  1122. .XE
  1123. .LP
  1124. RESOLUTION_X is as defined in the 
  1125. .PN FontName
  1126. except that the property type is CARD32.
  1127. .LP
  1128. RESOLUTION_X cannot be calculated or approximated.
  1129. .NH 3
  1130. RESOLUTION_Y
  1131. .XS
  1132. \*(SN RESOLUTION_Y
  1133. .XE
  1134. .LP
  1135. RESOLUTION_Y is as defined in the 
  1136. .PN FontName 
  1137. except that the property type is CARD32.
  1138. .LP
  1139. RESOLUTION_X cannot be calculated or approximated.
  1140. .NH 3
  1141. SPACING
  1142. .XS
  1143. \*(SN SPACING
  1144. .XE
  1145. .LP
  1146. SPACING is as defined in the 
  1147. .PN FontName
  1148. except that the property type is ATOM.
  1149. .LP
  1150. SPACING can be calculated if not supplied as a font property, 
  1151. according to the definitions given above for the 
  1152. .PN FontName .
  1153. .NH 3
  1154. AVERAGE_WIDTH
  1155. .XS
  1156. \*(SN AVERAGE_WIDTH
  1157. .XE
  1158. .LP
  1159. AVERAGE_WIDTH is as defined in the 
  1160. .PN FontName
  1161. except that the property type is CARD32.
  1162. .LP
  1163. AVERAGE_WIDTH can be calculated if not provided as a font property, 
  1164. according to the following algorithm:
  1165. .LP
  1166. .DS
  1167. if (AVERAGE_WIDTH undefined) then
  1168.    AVERAGE_WIDTH = ROUND (MEAN (all glyph widths in font) * 10)
  1169. .DE
  1170. .LP
  1171. where MEAN is a function that returns the arithmetic mean of its arguments.
  1172. .LP
  1173. X clients that require values for the number of characters per inch (pitch) 
  1174. of a monospaced font can use the following algorithm using the 
  1175. AVERAGE_WIDTH and RESOLUTION_X font properties:
  1176. .LP
  1177. .DS
  1178. if (SPACING not proportional) then
  1179.    CharPitch = (RESOLUTION_X * 10) / AVERAGE_WIDTH
  1180. .DE
  1181. .NH 3
  1182. CHARSET_REGISTRY
  1183. .XS
  1184. \*(SN CHARSET_REGISTRY
  1185. .XE
  1186. .LP
  1187. CHARSET_REGISTRY is as defined in the 
  1188. .PN FontName
  1189. except that the property type is ATOM.
  1190. .LP
  1191. CHARSET_REGISTRY cannot be defaulted if not supplied as a font property.
  1192. .NH 3
  1193. CHARSET_ENCODING
  1194. .XS
  1195. \*(SN CHARSET_ENCODING
  1196. .XE
  1197. .LP
  1198. CHARSET_ENCODING is as defined in the 
  1199. .PN FontName
  1200. except that the property type is ATOM.
  1201. .LP
  1202. CHARSET_ENCODING cannot be defaulted if not supplied as a font property.
  1203. .NH 3
  1204. MIN_SPACE
  1205. .XS
  1206. \*(SN MIN_SPACE
  1207. .XE
  1208. .LP
  1209. MIN_SPACE is an unsigned integer value (of type CARD32)
  1210. that gives the recommended minimum word-space value to be used with this font.
  1211. .LP
  1212. MIN_SPACE can be approximated if not provided as a font property, 
  1213. according to the following algorithm:
  1214. .LP
  1215. .DS I
  1216. if (MIN_SPACE undefined) then
  1217.    MIN_SPACE = ROUND(0.75 * NORM_SPACE)
  1218. .DE
  1219. .NH 3
  1220. NORM_SPACE
  1221. .XS
  1222. \*(SN NORM_SPACE
  1223. .XE
  1224. .LP
  1225. NORM_SPACE is an unsigned integer value (of type CARD32)
  1226. that gives the recommended normal word-space value to be used with this font.
  1227. .LP
  1228. NORM_SPACE can be approximated if not provided as a font property, 
  1229. according to the following algorithm:
  1230. .LP
  1231. .DS 0
  1232. DeciPointsPerInch = 722.7
  1233. if (NORM_SPACE undefined) then
  1234.    if (SPACE glyph exists) then
  1235.       NORM_SPACE = width of SPACE
  1236.    else NORM_SPACE = ROUND((0.33 * RESOLUTION_X * POINT_SIZE)/ DeciPointsPerInch)
  1237. .DE
  1238. .NH 3
  1239. MAX_SPACE
  1240. .XS
  1241. \*(SN MAX_SPACE
  1242. .XE
  1243. .LP
  1244. MAX_SPACE is an unsigned integer value (of type CARD32)
  1245. that gives the recommended maximum word-space value to be used with this font.
  1246. .LP
  1247. MAX_SPACE can be approximated if not provided as a font property, 
  1248. according to the following algorithm:
  1249. .LP
  1250. .DS
  1251. if (MAX_SPACE undefined) then
  1252.    MAX_SPACE = ROUND(1.5 * NORM_SPACE)
  1253. .DE
  1254. .NH 3
  1255. END_SPACE
  1256. .XS
  1257. \*(SN END_SPACE
  1258. .XE
  1259. .LP
  1260. END_SPACE is an unsigned integer value (of type CARD32)
  1261. that gives the recommended spacing at the end of sentences.
  1262. .LP
  1263. END_SPACE can be approximated if not provided as a font property, 
  1264. according to the following algorithm:
  1265. .LP
  1266. .DS 
  1267. if (END_SPACE undefined) then
  1268.    END_SPACE = NORM_SPACE
  1269. .DE
  1270. .NH 3
  1271. AVG_CAPITAL_WIDTH 
  1272. .XS
  1273. \*(SN AVG_CAPITAL_WIDTH
  1274. .XE
  1275. .LP
  1276. AVG_CAPITAL_WIDTH is an integer value (of type INT32)
  1277. that gives the unweighted arithmetic mean width of all the capital glyphs 
  1278. in the font, in tenths of pixels (applies to Latin and non-Latin fonts).
  1279. For Latin fonts, 
  1280. capitals are the glyphs A through Z.
  1281. This property is usually used for font matching or substitution.
  1282. .LP
  1283. AVG_CAPITAL_WIDTH can be calculated if not provided as a font property, 
  1284. according to the following algorithm:
  1285. .LP
  1286. .DS I
  1287. if (AVG_CAPITAL_WIDTH undefined) then
  1288.    AVG_CAPITAL_WIDTH = ROUND (MEAN (capital glyph widths) * 10)
  1289. .DE
  1290. .NH 3
  1291. AVG_LOWERCASE_WIDTH
  1292. .XS
  1293. \*(SN AVG_LOWERCASE_WIDTH
  1294. .XE
  1295. .LP
  1296. AVG_LOWERCASE_WIDTH is an integer value (of type INT32)
  1297. that gives the unweighted arithmetic mean width of all the lowercase glyphs 
  1298. in the font in tenths of pixels.
  1299. For Latin fonts, 
  1300. lowercase are the glyphs a through z. 
  1301. This property is usually used for font matching or substitution. 
  1302. .LP
  1303. Where appropriate, 
  1304. AVG_LOWERCASE_WIDTH can be approximated if not provided as a font property, 
  1305. according to the following algorithm:
  1306. .LP
  1307. .DS
  1308. if (AVG_LOWERCASE_WIDTH undefined) then
  1309.    if (lowercase exists) then
  1310.       AVG_LOWERCASE_WIDTH = ROUND (MEAN (lowercase glyph widths) * 10)
  1311.    else AVG_LOWERCASE_WIDTH undefined
  1312. .DE
  1313. .NH 3
  1314. QUAD_WIDTH 
  1315. .XS
  1316. \*(SN QUAD_WIDTH
  1317. .XE
  1318. .LP
  1319. QUAD_WIDTH is an integer typographic metric (of type INT32) 
  1320. that gives the width of a quad (em) space.
  1321. .NT Note
  1322. Because all typographic fixed spaces (em, en, and thin) are constant 
  1323. for a given font size (that is, they do not vary according to setwidth),
  1324. the use of this font property has been deprecated.
  1325. X clients that require typographic fixed space values are encouraged 
  1326. to discontinue use of QUAD_WIDTH and compute these values 
  1327. from other font properties (for example, PIXEL_SIZE).
  1328. X clients that require  a font-dependent width value should use either 
  1329. the FIGURE_WIDTH or one of the average character width font properties
  1330. (AVERAGE_WIDTH, AVG_CAPITAL_WIDTH or AVG_LOWERCASE_WIDTH).
  1331. .NE
  1332. .NH 3
  1333. FIGURE_WIDTH
  1334. .XS
  1335. \*(SN FIGURE_WIDTH
  1336. .XE
  1337. .LP
  1338. FIGURE_WIDTH is an integer typographic metric (of type INT32)
  1339. that gives the width of the tabular figures and the dollar sign,
  1340. if suitable for tabular setting (all widths equal).
  1341. For Latin fonts, these tabular figures are the arabic numerals 0 through 9.
  1342. .LP
  1343. FIGURE_WIDTH can be approximated if not supplied as a font property, 
  1344. according to the following algorithm:
  1345. .LP
  1346. .DS I
  1347. if (numerals and DOLLAR sign are defined & widths are equal) then
  1348.    FIGURE_WIDTH = width of DOLLAR
  1349. else FIGURE_WIDTH property undefined
  1350. .DE
  1351. .NH 3
  1352. SUPERSCRIPT_X 
  1353. .XS
  1354. \*(SN SUPERSCRIPT_X
  1355. .XE
  1356. .LP
  1357. SUPERSCRIPT_X is an integer value (of type INT32)
  1358. that gives the recommended horizontal offset in pixels 
  1359. from the position point to the X origin of synthetic superscript text.
  1360. If the current position point is at [X,Y], 
  1361. then superscripts should begin at [X + SUPERSCRIPT_X, Y \- SUPERSCRIPT_Y].
  1362. .LP
  1363. SUPERSCRIPT_X can be approximated if not provided as a font property, 
  1364. according to the following algorithm:
  1365. .LP
  1366. .DS
  1367. if (SUPERSCRIPT_X undefined) then
  1368.    if (TANGENT(ITALIC_ANGLE) defined) then
  1369.       SUPERSCRIPT_X = ROUND((0.40 * CAP_HEIGHT) / TANGENT(ITALIC_ANGLE))
  1370.    else SUPERSCRIPT_X = ROUND(0.40 * CAP_HEIGHT)
  1371. .DE
  1372. .LP
  1373. where TANGENT is a trigonometric function that returns the tangent of 
  1374. its argument (in degrees scaled by 64).
  1375. .NH 3
  1376. SUPERSCRIPT_Y
  1377. .XS
  1378. \*(SN SUPERSCRIPT_Y
  1379. .XE
  1380. .LP
  1381. SUPERSCRIPT_Y is an integer value (of type INT32)
  1382. that gives the recommended vertical offset in pixels 
  1383. from the position point to the Y origin of synthetic superscript text.
  1384. If the current position point is at [X,Y], 
  1385. then superscripts should begin at [X + SUPERSCRIPT_X, Y \- SUPERSCRIPT_Y].
  1386. .LP
  1387. SUPERSCRIPT_Y can be approximated if not provided as a font property, 
  1388. according to the following algorithm:
  1389. .LP
  1390. .DS
  1391. if (SUPERSCRIPT_Y undefined) then
  1392.    SUPERSCRIPT_Y = ROUND(0.40 * CAP_HEIGHT)
  1393. .DE
  1394. .NH 3
  1395. SUBSCRIPT_X
  1396. .XS
  1397. \*(SN SUBSCRIPT_X
  1398. .XE
  1399. .LP
  1400. SUBSCRIPT_X is an integer value (of type INT32)
  1401. that gives the recommended horizontal offset in pixels 
  1402. from the position point to the X origin of synthetic subscript text.
  1403. If the current position point is at [X,Y], 
  1404. then subscripts should begin at [X + SUBSCRIPT_X, Y + SUBSCRIPT_Y].
  1405. .LP
  1406. SUBSCRIPT_X can be approximated if not provided as a font property, 
  1407. according to the following algorithm:
  1408. .LP
  1409. .DS
  1410. if (SUBSCRIPT_X undefined) then
  1411.    if (TANGENT(ITALIC_ANGLE) defined) then
  1412.       SUBSCRIPT_X = ROUND((0.40 * CAP_HEIGHT) / TANGENT(ITALIC_ANGLE))
  1413.    else SUBSCRIPT_X = ROUND(0.40 * CAP_HEIGHT)
  1414. .DE
  1415. .NH 3
  1416. SUBSCRIPT_Y 
  1417. .XS
  1418. \*(SN SUBSCRIPT_Y
  1419. .XE
  1420. .LP
  1421. SUBSCRIPT_Y is an integer value (of type INT32)
  1422. that gives the recommended vertical offset in pixels 
  1423. from the position point to the Y origin of synthetic subscript text.
  1424. If the current position point is at [X,Y], 
  1425. then subscripts should begin at [X + SUBSCRIPT_X, Y + SUBSCRIPT_Y].
  1426. .LP
  1427. SUBSCRIPT_Y can be approximated if not provided as a font property, 
  1428. according to the following algorithm:
  1429. .LP
  1430. .DS
  1431. if (SUBSCRIPT_Y undefined) then
  1432.    SUBSCRIPT_Y = ROUND(0.40 * CAP_HEIGHT)
  1433. .DE
  1434. .NH 3
  1435. SUPERSCRIPT_SIZE 
  1436. .XS
  1437. \*(SN SUPERSCRIPT_SIZE
  1438. .XE
  1439. .LP
  1440. SUPERSCRIPT_SIZE is an unsigned integer value (of type CARD32)
  1441. that gives the recommended body size of synthetic superscripts 
  1442. to be used with this font, in pixels.
  1443. This will generally be smaller than the size of the current font;
  1444. that is, superscripts are imaged from a smaller font
  1445. offset according to SUPERSCRIPT_X and SUPERSCRIPT_Y.
  1446. .LP
  1447. SUPERSCRIPT_SIZE can be approximated if not provided as a font property, 
  1448. according to the following algorithm:
  1449. .LP
  1450. .DS
  1451. if (SUPERSCRIPT_SIZE undefined) then
  1452.    SUPERSCRIPT_SIZE = ROUND(0.60 * PIXEL_SIZE)
  1453. .DE
  1454. .NH 3
  1455. SUBSCRIPT_SIZE
  1456. .XS
  1457. \*(SN SUBSCRIPT_SIZE
  1458. .XE
  1459. .LP
  1460. SUBSCRIPT_SIZE is an unsigned integer value (of type CARD32)
  1461. that gives the recommended body size of synthetic subscripts 
  1462. to be used with this font, in pixels.
  1463. As with SUPERSCRIPT_SIZE, 
  1464. this will generally be smaller than the size of the current font; 
  1465. that is, subscripts are imaged from a smaller 
  1466. font offset according to SUBSCRIPT_X and SUBSCRIPT_Y.
  1467. .LP
  1468. SUBSCRIPT_SIZE can be approximated if not provided as a font property, 
  1469. according to the algorithm:
  1470. .LP
  1471. .DS
  1472. if (SUBSCRIPT_SIZE undefined) then
  1473.    SUBSCRIPT_SIZE = ROUND(0.60 * PIXEL_SIZE)
  1474. .DE
  1475. .NH 3
  1476. SMALL_CAP_SIZE
  1477. .XS
  1478. \*(SN SMALL_CAP_SIZE
  1479. .XE
  1480. .LP
  1481. SMALL_CAP_SIZE is an unsigned integer value (of type CARD32)
  1482. that gives the recommended body size of synthetic small capitals 
  1483. to be used with this font, in pixels.
  1484. Small capitals are generally imaged from a smaller font 
  1485. of slightly more weight.
  1486. No offset [X,Y] is necessary.
  1487. .LP
  1488. SMALL_CAP_SIZE can be approximated if not provided as a font property, 
  1489. according to the following algorithm:
  1490. .LP
  1491. .DS
  1492. if (SMALL_CAP_SIZE undefined) then
  1493.    SMALL_CAP_SIZE = ROUND(PIXEL_SIZE * ((X_HEIGHT 
  1494.                               + ((CAP_HEIGHT \- X_HEIGHT) / 3)) / CAP_HEIGHT))
  1495. .DE
  1496. .NH 3
  1497. UNDERLINE_POSITION
  1498. .XS
  1499. \*(SN UNDERLINE_POSITION
  1500. .XE
  1501. .LP
  1502. UNDERLINE_POSITION is an unsigned integer value (of type CARD32)
  1503. that gives the recommended vertical offset in pixels
  1504. from the baseline to the top of the underline. 
  1505. If the current position point is at [X,Y], 
  1506. the top of the baseline is given by [X, Y + UNDERLINE_POSITION].
  1507. .LP
  1508. UNDERLINE_POSITION can be approximated if not provided as a font 
  1509. property, according to the following algorithm:
  1510. .LP
  1511. .DS
  1512. if (UNDERLINE_POSITION undefined) then
  1513.    UNDERLINE_POSITION = ROUND((maximum descent) / 2)
  1514. .DE
  1515. where maximum descent is the maximum descent (below the baseline)
  1516. in pixels of any glyph in the font.
  1517. .NH 3
  1518. UNDERLINE_THICKNESS 
  1519. .XS
  1520. \*(SN UNDERLINE_THICKNESS
  1521. .XE
  1522. .LP
  1523. UNDERLINE_POSITION is an unsigned integer value (of type CARD32)
  1524. that gives the recommended underline thickness, in pixels.
  1525. .LP
  1526. UNDERLINE_THICKNESS can be approximated if not provided as a font property, 
  1527. according to the following algorithm:
  1528. .LP
  1529. .DS
  1530. CapStemWidth = average width of the stems of capitals
  1531. if (UNDERLINE_THICKNESS undefined) then
  1532.    UNDERLINE_THICKNESS = CapStemWidth
  1533. .DE
  1534. .NH 3
  1535. STRIKEOUT_ASCENT
  1536. .XS
  1537. \*(SN STRIKEOUT_ASCENT
  1538. .XE
  1539. .LP
  1540. STRIKEOUT_ASCENT is an integer value (of type INT32)
  1541. that gives the vertical ascent for boxing or voiding glyphs in this font.
  1542. If the current position is at [X,Y] and the string extent is EXTENT, 
  1543. the upper-left corner of the strikeout box is at [X, Y \- STRIKEOUT_ASCENT] 
  1544. and the lower-right corner of the box is at [X + EXTENT, Y + STRIKEOUT_DESCENT].
  1545. .LP
  1546. STRIKEOUT_ASCENT can be approximated if not provided as a font property, 
  1547. according to the following algorithm:
  1548. .LP
  1549. .DS
  1550. if (STRIKEOUT_ASCENT undefined)
  1551.    STRIKEOUT_ASCENT =  maximum ascent
  1552. .DE
  1553. where maximum ascent is the maximum ascent (above the baseline)
  1554. in pixels of any glyph in the font.
  1555. .NH 3
  1556. STRIKEOUT_DESCENT
  1557. .XS
  1558. \*(SN STRIKEOUT_DESCENT
  1559. .XE
  1560. .LP
  1561. STRIKEOUT_DESCENT is an integer value (of type INT32)
  1562. that gives the vertical descent for boxing or voiding glyphs in this font.
  1563. If the current position is at [X,Y] and the string extent is EXTENT,
  1564. the upper-left corner of the strikeout box is at [X, Y \- STRIKEOUT_ASCENT] 
  1565. and the lower-right corner of the box is at [X + EXTENT, Y + STRIKEOUT_DESCENT].
  1566. .LP
  1567. STRIKEOUT_DESCENT can be approximated if not provided as a font property, 
  1568. according to the following algorithm:
  1569. .LP
  1570. .DS
  1571. if (STRIKEOUT_DESCENT undefined)
  1572.    STRIKEOUT_DESCENT =  maximum descent
  1573. .DE
  1574. where maximum descent is the maximum descent (below the baseline)
  1575. in pixels of any glyph in the font.
  1576. .NH 3
  1577. ITALIC_ANGLE
  1578. .XS
  1579. \*(SN ITALIC_ANGLE
  1580. .XE
  1581. .LP
  1582. ITALIC_ANGLE is an integer value (of type INT32)
  1583. that gives the nominal posture angle of the typeface design, in 1/64 degrees, 
  1584. measured from the glyph origin counterclockwise from the three o'clock position.
  1585. .LP
  1586. ITALIC_ANGLE can be defaulted if not provided as a font property, 
  1587. according to the following algorithm:
  1588. .LP
  1589. .DS
  1590. if (ITALIC_ANGLE undefined) then
  1591.    ITALIC_ANGLE = (90 * 64)
  1592. .DE
  1593. .NH 3
  1594. CAP_HEIGHT 
  1595. .XS
  1596. \*(SN CAP_HEIGHT
  1597. .XE
  1598. .LP
  1599. CAP_HEIGHT is an unsigned integer value (of type CARD32)
  1600. that gives the nominal height of the capital letters contained in the font, 
  1601. as specified by the FOUNDRY or typeface designer.
  1602. Where applicable, 
  1603. it is defined to be the height of the Latin uppercase letter \fIX\fP.
  1604. .LP
  1605. Certain clients require CAP_HEIGHT to compute scale factors and 
  1606. positioning offsets for synthesized glyphs where this 
  1607. information or designed glyphs are not explicitly provided by the font 
  1608. (for example, small capitals, superiors, inferiors, and so on).
  1609. CAP_HEIGHT is also a critical factor in font matching and substitution.
  1610. .LP
  1611. CAP_HEIGHT can be approximated if not provided as a font property, 
  1612. according to the following algorithm:
  1613. .LP
  1614. .DS
  1615. if (CAP_HEIGHT undefined) then
  1616.    if (latin font) then
  1617.       CAP_HEIGHT = XCharStruct.ascent[glyph X]
  1618.    else if (capitals exist) then
  1619.        CAP_HEIGHT = XCharStruct.ascent[some capital glyph]
  1620.    else CAP_HEIGHT undefined
  1621. .DE
  1622. .NH 3
  1623. X_HEIGHT
  1624. .XS
  1625. \*(SN X_HEIGHT
  1626. .XE
  1627. .LP
  1628. X_HEIGHT is a unsigned integer value (of type CARD32)
  1629. that gives the nominal height above the baseline of the lowercase glyphs 
  1630. contained in the font, 
  1631. as specified by the FOUNDRY or typeface designer.
  1632. Where applicable, 
  1633. it is defined to be the height of the Latin lowercase letter \fIx\fP.
  1634. .LP
  1635. As with CAP_HEIGHT, 
  1636. X_HEIGHT is required by certain clients to compute scale factors 
  1637. for synthesized small capitals where this information is not explicitly 
  1638. provided by the font resource.
  1639. X_HEIGHT is a critical factor in font matching and substitution.
  1640. .LP
  1641. X_HEIGHT can be approximated if not provided as a font property, 
  1642. according to the following algorithm:
  1643. .LP
  1644. .DS I
  1645. if (X_HEIGHT undefined) then
  1646.    if (latin font) then
  1647.       X_HEIGHT = XCharStruct.ascent[glyph x]
  1648.    else if (lowercase exists) then
  1649.         X_HEIGHT = XCharStruct.ascent[some lowercase glyph]
  1650.    else X_HEIGHT is undefined
  1651. .DE
  1652. .NH 3
  1653. RELATIVE_SETWIDTH
  1654. .XS
  1655. \*(SN RELATIVE_SETWIDTH
  1656. .XE
  1657. .LP
  1658. RELATIVE_SETWIDTH is an unsigned integer value (of type CARD32)
  1659. that gives the coded proportionate width of the font,
  1660. relative to all known fonts of the same typeface family, 
  1661. according to the type designer's or FOUNDRY's judgment.
  1662. .LP
  1663. The possible values are:
  1664. .TS H
  1665. lw(.5i) lw(1i) lw(2.75i).
  1666. _
  1667. .sp 6p
  1668. .B
  1669. Code    English Translation    Description
  1670. .sp 6p
  1671. _
  1672. .sp 6p
  1673. .TH
  1674. .R
  1675. 0    Undefined    Undefined or unknown
  1676. 10    UltraCondensed    The lowest ratio of average width to height
  1677. 20    ExtraCondensed
  1678. 30    Condensed    Condensed, Narrow, Compressed, ...
  1679. 40    SemiCondensed
  1680. 50    Medium    Medium, Normal, Regular, ...
  1681. 60    SemiExpanded    SemiExpanded, DemiExpanded, ...
  1682. 70    Expanded
  1683. 80    ExtraExpanded    ExtraExpanded, Wide, ...
  1684. 90    UltraExpanded    The highest ratio of average width to height
  1685. .sp 6p
  1686. _
  1687. .TE
  1688. .LP
  1689. RELATIVE_SETWIDTH can be defaulted if not provided as a font property, 
  1690. according to the following algorithm:
  1691. .LP
  1692. .DS
  1693. if (RELATIVE_SETWIDTH undefined) then
  1694.    RELATIVE_SETWIDTH = 50
  1695. .DE
  1696. .LP
  1697. X clients that want to obtain a calculated proportionate width of the 
  1698. font (that is, a font-independent way of identifying the proportionate 
  1699. width across all fonts and all font vendors) can use the following algorithm: 
  1700. .LP
  1701. .DS
  1702. SETWIDTH = AVG_CAPITAL_WIDTH / (CAP_HEIGHT * 10)
  1703. .DE
  1704. .LP
  1705. where SETWIDTH is a real number with zero being the narrowest 
  1706. calculated setwidth.
  1707. .NH 3
  1708. RELATIVE_WEIGHT
  1709. .XS
  1710. \*(SN RELATIVE_WEIGHT
  1711. .XE
  1712. .LP
  1713. RELATIVE_WEIGHT is an unsigned integer value (of type CARD32)
  1714. that gives the coded weight of the font, 
  1715. relative to all known fonts of the same typeface family, 
  1716. according to the type designer's or FOUNDRY's judgment.
  1717. .LP
  1718. The possible values are:
  1719. .TS H
  1720. lw(.5i) lw(1i) lw(3.75i).
  1721. _
  1722. .sp 6p
  1723. .B
  1724. Code    English Translation    Description
  1725. .sp 6p
  1726. _
  1727. .sp 6p
  1728. .TH
  1729. .R
  1730. 0    Undefined    Undefined or unknown
  1731. 10    UltraLight    The lowest ratio of stem width to height
  1732. 20    ExtraLight
  1733. 30    Light
  1734. 40    SemiLight    SemiLight, Book, ...
  1735. 50    Medium    Medium, Normal, Regular,...
  1736. 60    SemiBold    SemiBold, DemiBold, ...
  1737. 70    Bold
  1738. 80    ExtraBold    ExtraBold, Heavy, ...
  1739. 90    UltraBold    T{
  1740. UltraBold, Black, ..., the highest ratio of stem width to height
  1741. T}
  1742. .sp 6p
  1743. _
  1744. .TE
  1745. .LP
  1746. RELATIVE_WEIGHT can be defaulted if not provided as a font property, 
  1747. according to the following algorithm:
  1748. .LP
  1749. .DS
  1750. if (RELATIVE_WEIGHT undefined) then
  1751.    RELATIVE_WEIGHT = 50
  1752. .DE
  1753. .NH 3 
  1754. WEIGHT
  1755. .XS
  1756. \*(SN WEIGHT
  1757. .XE
  1758. .LP
  1759. Calculated WEIGHT is an unsigned integer value (of type CARD32)
  1760. that gives the calculated weight of the font, 
  1761. computed as the ratio of capital stem width to CAP_HEIGHT, 
  1762. in the range 0 to 1000, where 0 is the lightest weight.
  1763. .LP
  1764. WEIGHT can be calculated if not supplied as a font property, 
  1765. according to the following algorithm:
  1766. .LP
  1767. .DS
  1768. CapStemWidth = average width of the stems of capitals
  1769. if (WEIGHT undefined) then
  1770.    WEIGHT = ROUND ((CapStemWidth * 1000) / CAP_HEIGHT)
  1771. .DE
  1772. .LP
  1773. A calculated value for weight is necessary when matching fonts from 
  1774. different families because both the RELATIVE_WEIGHT and the WEIGHT_NAME are 
  1775. assigned by the typeface supplier, according to its tradition and practice, 
  1776. and therefore, are somewhat subjective.
  1777. Calculated WEIGHT provides a font-independent way of identifying 
  1778. the weight across all fonts and all font vendors.
  1779. .NH 3
  1780. RESOLUTION 
  1781. .XS
  1782. \*(SN RESOLUTION 
  1783. .XE
  1784. .LP
  1785. RESOLUTION is an integer value (of type INT32)
  1786. that gives the resolution for which this font was created,
  1787. measured in 1/100 pixels per point.
  1788. .NT Note
  1789. As independent horizontal and vertical design resolution components
  1790. are required to accommodate displays with nonsquare aspect ratios,
  1791. the use of this font property has been deprecated,
  1792. and independent RESOLUTION_X and RESOLUTION_Y font name fields/properties 
  1793. have been defined (see sections 3.1.2.9 and 3.1.2.10).
  1794. X clients are encouraged to discontinue use of the RESOLUTION property
  1795. and are encouraged to use the appropriate X,Y resolution properties,
  1796. as required.
  1797. .NE
  1798. .NH 3
  1799. FACE_NAME 
  1800. .XS
  1801. \*(SN FACE_NAME
  1802. .XE
  1803. .LP
  1804. FACE_NAME is a human-understandable string (of type ATOM)
  1805. that gives the full device-independent typeface name, 
  1806. including the owner, weight, slant, set, and so on 
  1807. but not the resolution, size, and so on.
  1808. This property may be used as feedback during font selection.
  1809. .LP
  1810. FACE_NAME cannot be calculated or approximated if not provided as a font 
  1811. property.
  1812. .NH 3
  1813. COPYRIGHT 
  1814. .XS
  1815. \*(SN COPYRIGHT
  1816. .XE
  1817. .LP
  1818. COPYRIGHT is a human-understandable string (of type ATOM)
  1819. that gives the copyright information of the legal owner 
  1820. of the digital font data.
  1821. .LP
  1822. This information is a required component of a font
  1823. but is independent of the particular format used to represent it 
  1824. (that is, it cannot be captured as a comment that could later 
  1825. be ``thrown away'' for efficiency reasons).
  1826. .LP
  1827. COPYRIGHT cannot be calculated or approximated if not provided as a font 
  1828. property.
  1829. .NH 3
  1830. NOTICE
  1831. .XS
  1832. \*(SN NOTICE
  1833. .XE
  1834. .LP
  1835. NOTICE is a human-understandable string (of type ATOM)
  1836. that gives the copyright information of the legal owner of the font design
  1837. or, if not applicable, the trademark information for the typeface FAMILY_NAME.
  1838. .LP
  1839. Typeface design and trademark protection laws vary from country to country, 
  1840. the USA having no design copyright protection currently
  1841. while various countries in Europe offer both design and typeface family name 
  1842. trademark protection.
  1843. As with COPYRIGHT, 
  1844. this information is a required component of a font 
  1845. but is independent of the particular format used to represent it.
  1846. .LP
  1847. NOTICE cannot be calculated or approximated if not provided as a font property.
  1848. .NH 3
  1849. DESTINATION 
  1850. .XS
  1851. \*(SN DESTINATION
  1852. .XE
  1853. .LP
  1854. DESTINATION is an unsigned integer code (of type CARD32)
  1855. that gives the font design destination, 
  1856. that is, whether it was designed as a screen proofing font to match 
  1857. printer font glyph widths (WYSIWYG), as an optimal video font (possibly with 
  1858. corresponding printer font) for extended screen viewing (video text), and so on.
  1859. .LP
  1860. The font design considerations are very different, 
  1861. and at current display resolutions, 
  1862. the readability and legibility of these two kinds of screen fonts 
  1863. are very different.
  1864. DESTINATION allows publishing clients that use X to model the printed page
  1865. and video text clients, such as on-line documentation browsers, 
  1866. to query for X screen fonts that suit their particular requirements.
  1867. .LP
  1868. The encoding is as follows:
  1869. .TS H
  1870. lw(.5i) lw(1i) lw(3.75i).
  1871. _
  1872. .sp 6p
  1873. .B
  1874. Code    English Translation    Description
  1875. .sp 6p
  1876. _
  1877. .sp 6p
  1878. .TH
  1879. .R
  1880. 0    WYSIWYG    T{
  1881. The font is optimized to match the typographic design and metrics of an 
  1882. equivalent printer font
  1883. T}
  1884. 1    Video text    T{
  1885. The font is optimized for screen legibility and readability
  1886. T}
  1887. .sp 6p
  1888. _
  1889. .TE
  1890. .NH 2
  1891. Built-in Font Property Atoms
  1892. .XS
  1893. \*(SN Built-in Font Property Atoms
  1894. .XE
  1895. .LP
  1896. The following font property atom definitions were predefined in the initial 
  1897. version of the core protocol:
  1898. .TS H
  1899. l l.
  1900. _
  1901. .sp 6p
  1902. .B
  1903. Font Property/Atom Name    Property Type
  1904. .sp 6p
  1905. _
  1906. .sp 6p
  1907. .TH
  1908. .R
  1909. MIN_SPACE    CARD32
  1910. NORM_SPACE    CARD32
  1911. MAX_SPACE    CARD32
  1912. END_SPACE    CARD32
  1913. SUPERSCRIPT_X    INT32
  1914. SUPERSCRIPT_Y    INT32
  1915. SUBSCRIPT_X    INT32
  1916. SUBSCRIPT_Y    INT32
  1917. UNDERLINE_POSITION    INT32
  1918. UNDERLINE_THICKNESS    CARD32
  1919. STRIKEOUT_ASCENT    INT32
  1920. STRIKEOUT_DESCENT    INT32
  1921. FONT_ASCENT    INT32
  1922. FONT_DESCENT    INT32
  1923. ITALIC_ANGLE    INT32
  1924. X_HEIGHT    INT32
  1925. QUAD_WIDTH    INT32 \- deprecated
  1926. WEIGHT    CARD32
  1927. POINT_SIZE    CARD32
  1928. RESOLUTION    CARD32 \- deprecated
  1929. COPYRIGHT    ATOM
  1930. FULL_NAME    ATOM
  1931. FAMILY_NAME    ATOM
  1932. DEFAULT_CHAR    CARD32
  1933. .sp 6p
  1934. _
  1935. .TE
  1936. .NH 1
  1937. Scalable Fonts
  1938. .XS
  1939. \*(SN Scalable Fonts
  1940. .XE
  1941. .LP
  1942. The XLFD is designed to support scalable fonts.  A scalable font is a
  1943. font source from which instances of arbitrary size can be derived.
  1944. A scalable font source might be one or more outlines
  1945. together with zero or more hand-tuned bitmap fonts at specific sizes and
  1946. resolutions, or it might be a programmatic description together with
  1947. zero or more bitmap fonts, or some other format
  1948. (perhap even just a single bitmap font).
  1949. .LP
  1950. The following definitions are useful for discussing scalable fonts:
  1951. .LP
  1952. \fBWell-formed XLFD pattern\fP
  1953. .br
  1954. .IP
  1955. A pattern string containing 14 hyphens, one of which is
  1956. the first character of the pattern.  Wildcard characters are permitted
  1957. in the fields of a well-formed XLFD pattern.
  1958. .LP
  1959. \fBScalable font name\fP
  1960. .br
  1961. .IP
  1962. A well-formed XLFD pattern containing no wildcards and containing the
  1963. digit ``0'' in the PIXEL_SIZE, POINT_SIZE, and AVERAGE_WIDTH fields.
  1964. .LP
  1965. \fBScalable fields\fP
  1966. .br
  1967. .IP
  1968. The XLFD fields PIXEL_SIZE, POINT_SIZE, RESOLUTION_X,
  1969. RESOLUTION_Y, and AVERAGE_WIDTH.
  1970. .LP
  1971. \fBDerived instance\fP
  1972. .br
  1973. .IP
  1974. The result of replacing the scalable fields of a font name
  1975. with values to yield a font name that could actually be
  1976. produced from the font source.  A scaling engine is
  1977. permitted, but not required, to interpret the scalable
  1978. fields in font names to support anamorphic scaling.
  1979. .LP
  1980. \fBGlobal list\fP
  1981. .br
  1982. .IP
  1983. The list of names that would be returned by an X server for a
  1984. .PN ListFonts
  1985. protocol request on the pattern ``*'' if there were no protocol
  1986. restrictions on the total number of names returned.
  1987. .sp
  1988. .LP
  1989. The global list consists of font names derived from font sources.  If a single
  1990. font source can support multiple character sets (specified
  1991. in the CHARSET_REGISTRY and CHARSET_ENCODING fields), each such character
  1992. set should be used to form a separate font name in the list.
  1993. For a nonscalable font source, the simple font name
  1994. for each character set is included in the global list.
  1995. For a scalable font source, a scalable font name for each character set
  1996. is included in the list.  In addition to the scalable font name,
  1997. specific derived instance names may also be included in the list.
  1998. The relative order of derived instances with respect to the scalable
  1999. font name is not constrained.  Finally, font name aliases may also be included
  2000. in the list.  The relative order of aliases with respect to the ``real''
  2001. font name is not constrained.
  2002. .LP
  2003. The values of the RESOLUTION_X and RESOLUTION_Y fields of a scalable font name
  2004. are implementation dependent, but to maximize backward compatibility they
  2005. should be reasonable non-zero values, for example, a resolution close to that
  2006. provided by the screen (in a single-screen server).  Since some existing
  2007. applications rely on seeing a collection of point and pixel sizes,
  2008. server vendors are strongly encouraged in the near term to
  2009. provide a mechanism for including, for each scalable font name,
  2010. a set of specific derived instance names.  For font sources that contain
  2011. a collection of hand-tuned bitmap fonts, including names of these instances
  2012. in the global list is recommended and sufficient.
  2013. .LP
  2014. The X protocol request
  2015. .PN OpenFont
  2016. on a scalable font name returns a font corresponding to an
  2017. implementation-dependent derived instance of that font name.
  2018. .LP
  2019. The X protocol request
  2020. .PN ListFonts
  2021. on a well-formed XLFD pattern returns the following.  Start with the
  2022. global list.  If the actual pattern argument has values containing no wildcards
  2023. in scalable fields, then substitute each such field into the corresponding
  2024. field in each scalable font name in the list.  For each resulting font name,
  2025. if the remaining scalable fields cannot be replaced with values to produce a
  2026. derived instance, remove the font name from the list.  Now take the modified
  2027. list, and perform a simple pattern match against the pattern argument.
  2028. .PN ListFonts
  2029. returns the resulting list.
  2030. .LP
  2031. For example, given the global list:
  2032. .DS
  2033. -Linotype-Times-Bold-I-Normal--0-0-100-100-P-0-ISO8859-1
  2034. -Linotype-Times-Bold-R-Normal--0-0-100-100-P-0-ISO8859-1
  2035. -Linotype-Times-Medium-I-Normal--0-0-100-100-P-0-ISO8859-1
  2036. -Linotype-Times-Medium-R-Normal--0-0-100-100-P-0-ISO8859-1
  2037. .DE
  2038. .LP
  2039. A
  2040. .PN ListFonts
  2041. request with the pattern:
  2042. .LP
  2043. .DS
  2044. -*-Times-*-R-Normal--*-120-100-100-P-*-ISO8859-1
  2045. .DE
  2046. .LP
  2047. would return:
  2048. .DS
  2049. -Linotype-Times-Bold-R-Normal--0-120-100-100-P-0-ISO8859-1
  2050. -Linotype-Times-Medium-R-Normal--0-120-100-100-P-0-ISO8859-1
  2051. .DE
  2052. .LP
  2053. .PN ListFonts
  2054. on a pattern containing wildcards that is not a well-formed XLFD
  2055. pattern is only required to return the list obtained by performing
  2056. a simple pattern match against the global list.
  2057. X servers are permitted, but not required,
  2058. to use a more sophisticated matching algorithm.
  2059. .NH 1
  2060. Affected Elements of Xlib and the X Protocol
  2061. .XS
  2062. \*(SN Affected Elements of Xlib and the X Protocol
  2063. .XE
  2064. .LP
  2065. The following X protocol requests must support the XLFD conventions:
  2066. .IP \(bu 5
  2067. .PN OpenFont
  2068. \- for the name argument
  2069. .IP \(bu 5
  2070. .PN ListFonts
  2071. \- for the pattern argument
  2072. .IP \(bu 5
  2073. .PN ListFontsWithInfo
  2074. \- for the pattern argument
  2075. .LP
  2076. In addition, 
  2077. the following Xlib functions must support the XLFD conventions:
  2078. .IP \(bu 5
  2079. .PN XLoadFont
  2080. \- for the name argument
  2081. .IP \(bu 5
  2082. .PN XListFontsWithInfo
  2083. \- for the pattern argument
  2084. .IP \(bu 5
  2085. .PN XLoadQueryFont
  2086. \- for the name argument
  2087. .IP \(bu 5
  2088. .PN XListFonts
  2089. \- for the pattern argument
  2090. .NH 1
  2091. BDF Conformance
  2092. .XS
  2093. \*(SN BDF Conformance
  2094. .XE
  2095. .LP
  2096. The bitmap font distribution and interchange format adopted by the 
  2097. X Consortium (BDF V2.1) provides a general mechanism for identifying the 
  2098. font name of an X font and a variable list of font properties, 
  2099. but it does not mandate the syntax or semantics of the font name 
  2100. or the semantics of the font properties that might be provided in a BDF font.
  2101. This section identifies the requirements for BDF fonts that conform to XLFD.
  2102. .NH 2
  2103. XLFD Conformance Requirements
  2104. .XS
  2105. \*(SN XLFD Conformance Requirements
  2106. .XE
  2107. .LP
  2108. A BDF font conforms to the XLFD specification if and only if the 
  2109. following conditions are satisfied:
  2110. .IP \(bu 5
  2111. The value for the BDF item \fBFONT\fP conforms to the syntax 
  2112. and semantic definition of a XLFD 
  2113. .PN FontName 
  2114. string.
  2115. .IP \(bu 5
  2116. The 
  2117. .PN FontName 
  2118. begins with the X 
  2119. .PN FontNameRegistry 
  2120. prefix: ``-''.
  2121. .IP \(bu 5
  2122. All XLFD 
  2123. .PN FontName 
  2124. fields are defined.
  2125. .IP \(bu 5
  2126. Any FontProperties provided conform in name and semantics to the XLFD 
  2127. .PN FontProperty 
  2128. definitions.
  2129. .LP             
  2130. A simple method of testing for conformance would entail verifying that the 
  2131. .PN FontNameRegistry 
  2132. prefix is the string ``-'', 
  2133. that the number of field delimiters in the string and coded field values 
  2134. are valid, 
  2135. and that each font property name either matches a standard XLFD property name 
  2136. or follows the definition of a private property.
  2137. .NH 2
  2138. FONT_ASCENT, FONT_DESCENT, and DEFAULT_CHAR
  2139. .XS
  2140. \*(SN FONT_ASCENT, FONT_DESCENT, and DEFAULT_CHAR
  2141. .XE
  2142. .LP
  2143. FONT_ASCENT, FONT_DESCENT, and DEFAULT_CHAR are provided in the BDF 
  2144. specification as properties that are moved to the 
  2145. .PN XFontStruct 
  2146. by the BDF font compiler in generating the X server-specific 
  2147. binary font encoding. 
  2148. If present, 
  2149. these properties shall comply with the following semantic definitions.
  2150. .EQ
  2151. delim !!
  2152. .EN
  2153. .NH 3
  2154. FONT_ASCENT
  2155. .XS
  2156. \*(SN FONT_ASCENT
  2157. .XE
  2158. .LP
  2159. FONT_ASCENT is an integer value (of type INT32)
  2160. that gives the recommended typographic ascent above the baseline 
  2161. for determining interline spacing. 
  2162. Specific glyphs of the font may extend beyond this.
  2163. If the current position point for line \fIn\fP is at [X,Y], 
  2164. then the origin of the next line \fIn+1\fP 
  2165. (allowing for a possible font change) is 
  2166. [X, Y + !FONT_DESCENT sub n! + !FONT_ ASCENT sub n+1!].
  2167. .LP
  2168. FONT_ASCENT can be approximated if not provided as a font property, 
  2169. according to the following algorithm:
  2170. .LP
  2171. .DS
  2172. if (FONT_ASCENT undefined) then
  2173.    FONT_ASCENT = maximum ascent
  2174. .DE
  2175. where maximum ascent is the maximum ascent (above the baseline)
  2176. in pixels of any glyph in the font.
  2177. .NH 3
  2178. FONT_DESCENT
  2179. .XS
  2180. \*(SN FONT_DESCENT
  2181. .XE
  2182. .LP
  2183. FONT_DESCENT is an integer value (of type INT32)
  2184. that gives the recommended typographic descent below the baseline
  2185. for determining interline spacing. 
  2186. Specific glyphs of the font may extend beyond this.
  2187. If the current position point for line \fIn\fP is at [X,Y],
  2188. then the origin of the next line \fIn+1\fP 
  2189. (allowing for a possible font change) is 
  2190. [X, Y + !FONT_DESCENT sub n! + !FONT_ ASCENT sub n+1!].
  2191. .LP
  2192. The logical extent of the font is inclusive between the Y-coordinate values: 
  2193. Y \- FONT_ASCENT and Y + FONT_DESCENT + 1.
  2194. .LP
  2195. FONT_DESCENT can be approximated if not provided as a font property, 
  2196. according to the following algorithm:
  2197. .LP
  2198. .DS
  2199. if (FONT_DESCENT undefined) then
  2200.    FONT_DESCENT = maximum descent
  2201. .DE
  2202. where maximum descent is the maximum descent (below the baseline)
  2203. in pixels of any glyph in the font.
  2204. .NH 3
  2205. DEFAULT_CHAR
  2206. .XS
  2207. \*(SN DEFAULT_CHAR
  2208. .XE
  2209. .LP
  2210. The DEFAULT_CHAR is a unsigned integer value (of type CARD32)
  2211. that specifies the index
  2212. of the default character to be used by the X server when an attempt
  2213. is made to display an undefined or nonexistent character in the font.
  2214. (For a font using two byte matrix format,
  2215. the index bytes are encoded in the integer as byte1 * 65536 + byte2.)
  2216. If the DEFAULT_CHAR itself specifies an undefined or nonexistent character 
  2217. in the font, 
  2218. then no display is performed.
  2219. .LP
  2220. DEFAULT_CHAR cannot be approximated if not provided as a font property.
  2221. .TC
  2222.