next up previous contents index
Next: Metric Information on Glyphs Up: Common Information on Fonts Previous: Common Information on Fonts   Contents   Index


Information from FontInfo-Dictionary

 char *T1_GetFontName( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns the string object FontName from the fontinfo-dictionary of the specified font or a NULL pointer if the font is not loaded.

The memory for the returned string is static in this function and should thus not be freed by the user. As another consequence, the returned string is only constant until the function is called the next time.

 char *T1_GetFullName( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns the string object FullName from the fontinfo-dictionary of the specified font or a NULL pointer if the font is not loaded.

The memory for the returned string is static in this function and should thus not be freed by the user. As another consequence, the returned string is only constant until the function is called the next time.

 char *T1_GetFamilyName( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns the string object FamilyName from the fontinfo-dictionary of the specified font or a NULL pointer if the font is not loaded.

The memory for the returned string is static in this function and should thus not be freed by the user. As another consequence, the returned string is only constant until the function is called the next time.

 char *T1_GetWeight( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} It returns the Weight entry from fontinfo dictionary. It is a string entry and represents a verbatim classification of the font rather than a numerical quantity. In case of an error NULL is returned.

 float T1_GetItalicAngle( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} The returned value is the italic angle of the font in degrees as a float. Notice that the meaning of ItalicAngle is related to the slanting of fonts, but not in the sense of t1lib (see [*]). An italic font may be artificially slanted and an artificially slanted font in the sense of t1lib may have an italic angle of zero.

 int T1_GetIsFixedPitch( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns 0 if the font's spacing is proportional and 1 if it is fixed.

 BBox T1_GetFontBBox( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns the bounding box of the font identified by FontID. It is the bounding box that results if all characters of a font are overlayed with their reference point falling on the point (0,0). All values are in charspace units. The members lly and urx represent the fonts overall descent and ascent, respectively.

The font's bounding box is part of the AFM information as well as member in the font's private dictionary. It turns out that the information from .afm- and .pfa/.pfb-file is not consistent for some fonts. t1lib returns the information stored in the font-file itself, since I assume it is more consistent to the font's data.

 float T1_GetUnderlinePosition( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns the underline position of the specified font as given in the fontinfo-dictionary. The value is to be interpreted in charspace units. If the font is not loaded, 0 is returned since an underline position of 0 can be considered impossible for most fonts.

 float T1_GetUnderlineThickness( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns the thickness of the underlining rule for this font or 0 if the font is not loaded. 0 is a safe index for an error since a rule of height 0 would not be visible anyhow.

 char *T1_GetVersion( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} The version string from the Type 1 font file is returned. The memory where the string is located is managed by the function itself.

 char *T1_GetNotice( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} The notice string from the Type 1 font file is returned. Again the user should not touch the memory where the string is located.


next up previous contents index
Next: Metric Information on Glyphs Up: Common Information on Fonts Previous: Common Information on Fonts   Contents   Index
2004-10-04