cheshirekow  v0.1.0
freetype::load Namespace Reference

A list of bit-field constants used with FT_Load_Glyph to indicate what kind of operations to perform during glyph loading. More...

Variables

const UInt_t CROP_BITMAP = FT_LOAD_CROP_BITMAP
 Indicates that the font driver should crop the loaded bitmap glyph (i.e., remove all space around its black bits). More...
 
const UInt_t DEFAULT = FT_LOAD_DEFAULT
 Corresponding to 0, this value is used as the default glyph load operation. More...
 
const UInt_t FORCE_AUTOHINT = FT_LOAD_FORCE_AUTOHINT
 Indicates that the auto-hinter is preferred over the font's native hinter. More...
 
const UInt_t IGNORE_TRANSFORM = FT_LOAD_IGNORE_TRANSFORM
 Indicates that the transform matrix set by FT_Set_Transform should be ignored. More...
 
const UInt_t LINEAR_DESIGN = FT_LOAD_LINEAR_DESIGN
 Indicates that the ‘linearHoriAdvance’ and ‘linearVertAdvance’ fields of FT_GlyphSlotRec should be kept in font units. More...
 
const UInt_t MONOCHROME = FT_LOAD_MONOCHROME
 This flag is used with FT_LOAD_RENDER to indicate that you want to render an outline glyph to a 1-bit monochrome bitmap glyph, with 8 pixels packed into each byte of the bitmap data. More...
 
const UInt_t NO_AUTOHINT = FT_LOAD_NO_AUTOHINT
 Disable auto-hinter. More...
 
const UInt_t NO_BITMAP = FT_LOAD_NO_BITMAP
 Ignore bitmap strikes when loading. Bitmap-only fonts ignore this flag. More...
 
const UInt_t NO_HINTING = FT_LOAD_NO_HINTING
 Disable hinting. More...
 
const UInt_t NO_RECURSE = FT_LOAD_NO_RECURSE
 This flag is only used internally. More...
 
const UInt_t NO_SCALE = FT_LOAD_NO_SCALE
 Don't scale the outline glyph loaded, but keep it in font units. More...
 
const UInt_t PEDANTIC = FT_LOAD_PEDANTIC
 Indicates that the font driver should perform pedantic verifications during glyph loading. More...
 
const UInt_t RENDER = FT_LOAD_RENDER
 Call FT_Render_Glyph after the glyph is loaded. More...
 
const UInt_t VERTICAL_LAYOUT = FT_LOAD_VERTICAL_LAYOUT
 Load the glyph for vertical text layout. More...
 

Detailed Description

A list of bit-field constants used with FT_Load_Glyph to indicate what kind of operations to perform during glyph loading.

Variable Documentation

const UInt_t freetype::load::CROP_BITMAP = FT_LOAD_CROP_BITMAP

Indicates that the font driver should crop the loaded bitmap glyph (i.e., remove all space around its black bits).

Definition at line 496 of file types.h.

const UInt_t freetype::load::DEFAULT = FT_LOAD_DEFAULT

Corresponding to 0, this value is used as the default glyph load operation.

In this case, the following happens:

FreeType looks for a bitmap for the glyph corresponding to the

face's current size. If one is found, the function returns. The bitmap data can be accessed from the glyph slot (see note below).

If no embedded bitmap is searched or found, FreeType looks for a

scalable outline. If one is found, it is loaded from the font file, scaled to device pixels, then ‘hinted’ to the pixel grid in order to optimize it. The outline data can be accessed from the glyph slot (see note below).

Note that by default, the glyph loader doesn't render outlines into bitmaps. The following flags are used to modify this default behaviour to more specific and useful cases.

Note
By default, hinting is enabled and the font's native hinter (see FT_FACE_FLAG_HINTER) is preferred over the auto-hinter. You can disable hinting by setting FT_LOAD_NO_HINTING or change the precedence by setting FT_LOAD_FORCE_AUTOHINT. You can also set FT_LOAD_NO_AUTOHINT in case you don't want the auto-hinter to be used at all.

See the description of FT_FACE_FLAG_TRICKY for a special exception (affecting only a handful of Asian fonts).

Besides deciding which hinter to use, you can also decide which hinting algorithm to use. See FT_LOAD_TARGET_XXX for details.

Note that the auto-hinter needs a valid Unicode cmap (either a native one or synthesized by FreeType) for producing correct results. If a font provides an incorrect mapping (for example, assigning the character code U+005A, LATIN CAPITAL LETTER Z, to a glyph depicting a mathematical integral sign), the auto-hinter might produce useless results.

Definition at line 444 of file types.h.

const UInt_t freetype::load::FORCE_AUTOHINT = FT_LOAD_FORCE_AUTOHINT

Indicates that the auto-hinter is preferred over the font's native hinter.

Definition at line 489 of file types.h.

const UInt_t freetype::load::IGNORE_TRANSFORM = FT_LOAD_IGNORE_TRANSFORM

Indicates that the transform matrix set by FT_Set_Transform should be ignored.

Definition at line 530 of file types.h.

const UInt_t freetype::load::LINEAR_DESIGN = FT_LOAD_LINEAR_DESIGN

Indicates that the ‘linearHoriAdvance’ and ‘linearVertAdvance’ fields of FT_GlyphSlotRec should be kept in font units.

Definition at line 547 of file types.h.

const UInt_t freetype::load::MONOCHROME = FT_LOAD_MONOCHROME

This flag is used with FT_LOAD_RENDER to indicate that you want to render an outline glyph to a 1-bit monochrome bitmap glyph, with 8 pixels packed into each byte of the bitmap data.

Definition at line 540 of file types.h.

const UInt_t freetype::load::NO_AUTOHINT = FT_LOAD_NO_AUTOHINT

Disable auto-hinter.

Definition at line 553 of file types.h.

const UInt_t freetype::load::NO_BITMAP = FT_LOAD_NO_BITMAP

Ignore bitmap strikes when loading. Bitmap-only fonts ignore this flag.

Definition at line 476 of file types.h.

const UInt_t freetype::load::NO_HINTING = FT_LOAD_NO_HINTING

Disable hinting.

This generally generates ‘blurrier’ bitmap glyph when the glyph is rendered in any of the anti-aliased modes. See also the note below.

This flag is implied by FT_LOAD_NO_SCALE.

Definition at line 461 of file types.h.

const UInt_t freetype::load::NO_RECURSE = FT_LOAD_NO_RECURSE

This flag is only used internally.

Definition at line 523 of file types.h.

const UInt_t freetype::load::NO_SCALE = FT_LOAD_NO_SCALE

Don't scale the outline glyph loaded, but keep it in font units.

This flag implies FT_LOAD_NO_HINTING and FT_LOAD_NO_BITMAP, and unsets FT_LOAD_RENDER.

Definition at line 451 of file types.h.

const UInt_t freetype::load::PEDANTIC = FT_LOAD_PEDANTIC

Indicates that the font driver should perform pedantic verifications during glyph loading.

Definition at line 509 of file types.h.

const UInt_t freetype::load::RENDER = FT_LOAD_RENDER

Call FT_Render_Glyph after the glyph is loaded.

Definition at line 470 of file types.h.

const UInt_t freetype::load::VERTICAL_LAYOUT = FT_LOAD_VERTICAL_LAYOUT

Load the glyph for vertical text layout.

Definition at line 482 of file types.h.