Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AG_FONT_SELECTOR(3)	    Library Functions Manual	   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 parame-
       ters such as family (face), size	and style options.  Types  listed  in-
       clude:

          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 pre-
				    view.

       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 modi-
			fied 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.

Agar 1.7		       December	21, 2022	   AG_FONT_SELECTOR(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=AG_FontSelector&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help