FreeBSD Manual Pages
fcft_rasterize_char_utf32(3) fcft fcft_rasterize_char_utf32(3) NAME fcft_rasterize_char_utf32 - rasterize a glyph for a single UTF-32 code- point SYNOPSIS #include <fcft/fcft.h> const struct fcft_glyph *fcft_rasterize_char_utf32( struct fcft_font *font, uint32_t cp, enum fcft_subpixel subpixel); DESCRIPTION fcft_rasterize_char_utf32() rasterizes the UTF-32 encoded Unicode code- point cp using the primary font, or one of the fallback fonts, in font. cp is first searched for in the primary font. If not found, the fall- back fonts are searched (in the order they were specified in fcft_from_name()). If not found in any of the fallback fonts, the Font- Config fallback list for the primary font is searched. subpixel allows you to specify which subpixel mode to use. It is one of: enum fcft_subpixel { FCFT_SUBPIXEL_DEFAULT, FCFT_SUBPIXEL_NONE, FCFT_SUBPIXEL_HORIZONTAL_RGB, FCFT_SUBPIXEL_HORIZONTAL_BGR, FCFT_SUBPIXEL_VERTICAL_RGB, FCFT_SUBPIXEL_VERTICAL_BGR, }; If FCFT_SUBPIXEL_DEFAULT is specified, the subpixel mode configured in FontConfig is used. If FCFT_SUBPIXEL_NONE is specified, grayscale an- tialiasing will be used. For all other values, the specified mode is used. Note that if antialiasing has been disabled (in FontConfig, either globally, or specifically for the current font), then subpixel is ig- nored. The intention is to enable programs to use per-monitor subpixel modes. Incidentally, enum fcft_subpixel matches enum wl_output_subpixel, the enum used in Wayland. Note: you probably do not want to use anything other than FCFT_SUB- PIXEL_NONE if blending with a transparent background. RETURN VALUE On error, NULL is returned. On success, a pointer to a rasterized glyph is returned. The glyph 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 them- selves). The glyph 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_glyph { uint32_t cp; int cols; const char *font_name; pixman_image_t *pix; int x; int y; int width; int height; struct { int x; int y; } advance; bool is_color_glyph; }; cp is the same cp from the fcft_rasterize_char_utf32() call. cols is the number of "columns" the glyph occupies (effectively, wcwidth(cp)). Note that this value will be incorrect if wide characters (wchar_t) is not UTF-32 encoded in the current locale. pix is the rasterized glyph. Its format depends on a number of factors, but will be one of PIXMAN_a1, PIXMAN_a8, PIXMAN_x8r8g8b8, PIX- MAN_a8r8g8b8. Use pixman_image_get_format() to find out which one it is. PIXMAN_a1 corresponds to FT_PIXEL_MODE_MONO. I.e. the glyph is an un-antialiased bitmask. Use as a mask when blending. PIXMAN_a8 corresponds to FT_PIXEL_MODE_GRAY. I.e. the glyph is a grayscale antialiased bitmask. Use as a mask when blending. PIXMAN_x8r8g8b8 corresponds to either FT_PIXEL_MODE_LCD or FT_PIXEL_MODE_LCD_V. pixman_image_set_component_alpha() has been called by fcft for you. Use as a mask when blending. PIXMAN_a8r8g8b8 corresponds to FT_PIXEL_MODE_BGRA. I.e. the glyph is a plain RGBA image. Use as source when blending. x is the glyph's horizontal offset, in pixels. Add this to the current pen position when blending. y is the glyph's vertical offset, in pixels. Add this to the current pen position when blending. width is the glyph's width, in pixels. Use as 'width' argument when blending. height is the glyph's height, in pixels. Use as 'height' argument when blending. advance is the glyph's 'advance', in pixels. Add this to the pen posi- tion after blending; x for a horizontal layout and y for a vertical layout. is_color_glyph is true if the glyph is a color glyph, typically an emoji. When true, the glyph should be composited OVER the destination surface, instead of being used as a mask. EXAMPLE See fcft_from_name() SEE ALSO fcft_destroy(), fcft_kerning(), fcft_rasterize_grapheme_utf32(), fcft_rasterize_text_run_utf32() 3.3.1 2025-04-12 fcft_rasterize_char_utf32(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fcft_rasterize_char_utf32&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>