next up previous contents index
Next: Transformation of Fonts Up: Common Information on Fonts Previous: Character-Encoding Relation   Contents   Index


Administrative Information

 int T1_GetNoFonts( void)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} Usually, this function returns the number of fonts declared in the font database file, i.e., the integer quantity from the first line of the font database file. However, if some new fonts have been created using T1_CopyFont() (see [*]) or if some fonts have been added to the database after initialization (see [*]), these are also taken into account. The number returned by T1_GetNoFonts() minus 1 is thus the largest valid font ID specification.

 int T1_CheckForInit( void)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} Use this function in order to check whether t1lib is initialized. It returns $0$ if initialization has already happened and $-1$ otherwise.

 int T1_CheckForFontID( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This functions gives information on the load status of the font associated to FontID. It returns $0$ if the font FontID has not yet been loaded, $1$ if it has already been loaded. Finally, a return value of $-1$ indicates that either FontID is an invalid specification or t1lib is not initialized.

 char *T1_GetFontFileName( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns a pointer to the fontfilename identified by FontID. In no case, this pointer may be freed since the memory is static to this function. The string also is only valid up to the next call of this function.

 char *T1_GetFontFilePath( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns a pointer to the fully qualified path of the font file identified by FontID. In no case, this pointer may be freed since the memory is static to this function. The string also is only valid up to the next call of this function.

 char *T1_GetAFMFilePath( int FontID)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns a pointer to the fully qualified path of the AFM file of the font identified by FontID, as used by t1lib. In case of an error NULL is returned. It may also happen that there exists no AFM file for the font either because AFM information was generated on the fly at the time the font was loaded, or because AFM processing had been disabled at initialization time. For those cases T1_errno is not set.

In no case, the returned pointer may be freed since the memory is static to this function. The string also is only valid up to the next call of this function.

 char *T1_GetLibIdent( void)

to 0pt \fbox{$\mathcal{F}()\Rightarrow$} This function returns the identifier string for the version of t1lib. For example, this could be 0.8-beta. The string is static in this function and should thus not be freed by the user.


next up previous contents index
Next: Transformation of Fonts Up: Common Information on Fonts Previous: Character-Encoding Relation   Contents   Index
2004-10-04