freetype::render_mode Namespace Reference

An enumeration type that lists the render modes supported by FreeType 2. More...

Enumerations
enum	RenderMode {   NORMAL = 0, LIGHT, MONO, LCD,   LCD_V, MAX }
	An enumeration type that lists the render modes supported by FreeType 2. More...

Detailed Description

An enumeration type that lists the render modes supported by FreeType 2.

See Also

RenderMode

Enumeration Type Documentation

enum freetype::render_mode::RenderMode

An enumeration type that lists the render modes supported by FreeType 2.

Each mode corresponds to a specific type of scanline conversion performed on the outline.

For bitmap fonts and embedded bitmaps the ‘bitmap->pixel_mode’ field in the FT_GlyphSlotRec structure gives the format of the returned bitmap.

All modes except FT_RENDER_MODE_MONO use 256 levels of opacity.

Note

The LCD-optimized glyph bitmaps produced by FT_Render_Glyph can be filtered to reduce color-fringes by using FT_Library_SetLcdFilter (not active in the default builds). It is up to the caller to either call FT_Library_SetLcdFilter (if available) or do the filtering itself.

The selected render mode only affects vector glyphs of a font. Embedded bitmaps often have a different pixel mode like FT_PIXEL_MODE_MONO. You can use FT_Bitmap_Convert to transform them into 8-bit pixmaps.

Enumerator
NORMAL	This is the default render mode; it corresponds to 8-bit anti-aliased bitmaps.
LIGHT	This is equivalent to FT_RENDER_MODE_NORMAL. It is only defined as a separate value because render modes are also used indirectly to define hinting algorithm selectors. See FT_LOAD_TARGET_XXX for details.
MONO	This mode corresponds to 1-bit bitmaps (with 2 levels of opacity).
LCD	This mode corresponds to horizontal RGB and BGR sub-pixel displays like LCD screens. It produces 8-bit bitmaps that are 3 times the width of the original glyph outline in pixels, and which use the FT_PIXEL_MODE_LCD mode.
LCD_V	This mode corresponds to vertical RGB and BGR sub-pixel displays (like PDA screens, rotated LCD displays, etc.). It produces 8-bit bitmaps that are 3 times the height of the original glyph outline in pixels and use the FT_PIXEL_MODE_LCD_V mode.
MAX	Max.

Definition at line 583 of file types.h.