Function
Returns a Group representing the named font.
Syntax
#include <dx/dx.h>
Object DXGetFont(char *name, float *ascent, float *descent)
Functional Details
The Group has as many members as there are characters in the named font (name). Typically, the returned font is passed to DXGeometricText to construct a text Object from a given string. Alternatively, individual characters can be extracted using DXGetEnumeratedMember. The member number is the same as the ASCII character code.
The font has an overall height of 1. If ascent is not NULL, the portion of the overall height above the baseline is returned in *ascent. If descent is not NULL, the portion of the overall height below the baseline is returned in *descent. The sum of the ascent and the descent is the overall height 1.
This routine checks the environment variables DXFONTS, DXEXECROOT, and DXROOT for directories to search for fonts. The routine also checks in /usr/lpp/dx and in the subdirectory fonts of each of these directories.
Return Value
Returns the font or returns NULL and sets an error code.
See Also
DXGeometricText, DXGetEnumeratedMember
[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]