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

FreeBSD Manual Pages

  
 
  

home | help
fcft_init(3)			     fcft			  fcft_init(3)

NAME
       fcft_init - initialize the library

SYNOPSIS
       #include	<fcft/fcft.h>

       bool fcft_init(
	   enum	   fcft_log_colorize	colorize,    bool    do_syslog,	  enum
	   fcft_log_class log_level);

DESCRIPTION
       fcft_init() initializes the fcft	library, and must be called before in-
       stantiating any fonts.

       Since it	also initializes logging, you may also want to	ensure	it  is
       called  before any other	functions affecting the	library	state. For ex-
       ample, fcft_set_scaling_filter().

       colorize	is one of:

	   enum	fcft_log_colorize {
	       FCFT_LOG_COLORIZE_NEVER,
	       FCFT_LOG_COLORIZE_ALWAYS,
	       FCFT_LOG_COLORIZE_AUTO
	   };

       FCFT_LOG_COLORIZE_AUTO enables colors if	stderr is a TTY.

       if do_syslog is set, fcft will log to syslog, in	addition to the	 regu-
       lar logging on stderr.

       Note  that  fcft	 does not call openlog(), even if do_syslog is set. Do
       this from the calling application. Before, or after calling fcft_init()
       does not	matter,	as long	as it is done before calling  any  other  fcft
       API functions.

       Finally,	 log_level configures which types of log messages that will be
       shown.

	   enum	fcft_log_class {
	       FCFT_LOG_CLASS_NONE,
	       FCFT_LOG_CLASS_ERROR,
	       FCFT_LOG_CLASS_WARNING,
	       FCFT_LOG_CLASS_INFO,
	       FCFT_LOG_CLASS_DEBUG
	   };

       Note that this is not a bitmask;	setting	FCFT_LOG_CLASS_INFO, also  en-
       ables FCFT_LOG_CLASS_WARNING and	FCFT_LOG_CLASS_ERROR.

RETURN VALUE
       True if initialization was successful, otherwise	false.

SEE ALSO
       fcft_fini()

3.3.1				  2025-04-12			  fcft_init(3)

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

home | help