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_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);

HISTORY ↑

The AG_FontSelector widget first appeared in Agar 1.3.4.