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 us-
     ing 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_raster-
     ize_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 arguments 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.3				   2026-07-30	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+15.1.quarterly>

home | help