home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _04c78db96890783b96311948357085e6 < prev    next >
Encoding:
Text File  |  2000-03-23  |  7.7 KB  |  211 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Font::AFM - Interface to Adobe Font Metrics files</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Font::AFM - Interface to Adobe Font Metrics files</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#environment">ENVIRONMENT</A></LI>
  26.     <LI><A HREF="#bugs">BUGS</A></LI>
  27.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  28. </UL>
  29. <!-- INDEX END -->
  30.  
  31. <HR>
  32. <P>
  33. <H1><A NAME="name">NAME</A></H1>
  34. <P>Font::AFM - Interface to Adobe Font Metrics files</P>
  35. <P>
  36. <HR>
  37. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  38. <UL>
  39. <LI>Linux</LI>
  40. <LI>Solaris</LI>
  41. <LI>Windows</LI>
  42. </UL>
  43. <HR>
  44. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  45. <PRE>
  46.  use Font::AFM;
  47.  $h = new Font::AFM "Helvetica";
  48.  $copyright = $h->Notice;
  49.  $w = $h->Wx->{"aring"};
  50.  $w = $h->stringwidth("Gisle", 10);
  51.  $h->dump;  # for debugging</PRE>
  52. <P>
  53. <HR>
  54. <H1><A NAME="description">DESCRIPTION</A></H1>
  55. <P>This module implements the Font::AFM class. Objects of this class are
  56. initialised from an AFM-file and allows you to obtain information
  57. about the font and the metrics of the various glyphs in the font.</P>
  58. <P>All measurements in AFM files are given in terms of units equal to
  59. 1/1000 of the scale factor of the font being used. To compute actual
  60. sizes in a document, these amounts should be multiplied by (scale
  61. factor of font)/1000.</P>
  62. <P>The following methods are available:</P>
  63. <DL>
  64. <DT><STRONG><A NAME="item_new">$afm = Font::AFM-><CODE>new($fontname)</CODE></A></STRONG><BR>
  65. <DD>
  66. Object constructor. Takes the name of the font as argument. It will
  67. croak if the font can not be found.
  68. <P></P>
  69. <DT><STRONG><A NAME="item_latin1_wx_table">$afm-><CODE>latin1_wx_table()</CODE></A></STRONG><BR>
  70. <DD>
  71. Returns a 256 element array, where each element contains the width
  72. of the corresponding character in the iso-8859-1 character set.
  73. <P></P>
  74. <DT><STRONG><A NAME="item_stringwidth">$afm->stringwidth($string, [$fontsize])</A></STRONG><BR>
  75. <DD>
  76. Returns the width of the string passed as argument. The string is
  77. assumed to be encoded in the iso-8859-1 character set.  A second
  78. argument can be used to scale the width according to the font size.
  79. <P></P>
  80. <DT><STRONG><A NAME="item_FontName">$afm->FontName</A></STRONG><BR>
  81. <DD>
  82. The name of the font as presented to the PostScript language
  83. <CODE>findfont</CODE> operator, for instance ``Times-Roman''.
  84. <P></P>
  85. <DT><STRONG><A NAME="item_FullName">$afm->FullName</A></STRONG><BR>
  86. <DD>
  87. Unique, human-readable name for an individual font, for instance
  88. ``Times Roman''.
  89. <P></P>
  90. <DT><STRONG><A NAME="item_FamilyName">$afm->FamilyName</A></STRONG><BR>
  91. <DD>
  92. Human-readable name for a group of fonts that are stylistic variants
  93. of a single design. All fonts that are member of such a group should
  94. have exactly the same <A HREF="#item_FamilyName"><CODE>FamilyName</CODE></A>. Example of a family name is
  95. ``Times''.
  96. <P></P>
  97. <DT><STRONG><A NAME="item_Weight">$afm->Weight</A></STRONG><BR>
  98. <DD>
  99. Human-readable name for the weight, or ``boldness'', attribute of a font.
  100. Exampes are <CODE>Roman</CODE>, <CODE>Bold</CODE>, <CODE>Light</CODE>.
  101. <P></P>
  102. <DT><STRONG><A NAME="item_ItalicAngle">$afm->ItalicAngle</A></STRONG><BR>
  103. <DD>
  104. Angle in degrees counterclockwise from the vertical of the dominant
  105. vertical strokes of the font.
  106. <P></P>
  107. <DT><STRONG><A NAME="item_IsFixedPitch">$afm->IsFixedPitch</A></STRONG><BR>
  108. <DD>
  109. If the value is <CODE>true</CODE>, it indicated that the font is a fixed-pitch
  110. (monospaced) font.
  111. <P></P>
  112. <DT><STRONG><A NAME="item_FontBBox">$afm->FontBBox</A></STRONG><BR>
  113. <DD>
  114. A string of four numbers giving the lower-left x, lower-left y,
  115. upper-right x, and upper-right y of the font bounding box. The font
  116. bounding box is the smallest rectangle enclosing the shape that would
  117. result if all the characters of the font were placed with their
  118. origins coincident, and then painted.
  119. <P></P>
  120. <DT><STRONG><A NAME="item_UnderlinePosition">$afm->UnderlinePosition</A></STRONG><BR>
  121. <DD>
  122. Recommended distance from the baseline for positioning underline
  123. stokes. This number is the y coordinate of the center of the stroke.
  124. <P></P>
  125. <DT><STRONG><A NAME="item_UnderlineThickness">$afm->UnderlineThickness</A></STRONG><BR>
  126. <DD>
  127. Recommended stroke width for underlining.
  128. <P></P>
  129. <DT><STRONG><A NAME="item_Version">$afm->Version</A></STRONG><BR>
  130. <DD>
  131. Version number of the font.
  132. <P></P>
  133. <DT><STRONG><A NAME="item_Notice">$afm->Notice</A></STRONG><BR>
  134. <DD>
  135. Trademark or copyright notice, if applicable.
  136. <P></P>
  137. <DT><STRONG><A NAME="item_Comment">$afm->Comment</A></STRONG><BR>
  138. <DD>
  139. Comments found in the AFM file.
  140. <P></P>
  141. <DT><STRONG><A NAME="item_EncodingScheme">$afm->EncodingScheme</A></STRONG><BR>
  142. <DD>
  143. The name of the standard encoding scheme for the font. Most Adobe
  144. fonts use the <CODE>AdobeStandardEncoding</CODE>. Special fonts might state
  145. <CODE>FontSpecific</CODE>.
  146. <P></P>
  147. <DT><STRONG><A NAME="item_CapHeight">$afm->CapHeight</A></STRONG><BR>
  148. <DD>
  149. Usually the y-value of the top of the capital H.
  150. <P></P>
  151. <DT><STRONG><A NAME="item_XHeight">$afm->XHeight</A></STRONG><BR>
  152. <DD>
  153. Typically the y-value of the top of the lowercase x.
  154. <P></P>
  155. <DT><STRONG><A NAME="item_Ascender">$afm->Ascender</A></STRONG><BR>
  156. <DD>
  157. Typically the y-value of the top of the lowercase d.
  158. <P></P>
  159. <DT><STRONG><A NAME="item_Descender">$afm->Descender</A></STRONG><BR>
  160. <DD>
  161. Typically the y-value of the bottom of the lowercase p.
  162. <P></P>
  163. <DT><STRONG><A NAME="item_Wx">$afm->Wx</A></STRONG><BR>
  164. <DD>
  165. Returns a hash table that maps from glyph names to the width of that glyph.
  166. <P></P>
  167. <DT><STRONG><A NAME="item_BBox">$afm->BBox</A></STRONG><BR>
  168. <DD>
  169. Returns a hash table that maps from glyph names to bounding box information.
  170. The bounding box consist of 4 numbers: llx, lly, urx, ury.
  171. <P></P>
  172. <DT><STRONG><A NAME="item_dump">$afm->dump</A></STRONG><BR>
  173. <DD>
  174. Dumps the content of the Font::AFM object to STDOUT.  Might sometimes
  175. be useful for debugging.
  176. <P></P></DL>
  177. <P>The AFM specification can be found at:</P>
  178. <PRE>
  179.    <A HREF="ftp://ftp.adobe.com/pub/adobe/DeveloperSupport/TechNotes/PSfiles/5004.AFM_Spec.ps">ftp://ftp.adobe.com/pub/adobe/DeveloperSupport/TechNotes/PSfiles/5004.AFM_Spec.ps</A></PRE>
  180. <P>
  181. <HR>
  182. <H1><A NAME="environment">ENVIRONMENT</A></H1>
  183. <DL>
  184. <DT><STRONG><A NAME="item_METRICS">METRICS</A></STRONG><BR>
  185. <DD>
  186. Contains the path to seach for AFM-files.  Format is as for the PATH
  187. environment variable. The default path built into this library is:
  188. <PRE>
  189.  /usr/lib/afm:/usr/local/lib/afm:/usr/openwin/lib/fonts/afm/:.</PRE>
  190. <P></P></DL>
  191. <P>
  192. <HR>
  193. <H1><A NAME="bugs">BUGS</A></H1>
  194. <P>Kerning data and composite character data is not yet parsed.
  195. Ligature data is not parsed.</P>
  196. <P>
  197. <HR>
  198. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  199. <P>Copyright 1995-1998 Gisle Aas. All rights reserved.</P>
  200. <P>This program is free software; you can redistribute it and/or modify
  201. it under the same terms as Perl itself.</P>
  202. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  203. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  204. <STRONG><P CLASS=block> Font::AFM - Interface to Adobe Font Metrics files</P></STRONG>
  205. </TD></TR>
  206. </TABLE>
  207.  
  208. </BODY>
  209.  
  210. </HTML>
  211.