AG_FONT_SELECTOR(3)

NAME
AG_FontSelector - agar font selection widget

SYNOPSIS

    #include <agar/core.h>
    #include <agar/gui.h>

DESCRIPTION
AG_FontSelector allows the user to select a specific font from parameters such as family (face), size and style options. Types listed include:

•   Compiled-in fonts (fonts statically built into libag_gui).

•   Agar core fonts, application-specific and user fonts obtained by scanning the font path (the AG_CONFIG_PATH_FONTS setting of AG_Config(3)) for recognized extensions (.otf .ttf .ttc .woff2 .woff .dfont .fnt .bmp or .png).

•   System fonts (obtained via fontconfig where available).

INHERITANCE HIERARCHY
AG_Object(3) -> AG_Widget(3) -> AG_FontSelector.

INITIALIZATION
AG_FontSelector * AG_FontSelectorNew(AG_Widget *parent, Uint flags)

The AG_FontSelectorNew() function allocates, initializes, and attaches a new AG_FontSelector widget. Acceptable flags include:

AG_FONTSELECTOR_ALT_PHRASE
    Select a different text string for preview.

AG_FONTSELECTOR_SW_STYLES
    Display "Software styles".

AG_FONTSELECTOR_HFILL
    Expand horizontally in parent container.

AG_FONTSELECTOR_VFILL
    Expand horizontally in parent container.

AG_FONTSELECTOR_EXPAND
    Shorthand for AG_FONTSELECTOR_HFILL | AG_FONTSELECTOR_VFILL.

BINDINGS
The AG_FontSelector widget provides the following bindings:

AG_Font **font
    Pointer to an AG_Font(3) pointer which will be modified according to the user's selection.

EVENTS
The AG_FontSelector widget does not generate any event.

EXAMPLES
The following code fragment creates a new window containing a AG_FontSelector widget:

    AG_Window *win;
    AG_FontSelector *fs;
    AG_Font *myFont;
    win = AG_WindowNew(0);
    fs = AG_FontSelectorNew(win, AG_FONTSELECTOR_EXPAND);
    myFont = AG_TextFontPct(150);
    AG_BindPointer(fs, "font", (void **)&myFont);
    AG_WindowShow(win);

SEE ALSO
AG_Intro(3), AG_Text(3), AG_Widget(3), AG_Window(3)

HISTORY
The AG_FontSelector widget first appeared in Agar 1.3.4.