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

FreeBSD Manual Pages

  
 
  

home | help
fcft_rasterize_grapheme_utf32(3)     fcft     fcft_rasterize_grapheme_utf32(3)

NAME
       fcft_rasterize_grapheme_utf32  -	 rasterize  glyph(s)  for  a  grapheme
       cluster

SYNOPSIS
       #include	<fcft/fcft.h>

       const struct fcft_grapheme *fcft_rasterize_grapheme_utf32(
	   struct fcft_font *font, size_t len, const  uint32_t	grapheme_clus-
	   ter[static len], enum fcft_subpixel subpixel);

DESCRIPTION
       fcft_rasterize_grapheme_utf32() rasterizes the grapheme cluster cluster
       using the primary font, or one of the fallback fonts, in	font.

       Each cluster element is an UTF-32 encoded Unicode codepoint.

       The  fonts  are	searched  for  all codepoints in the grapheme cluster,
       starting	with the primary font and then the custom fallback fonts,  and
       finally the FontConfig provided fallback	fonts.

       subpixel	 allows	 you  to  specify  which  subpixel  mode  to  use. See
       fcft_rasterize_char_utf32() for details.

RETURN VALUE
       On error, NULL is returned.

       On success, a  pointer  to  a  rasterized  grapheme  is	returned.  The
       grapheme	is cached in fcft, making subsequent calls with	the same argu-
       ments  very fast	(i.e. there is no need for programs to cache glyphs by
       themselves).

       The grapheme object is managed by font. There is	no need	to  explicitly
       free it;	it is freed when font is destroyed (with fcft_destroy()).

	   struct fcft_grapheme	{
	       int cols;

	       size_t count;
	       const struct fcft_glyph **glyphs;
	   };

       cols  is	 the  number of	"columns" the glyph occupies (effectively, wc-
       swidth(cluster)).

       glyphs is  an  array  of	 count	rasterized  glyphs.  See  fcft_raster-
       ize_char_utf32()	for a description of struct fcft_glyph.

SEE ALSO
       fcft_destroy(),	      fcft_rasterize_char_utf32(),	  fcft_raster-
       ize_text_run_utf32()

3.3.1				  2025-04-12  fcft_rasterize_grapheme_utf32(3)

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

home | help