Nano-X API Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# fonts

## Name

fonts —

## Synopsis

    GR_FONT_ID  GrCreateFont                    (GR_CHAR *name,
                                                 GR_COORD height,
                                                 GR_LOGFONT *plogfont);
    void        GrSetFontSize                   (GR_FONT_ID fontid,
                                                 GR_COORD size);
    void        GrSetFontRotation               (GR_FONT_ID fontid,
                                                 int tenthsdegrees);
    void        GrSetFontAttr                   (GR_FONT_ID fontid,
                                                 int setflags,
                                                 int clrflags);
    void        GrDestroyFont                   (GR_FONT_ID fontid);
    void        GrGetFontInfo                   (GR_FONT_ID font,
                                                 GR_FONT_INFO *fip);

## Description

## Details

### GrCreateFont ()

    GR_FONT_ID  GrCreateFont                    (GR_CHAR *name,
                                                 GR_COORD height,
                                                 GR_LOGFONT *plogfont);

Attempts to locate a font with the desired attributes and returns a font ID number which can be used to refer to it. If the plogfont argument is not NULL, the values in that structure will be used to choose a font. Otherwise, if the height is non zero, the built in font with the closest height to that specified will be used. If the height is zero, the built in font with the specified name will be used. If the desired font is not found, the first built in font will be returned as a last resort.

`name` : | string containing the name of a built in font to look for
`height` : | the desired height of the font
`plogfont` : | pointer to a LOGFONT structure
Returns : | a font ID number which can be used to refer to the font

### GrSetFontSize ()

    void        GrSetFontSize                   (GR_FONT_ID fontid,
                                                 GR_COORD size);

Changes the size of the specified font to the specified size.

`fontid` : | the ID number of the font to change the size of
`size` : |

### GrSetFontRotation ()

    void        GrSetFontRotation               (GR_FONT_ID fontid,
                                                 int tenthsdegrees);

Changes the rotation of the specified font to the specified angle.

`fontid` : | the ID number of the font to rotate
`tenthsdegrees` : |

### GrSetFontAttr ()

    void        GrSetFontAttr                   (GR_FONT_ID fontid,
                                                 int setflags,
                                                 int clrflags);

Changes the attributes (GR_TFKERNING, GR_TFANTIALIAS, GR_TFUNDERLINE, etc.) of the specified font according to the set and clear mask arguments.

`fontid` : | the ID of the font to set the attributes of
`setflags` : | mask specifying attribute flags to set
`clrflags` : | mask specifying attribute flags to clear

### GrDestroyFont ()

    void        GrDestroyFont                   (GR_FONT_ID fontid);

Frees all resources associated with the specified font ID, and if the font is a non built in type and this is the last ID referring to it, unloads the font from memory.

`fontid` : | the ID of the font to destroy

### GrGetFontInfo ()

    void        GrGetFontInfo                   (GR_FONT_ID font,
                                                 GR_FONT_INFO *fip);

Fills in the specified GR_FONT_INFO structure with information regarding the specified font.

`font` : |
`fip` : | pointer to a GR_FONT_INFO structure

<<< Previous Page | Home | Up | Next Page >>>
events | pointer