1049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/***************************************************************************/ 2049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* */ 3049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* freetype.h */ 4049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* */ 5049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* FreeType high-level API and common types (specification only). */ 6049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* */ 7a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* Copyright 1996-2013 by */ 8049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* David Turner, Robert Wilhelm, and Werner Lemberg. */ 9049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* */ 10049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* This file is part of the FreeType project, and may only be used, */ 11049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* modified, and distributed under the terms of the FreeType project */ 12049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* license, LICENSE.TXT. By continuing to use, modify, or distribute */ 13049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* this file you indicate that you have read the license and */ 14049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* understand and accept it fully. */ 15049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* */ 16049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/***************************************************************************/ 17049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 18049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 19a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#ifndef __FREETYPE_H__ 20a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#define __FREETYPE_H__ 21a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 22a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 23049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#ifndef FT_FREETYPE_H 24049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#error "`ft2build.h' hasn't been included yet!" 25049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#error "Please always use macros to include FreeType header files." 26049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#error "Example:" 27049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#error " #include <ft2build.h>" 28049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#error " #include FT_FREETYPE_H" 29049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#endif 30049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 31049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 32049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#include <ft2build.h> 33049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#include FT_CONFIG_CONFIG_H 34049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#include FT_TYPES_H 35a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#include FT_ERRORS_H 36049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 37049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 38049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source ProjectFT_BEGIN_HEADER 39049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 40049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 41049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 42049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 43049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 44049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Section> */ 45049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* user_allocation */ 46049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 47049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Title> */ 48049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* User allocation */ 49049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 50049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Abstract> */ 51049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* How client applications should allocate FreeType data structures. */ 52049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 53049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 54049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FreeType assumes that structures allocated by the user and passed */ 5577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* as arguments are zeroed out except for the actual data. In other */ 5677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* words, it is recommended to use `calloc' (or variants of it) */ 57049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* instead of `malloc' for allocation. */ 58049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 59049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 60049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 61049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 62049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 63049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 64049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 65049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 66049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* B A S I C T Y P E S */ 67049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 68049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 69049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 70049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 71049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 72049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 73049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 74049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Section> */ 75049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* base_interface */ 76049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 77049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Title> */ 78049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Base Interface */ 79049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 80049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Abstract> */ 8177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The FreeType~2 base font interface. */ 82049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 83049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 8477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* This section describes the public high-level API of FreeType~2. */ 85049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 86049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Order> */ 87049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Library */ 88049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face */ 89049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size */ 90049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_GlyphSlot */ 91049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_CharMap */ 92049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Encoding */ 93049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 94049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FaceRec */ 95049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 96049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_SCALABLE */ 97049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_FIXED_SIZES */ 98049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_FIXED_WIDTH */ 99049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_HORIZONTAL */ 100049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_VERTICAL */ 101049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_SFNT */ 102049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_KERNING */ 103049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_MULTIPLE_MASTERS */ 104049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_GLYPH_NAMES */ 105049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_EXTERNAL_STREAM */ 106049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_FAST_GLYPHS */ 107049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_HINTER */ 108049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 109049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_STYLE_FLAG_BOLD */ 110049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_STYLE_FLAG_ITALIC */ 111049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 112049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SizeRec */ 113049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_Metrics */ 114049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 115049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_GlyphSlotRec */ 116049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Glyph_Metrics */ 117049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SubGlyph */ 118049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 119049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Bitmap_Size */ 120049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 121049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Init_FreeType */ 122049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Done_FreeType */ 123049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 124049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_New_Face */ 125049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Done_Face */ 126049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_New_Memory_Face */ 127049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Open_Face */ 128049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Open_Args */ 129049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Parameter */ 130049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Attach_File */ 131049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Attach_Stream */ 132049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 133049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Char_Size */ 134049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Pixel_Sizes */ 135049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Request_Size */ 136049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Select_Size */ 137049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_Request_Type */ 138049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_Request */ 139049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Transform */ 140049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Load_Glyph */ 141049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Char_Index */ 142049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Name_Index */ 143049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Load_Char */ 144049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 145049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_OPEN_MEMORY */ 146049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_OPEN_STREAM */ 147049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_OPEN_PATHNAME */ 148049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_OPEN_DRIVER */ 149049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_OPEN_PARAMS */ 150049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 151049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_DEFAULT */ 152049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_RENDER */ 153049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_MONOCHROME */ 154049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_LINEAR_DESIGN */ 155049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_NO_SCALE */ 156049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_NO_HINTING */ 157049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_NO_BITMAP */ 158049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_CROP_BITMAP */ 159049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 160049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_VERTICAL_LAYOUT */ 161049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_IGNORE_TRANSFORM */ 162049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH */ 163049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_FORCE_AUTOHINT */ 164049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_NO_RECURSE */ 165049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_PEDANTIC */ 166049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 167049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_TARGET_NORMAL */ 168049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_TARGET_LIGHT */ 169049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_TARGET_MONO */ 170049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_TARGET_LCD */ 171049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_LOAD_TARGET_LCD_V */ 172049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 173049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Render_Glyph */ 174049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Render_Mode */ 175049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Kerning */ 176049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Kerning_Mode */ 177049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Track_Kerning */ 178049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Glyph_Name */ 179049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Postscript_Name */ 180049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 181049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_CharMapRec */ 182049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Select_Charmap */ 183049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Charmap */ 184049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Charmap_Index */ 185049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 18677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_INSTALLABLE_EMBEDDING */ 18777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_RESTRICTED_LICENSE_EMBEDDING */ 18877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_PREVIEW_AND_PRINT_EMBEDDING */ 18977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_EDITABLE_EMBEDDING */ 19077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_NO_SUBSETTING */ 19177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_BITMAP_EMBEDDING_ONLY */ 19277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 19377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_Get_FSType_Flags */ 19477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 195049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 196049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 197049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 198049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 199049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 200049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 201049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Glyph_Metrics */ 202049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 203049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 204049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A structure used to model the metrics of a single glyph. The */ 205049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* values are expressed in 26.6 fractional pixel format; if the flag */ 206049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_LOAD_NO_SCALE has been used while loading the glyph, values */ 207049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* are expressed in font units instead. */ 208049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 209049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 210049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* width :: */ 211049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The glyph's width. */ 212049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 213049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* height :: */ 214049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The glyph's height. */ 215049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 216049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* horiBearingX :: */ 217049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Left side bearing for horizontal layout. */ 218049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 219049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* horiBearingY :: */ 220049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Top side bearing for horizontal layout. */ 221049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 222049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* horiAdvance :: */ 223049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Advance width for horizontal layout. */ 224049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 225049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vertBearingX :: */ 226049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Left side bearing for vertical layout. */ 227049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 228049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vertBearingY :: */ 229c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* Top side bearing for vertical layout. Larger positive values */ 230c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* mean further below the vertical glyph origin. */ 231049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 232049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vertAdvance :: */ 233c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* Advance height for vertical layout. Positive values mean the */ 234c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* glyph has a positive advance downward. */ 235049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 236295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* <Note> */ 237295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* If not disabled with @FT_LOAD_NO_HINTING, the values represent */ 238295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* dimensions of the hinted glyph (in case hinting is applicable). */ 239295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* */ 240a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* Stroking a glyph with an outside border does not increase */ 241a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* `horiAdvance' or `vertAdvance'; you have to manually adjust these */ 242a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* values to account for the added width and height. */ 243a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* */ 244049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Glyph_Metrics_ 245049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 246049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos width; 247049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos height; 248049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 249049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos horiBearingX; 250049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos horiBearingY; 251049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos horiAdvance; 252049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 253049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos vertBearingX; 254049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos vertBearingY; 255049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos vertAdvance; 256049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 257049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Glyph_Metrics; 258049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 259049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 260049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 261049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 262049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 263049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Bitmap_Size */ 264049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 265049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 266049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This structure models the metrics of a bitmap strike (i.e., a set */ 267049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* of glyphs for a given point size and resolution) in a bitmap font. */ 268049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* It is used for the `available_sizes' field of @FT_Face. */ 269049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 270049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 271049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* height :: The vertical distance, in pixels, between two */ 272049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* consecutive baselines. It is always positive. */ 273049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 274049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* width :: The average width, in pixels, of all glyphs in the */ 275049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* strike. */ 276049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 277049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* size :: The nominal size of the strike in 26.6 fractional */ 278049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* points. This field is not very useful. */ 279049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 280049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* x_ppem :: The horizontal ppem (nominal width) in 26.6 fractional */ 281049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pixels. */ 282049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 283049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* y_ppem :: The vertical ppem (nominal height) in 26.6 fractional */ 284049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pixels. */ 285049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 286049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 287049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Windows FNT: */ 288049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The nominal size given in a FNT font is not reliable. Thus when */ 289049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the driver finds it incorrect, it sets `size' to some calculated */ 290049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* values and sets `x_ppem' and `y_ppem' to the pixel width and */ 291049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* height given in the font, respectively. */ 292049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 293049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* TrueType embedded bitmaps: */ 294049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `size', `width', and `height' values are not contained in the */ 295049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* bitmap strike itself. They are computed from the global font */ 296049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* parameters. */ 297049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 298049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Bitmap_Size_ 299049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 300049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short height; 301049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short width; 302049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 303049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos size; 304049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 305049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos x_ppem; 306049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos y_ppem; 307049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 308049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Bitmap_Size; 309049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 310049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 311049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 312049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 313049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 314049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* O B J E C T C L A S S E S */ 315049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 316049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 317049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 318049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 319049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 320049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 321049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 322049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Library */ 323049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 324049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 325049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a FreeType library instance. Each `library' is */ 326049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* completely independent from the others; it is the `root' of a set */ 327049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* of objects like fonts, faces, sizes, etc. */ 328049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 329049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* It also embeds a memory manager (see @FT_Memory), as well as a */ 330049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* scan-line converter object (see @FT_Raster). */ 331049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 332049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* For multi-threading applications each thread should have its own */ 333049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Library object. */ 334049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 335049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 336049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Library objects are normally created by @FT_Init_FreeType, and */ 337049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* destroyed with @FT_Done_FreeType. */ 338049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 339049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_LibraryRec_ *FT_Library; 340049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 341049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 342049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 343049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 344049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 345049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Module */ 346049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 347049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 348049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a given FreeType module object. Each module can be a */ 349049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* font driver, a renderer, or anything else that provides services */ 350049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* to the formers. */ 351049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 352049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_ModuleRec_* FT_Module; 353049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 354049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 355049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 356049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 357049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 358049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Driver */ 359049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 360049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 361049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a given FreeType font driver object. Each font driver */ 362049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is a special module capable of creating faces from font files. */ 363049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 364049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_DriverRec_* FT_Driver; 365049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 366049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 367049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 368049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 369049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 370049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Renderer */ 371049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 372049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 373049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a given FreeType renderer. A renderer is a special */ 374049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* module in charge of converting a glyph image to a bitmap, when */ 375049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* necessary. Each renderer supports a given glyph image format, and */ 376049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* one or more target surface depths. */ 377049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 378049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_RendererRec_* FT_Renderer; 379049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 380049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 381049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 382049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 383049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 384049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face */ 385049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 386049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 387049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a given typographic face object. A face object models */ 388049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a given typeface, in a given style. */ 389049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 390049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 391049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Each face object also owns a single @FT_GlyphSlot object, as well */ 392049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* as one or more @FT_Size objects. */ 393049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 394049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Use @FT_New_Face or @FT_Open_Face to create a new face object from */ 395049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a given filepathname or a custom input stream. */ 396049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 397049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Use @FT_Done_Face to destroy it (along with its slot and sizes). */ 398049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 399049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Also> */ 40077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* See @FT_FaceRec for the publicly accessible fields of a given face */ 40177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* object. */ 402049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 403049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_FaceRec_* FT_Face; 404049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 405049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 406049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 407049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 408049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 409049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size */ 410049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 411049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 412049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to an object used to model a face scaled to a given */ 413049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* character size. */ 414049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 415049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 416049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Each @FT_Face has an _active_ @FT_Size object that is used by */ 417049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* functions like @FT_Load_Glyph to determine the scaling */ 418049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* transformation which is used to load and hint glyphs and metrics. */ 419049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 420049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* You can use @FT_Set_Char_Size, @FT_Set_Pixel_Sizes, */ 421049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Request_Size or even @FT_Select_Size to change the content */ 422049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (i.e., the scaling values) of the active @FT_Size. */ 423049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 424049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* You can use @FT_New_Size to create additional size objects for a */ 425049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* given @FT_Face, but they won't be used by other functions until */ 426049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* you activate it through @FT_Activate_Size. Only one size can be */ 427049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* activated at any given time per face. */ 428049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 429049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Also> */ 43077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* See @FT_SizeRec for the publicly accessible fields of a given size */ 43177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* object. */ 432049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 433049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_SizeRec_* FT_Size; 434049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 435049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 436049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 437049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 438049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 439049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_GlyphSlot */ 440049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 441049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 442049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a given `glyph slot'. A slot is a container where it */ 44377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* is possible to load any of the glyphs contained in its parent */ 444049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face. */ 445049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 446049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* In other words, each time you call @FT_Load_Glyph or */ 447049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Load_Char, the slot's content is erased by the new glyph data, */ 448049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* i.e., the glyph's metrics, its image (bitmap or outline), and */ 449049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* other control information. */ 450049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 451049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Also> */ 45277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* See @FT_GlyphSlotRec for the publicly accessible glyph fields. */ 453049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 454049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_GlyphSlotRec_* FT_GlyphSlot; 455049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 456049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 457049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 458049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 459049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 460049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_CharMap */ 461049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 462049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 463049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a given character map. A charmap is used to translate */ 464049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* character codes in a given encoding into glyph indexes for its */ 465049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* parent's face. Some font formats may provide several charmaps per */ 466049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* font. */ 467049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 468049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Each face object owns zero or more charmaps, but only one of them */ 469049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* can be `active' and used by @FT_Get_Char_Index or @FT_Load_Char. */ 470049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 471049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The list of available charmaps in a face is available through the */ 472049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `face->num_charmaps' and `face->charmaps' fields of @FT_FaceRec. */ 473049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 474049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The currently active charmap is available as `face->charmap'. */ 475049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* You should call @FT_Set_Charmap to change it. */ 476049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 477049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 478049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* When a new face is created (either through @FT_New_Face or */ 479049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Open_Face), the library looks for a Unicode charmap within */ 480049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the list and automatically activates it. */ 481049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 482049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Also> */ 48377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* See @FT_CharMapRec for the publicly accessible fields of a given */ 48477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* character map. */ 485049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 486049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_CharMapRec_* FT_CharMap; 487049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 488049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 489049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 490049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 491049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Macro> */ 492049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_ENC_TAG */ 493049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 494049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 495049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This macro converts four-letter tags into an unsigned long. It is */ 496049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* used to define `encoding' identifiers (see @FT_Encoding). */ 497049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 498049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 49977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Since many 16-bit compilers don't like 32-bit enumerations, you */ 500049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* should redefine this macro in case of problems to something like */ 501049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* this: */ 502049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 503049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* { */ 504049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* #define FT_ENC_TAG( value, a, b, c, d ) value */ 505049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* } */ 506049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 507049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* to get a simple enumeration without assigning special numbers. */ 508049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 509049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 510049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#ifndef FT_ENC_TAG 511049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_ENC_TAG( value, a, b, c, d ) \ 512049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project value = ( ( (FT_UInt32)(a) << 24 ) | \ 513049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( (FT_UInt32)(b) << 16 ) | \ 514049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( (FT_UInt32)(c) << 8 ) | \ 515049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project (FT_UInt32)(d) ) 516049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 517049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#endif /* FT_ENC_TAG */ 518049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 519049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 520049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 521049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 522049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 523049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Encoding */ 524049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 525049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 526049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An enumeration used to specify character sets supported by */ 527049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charmaps. Used in the @FT_Select_Charmap API function. */ 528049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 529049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 530049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Despite the name, this enumeration lists specific character */ 531049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* repertories (i.e., charsets), and not text encoding methods (e.g., */ 532295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* UTF-8, UTF-16, etc.). */ 533049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 534049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Other encodings might be defined in the future. */ 535049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 536049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 53777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_NONE :: */ 53877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The encoding value~0 is reserved. */ 539049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 54077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_UNICODE :: */ 54177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to the Unicode character set. This value covers */ 54277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* all versions of the Unicode repertoire, including ASCII and */ 54377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Latin-1. Most fonts include a Unicode charmap, but not all */ 54477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* of them. */ 545049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 546295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* For example, if you want to access Unicode value U+1F028 (and */ 547295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* the font contains it), use value 0x1F028 as the input value for */ 548295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* @FT_Get_Char_Index. */ 549295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* */ 55077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_MS_SYMBOL :: */ 55177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to the Microsoft Symbol encoding, used to encode */ 55277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* mathematical symbols in the 32..255 character code range. For */ 55377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* more information, see `http://www.ceviz.net/symbol.htm'. */ 554049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 55577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_SJIS :: */ 55677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to Japanese SJIS encoding. More info at */ 55777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* at `http://langsupport.japanreference.com/encoding.shtml'. */ 55877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* See note on multi-byte encodings below. */ 559049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 56077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_GB2312 :: */ 56177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to an encoding system for Simplified Chinese as used */ 56277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* used in mainland China. */ 563049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 56477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_BIG5 :: */ 56577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to an encoding system for Traditional Chinese as */ 56677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* used in Taiwan and Hong Kong. */ 567049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 56877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_WANSUNG :: */ 56977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to the Korean encoding system known as Wansung. */ 57077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* For more information see */ 57177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* `http://www.microsoft.com/typography/unicode/949.txt'. */ 572049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 57377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_JOHAB :: */ 57477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The Korean standard character set (KS~C 5601-1992), which */ 57577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* corresponds to MS Windows code page 1361. This character set */ 57677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* includes all possible Hangeul character combinations. */ 577049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 57877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_ADOBE_LATIN_1 :: */ 57977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to a Latin-1 encoding as defined in a Type~1 */ 58077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* PostScript font. It is limited to 256 character codes. */ 581049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 58277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_ADOBE_STANDARD :: */ 58377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to the Adobe Standard encoding, as found in Type~1, */ 58477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* CFF, and OpenType/CFF fonts. It is limited to 256 character */ 58577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* codes. */ 586049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 58777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_ADOBE_EXPERT :: */ 58877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to the Adobe Expert encoding, as found in Type~1, */ 58977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* CFF, and OpenType/CFF fonts. It is limited to 256 character */ 59077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* codes. */ 591049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 59277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_ADOBE_CUSTOM :: */ 59377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to a custom encoding, as found in Type~1, CFF, and */ 59477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* OpenType/CFF fonts. It is limited to 256 character codes. */ 595049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 59677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_APPLE_ROMAN :: */ 59777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Corresponds to the 8-bit Apple roman encoding. Many TrueType */ 59877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* and OpenType fonts contain a charmap for this encoding, since */ 59977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* older versions of Mac OS are able to use it. */ 600049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 60177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_OLD_LATIN_2 :: */ 60277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* This value is deprecated and was never used nor reported by */ 60377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType. Don't use or test for it. */ 604049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 60577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_MS_SJIS :: */ 60677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Same as FT_ENCODING_SJIS. Deprecated. */ 607049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 60877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_MS_GB2312 :: */ 60977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Same as FT_ENCODING_GB2312. Deprecated. */ 610049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 61177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_MS_BIG5 :: */ 61277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Same as FT_ENCODING_BIG5. Deprecated. */ 613049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 61477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_MS_WANSUNG :: */ 61577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Same as FT_ENCODING_WANSUNG. Deprecated. */ 616049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 61777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_MS_JOHAB :: */ 61877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Same as FT_ENCODING_JOHAB. Deprecated. */ 619049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 620049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 62177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* By default, FreeType automatically synthesizes a Unicode charmap */ 62277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* for PostScript fonts, using their glyph names dictionaries. */ 62377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* However, it also reports the encodings defined explicitly in the */ 62477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* font file, for the cases when they are needed, with the Adobe */ 62577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* values as well. */ 62677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 62777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_NONE is set by the BDF and PCF drivers if the charmap */ 62877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* is neither Unicode nor ISO-8859-1 (otherwise it is set to */ 62977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_UNICODE). Use @FT_Get_BDF_Charset_ID to find out */ 63077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* which encoding is really present. If, for example, the */ 63177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* `cs_registry' field is `KOI8' and the `cs_encoding' field is `R', */ 63277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* the font is encoded in KOI8-R. */ 63377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 63477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_NONE is always set (with a single exception) by the */ 63577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* winfonts driver. Use @FT_Get_WinFNT_Header and examine the */ 63677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* `charset' field of the @FT_WinFNT_HeaderRec structure to find out */ 63777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* which encoding is really present. For example, */ 63877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_WinFNT_ID_CP1251 (204) means Windows code page 1251 (for */ 63977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Russian). */ 64077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 64177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_NONE is set if `platform_id' is @TT_PLATFORM_MACINTOSH */ 64277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* and `encoding_id' is not @TT_MAC_ID_ROMAN (otherwise it is set to */ 64377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_ENCODING_APPLE_ROMAN). */ 64477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 64577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* If `platform_id' is @TT_PLATFORM_MACINTOSH, use the function */ 64677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_Get_CMap_Language_ID to query the Mac language ID which may */ 64777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* be needed to be able to distinguish Apple encoding variants. See */ 64877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 64977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* http://www.unicode.org/Public/MAPPINGS/VENDORS/APPLE/README.TXT */ 65077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 65177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* to get an idea how to do that. Basically, if the language ID */ 65277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* is~0, don't use it, otherwise subtract 1 from the language ID. */ 65377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Then examine `encoding_id'. If, for example, `encoding_id' is */ 65477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @TT_MAC_ID_ROMAN and the language ID (minus~1) is */ 65577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* `TT_MAC_LANGID_GREEK', it is the Greek encoding, not Roman. */ 65677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @TT_MAC_ID_ARABIC with `TT_MAC_LANGID_FARSI' means the Farsi */ 65777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* variant the Arabic encoding. */ 658049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 659049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef enum FT_Encoding_ 660049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 661049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_NONE, 0, 0, 0, 0 ), 662049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 663049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_MS_SYMBOL, 's', 'y', 'm', 'b' ), 664049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_UNICODE, 'u', 'n', 'i', 'c' ), 665049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 666049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_SJIS, 's', 'j', 'i', 's' ), 667049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_GB2312, 'g', 'b', ' ', ' ' ), 668049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_BIG5, 'b', 'i', 'g', '5' ), 669049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_WANSUNG, 'w', 'a', 'n', 's' ), 670049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_JOHAB, 'j', 'o', 'h', 'a' ), 671049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 672049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for backwards compatibility */ 673049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENCODING_MS_SJIS = FT_ENCODING_SJIS, 674049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENCODING_MS_GB2312 = FT_ENCODING_GB2312, 675049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENCODING_MS_BIG5 = FT_ENCODING_BIG5, 676049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENCODING_MS_WANSUNG = FT_ENCODING_WANSUNG, 677049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENCODING_MS_JOHAB = FT_ENCODING_JOHAB, 678049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 679049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_ADOBE_STANDARD, 'A', 'D', 'O', 'B' ), 680049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_ADOBE_EXPERT, 'A', 'D', 'B', 'E' ), 681049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_ADOBE_CUSTOM, 'A', 'D', 'B', 'C' ), 682049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_ADOBE_LATIN_1, 'l', 'a', 't', '1' ), 683049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 684049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_OLD_LATIN_2, 'l', 'a', 't', '2' ), 685049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 686049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ENC_TAG( FT_ENCODING_APPLE_ROMAN, 'a', 'r', 'm', 'n' ) 687049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 688049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Encoding; 689049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 690049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 691049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 692049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 693049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 694049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ft_encoding_xxx */ 695049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 696049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 697049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* These constants are deprecated; use the corresponding @FT_Encoding */ 698049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* values instead. */ 699049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 700049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_none FT_ENCODING_NONE 701049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_unicode FT_ENCODING_UNICODE 702049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_symbol FT_ENCODING_MS_SYMBOL 703049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_latin_1 FT_ENCODING_ADOBE_LATIN_1 704049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_latin_2 FT_ENCODING_OLD_LATIN_2 705049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_sjis FT_ENCODING_SJIS 706049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_gb2312 FT_ENCODING_GB2312 707049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_big5 FT_ENCODING_BIG5 708049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_wansung FT_ENCODING_WANSUNG 709049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_johab FT_ENCODING_JOHAB 710049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 711049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_adobe_standard FT_ENCODING_ADOBE_STANDARD 712049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_adobe_expert FT_ENCODING_ADOBE_EXPERT 713049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_adobe_custom FT_ENCODING_ADOBE_CUSTOM 714049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_encoding_apple_roman FT_ENCODING_APPLE_ROMAN 715049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 716049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 717049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 718049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 719049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 720049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_CharMapRec */ 721049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 722049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 723049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The base charmap structure. */ 724049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 725049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 726049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the parent face object. */ 727049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 728049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* encoding :: An @FT_Encoding tag identifying the charmap. Use */ 729049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* this with @FT_Select_Charmap. */ 730049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 731049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* platform_id :: An ID number describing the platform for the */ 732049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* following encoding ID. This comes directly from */ 733049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the TrueType specification and should be emulated */ 734049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for other formats. */ 735049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 736049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* encoding_id :: A platform specific encoding number. This also */ 737049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* comes from the TrueType specification and should be */ 738049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* emulated similarly. */ 739049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 740049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_CharMapRec_ 741049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 742049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face face; 743049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Encoding encoding; 744049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UShort platform_id; 745049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UShort encoding_id; 746049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 747049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_CharMapRec; 748049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 749049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 750049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 751049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 752049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 753049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* B A S E O B J E C T C L A S S E S */ 754049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 755049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 756049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 757049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 758049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 759049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 760049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 761049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 762049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_Internal */ 763049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 764049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 765049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An opaque handle to an `FT_Face_InternalRec' structure, used to */ 766049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* model private data of a given @FT_Face object. */ 767049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 76877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* This structure might change between releases of FreeType~2 and is */ 769049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* not generally available to client applications. */ 770049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 771049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Face_InternalRec_* FT_Face_Internal; 772049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 773049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 774049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 775049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 776049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 777049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FaceRec */ 778049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 779049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 780049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FreeType root face class structure. A face object models a */ 781049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* typeface in a font file. */ 782049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 783049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 784049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* num_faces :: The number of faces in the font file. Some */ 785049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* font formats can have multiple faces in */ 786049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a font file. */ 787049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 788049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face_index :: The index of the face in the font file. It */ 78977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* is set to~0 if there is only one face in */ 790049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the font file. */ 791049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 792049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face_flags :: A set of bit flags that give important */ 793049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* information about the face; see */ 794049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_FACE_FLAG_XXX for the details. */ 795049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 796049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* style_flags :: A set of bit flags indicating the style of */ 797049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the face; see @FT_STYLE_FLAG_XXX for the */ 798049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* details. */ 799049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 800049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* num_glyphs :: The number of glyphs in the face. If the */ 801049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face is scalable and has sbits (see */ 802049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `num_fixed_sizes'), it is set to the number */ 803049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* of outline glyphs. */ 804049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 80577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* For CID-keyed fonts, this value gives the */ 80677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* highest CID used in the font. */ 80777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 808049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* family_name :: The face's family name. This is an ASCII */ 809049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* string, usually in English, which describes */ 810049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the typeface's family (like `Times New */ 811049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Roman', `Bodoni', `Garamond', etc). This */ 812049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is a least common denominator used to list */ 813049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* fonts. Some formats (TrueType & OpenType) */ 814049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* provide localized and Unicode versions of */ 815049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* this string. Applications should use the */ 816049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* format specific interface to access them. */ 817049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Can be NULL (e.g., in fonts embedded in a */ 818049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* PDF file). */ 819049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 820049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* style_name :: The face's style name. This is an ASCII */ 821049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* string, usually in English, which describes */ 822049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the typeface's style (like `Italic', */ 823049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `Bold', `Condensed', etc). Not all font */ 824049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* formats provide a style name, so this field */ 825049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is optional, and can be set to NULL. As */ 826049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for `family_name', some formats provide */ 827049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* localized and Unicode versions of this */ 828049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* string. Applications should use the format */ 829049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* specific interface to access them. */ 830049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 831049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* num_fixed_sizes :: The number of bitmap strikes in the face. */ 832049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Even if the face is scalable, there might */ 833049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* still be bitmap strikes, which are called */ 834049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `sbits' in that case. */ 835049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 836049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* available_sizes :: An array of @FT_Bitmap_Size for all bitmap */ 837049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* strikes in the face. It is set to NULL if */ 838049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* there is no bitmap strike. */ 839049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 840049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* num_charmaps :: The number of charmaps in the face. */ 841049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 842049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charmaps :: An array of the charmaps of the face. */ 843049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 844049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* generic :: A field reserved for client uses. See the */ 845049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Generic type description. */ 846049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 847049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* bbox :: The font bounding box. Coordinates are */ 848049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* expressed in font units (see */ 849049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `units_per_EM'). The box is large enough */ 850049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* to contain any glyph from the font. Thus, */ 851a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* `bbox.yMax' can be seen as the `maximum */ 852a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* ascender', and `bbox.yMin' as the `minimum */ 853049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* descender'. Only relevant for scalable */ 854049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* formats. */ 855049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 85677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Note that the bounding box might be off by */ 85777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* (at least) one pixel for hinted fonts. See */ 85877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_Size_Metrics for further discussion. */ 85977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 860049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* units_per_EM :: The number of font units per EM square for */ 861049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* this face. This is typically 2048 for */ 86277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* TrueType fonts, and 1000 for Type~1 fonts. */ 863049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Only relevant for scalable formats. */ 864049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 865049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ascender :: The typographic ascender of the face, */ 866049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* expressed in font units. For font formats */ 867049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* not having this information, it is set to */ 868049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `bbox.yMax'. Only relevant for scalable */ 869049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* formats. */ 870049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 871049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* descender :: The typographic descender of the face, */ 872049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* expressed in font units. For font formats */ 873049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* not having this information, it is set to */ 874049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `bbox.yMin'. Note that this field is */ 875049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* usually negative. Only relevant for */ 876049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* scalable formats. */ 877049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 878a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* height :: This value is the vertical distance */ 879049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* between two consecutive baselines, */ 880049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* expressed in font units. It is always */ 881049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* positive. Only relevant for scalable */ 882049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* formats. */ 883049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 884a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* If you want the global glyph height, use */ 885a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* `ascender - descender'. */ 886a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* */ 887a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* max_advance_width :: The maximum advance width, in font units, */ 888049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for all glyphs in this face. This can be */ 889049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* used to make word wrapping computations */ 890049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* faster. Only relevant for scalable */ 891049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* formats. */ 892049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 893a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* max_advance_height :: The maximum advance height, in font units, */ 894049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for all glyphs in this face. This is only */ 895049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* relevant for vertical layouts, and is set */ 896049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* to `height' for fonts that do not provide */ 897049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vertical metrics. Only relevant for */ 898049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* scalable formats. */ 899049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 900049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* underline_position :: The position, in font units, of the */ 90177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* underline line for this face. It is the */ 902049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* center of the underlining stem. Only */ 903049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* relevant for scalable formats. */ 904049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 905049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* underline_thickness :: The thickness, in font units, of the */ 906049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* underline for this face. Only relevant for */ 907049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* scalable formats. */ 908049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 909049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph :: The face's associated glyph slot(s). */ 910049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 911049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* size :: The current active size for this face. */ 912049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 913049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charmap :: The current active charmap for this face. */ 914049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 915049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 91677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Fields may be changed after a call to @FT_Attach_File or */ 91777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_Attach_Stream. */ 918049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 919049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_FaceRec_ 920049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 921049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long num_faces; 922049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long face_index; 923049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 924049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long face_flags; 925049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long style_flags; 926049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 927049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long num_glyphs; 928049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 929049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_String* family_name; 930049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_String* style_name; 931049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 932049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int num_fixed_sizes; 933049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Bitmap_Size* available_sizes; 934049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 935049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int num_charmaps; 936049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_CharMap* charmaps; 937049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 938049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Generic generic; 939049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 940049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*# The following member variables (down to `underline_thickness') */ 941049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*# are only relevant to scalable outlines; cf. @FT_Bitmap_Size */ 942049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*# for bitmap fonts. */ 943049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_BBox bbox; 944049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 945049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UShort units_per_EM; 946049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short ascender; 947049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short descender; 948049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short height; 949049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 950049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short max_advance_width; 951049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short max_advance_height; 952049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 953049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short underline_position; 954049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Short underline_thickness; 955049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 956049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_GlyphSlot glyph; 957049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Size size; 958049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_CharMap charmap; 959049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 960049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*@private begin */ 961049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 962049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Driver driver; 963049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Memory memory; 964049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Stream stream; 965049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 966049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ListRec sizes_list; 967049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 968e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang FT_Generic autohint; /* face-specific auto-hinter data */ 969e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang void* extensions; /* unused */ 970049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 971049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_Internal internal; 972049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 973049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*@private end */ 974049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 975049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_FaceRec; 976049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 977049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 978049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 979049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 980049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 981049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_XXX */ 982049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 983049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 984049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A list of bit flags used in the `face_flags' field of the */ 985049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_FaceRec structure. They inform client applications of */ 986049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* properties of the corresponding face. */ 987049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 988049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 989049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_SCALABLE :: */ 990049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the face contains outline glyphs. This doesn't */ 991049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* prevent bitmap strikes, i.e., a face can have both this and */ 992049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* and @FT_FACE_FLAG_FIXED_SIZES set. */ 993049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 994049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_FIXED_SIZES :: */ 995049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the face contains bitmap strikes. See also the */ 996049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `num_fixed_sizes' and `available_sizes' fields of @FT_FaceRec. */ 997049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 998049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_FIXED_WIDTH :: */ 999049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the face contains fixed-width characters (like */ 1000049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Courier, Lucido, MonoType, etc.). */ 1001049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1002049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_SFNT :: */ 1003049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the face uses the `sfnt' storage scheme. For */ 1004049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* now, this means TrueType and OpenType. */ 1005049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1006049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_HORIZONTAL :: */ 1007049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the face contains horizontal glyph metrics. This */ 1008049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* should be set for all common formats. */ 1009049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1010049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_VERTICAL :: */ 1011049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the face contains vertical glyph metrics. This */ 1012049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is only available in some formats, not all of them. */ 1013049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1014049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_KERNING :: */ 1015049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the face contains kerning information. If set, */ 1016049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the kerning distance can be retrieved through the function */ 1017049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Get_Kerning. Otherwise the function always return the */ 1018049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vector (0,0). Note that FreeType doesn't handle kerning data */ 1019049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* from the `GPOS' table (as present in some OpenType fonts). */ 1020049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1021049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_FAST_GLYPHS :: */ 1022049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* THIS FLAG IS DEPRECATED. DO NOT USE OR TEST IT. */ 1023049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1024049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_MULTIPLE_MASTERS :: */ 1025049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the font contains multiple masters and is capable */ 1026049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* of interpolating between them. See the multiple-masters */ 1027049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* specific API for details. */ 1028049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1029049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_GLYPH_NAMES :: */ 1030049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that the font contains glyph names that can be */ 1031049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* retrieved through @FT_Get_Glyph_Name. Note that some TrueType */ 1032049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* fonts contain broken glyph name tables. Use the function */ 1033049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Has_PS_Glyph_Names when needed. */ 1034049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1035049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_EXTERNAL_STREAM :: */ 1036049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Used internally by FreeType to indicate that a face's stream was */ 1037049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* provided by the client application and should not be destroyed */ 1038049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* when @FT_Done_Face is called. Don't read or test this flag. */ 1039049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1040049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_HINTER :: */ 1041049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Set if the font driver has a hinting machine of its own. For */ 1042049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* example, with TrueType fonts, it makes sense to use data from */ 1043049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the SFNT `gasp' table only if the native TrueType hinting engine */ 1044049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (with the bytecode interpreter) is available and active. */ 1045049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1046049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FACE_FLAG_CID_KEYED :: */ 1047049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Set if the font is CID-keyed. In that case, the font is not */ 1048049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* accessed by glyph indices but by CID values. For subsetted */ 1049049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* CID-keyed fonts this has the consequence that not all index */ 1050049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* values are a valid argument to FT_Load_Glyph. Only the CID */ 1051049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* values for which corresponding glyphs in the subsetted font */ 1052049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* exist make FT_Load_Glyph return successfully; in all other cases */ 1053049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* you get an `FT_Err_Invalid_Argument' error. */ 1054049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 105577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Note that CID-keyed fonts which are in an SFNT wrapper don't */ 105677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* have this flag set since the glyphs are accessed in the normal */ 105777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* way (using contiguous indices); the `CID-ness' isn't visible to */ 105877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* the application. */ 105977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 106077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FACE_FLAG_TRICKY :: */ 106177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Set if the font is `tricky', this is, it always needs the */ 106277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* font format's native hinting engine to get a reasonable result. */ 106377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* A typical example is the Chinese font `mingli.ttf' which uses */ 106477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* TrueType bytecode instructions to move and scale all of its */ 106577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* subglyphs. */ 106677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 106777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* It is not possible to autohint such fonts using */ 106877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_LOAD_FORCE_AUTOHINT; it will also ignore */ 1069c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* @FT_LOAD_NO_HINTING. You have to set both @FT_LOAD_NO_HINTING */ 107077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* and @FT_LOAD_NO_AUTOHINT to really disable hinting; however, you */ 107177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* probably never want this except for demonstration purposes. */ 107277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 1073c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* Currently, there are about a dozen TrueType fonts in the list of */ 1074c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* tricky fonts; they are hard-coded in file `ttobjs.c'. */ 107577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 1076049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_SCALABLE ( 1L << 0 ) 1077049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_FIXED_SIZES ( 1L << 1 ) 1078049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_FIXED_WIDTH ( 1L << 2 ) 1079049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_SFNT ( 1L << 3 ) 1080049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_HORIZONTAL ( 1L << 4 ) 1081049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_VERTICAL ( 1L << 5 ) 1082049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_KERNING ( 1L << 6 ) 1083049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_FAST_GLYPHS ( 1L << 7 ) 1084049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_MULTIPLE_MASTERS ( 1L << 8 ) 1085049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_GLYPH_NAMES ( 1L << 9 ) 1086049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_EXTERNAL_STREAM ( 1L << 10 ) 1087049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_HINTER ( 1L << 11 ) 1088049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_FACE_FLAG_CID_KEYED ( 1L << 12 ) 108977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_FACE_FLAG_TRICKY ( 1L << 13 ) 1090049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1091049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1092049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1093049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1094049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1095049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_HAS_HORIZONTAL( face ) 1096049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1097049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1098049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains 1099049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * horizontal metrics (this is true for all font formats though). 1100049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1101049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @also: 1102049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_HAS_VERTICAL can be used to check for vertical metrics. 1103049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1104049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1105049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_HAS_HORIZONTAL( face ) \ 1106049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_HORIZONTAL ) 1107049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1108049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1109049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1110049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1111049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1112049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_HAS_VERTICAL( face ) 1113049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1114049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1115a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * A macro that returns true whenever a face object contains real 1116a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * vertical metrics (and not only synthesized ones). 1117049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1118049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1119049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_HAS_VERTICAL( face ) \ 1120049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_VERTICAL ) 1121049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1122049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1123049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1124049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1125049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1126049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_HAS_KERNING( face ) 1127049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1128049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1129049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains kerning 1130049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * data that can be accessed with @FT_Get_Kerning. 1131049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1132049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1133049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_HAS_KERNING( face ) \ 1134049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_KERNING ) 1135049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1136049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1137049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1138049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1139049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1140049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_IS_SCALABLE( face ) 1141049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1142049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1143049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains a scalable 114477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * font face (true for TrueType, Type~1, Type~42, CID, OpenType/CFF, 1145049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * and PFR font formats. 1146049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1147049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1148049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_IS_SCALABLE( face ) \ 1149049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_SCALABLE ) 1150049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1151049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1152049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1153049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1154049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1155049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_IS_SFNT( face ) 1156049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1157049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1158049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains a font 1159049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * whose format is based on the SFNT storage scheme. This usually 1160049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * means: TrueType fonts, OpenType fonts, as well as SFNT-based embedded 1161049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * bitmap fonts. 1162049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1163049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * If this macro is true, all functions defined in @FT_SFNT_NAMES_H and 1164049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_TRUETYPE_TABLES_H are available. 1165049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1166049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1167049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_IS_SFNT( face ) \ 1168049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_SFNT ) 1169049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1170049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1171049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1172049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1173049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1174049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_IS_FIXED_WIDTH( face ) 1175049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1176049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1177049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains a font face 1178049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * that contains fixed-width (or `monospace', `fixed-pitch', etc.) 1179049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * glyphs. 1180049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1181049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1182049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_IS_FIXED_WIDTH( face ) \ 1183049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_FIXED_WIDTH ) 1184049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1185049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1186049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1187049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1188049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1189049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_HAS_FIXED_SIZES( face ) 1190049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1191049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1192049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains some 1193049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * embedded bitmaps. See the `available_sizes' field of the 1194049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_FaceRec structure. 1195049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1196049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1197049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_HAS_FIXED_SIZES( face ) \ 1198049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_FIXED_SIZES ) 1199049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1200049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1201049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1202049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1203049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1204049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_HAS_FAST_GLYPHS( face ) 1205049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1206049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1207049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Deprecated. 1208049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1209049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1210049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_HAS_FAST_GLYPHS( face ) 0 1211049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1212049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1213049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1214049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1215049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1216049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_HAS_GLYPH_NAMES( face ) 1217049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1218049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1219049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains some glyph 1220049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * names that can be accessed through @FT_Get_Glyph_Name. 1221049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1222049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1223049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_HAS_GLYPH_NAMES( face ) \ 1224049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_GLYPH_NAMES ) 1225049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1226049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1227049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1228049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1229049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1230049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_HAS_MULTIPLE_MASTERS( face ) 1231049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1232049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1233049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains some 1234049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * multiple masters. The functions provided by @FT_MULTIPLE_MASTERS_H 1235049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * are then available to choose the exact design you want. 1236049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1237049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1238049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_HAS_MULTIPLE_MASTERS( face ) \ 1239049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_MULTIPLE_MASTERS ) 1240049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1241049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1242049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 1243049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1244049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 1245049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_IS_CID_KEYED( face ) 1246049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1247049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 1248049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A macro that returns true whenever a face object contains a CID-keyed 1249049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * font. See the discussion of @FT_FACE_FLAG_CID_KEYED for more 1250049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * details. 1251049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1252049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * If this macro is true, all functions defined in @FT_CID_H are 1253049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * available. 1254049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1255049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 1256049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_IS_CID_KEYED( face ) \ 1257049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project ( face->face_flags & FT_FACE_FLAG_CID_KEYED ) 1258049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1259049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 126077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /************************************************************************* 126177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 126277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * @macro: 126377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * FT_IS_TRICKY( face ) 126477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 126577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * @description: 126677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * A macro that returns true whenever a face represents a `tricky' font. 126777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * See the discussion of @FT_FACE_FLAG_TRICKY for more details. 126877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 126977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner */ 127077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_IS_TRICKY( face ) \ 127177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner ( face->face_flags & FT_FACE_FLAG_TRICKY ) 127277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 127377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 1274049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1275049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 127677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Const> */ 1277049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_STYLE_FLAG_XXX */ 1278049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1279049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1280049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A list of bit-flags used to indicate the style of a given face. */ 1281049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* These are used in the `style_flags' field of @FT_FaceRec. */ 1282049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1283049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 1284049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_STYLE_FLAG_ITALIC :: */ 1285049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that a given face style is italic or oblique. */ 1286049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1287049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_STYLE_FLAG_BOLD :: */ 1288049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indicates that a given face is bold. */ 1289049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1290049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1291049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The style information as provided by FreeType is very basic. More */ 1292049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* details are beyond the scope and should be done on a higher level */ 1293049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (for example, by analyzing various fields of the `OS/2' table in */ 1294049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* SFNT based fonts). */ 1295049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1296049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_STYLE_FLAG_ITALIC ( 1 << 0 ) 1297049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_STYLE_FLAG_BOLD ( 1 << 1 ) 1298049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1299049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1300049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1301049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1302049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 1303049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_Internal */ 1304049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1305049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1306049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An opaque handle to an `FT_Size_InternalRec' structure, used to */ 1307049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* model private data of a given @FT_Size object. */ 1308049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1309049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Size_InternalRec_* FT_Size_Internal; 1310049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1311049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1312049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1313049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1314049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 1315049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_Metrics */ 1316049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1317049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1318049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The size metrics structure gives the metrics of a size object. */ 1319049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1320049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 1321049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* x_ppem :: The width of the scaled EM square in pixels, hence */ 1322049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the term `ppem' (pixels per EM). It is also */ 1323049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* referred to as `nominal width'. */ 1324049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1325049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* y_ppem :: The height of the scaled EM square in pixels, */ 1326049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* hence the term `ppem' (pixels per EM). It is also */ 1327049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* referred to as `nominal height'. */ 1328049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1329049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* x_scale :: A 16.16 fractional scaling value used to convert */ 1330049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* horizontal metrics from font units to 26.6 */ 1331049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* fractional pixels. Only relevant for scalable */ 1332049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* font formats. */ 1333049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1334049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* y_scale :: A 16.16 fractional scaling value used to convert */ 1335049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vertical metrics from font units to 26.6 */ 1336049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* fractional pixels. Only relevant for scalable */ 1337049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* font formats. */ 1338049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1339049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ascender :: The ascender in 26.6 fractional pixels. See */ 1340049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_FaceRec for the details. */ 1341049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1342049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* descender :: The descender in 26.6 fractional pixels. See */ 1343049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_FaceRec for the details. */ 1344049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1345049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* height :: The height in 26.6 fractional pixels. See */ 1346049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_FaceRec for the details. */ 1347049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1348a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* max_advance :: The maximum advance width in 26.6 fractional */ 1349049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pixels. See @FT_FaceRec for the details. */ 1350049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1351049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1352049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The scaling values, if relevant, are determined first during a */ 1353049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* size changing operation. The remaining fields are then set by the */ 1354049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* driver. For scalable formats, they are usually set to scaled */ 1355049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* values of the corresponding fields in @FT_FaceRec. */ 1356049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1357049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Note that due to glyph hinting, these values might not be exact */ 1358049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for certain fonts. Thus they must be treated as unreliable */ 1359049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* with an error margin of at least one pixel! */ 1360049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1361049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Indeed, the only way to get the exact metrics is to render _all_ */ 1362049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyphs. As this would be a definite performance hit, it is up to */ 1363049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* client applications to perform such computations. */ 1364049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1365049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The FT_Size_Metrics structure is valid for bitmap fonts also. */ 1366049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1367049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Size_Metrics_ 1368049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 1369049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UShort x_ppem; /* horizontal pixels per EM */ 1370049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UShort y_ppem; /* vertical pixels per EM */ 1371049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1372049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Fixed x_scale; /* scaling values used to convert font */ 1373049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Fixed y_scale; /* units to 26.6 fractional pixels */ 1374049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1375049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos ascender; /* ascender in 26.6 frac. pixels */ 1376049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos descender; /* descender in 26.6 frac. pixels */ 1377049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos height; /* text height in 26.6 frac. pixels */ 1378049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos max_advance; /* max horizontal advance, in 26.6 pixels */ 1379049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1380049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Size_Metrics; 1381049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1382049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1383049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1384049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1385049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 1386049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SizeRec */ 1387049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1388049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1389049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FreeType root size class structure. A size object models a face */ 1390049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* object at a given size. */ 1391049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1392049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 1393049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: Handle to the parent face object. */ 1394049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1395049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* generic :: A typeless pointer, which is unused by the FreeType */ 1396049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* library or any of its drivers. It can be used by */ 1397049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* client applications to link their own data to each size */ 1398049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* object. */ 1399049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1400049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* metrics :: Metrics for this size object. This field is read-only. */ 1401049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1402049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_SizeRec_ 1403049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 1404049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face face; /* parent face object */ 1405049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Generic generic; /* generic pointer for client uses */ 1406049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Size_Metrics metrics; /* size metrics */ 1407049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Size_Internal internal; 1408049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1409049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_SizeRec; 1410049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1411049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1412049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1413049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1414049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 1415049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SubGlyph */ 1416049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1417049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1418049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The subglyph structure is an internal object used to describe */ 1419049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* subglyphs (for example, in the case of composites). */ 1420049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1421049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1422049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The subglyph implementation is not part of the high-level API, */ 1423049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* hence the forward structure declaration. */ 1424049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1425049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* You can however retrieve subglyph information with */ 1426049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Get_SubGlyph_Info. */ 1427049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1428049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_SubGlyphRec_* FT_SubGlyph; 1429049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1430049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1431049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1432049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1433049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Type> */ 1434049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Slot_Internal */ 1435049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1436049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1437049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An opaque handle to an `FT_Slot_InternalRec' structure, used to */ 1438049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* model private data of a given @FT_GlyphSlot object. */ 1439049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1440049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Slot_InternalRec_* FT_Slot_Internal; 1441049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1442049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1443049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1444049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1445049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 1446049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_GlyphSlotRec */ 1447049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1448049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1449049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FreeType root glyph slot class structure. A glyph slot is a */ 1450049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* container where individual glyphs can be loaded, be they in */ 1451049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* outline or bitmap format. */ 1452049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1453049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 1454049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* library :: A handle to the FreeType library instance */ 1455049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* this slot belongs to. */ 1456049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1457049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the parent face object. */ 1458049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1459049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* next :: In some cases (like some font tools), several */ 1460049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph slots per face object can be a good */ 1461049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* thing. As this is rare, the glyph slots are */ 1462049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* listed through a direct, single-linked list */ 1463049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* using its `next' field. */ 1464049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1465049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* generic :: A typeless pointer which is unused by the */ 1466049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FreeType library or any of its drivers. It */ 1467049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* can be used by client applications to link */ 1468049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* their own data to each glyph slot object. */ 1469049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1470049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* metrics :: The metrics of the last loaded glyph in the */ 1471049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* slot. The returned values depend on the last */ 1472049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* load flags (see the @FT_Load_Glyph API */ 1473049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* function) and can be expressed either in 26.6 */ 1474049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* fractional pixels or font units. */ 1475049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1476049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Note that even when the glyph image is */ 1477049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* transformed, the metrics are not. */ 1478049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1479049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* linearHoriAdvance :: The advance width of the unhinted glyph. */ 1480049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Its value is expressed in 16.16 fractional */ 1481049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pixels, unless @FT_LOAD_LINEAR_DESIGN is set */ 1482049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* when loading the glyph. This field can be */ 1483049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* important to perform correct WYSIWYG layout. */ 1484049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Only relevant for outline glyphs. */ 1485049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1486049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* linearVertAdvance :: The advance height of the unhinted glyph. */ 1487049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Its value is expressed in 16.16 fractional */ 1488049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pixels, unless @FT_LOAD_LINEAR_DESIGN is set */ 1489049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* when loading the glyph. This field can be */ 1490049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* important to perform correct WYSIWYG layout. */ 1491049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Only relevant for outline glyphs. */ 1492049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1493295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* advance :: This shorthand is, depending on */ 1494295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* @FT_LOAD_IGNORE_TRANSFORM, the transformed */ 1495295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* advance width for the glyph (in 26.6 */ 1496295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* fractional pixel format). As specified with */ 1497295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* @FT_LOAD_VERTICAL_LAYOUT, it uses either the */ 1498295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* `horiAdvance' or the `vertAdvance' value of */ 1499295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* `metrics' field. */ 1500049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1501049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* format :: This field indicates the format of the image */ 1502049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* contained in the glyph slot. Typically */ 1503049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_GLYPH_FORMAT_BITMAP, */ 1504049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_GLYPH_FORMAT_OUTLINE, or */ 1505049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_GLYPH_FORMAT_COMPOSITE, but others are */ 1506049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* possible. */ 1507049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1508049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* bitmap :: This field is used as a bitmap descriptor */ 1509049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* when the slot format is */ 1510049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_GLYPH_FORMAT_BITMAP. Note that the */ 1511049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* address and content of the bitmap buffer can */ 1512049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* change between calls of @FT_Load_Glyph and a */ 1513049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* few other functions. */ 1514049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1515049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* bitmap_left :: This is the bitmap's left bearing expressed */ 1516049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* in integer pixels. Of course, this is only */ 1517049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* valid if the format is */ 1518049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_GLYPH_FORMAT_BITMAP. */ 1519049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1520049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* bitmap_top :: This is the bitmap's top bearing expressed in */ 1521049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* integer pixels. Remember that this is the */ 1522049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* distance from the baseline to the top-most */ 152377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* glyph scanline, upwards y~coordinates being */ 1524049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* *positive*. */ 1525049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1526049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* outline :: The outline descriptor for the current glyph */ 1527049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* image if its format is */ 1528049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_GLYPH_FORMAT_OUTLINE. Once a glyph is */ 1529049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* loaded, `outline' can be transformed, */ 1530049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* distorted, embolded, etc. However, it must */ 1531049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* not be freed. */ 1532049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1533049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* num_subglyphs :: The number of subglyphs in a composite glyph. */ 1534049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This field is only valid for the composite */ 1535049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph format that should normally only be */ 1536049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* loaded with the @FT_LOAD_NO_RECURSE flag. */ 1537049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* For now this is internal to FreeType. */ 1538049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1539049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* subglyphs :: An array of subglyph descriptors for */ 1540049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* composite glyphs. There are `num_subglyphs' */ 1541049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* elements in there. Currently internal to */ 1542049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FreeType. */ 1543049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1544049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* control_data :: Certain font drivers can also return the */ 1545049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* control data for a given glyph image (e.g. */ 154677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* TrueType bytecode, Type~1 charstrings, etc.). */ 1547049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This field is a pointer to such data. */ 1548049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1549049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* control_len :: This is the length in bytes of the control */ 1550049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* data. */ 1551049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1552049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* other :: Really wicked formats can use this pointer to */ 1553049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* present their own glyph image to client */ 1554049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* applications. Note that the application */ 1555049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* needs to know about the image format. */ 1556049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1557049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* lsb_delta :: The difference between hinted and unhinted */ 1558049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* left side bearing while autohinting is */ 1559049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* active. Zero otherwise. */ 1560049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1561049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* rsb_delta :: The difference between hinted and unhinted */ 1562049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* right side bearing while autohinting is */ 1563049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* active. Zero otherwise. */ 1564049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1565049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1566049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If @FT_Load_Glyph is called with default flags (see */ 1567049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_LOAD_DEFAULT) the glyph image is loaded in the glyph slot in */ 156877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* its native format (e.g., an outline glyph for TrueType and Type~1 */ 1569049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* formats). */ 1570049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1571049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This image can later be converted into a bitmap by calling */ 1572049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Render_Glyph. This function finds the current renderer for */ 157377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* the native image's format, then invokes it. */ 1574049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1575049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The renderer is in charge of transforming the native image through */ 157677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* the slot's face transformation fields, then converting it into a */ 1577049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* bitmap that is returned in `slot->bitmap'. */ 1578049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1579049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Note that `slot->bitmap_left' and `slot->bitmap_top' are also used */ 1580049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* to specify the position of the bitmap relative to the current pen */ 1581049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* position (e.g., coordinates (0,0) on the baseline). Of course, */ 1582049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `slot->format' is also changed to @FT_GLYPH_FORMAT_BITMAP. */ 1583049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1584049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1585049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Here a small pseudo code fragment which shows how to use */ 1586049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `lsb_delta' and `rsb_delta': */ 1587049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1588049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* { */ 1589049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Pos origin_x = 0; */ 1590049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Pos prev_rsb_delta = 0; */ 1591049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1592049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1593049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for all glyphs do */ 1594049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <compute kern between current and previous glyph and add it to */ 1595049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `origin_x'> */ 1596049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1597049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <load glyph with `FT_Load_Glyph'> */ 1598049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1599049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* if ( prev_rsb_delta - face->glyph->lsb_delta >= 32 ) */ 1600049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* origin_x -= 64; */ 1601049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* else if ( prev_rsb_delta - face->glyph->lsb_delta < -32 ) */ 1602049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* origin_x += 64; */ 1603049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1604049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* prev_rsb_delta = face->glyph->rsb_delta; */ 1605049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1606049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <save glyph image, or render glyph, or ...> */ 1607049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1608049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* origin_x += face->glyph->advance.x; */ 1609049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* endfor */ 1610049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* } */ 1611049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1612049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_GlyphSlotRec_ 1613049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 1614049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Library library; 1615049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face face; 1616049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_GlyphSlot next; 1617049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt reserved; /* retained for binary compatibility */ 1618049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Generic generic; 1619049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1620049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Glyph_Metrics metrics; 1621049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Fixed linearHoriAdvance; 1622049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Fixed linearVertAdvance; 1623049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Vector advance; 1624049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1625049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Glyph_Format format; 1626049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1627049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Bitmap bitmap; 1628049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int bitmap_left; 1629049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int bitmap_top; 1630049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1631049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Outline outline; 1632049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1633049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt num_subglyphs; 1634049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_SubGlyph subglyphs; 1635049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1636049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project void* control_data; 1637049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project long control_len; 1638049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1639049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos lsb_delta; 1640049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pos rsb_delta; 1641049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1642049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project void* other; 1643049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1644049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Slot_Internal internal; 1645049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1646049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_GlyphSlotRec; 1647049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1648049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1649049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1650049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1651049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1652049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* F U N C T I O N S */ 1653049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1654049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1655049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1656049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1657049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1658049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1659049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1660049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 1661049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Init_FreeType */ 1662049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1663049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1664049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Initialize a new FreeType library object. The set of modules */ 1665049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* that are registered by this function is determined at build time. */ 1666049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1667049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 1668049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* alibrary :: A handle to a new library object. */ 1669049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1670049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 167177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 1672049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1673295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* <Note> */ 1674295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* In case you want to provide your own memory allocating routines, */ 1675295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* use @FT_New_Library instead, followed by a call to */ 1676295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* @FT_Add_Default_Modules (or a series of calls to @FT_Add_Module). */ 1677295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* */ 1678e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* For multi-threading applications each thread should have its own */ 1679e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* FT_Library object. */ 1680e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* */ 1681049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 1682049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Init_FreeType( FT_Library *alibrary ); 1683049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1684049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1685049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1686049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1687049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 1688049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Done_FreeType */ 1689049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1690049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1691049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Destroy a given FreeType library object and all of its children, */ 1692049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* including resources, drivers, faces, sizes, etc. */ 1693049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1694049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 1695049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* library :: A handle to the target library object. */ 1696049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1697049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 169877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 1699049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1700049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 1701049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Done_FreeType( FT_Library library ); 1702049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1703049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1704049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1705049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1706049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 1707049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_OPEN_XXX */ 1708049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1709049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1710049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A list of bit-field constants used within the `flags' field of the */ 1711049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Open_Args structure. */ 1712049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1713049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 171477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_OPEN_MEMORY :: This is a memory-based stream. */ 1715049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 171677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_OPEN_STREAM :: Copy the stream from the `stream' field. */ 1717049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 171877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_OPEN_PATHNAME :: Create a new input stream from a C~path */ 171977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* name. */ 1720049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 172177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_OPEN_DRIVER :: Use the `driver' field. */ 1722049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 172377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_OPEN_PARAMS :: Use the `num_params' and `params' fields. */ 1724049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 172577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* ft_open_memory :: Deprecated; use @FT_OPEN_MEMORY instead. */ 1726049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 172777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* ft_open_stream :: Deprecated; use @FT_OPEN_STREAM instead. */ 1728049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 172977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* ft_open_pathname :: Deprecated; use @FT_OPEN_PATHNAME instead. */ 1730049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 173177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* ft_open_driver :: Deprecated; use @FT_OPEN_DRIVER instead. */ 1732049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 173377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* ft_open_params :: Deprecated; use @FT_OPEN_PARAMS instead. */ 1734049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1735049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1736049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The `FT_OPEN_MEMORY', `FT_OPEN_STREAM', and `FT_OPEN_PATHNAME' */ 1737049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* flags are mutually exclusive. */ 1738049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1739049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_OPEN_MEMORY 0x1 1740049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_OPEN_STREAM 0x2 1741049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_OPEN_PATHNAME 0x4 1742049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_OPEN_DRIVER 0x8 1743049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_OPEN_PARAMS 0x10 1744049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1745049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_open_memory FT_OPEN_MEMORY /* deprecated */ 1746049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_open_stream FT_OPEN_STREAM /* deprecated */ 1747049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_open_pathname FT_OPEN_PATHNAME /* deprecated */ 1748049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_open_driver FT_OPEN_DRIVER /* deprecated */ 1749049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_open_params FT_OPEN_PARAMS /* deprecated */ 1750049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1751049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1752049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1753049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1754049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 1755049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Parameter */ 1756049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1757049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 175877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* A simple structure used to pass more or less generic parameters to */ 175977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_Open_Face. */ 1760049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1761049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 1762049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* tag :: A four-byte identification tag. */ 1763049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1764049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* data :: A pointer to the parameter data. */ 1765049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1766049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1767295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* The ID and function of parameters are driver-specific. See the */ 1768295ffce55e0198e7a9f7d46b33f5c2b4147bf821David 'Digit' Turner /* various FT_PARAM_TAG_XXX flags for more information. */ 1769049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1770049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Parameter_ 1771049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 1772049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong tag; 1773049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pointer data; 1774049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1775049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Parameter; 1776049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1777049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1778049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1779049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1780049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 1781049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Open_Args */ 1782049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1783049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1784049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A structure used to indicate how to open a new font file or */ 1785049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* stream. A pointer to such a structure can be used as a parameter */ 1786049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for the functions @FT_Open_Face and @FT_Attach_Stream. */ 1787049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1788049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 1789049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* flags :: A set of bit flags indicating how to use the */ 1790049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* structure. */ 1791049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1792049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* memory_base :: The first byte of the file in memory. */ 1793049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1794049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* memory_size :: The size in bytes of the file in memory. */ 1795049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1796049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pathname :: A pointer to an 8-bit file pathname. */ 1797049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1798049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* stream :: A handle to a source stream object. */ 1799049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1800049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* driver :: This field is exclusively used by @FT_Open_Face; */ 1801049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* it simply specifies the font driver to use to open */ 180277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* the face. If set to~0, FreeType tries to load the */ 1803049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face with each one of the drivers in its list. */ 1804049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1805049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* num_params :: The number of extra parameters. */ 1806049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1807049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* params :: Extra parameters passed to the font driver when */ 1808049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* opening a new face. */ 1809049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1810049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1811049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The stream type is determined by the contents of `flags' which */ 1812049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* are tested in the following order by @FT_Open_Face: */ 1813049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1814049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If the `FT_OPEN_MEMORY' bit is set, assume that this is a */ 1815049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* memory file of `memory_size' bytes, located at `memory_address'. */ 1816049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The data are are not copied, and the client is responsible for */ 1817049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* releasing and destroying them _after_ the corresponding call to */ 1818049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Done_Face. */ 1819049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1820049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Otherwise, if the `FT_OPEN_STREAM' bit is set, assume that a */ 1821049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* custom input stream `stream' is used. */ 1822049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1823049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Otherwise, if the `FT_OPEN_PATHNAME' bit is set, assume that this */ 1824049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is a normal file and use `pathname' to open it. */ 1825049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1826049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If the `FT_OPEN_DRIVER' bit is set, @FT_Open_Face only tries to */ 1827049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* open the file with the driver whose handler is in `driver'. */ 1828049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1829049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If the `FT_OPEN_PARAMS' bit is set, the parameters given by */ 1830049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `num_params' and `params' is used. They are ignored otherwise. */ 1831049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1832049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Ideally, both the `pathname' and `params' fields should be tagged */ 183377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* as `const'; this is missing for API backwards compatibility. In */ 1834049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* other words, applications should treat them as read-only. */ 1835049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1836049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Open_Args_ 1837049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 1838049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt flags; 1839049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project const FT_Byte* memory_base; 1840049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long memory_size; 1841049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_String* pathname; 1842049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Stream stream; 1843049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Module driver; 1844049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int num_params; 1845049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Parameter* params; 1846049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1847049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Open_Args; 1848049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1849049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1850049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1851049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1852049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 1853049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_New_Face */ 1854049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1855049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1856049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function calls @FT_Open_Face to open a font by its pathname. */ 1857049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1858049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 1859049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* library :: A handle to the library resource. */ 1860049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1861049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 1862049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pathname :: A path to the font file. */ 1863049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1864049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face_index :: The index of the face within the font. The first */ 186577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* face has index~0. */ 1866049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1867049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 1868049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* aface :: A handle to a new face object. If `face_index' is */ 1869049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* greater than or equal to zero, it must be non-NULL. */ 1870049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* See @FT_Open_Face for more details. */ 1871049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1872049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 187377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 1874049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1875049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 1876049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_New_Face( FT_Library library, 1877049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project const char* filepathname, 1878049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long face_index, 1879049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face *aface ); 1880049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1881049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1882049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1883049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1884049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 1885049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_New_Memory_Face */ 1886049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1887049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1888049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function calls @FT_Open_Face to open a font which has been */ 1889049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* loaded into memory. */ 1890049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1891049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 1892049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* library :: A handle to the library resource. */ 1893049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1894049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 1895049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* file_base :: A pointer to the beginning of the font data. */ 1896049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1897049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* file_size :: The size of the memory chunk used by the font data. */ 1898049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1899049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face_index :: The index of the face within the font. The first */ 190077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* face has index~0. */ 1901049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1902049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 1903049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* aface :: A handle to a new face object. If `face_index' is */ 1904049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* greater than or equal to zero, it must be non-NULL. */ 1905049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* See @FT_Open_Face for more details. */ 1906049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1907049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 190877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 1909049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1910049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1911049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* You must not deallocate the memory before calling @FT_Done_Face. */ 1912049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1913049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 1914049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_New_Memory_Face( FT_Library library, 1915049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project const FT_Byte* file_base, 1916049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long file_size, 1917049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long face_index, 1918049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face *aface ); 1919049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1920049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1921049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1922049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1923049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 1924049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Open_Face */ 1925049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1926049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1927049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Create a face object from a given resource described by */ 1928049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Open_Args. */ 1929049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1930049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 1931049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* library :: A handle to the library resource. */ 1932049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1933049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 1934049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* args :: A pointer to an `FT_Open_Args' structure which must */ 1935049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* be filled by the caller. */ 1936049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1937049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face_index :: The index of the face within the font. The first */ 193877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* face has index~0. */ 1939049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1940049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 1941049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* aface :: A handle to a new face object. If `face_index' is */ 1942049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* greater than or equal to zero, it must be non-NULL. */ 1943049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* See note below. */ 1944049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1945049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 194677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 1947049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1948049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 1949049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Unlike FreeType 1.x, this function automatically creates a glyph */ 1950049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* slot for the face object which can be accessed directly through */ 1951049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `face->glyph'. */ 1952049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1953049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Open_Face can be used to quickly check whether the font */ 1954049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* format of a given font resource is supported by FreeType. If the */ 195577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* `face_index' field is negative, the function's return value is~0 */ 1956049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* if the font format is recognized, or non-zero otherwise; */ 1957049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the function returns a more or less empty face handle in `*aface' */ 1958049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (if `aface' isn't NULL). The only useful field in this special */ 1959049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* case is `face->num_faces' which gives the number of faces within */ 1960049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the font file. After examination, the returned @FT_Face structure */ 1961049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* should be deallocated with a call to @FT_Done_Face. */ 1962049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1963049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Each new face object created with this function also owns a */ 1964049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* default @FT_Size object, accessible as `face->size'. */ 1965049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1966e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* One @FT_Library instance can have multiple face objects, this is, */ 1967e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* @FT_Open_Face and its siblings can be called multiple times using */ 1968e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* the same `library' argument. */ 1969e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* */ 1970aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* See the discussion of reference counters in the description of */ 1971aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* @FT_Reference_Face. */ 1972aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 1973049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 1974049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Open_Face( FT_Library library, 1975049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project const FT_Open_Args* args, 1976049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long face_index, 1977049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face *aface ); 1978049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1979049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 1980049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 1981049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1982049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 1983049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Attach_File */ 1984049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1985049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 1986049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function calls @FT_Attach_Stream to attach a file. */ 1987049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1988049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 1989049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: The target face object. */ 1990049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1991049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 1992049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* filepathname :: The pathname. */ 1993049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1994049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 199577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 1996049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 1997049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 1998049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Attach_File( FT_Face face, 1999049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project const char* filepathname ); 2000049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2001049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2002049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2003049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2004049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2005049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Attach_Stream */ 2006049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2007049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2008049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `Attach' data to a face object. Normally, this is used to read */ 2009049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* additional information for the face object. For example, you can */ 201077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* attach an AFM file that comes with a Type~1 font to get the */ 2011049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* kerning values and other metrics. */ 2012049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2013049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2014049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: The target face object. */ 2015049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2016049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2017049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* parameters :: A pointer to @FT_Open_Args which must be filled by */ 2018049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the caller. */ 2019049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2020049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 202177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2022049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2023049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2024049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The meaning of the `attach' (i.e., what really happens when the */ 2025049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* new file is read) is not fixed by FreeType itself. It really */ 2026049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* depends on the font format (and thus the font driver). */ 2027049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2028049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Client applications are expected to know what they are doing */ 2029049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* when invoking this function. Most drivers simply do not implement */ 2030049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* file attachments. */ 2031049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2032049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2033049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Attach_Stream( FT_Face face, 2034049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Open_Args* parameters ); 2035049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2036049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2037049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2038049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2039049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2040aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* FT_Reference_Face */ 2041aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2042aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Description> */ 2043aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* A counter gets initialized to~1 at the time an @FT_Face structure */ 2044aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* is created. This function increments the counter. @FT_Done_Face */ 2045aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* then only destroys a face if the counter is~1, otherwise it simply */ 2046aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* decrements the counter. */ 2047aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2048aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* This function helps in managing life-cycles of structures which */ 2049aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* reference @FT_Face objects. */ 2050aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2051aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Input> */ 2052aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* face :: A handle to a target face object. */ 2053aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2054aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Return> */ 2055aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* FreeType error code. 0~means success. */ 2056aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2057aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Since> */ 2058aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* 2.4.2 */ 2059aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2060aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich FT_EXPORT( FT_Error ) 2061aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich FT_Reference_Face( FT_Face face ); 2062aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich 2063aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich 2064aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /*************************************************************************/ 2065aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2066aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Function> */ 2067049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Done_Face */ 2068049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2069049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2070049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Discard a given face object, as well as all of its child slots and */ 2071049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* sizes. */ 2072049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2073049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2074049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to a target face object. */ 2075049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2076049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 207777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2078049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2079aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Note> */ 2080aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* See the discussion of reference counters in the description of */ 2081aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* @FT_Reference_Face. */ 2082aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 2083049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2084049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Done_Face( FT_Face face ); 2085049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2086049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2087049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2088049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2089049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2090049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Select_Size */ 2091049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2092049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2093049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Select a bitmap strike. */ 2094049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2095049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2096049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to a target face object. */ 2097049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2098049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2099049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* strike_index :: The index of the bitmap strike in the */ 2100049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `available_sizes' field of @FT_FaceRec structure. */ 2101049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2102049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 210377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2104049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2105049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2106049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Select_Size( FT_Face face, 2107049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int strike_index ); 2108049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2109049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2110049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2111049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2112049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 2113049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_Request_Type */ 2114049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2115049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2116049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An enumeration type that lists the supported size request types. */ 2117049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2118049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 2119049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SIZE_REQUEST_TYPE_NOMINAL :: */ 2120049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The nominal size. The `units_per_EM' field of @FT_FaceRec is */ 2121049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* used to determine both scaling values. */ 2122049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2123049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SIZE_REQUEST_TYPE_REAL_DIM :: */ 2124c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* The real dimension. The sum of the the `ascender' and (minus */ 2125c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* of) the `descender' fields of @FT_FaceRec are used to determine */ 2126049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* both scaling values. */ 2127049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2128049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SIZE_REQUEST_TYPE_BBOX :: */ 2129049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The font bounding box. The width and height of the `bbox' field */ 2130049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* of @FT_FaceRec are used to determine the horizontal and vertical */ 2131049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* scaling value, respectively. */ 2132049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2133049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SIZE_REQUEST_TYPE_CELL :: */ 2134049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The `max_advance_width' field of @FT_FaceRec is used to */ 2135049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* determine the horizontal scaling value; the vertical scaling */ 2136049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* value is determined the same way as */ 2137049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_SIZE_REQUEST_TYPE_REAL_DIM does. Finally, both scaling */ 2138049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* values are set to the smaller one. This type is useful if you */ 2139049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* want to specify the font size for, say, a window of a given */ 2140049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* dimension and 80x24 cells. */ 2141049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2142049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_SIZE_REQUEST_TYPE_SCALES :: */ 2143049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Specify the scaling values directly. */ 2144049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2145049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2146049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The above descriptions only apply to scalable formats. For bitmap */ 2147049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* formats, the behaviour is up to the driver. */ 2148049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2149049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* See the note section of @FT_Size_Metrics if you wonder how size */ 2150049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* requesting relates to scaling values. */ 2151049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2152049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef enum FT_Size_Request_Type_ 2153049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 2154049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_SIZE_REQUEST_TYPE_NOMINAL, 2155049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_SIZE_REQUEST_TYPE_REAL_DIM, 2156049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_SIZE_REQUEST_TYPE_BBOX, 2157049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_SIZE_REQUEST_TYPE_CELL, 2158049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_SIZE_REQUEST_TYPE_SCALES, 2159049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2160049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_SIZE_REQUEST_TYPE_MAX 2161049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2162049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Size_Request_Type; 2163049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2164049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2165049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2166049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2167049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 2168049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_RequestRec */ 2169049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2170049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2171049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A structure used to model a size request. */ 2172049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2173049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Fields> */ 2174049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* type :: See @FT_Size_Request_Type. */ 2175049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2176049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* width :: The desired width. */ 2177049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2178049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* height :: The desired height. */ 2179049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2180049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* horiResolution :: The horizontal resolution. If set to zero, */ 2181049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `width' is treated as a 26.6 fractional pixel */ 2182049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* value. */ 2183049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2184049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vertResolution :: The vertical resolution. If set to zero, */ 2185049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `height' is treated as a 26.6 fractional pixel */ 2186049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* value. */ 2187049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2188049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 218977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* If `width' is zero, then the horizontal scaling value is set equal */ 219077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* to the vertical scaling value, and vice versa. */ 2191049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2192049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Size_RequestRec_ 2193049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 2194049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Size_Request_Type type; 2195049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long width; 2196049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long height; 2197049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt horiResolution; 2198049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt vertResolution; 2199049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2200049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Size_RequestRec; 2201049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2202049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2203049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2204049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2205049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Struct> */ 2206049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Size_Request */ 2207049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2208049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2209049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to a size request structure. */ 2210049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2211049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef struct FT_Size_RequestRec_ *FT_Size_Request; 2212049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2213049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2214049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2215049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2216049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2217049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Request_Size */ 2218049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2219049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2220049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Resize the scale of the active @FT_Size object in a face. */ 2221049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2222049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2223049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to a target face object. */ 2224049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2225049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2226049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* req :: A pointer to a @FT_Size_RequestRec. */ 2227049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2228049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 222977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2230049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2231049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2232049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Although drivers may select the bitmap strike matching the */ 2233049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* request, you should not rely on this if you intend to select a */ 2234049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* particular bitmap strike. Use @FT_Select_Size instead in that */ 2235049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* case. */ 2236049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2237a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* The relation between the requested size and the resulting glyph */ 2238a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* size is dependent entirely on how the size is defined in the */ 2239a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* source face. The font designer chooses the final size of each */ 2240a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* glyph relative to this size. For more information refer to */ 2241a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* `http://www.freetype.org/freetype2/docs/glyphs/glyphs-2.html' */ 2242a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* */ 2243049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2244049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Request_Size( FT_Face face, 2245049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Size_Request req ); 2246049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2247049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2248049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2249049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2250049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2251049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Char_Size */ 2252049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2253049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2254049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function calls @FT_Request_Size to request the nominal size */ 2255049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (in points). */ 2256049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2257049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2258049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to a target face object. */ 2259049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2260049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2261049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* char_width :: The nominal width, in 26.6 fractional points. */ 2262049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2263049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* char_height :: The nominal height, in 26.6 fractional points. */ 2264049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2265049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* horz_resolution :: The horizontal resolution in dpi. */ 2266049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2267049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vert_resolution :: The vertical resolution in dpi. */ 2268049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2269049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 227077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2271049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2272049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2273049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If either the character width or height is zero, it is set equal */ 2274049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* to the other value. */ 2275049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2276049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If either the horizontal or vertical resolution is zero, it is set */ 2277049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* equal to the other value. */ 2278049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2279049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A character width or height smaller than 1pt is set to 1pt; if */ 2280049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* both resolution values are zero, they are set to 72dpi. */ 2281049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 228277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Don't use this function if you are using the FreeType cache API. */ 228377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 2284049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2285049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Set_Char_Size( FT_Face face, 2286049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_F26Dot6 char_width, 2287049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_F26Dot6 char_height, 2288049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt horz_resolution, 2289049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt vert_resolution ); 2290049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2291049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2292049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2293049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2294049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2295049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Pixel_Sizes */ 2296049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2297049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2298049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function calls @FT_Request_Size to request the nominal size */ 2299049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (in pixels). */ 2300049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2301049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2302049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the target face object. */ 2303049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2304049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2305049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pixel_width :: The nominal width, in pixels. */ 2306049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2307049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* pixel_height :: The nominal height, in pixels. */ 2308049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2309049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 231077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2311049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2312a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* <Note> */ 2313a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* You should not rely on the resulting glyphs matching, or being */ 2314a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* constrained, to this pixel size. Refer to @FT_Request_Size to */ 2315a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* understand how requested sizes relate to actual sizes. */ 2316a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* */ 2317049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2318049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Set_Pixel_Sizes( FT_Face face, 2319049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt pixel_width, 2320049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt pixel_height ); 2321049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2322049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2323049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2324049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2325049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2326049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Load_Glyph */ 2327049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2328049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2329049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A function used to load a single glyph into the glyph slot of a */ 2330049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face object. */ 2331049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2332049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2333049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the target face object where the glyph */ 2334049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is loaded. */ 2335049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2336049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2337049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph_index :: The index of the glyph in the font file. For */ 2338049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* CID-keyed fonts (either in PS or in CFF format) */ 2339049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* this argument specifies the CID value. */ 2340049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2341049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* load_flags :: A flag indicating what to load for this glyph. The */ 2342049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_LOAD_XXX constants can be used to control the */ 2343049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph loading process (e.g., whether the outline */ 2344049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* should be scaled, whether to load bitmaps or not, */ 2345049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* whether to hint the outline, etc). */ 2346049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2347049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 234877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2349049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2350049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2351049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The loaded glyph may be transformed. See @FT_Set_Transform for */ 2352049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the details. */ 2353049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2354049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* For subsetted CID-keyed fonts, `FT_Err_Invalid_Argument' is */ 2355049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* returned for invalid CID values (this is, for CID values which */ 2356049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* don't have a corresponding glyph in the font). See the discussion */ 2357049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* of the @FT_FACE_FLAG_CID_KEYED flag for more details. */ 2358049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2359049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2360049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Load_Glyph( FT_Face face, 2361049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt glyph_index, 2362049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int32 load_flags ); 2363049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2364049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2365049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2366049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2367049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2368049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Load_Char */ 2369049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2370049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2371049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A function used to load a single glyph into the glyph slot of a */ 2372049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face object, according to its character code. */ 2373049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2374049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2375049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to a target face object where the glyph */ 2376049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is loaded. */ 2377049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2378049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2379049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* char_code :: The glyph's character code, according to the */ 2380049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* current charmap used in the face. */ 2381049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2382049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* load_flags :: A flag indicating what to load for this glyph. The */ 2383049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_LOAD_XXX constants can be used to control the */ 2384049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph loading process (e.g., whether the outline */ 2385049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* should be scaled, whether to load bitmaps or not, */ 2386049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* whether to hint the outline, etc). */ 2387049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2388049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 238977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2390049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2391049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2392049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function simply calls @FT_Get_Char_Index and @FT_Load_Glyph. */ 2393049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2394049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2395049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Load_Char( FT_Face face, 2396049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong char_code, 2397049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int32 load_flags ); 2398049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2399049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2400049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 2401049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2402049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @enum: 2403049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_XXX 2404049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2405049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 2406049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A list of bit-field constants used with @FT_Load_Glyph to indicate 2407049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * what kind of operations to perform during glyph loading. 2408049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2409049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @values: 2410049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_DEFAULT :: 241177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * Corresponding to~0, this value is used as the default glyph load 2412049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * operation. In this case, the following happens: 2413049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2414049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 1. FreeType looks for a bitmap for the glyph corresponding to the 2415049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * face's current size. If one is found, the function returns. 2416049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The bitmap data can be accessed from the glyph slot (see note 2417049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * below). 2418049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2419049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2. If no embedded bitmap is searched or found, FreeType looks for a 2420049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * scalable outline. If one is found, it is loaded from the font 2421049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * file, scaled to device pixels, then `hinted' to the pixel grid 2422049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * in order to optimize it. The outline data can be accessed from 2423049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * the glyph slot (see note below). 2424049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2425049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Note that by default, the glyph loader doesn't render outlines into 2426049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * bitmaps. The following flags are used to modify this default 2427049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * behaviour to more specific and useful cases. 2428049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2429049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_NO_SCALE :: 2430a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Don't scale the loaded outline glyph but keep it in font units. 2431049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2432049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * This flag implies @FT_LOAD_NO_HINTING and @FT_LOAD_NO_BITMAP, and 2433049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * unsets @FT_LOAD_RENDER. 2434049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2435a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * If the font is `tricky' (see @FT_FACE_FLAG_TRICKY for more), using 2436a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * FT_LOAD_NO_SCALE usually yields meaningless outlines because the 2437a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * subglyphs must be scaled and positioned with hinting instructions. 2438a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * This can be solved by loading the font without FT_LOAD_NO_SCALE and 2439a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * setting the character size to `font->units_per_EM'. 2440a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 2441049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_NO_HINTING :: 2442a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Disable hinting. This generally generates `blurrier' bitmap glyphs 2443a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * when the glyph are rendered in any of the anti-aliased modes. See 2444049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * also the note below. 2445049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2446049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * This flag is implied by @FT_LOAD_NO_SCALE. 2447049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2448049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_RENDER :: 2449049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Call @FT_Render_Glyph after the glyph is loaded. By default, the 2450049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * glyph is rendered in @FT_RENDER_MODE_NORMAL mode. This can be 2451049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * overridden by @FT_LOAD_TARGET_XXX or @FT_LOAD_MONOCHROME. 2452049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2453049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * This flag is unset by @FT_LOAD_NO_SCALE. 2454049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2455049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_NO_BITMAP :: 2456049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Ignore bitmap strikes when loading. Bitmap-only fonts ignore this 2457049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * flag. 2458049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2459049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_LOAD_NO_SCALE always sets this flag. 2460049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2461049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_VERTICAL_LAYOUT :: 2462a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Load the glyph for vertical text layout. In particular, the 2463a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `advance' value in the @FT_GlyphSlotRec structure is set to the 2464a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `vertAdvance' value of the `metrics' field. 2465a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 2466a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * In case @FT_HAS_VERTICAL doesn't return true, you shouldn't use 2467a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * this flag currently. Reason is that in this case vertical metrics 2468a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * get synthesized, and those values are not always consistent across 2469a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * various font formats. 2470049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2471049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_FORCE_AUTOHINT :: 2472049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Indicates that the auto-hinter is preferred over the font's native 2473049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * hinter. See also the note below. 2474049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2475049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_CROP_BITMAP :: 2476049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Indicates that the font driver should crop the loaded bitmap glyph 2477049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * (i.e., remove all space around its black bits). Not all drivers 2478049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * implement this. 2479049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2480049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_PEDANTIC :: 2481049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Indicates that the font driver should perform pedantic verifications 2482049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * during glyph loading. This is mostly used to detect broken glyphs 2483049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * in fonts. By default, FreeType tries to handle broken fonts also. 2484049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2485e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang * In particular, errors from the TrueType bytecode engine are not 2486e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang * passed to the application if this flag is not set; this might 2487e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang * result in partially hinted or distorted glyphs in case a glyph's 2488e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang * bytecode is buggy. 2489e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang * 2490049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH :: 2491c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner * Ignored. Deprecated. 2492049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2493049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_NO_RECURSE :: 2494049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * This flag is only used internally. It merely indicates that the 2495049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * font driver should not load composite glyphs recursively. Instead, 2496049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * it should set the `num_subglyph' and `subglyphs' values of the 2497049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * glyph slot accordingly, and set `glyph->format' to 2498049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_GLYPH_FORMAT_COMPOSITE. 2499049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2500049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The description of sub-glyphs is not available to client 2501049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * applications for now. 2502049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2503049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * This flag implies @FT_LOAD_NO_SCALE and @FT_LOAD_IGNORE_TRANSFORM. 2504049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2505049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_IGNORE_TRANSFORM :: 2506049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Indicates that the transform matrix set by @FT_Set_Transform should 2507049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * be ignored. 2508049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2509049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_MONOCHROME :: 2510049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * This flag is used with @FT_LOAD_RENDER to indicate that you want to 2511049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * render an outline glyph to a 1-bit monochrome bitmap glyph, with 251277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 8~pixels packed into each byte of the bitmap data. 2513049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2514049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Note that this has no effect on the hinting algorithm used. You 251577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * should rather use @FT_LOAD_TARGET_MONO so that the 2516049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * monochrome-optimized hinting algorithm is used. 2517049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2518049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_LINEAR_DESIGN :: 2519049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Indicates that the `linearHoriAdvance' and `linearVertAdvance' 2520049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * fields of @FT_GlyphSlotRec should be kept in font units. See 2521049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_GlyphSlotRec for details. 2522049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2523049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_NO_AUTOHINT :: 2524049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Disable auto-hinter. See also the note below. 2525049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2526a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * FT_LOAD_COLOR :: 2527a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * This flag is used to request loading of color embedded-bitmap 2528a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * images. The resulting color bitmaps, if available, will have the 2529a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * @FT_PIXEL_MODE_BGRA format. When the flag is not used and color 2530a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * bitmaps are found, they will be converted to 256-level gray 2531a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * bitmaps transparently. Those bitmaps will be in the 2532a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * @FT_PIXEL_MODE_GRAY format. 2533a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 2534049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @note: 2535049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * By default, hinting is enabled and the font's native hinter (see 2536049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_FACE_FLAG_HINTER) is preferred over the auto-hinter. You can 2537049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * disable hinting by setting @FT_LOAD_NO_HINTING or change the 2538049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * precedence by setting @FT_LOAD_FORCE_AUTOHINT. You can also set 2539049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_LOAD_NO_AUTOHINT in case you don't want the auto-hinter to be 2540049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * used at all. 2541049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 254277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * See the description of @FT_FACE_FLAG_TRICKY for a special exception 254377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * (affecting only a handful of Asian fonts). 254477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 2545049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Besides deciding which hinter to use, you can also decide which 2546049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * hinting algorithm to use. See @FT_LOAD_TARGET_XXX for details. 254777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 2548a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Note that the auto-hinter needs a valid Unicode cmap (either a native 2549a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * one or synthesized by FreeType) for producing correct results. If a 2550a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * font provides an incorrect mapping (for example, assigning the 2551a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * character code U+005A, LATIN CAPITAL LETTER Z, to a glyph depicting a 2552a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * mathematical integral sign), the auto-hinter might produce useless 2553a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * results. 2554a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 2555049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 2556049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_LOAD_DEFAULT 0x0 2557e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_NO_SCALE ( 1L << 0 ) 2558e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_NO_HINTING ( 1L << 1 ) 2559e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_RENDER ( 1L << 2 ) 2560e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_NO_BITMAP ( 1L << 3 ) 2561e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_VERTICAL_LAYOUT ( 1L << 4 ) 2562e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_FORCE_AUTOHINT ( 1L << 5 ) 2563e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_CROP_BITMAP ( 1L << 6 ) 2564e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_PEDANTIC ( 1L << 7 ) 2565e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH ( 1L << 9 ) 2566e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_NO_RECURSE ( 1L << 10 ) 2567e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_IGNORE_TRANSFORM ( 1L << 11 ) 2568e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_MONOCHROME ( 1L << 12 ) 2569e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_LINEAR_DESIGN ( 1L << 13 ) 2570e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_NO_AUTOHINT ( 1L << 15 ) 2571a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* Bits 16..19 are used by `FT_LOAD_TARGET_' */ 2572a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#define FT_LOAD_COLOR ( 1L << 20 ) 2573049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2574049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2575049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 257677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* used internally only by certain font drivers! */ 2577e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_ADVANCE_ONLY ( 1L << 8 ) 2578e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang#define FT_LOAD_SBITS_ONLY ( 1L << 14 ) 257977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 2580049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2581049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************** 2582049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2583049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @enum: 2584049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_TARGET_XXX 2585049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2586049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 2587049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A list of values that are used to select a specific hinting algorithm 2588049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * to use by the hinter. You should OR one of these values to your 2589049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * `load_flags' when calling @FT_Load_Glyph. 2590049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2591049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Note that font's native hinters may ignore the hinting algorithm you 2592049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * have specified (e.g., the TrueType bytecode interpreter). You can set 2593049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_LOAD_FORCE_AUTOHINT to ensure that the auto-hinter is used. 2594049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2595049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Also note that @FT_LOAD_TARGET_LIGHT is an exception, in that it 2596049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * always implies @FT_LOAD_FORCE_AUTOHINT. 2597049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2598049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @values: 2599049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_TARGET_NORMAL :: 2600049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * This corresponds to the default hinting algorithm, optimized for 2601049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * standard gray-level rendering. For monochrome output, use 2602049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_LOAD_TARGET_MONO instead. 2603049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2604049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_TARGET_LIGHT :: 2605049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A lighter hinting algorithm for non-monochrome modes. Many 2606049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * generated glyphs are more fuzzy but better resemble its original 260777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * shape. A bit like rendering on Mac OS~X. 2608049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2609049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * As a special exception, this target implies @FT_LOAD_FORCE_AUTOHINT. 2610049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2611049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_TARGET_MONO :: 2612049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Strong hinting algorithm that should only be used for monochrome 2613049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * output. The result is probably unpleasant if the glyph is rendered 2614049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * in non-monochrome modes. 2615049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2616049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_TARGET_LCD :: 2617049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A variant of @FT_LOAD_TARGET_NORMAL optimized for horizontally 2618049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * decimated LCD displays. 2619049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2620049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_TARGET_LCD_V :: 2621049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A variant of @FT_LOAD_TARGET_NORMAL optimized for vertically 2622049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * decimated LCD displays. 2623049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2624049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @note: 2625049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * You should use only _one_ of the FT_LOAD_TARGET_XXX values in your 2626049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * `load_flags'. They can't be ORed. 2627049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2628049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * If @FT_LOAD_RENDER is also set, the glyph is rendered in the 2629049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * corresponding mode (i.e., the mode which matches the used algorithm 2630a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * best). An exeption is FT_LOAD_TARGET_MONO since it implies 2631a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * @FT_LOAD_MONOCHROME. 2632049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2633049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * You can use a hinting algorithm that doesn't correspond to the same 2634049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * rendering mode. As an example, it is possible to use the `light' 2635049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * hinting algorithm and have the results rendered in horizontal LCD 2636049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * pixel mode, with code like 2637049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2638049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * { 2639049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_Load_Glyph( face, glyph_index, 2640049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * load_flags | FT_LOAD_TARGET_LIGHT ); 2641049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2642049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_Render_Glyph( face->glyph, FT_RENDER_MODE_LCD ); 2643049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * } 264477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 2645049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 264677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_LOAD_TARGET_( x ) ( (FT_Int32)( (x) & 15 ) << 16 ) 2647049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 264877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_LOAD_TARGET_NORMAL FT_LOAD_TARGET_( FT_RENDER_MODE_NORMAL ) 264977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_LOAD_TARGET_LIGHT FT_LOAD_TARGET_( FT_RENDER_MODE_LIGHT ) 265077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_LOAD_TARGET_MONO FT_LOAD_TARGET_( FT_RENDER_MODE_MONO ) 265177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_LOAD_TARGET_LCD FT_LOAD_TARGET_( FT_RENDER_MODE_LCD ) 265277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_LOAD_TARGET_LCD_V FT_LOAD_TARGET_( FT_RENDER_MODE_LCD_V ) 2653049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2654049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2655049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************** 2656049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2657049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 2658049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_LOAD_TARGET_MODE 2659049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2660049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 2661049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Return the @FT_Render_Mode corresponding to a given 2662049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @FT_LOAD_TARGET_XXX value. 2663049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 2664049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 2665049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_LOAD_TARGET_MODE( x ) ( (FT_Render_Mode)( ( (x) >> 16 ) & 15 ) ) 2666049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2667049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2668049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2669049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2670049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2671049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Transform */ 2672049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2673049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2674049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A function used to set the transformation that is applied to glyph */ 2675049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* images when they are loaded into a glyph slot through */ 2676049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Load_Glyph. */ 2677049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2678049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2679049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 2680049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2681049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 268277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* matrix :: A pointer to the transformation's 2x2 matrix. Use~0 for */ 2683049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the identity matrix. */ 268477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* delta :: A pointer to the translation vector. Use~0 for the null */ 2685049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vector. */ 2686049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2687049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2688049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The transformation is only applied to scalable image formats after */ 2689049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the glyph has been loaded. It means that hinting is unaltered by */ 2690049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the transformation and is performed on the character size given in */ 2691049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the last call to @FT_Set_Char_Size or @FT_Set_Pixel_Sizes. */ 2692049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2693049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Note that this also transforms the `face.glyph.advance' field, but */ 2694049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* *not* the values in `face.glyph.metrics'. */ 2695049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2696049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( void ) 2697049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Set_Transform( FT_Face face, 2698049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Matrix* matrix, 2699049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Vector* delta ); 2700049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2701049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2702049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2703049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2704049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 2705049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Render_Mode */ 2706049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2707049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2708049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An enumeration type that lists the render modes supported by */ 270977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType~2. Each mode corresponds to a specific type of scanline */ 2710049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* conversion performed on the outline. */ 2711049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 271277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* For bitmap fonts and embedded bitmaps the `bitmap->pixel_mode' */ 271377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* field in the @FT_GlyphSlotRec structure gives the format of the */ 271477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* returned bitmap. */ 271577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 271677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* All modes except @FT_RENDER_MODE_MONO use 256 levels of opacity. */ 2717049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2718049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 2719049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_RENDER_MODE_NORMAL :: */ 2720049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This is the default render mode; it corresponds to 8-bit */ 272177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* anti-aliased bitmaps. */ 2722049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2723049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_RENDER_MODE_LIGHT :: */ 2724049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This is equivalent to @FT_RENDER_MODE_NORMAL. It is only */ 2725049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* defined as a separate value because render modes are also used */ 2726049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* indirectly to define hinting algorithm selectors. See */ 2727049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_LOAD_TARGET_XXX for details. */ 2728049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2729049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_RENDER_MODE_MONO :: */ 273077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* This mode corresponds to 1-bit bitmaps (with 2~levels of */ 273177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* opacity). */ 2732049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2733049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_RENDER_MODE_LCD :: */ 2734049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This mode corresponds to horizontal RGB and BGR sub-pixel */ 273577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* displays like LCD screens. It produces 8-bit bitmaps that are */ 273677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* 3~times the width of the original glyph outline in pixels, and */ 2737049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* which use the @FT_PIXEL_MODE_LCD mode. */ 2738049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2739049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_RENDER_MODE_LCD_V :: */ 2740049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This mode corresponds to vertical RGB and BGR sub-pixel displays */ 2741049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (like PDA screens, rotated LCD displays, etc.). It produces */ 274277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* 8-bit bitmaps that are 3~times the height of the original */ 2743049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph outline in pixels and use the @FT_PIXEL_MODE_LCD_V mode. */ 2744049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2745049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 274677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The LCD-optimized glyph bitmaps produced by FT_Render_Glyph can be */ 274777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* filtered to reduce color-fringes by using @FT_Library_SetLcdFilter */ 274877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* (not active in the default builds). It is up to the caller to */ 274977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* either call @FT_Library_SetLcdFilter (if available) or do the */ 275077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* filtering itself. */ 275177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 275277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The selected render mode only affects vector glyphs of a font. */ 275377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Embedded bitmaps often have a different pixel mode like */ 275477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_PIXEL_MODE_MONO. You can use @FT_Bitmap_Convert to transform */ 275577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* them into 8-bit pixmaps. */ 2756049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2757049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef enum FT_Render_Mode_ 2758049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 2759049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_RENDER_MODE_NORMAL = 0, 2760049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_RENDER_MODE_LIGHT, 2761049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_RENDER_MODE_MONO, 2762049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_RENDER_MODE_LCD, 2763049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_RENDER_MODE_LCD_V, 2764049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2765049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_RENDER_MODE_MAX 2766049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2767049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Render_Mode; 2768049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2769049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2770049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2771049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2772049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 2773049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ft_render_mode_xxx */ 2774049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2775049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2776049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* These constants are deprecated. Use the corresponding */ 2777049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Render_Mode values instead. */ 2778049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2779049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 278077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* ft_render_mode_normal :: see @FT_RENDER_MODE_NORMAL */ 278177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* ft_render_mode_mono :: see @FT_RENDER_MODE_MONO */ 2782049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2783049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_render_mode_normal FT_RENDER_MODE_NORMAL 2784049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_render_mode_mono FT_RENDER_MODE_MONO 2785049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2786049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2787049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2788049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2789049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2790049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Render_Glyph */ 2791049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2792049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2793049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Convert a given glyph image to a bitmap. It does so by inspecting */ 2794049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the glyph image format, finding the relevant renderer, and */ 2795049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* invoking it. */ 2796049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2797049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 2798049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* slot :: A handle to the glyph slot containing the image to */ 2799049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* convert. */ 2800049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2801049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2802049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* render_mode :: This is the render mode used to render the glyph */ 2803049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* image into a bitmap. See @FT_Render_Mode for a */ 2804049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* list of possible values. */ 2805049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2806049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 280777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2808049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2809049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2810049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Render_Glyph( FT_GlyphSlot slot, 2811049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Render_Mode render_mode ); 2812049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2813049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2814049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2815049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2816049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Enum> */ 2817049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Kerning_Mode */ 2818049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2819049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2820049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An enumeration used to specify which kerning values to return in */ 2821049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Get_Kerning. */ 2822049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2823049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Values> */ 2824049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_KERNING_DEFAULT :: Return scaled and grid-fitted kerning */ 282577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* distances (value is~0). */ 2826049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2827049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_KERNING_UNFITTED :: Return scaled but un-grid-fitted kerning */ 2828049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* distances. */ 2829049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2830049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_KERNING_UNSCALED :: Return the kerning vector in original font */ 2831049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* units. */ 2832049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2833049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project typedef enum FT_Kerning_Mode_ 2834049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project { 2835049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_KERNING_DEFAULT = 0, 2836049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_KERNING_UNFITTED, 2837049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_KERNING_UNSCALED 2838049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2839049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project } FT_Kerning_Mode; 2840049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2841049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2842049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2843049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2844049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Const> */ 2845049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ft_kerning_default */ 2846049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2847049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2848049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This constant is deprecated. Please use @FT_KERNING_DEFAULT */ 2849049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* instead. */ 2850049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2851049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_kerning_default FT_KERNING_DEFAULT 2852049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2853049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2854049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2855049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2856049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Const> */ 2857049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ft_kerning_unfitted */ 2858049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2859049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2860049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This constant is deprecated. Please use @FT_KERNING_UNFITTED */ 2861049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* instead. */ 2862049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2863049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_kerning_unfitted FT_KERNING_UNFITTED 2864049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2865049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2866049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2867049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2868049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Const> */ 2869049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ft_kerning_unscaled */ 2870049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2871049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2872049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This constant is deprecated. Please use @FT_KERNING_UNSCALED */ 2873049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* instead. */ 2874049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2875049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define ft_kerning_unscaled FT_KERNING_UNSCALED 2876049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2877049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2878049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2879049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2880049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2881049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Kerning */ 2882049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2883049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2884049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return the kerning vector between two glyphs of a same face. */ 2885049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2886049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2887049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to a source face object. */ 2888049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2889049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* left_glyph :: The index of the left glyph in the kern pair. */ 2890049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2891049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* right_glyph :: The index of the right glyph in the kern pair. */ 2892049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2893049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* kern_mode :: See @FT_Kerning_Mode for more information. */ 2894049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Determines the scale and dimension of the returned */ 2895049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* kerning vector. */ 2896049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2897049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 2898049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* akerning :: The kerning vector. This is either in font units */ 2899049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* or in pixels (26.6 format) for scalable formats, */ 2900049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* and in pixels for fixed-sizes formats. */ 2901049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2902049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 290377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2904049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2905049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2906049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Only horizontal layouts (left-to-right & right-to-left) are */ 2907049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* supported by this method. Other layouts, or more sophisticated */ 2908049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* kernings, are out of the scope of this API function -- they can be */ 2909049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* implemented through format-specific interfaces. */ 2910049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2911049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2912049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Kerning( FT_Face face, 2913049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt left_glyph, 2914049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt right_glyph, 2915049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt kern_mode, 2916049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Vector *akerning ); 2917049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2918049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2919049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2920049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2921049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2922049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Track_Kerning */ 2923049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2924049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2925049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return the track kerning for a given face object at a given size. */ 2926049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2927049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 292877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* face :: A handle to a source face object. */ 2929049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 293077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* point_size :: The point size in 16.16 fractional points. */ 2931049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2932e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* degree :: The degree of tightness. Increasingly negative */ 2933e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* values represent tighter track kerning, while */ 2934e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* increasingly positive values represent looser track */ 2935e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* kerning. Value zero means no track kerning. */ 2936049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2937049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 2938e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* akerning :: The kerning in 16.16 fractional points, to be */ 2939e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* uniformly applied between all glyphs. */ 2940049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2941049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 294277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2943049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2944e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* <Note> */ 2945e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* Currently, only the Type~1 font driver supports track kerning, */ 2946e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* using data from AFM files (if attached with @FT_Attach_File or */ 2947e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* @FT_Attach_Stream). */ 2948e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* */ 2949e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* Only very few AFM files come with track kerning data; please refer */ 2950e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* to the Adobe's AFM specification for more details. */ 2951e3b631da8034f7c6ecc6d809cd9e46d306215c32Xianzhu Wang /* */ 2952049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 2953049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Track_Kerning( FT_Face face, 2954049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Fixed point_size, 2955049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int degree, 2956049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Fixed* akerning ); 2957049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2958049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 2959049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 2960049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2961049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 2962049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Glyph_Name */ 2963049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2964049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 2965049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Retrieve the ASCII name of a given glyph in a face. This only */ 296677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* works for those faces where @FT_HAS_GLYPH_NAMES(face) returns~1. */ 2967049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2968049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 2969049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to a source face object. */ 2970049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2971049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph_index :: The glyph index. */ 2972049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2973a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* buffer_max :: The maximum number of bytes available in the */ 2974049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* buffer. */ 2975049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2976049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 2977049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* buffer :: A pointer to a target buffer where the name is */ 2978049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* copied to. */ 2979049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2980049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 298177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 2982049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2983049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 2984049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An error is returned if the face doesn't provide glyph names or if */ 2985049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the glyph index is invalid. In all cases of failure, the first */ 298677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* byte of `buffer' is set to~0 to indicate an empty name. */ 2987049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2988049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The glyph name is truncated to fit within the buffer if it is too */ 2989049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* long. The returned string is always zero-terminated. */ 2990049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2991c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* Be aware that FreeType reorders glyph indices internally so that */ 2992c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* glyph index~0 always corresponds to the `missing glyph' (called */ 2993c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* `.notdef'). */ 2994c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* */ 2995049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function is not compiled within the library if the config */ 2996049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* macro `FT_CONFIG_OPTION_NO_GLYPH_NAMES' is defined in */ 2997049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `include/freetype/config/ftoptions.h'. */ 2998049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 2999049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 3000049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Glyph_Name( FT_Face face, 3001049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt glyph_index, 3002049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Pointer buffer, 3003049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt buffer_max ); 3004049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3005049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3006049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3007049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3008049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3009049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Postscript_Name */ 3010049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3011049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 301277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Retrieve the ASCII PostScript name of a given face, if available. */ 301377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* This only works with PostScript and TrueType fonts. */ 3014049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3015049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3016049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 3017049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3018049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 301977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* A pointer to the face's PostScript name. NULL if unavailable. */ 3020049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3021049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3022049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The returned pointer is owned by the face and is destroyed with */ 3023049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* it. */ 3024049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3025049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( const char* ) 3026049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Postscript_Name( FT_Face face ); 3027049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3028049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3029049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3030049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3031049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3032049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Select_Charmap */ 3033049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3034049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3035049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Select a given charmap by its encoding tag (as listed in */ 3036049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `freetype.h'). */ 3037049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3038049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 3039049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 3040049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3041049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3042049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* encoding :: A handle to the selected encoding. */ 3043049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3044049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 304577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 3046049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3047049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3048049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function returns an error if no charmap in the face */ 3049049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* corresponds to the encoding queried here. */ 3050049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3051049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Because many fonts contain more than a single cmap for Unicode */ 3052049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* encoding, this function has some special code to select the one */ 3053049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* which covers Unicode best (`best' in the sense that a UCS-4 cmap */ 3054049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is preferred to a UCS-2 cmap). It is thus preferable to */ 3055049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Set_Charmap in this case. */ 3056049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3057049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 3058049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Select_Charmap( FT_Face face, 3059049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Encoding encoding ); 3060049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3061049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3062049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3063049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3064049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3065049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Set_Charmap */ 3066049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3067049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3068049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Select a given charmap for character code to glyph index mapping. */ 3069049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3070049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 3071049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 3072049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3073049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3074049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charmap :: A handle to the selected charmap. */ 3075049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3076049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 307777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FreeType error code. 0~means success. */ 3078049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3079049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3080049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function returns an error if the charmap is not part of */ 3081049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the face (i.e., if it is not listed in the `face->charmaps' */ 3082049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* table). */ 3083049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 308477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* It also fails if a type~14 charmap is selected. */ 3085049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3086049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 3087049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Set_Charmap( FT_Face face, 3088049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_CharMap charmap ); 3089049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3090049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3091049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 3092049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3093049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @function: 3094049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_Get_Charmap_Index 3095049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3096049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 3097049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Retrieve index of a given charmap. 3098049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3099049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @input: 3100049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * charmap :: 3101049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A handle to a charmap. 3102049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3103049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @return: 3104049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The index into the array of character maps within the face to which 3105aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich * `charmap' belongs. If an error occurs, -1 is returned. 3106049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3107049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 3108049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Int ) 3109049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Charmap_Index( FT_CharMap charmap ); 3110049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3111049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3112049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3113049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3114049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3115049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Char_Index */ 3116049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3117049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3118049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return the glyph index of a given character code. This function */ 3119049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* uses a charmap object to do the mapping. */ 3120049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3121049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3122049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 3123049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3124049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charcode :: The character code. */ 3125049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3126049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 312777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The glyph index. 0~means `undefined character code'. */ 3128049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3129049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3130049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If you use FreeType to manipulate the contents of font files */ 3131049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* directly, be aware that the glyph index returned by this function */ 3132a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* doesn't always correspond to the internal indices used within the */ 3133a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* file. This is done to ensure that value~0 always corresponds to */ 3134a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* the `missing glyph'. If the first glyph is not named `.notdef', */ 3135a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* then for Type~1 and Type~42 fonts, `.notdef' will be moved into */ 3136a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* the glyph ID~0 position, and whatever was there will be moved to */ 3137a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* the position `.notdef' had. For Type~1 fonts, if there is no */ 3138a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* `.notdef' glyph at all, then one will be created at index~0 and */ 3139a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* whatever was there will be moved to the last index -- Type~42 */ 3140a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* fonts are considered invalid under this condition. */ 3141049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3142049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_UInt ) 3143049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Char_Index( FT_Face face, 3144049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong charcode ); 3145049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3146049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3147049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3148049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3149049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3150049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_First_Char */ 3151049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3152049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3153049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function is used to return the first character code in the */ 3154049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* current charmap of a given face. It also returns the */ 3155049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* corresponding glyph index. */ 3156049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3157049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3158049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 3159049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3160049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 316177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* agindex :: Glyph index of first character code. 0~if charmap is */ 3162049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* empty. */ 3163049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3164049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3165049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The charmap's first character code. */ 3166049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3167049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3168049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* You should use this function with @FT_Get_Next_Char to be able to */ 3169049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* parse all character codes available in a given charmap. The code */ 3170049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* should look like this: */ 3171049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3172049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* { */ 3173049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_ULong charcode; */ 3174049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_UInt gindex; */ 3175049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3176049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3177049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charcode = FT_Get_First_Char( face, &gindex ); */ 3178049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* while ( gindex != 0 ) */ 3179049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* { */ 3180049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* ... do something with (charcode,gindex) pair ... */ 3181049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3182049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charcode = FT_Get_Next_Char( face, charcode, &gindex ); */ 3183049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* } */ 3184049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* } */ 3185049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 318677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Note that `*agindex' is set to~0 if the charmap is empty. The */ 318777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* result itself can be~0 in two cases: if the charmap is empty or */ 318877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* if the value~0 is the first valid character code. */ 3189049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3190049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_ULong ) 3191049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_First_Char( FT_Face face, 3192049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt *agindex ); 3193049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3194049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3195049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3196049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3197049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3198049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Next_Char */ 3199049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3200049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3201049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function is used to return the next character code in the */ 3202049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* current charmap of a given face following the value `char_code', */ 3203049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* as well as the corresponding glyph index. */ 3204049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3205049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3206049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 3207049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* char_code :: The starting character code. */ 3208049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3209049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 321077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* agindex :: Glyph index of next character code. 0~if charmap */ 3211049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is empty. */ 3212049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3213049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3214049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The charmap's next character code. */ 3215049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3216049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3217049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* You should use this function with @FT_Get_First_Char to walk */ 3218049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* over all character codes available in a given charmap. See the */ 3219049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* note for this function for a simple code example. */ 3220049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 322177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Note that `*agindex' is set to~0 when there are no more codes in */ 3222049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the charmap. */ 3223049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3224049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_ULong ) 3225049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Next_Char( FT_Face face, 3226049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong char_code, 3227049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt *agindex ); 3228049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3229049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3230049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3231049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3232049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3233049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Get_Name_Index */ 3234049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3235049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3236049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return the glyph index of a given glyph name. This function uses */ 3237049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* driver specific objects to do the translation. */ 3238049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3239049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3240049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A handle to the source face object. */ 3241049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3242049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph_name :: The glyph name. */ 3243049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3244049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 324577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The glyph index. 0~means `undefined character code'. */ 3246049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3247049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_UInt ) 3248049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_Name_Index( FT_Face face, 3249049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_String* glyph_name ); 3250049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3251049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3252049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 3253049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3254049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @macro: 3255049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_XXX 3256049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3257049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 3258049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * A list of constants used to describe subglyphs. Please refer to the 3259049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * TrueType specification for the meaning of the various flags. 3260049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3261049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @values: 3262049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_ARGS_ARE_WORDS :: 3263049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_ARGS_ARE_XY_VALUES :: 3264049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_ROUND_XY_TO_GRID :: 3265049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_SCALE :: 3266049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_XY_SCALE :: 3267049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_2X2 :: 3268049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_SUBGLYPH_FLAG_USE_MY_METRICS :: 3269049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3270049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 3271049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_SUBGLYPH_FLAG_ARGS_ARE_WORDS 1 3272049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_SUBGLYPH_FLAG_ARGS_ARE_XY_VALUES 2 3273049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_SUBGLYPH_FLAG_ROUND_XY_TO_GRID 4 3274049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_SUBGLYPH_FLAG_SCALE 8 3275049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_SUBGLYPH_FLAG_XY_SCALE 0x40 3276049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_SUBGLYPH_FLAG_2X2 0x80 3277049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FT_SUBGLYPH_FLAG_USE_MY_METRICS 0x200 3278049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3279049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3280049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 3281049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3282049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @func: 3283049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * FT_Get_SubGlyph_Info 3284049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3285049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @description: 3286049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * Retrieve a description of a given subglyph. Only use it if 328777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * `glyph->format' is @FT_GLYPH_FORMAT_COMPOSITE; an error is 328877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * returned otherwise. 3289049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3290049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @input: 3291049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * glyph :: 3292049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The source glyph slot. 3293049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3294049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * sub_index :: 329577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * The index of the subglyph. Must be less than 329677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * `glyph->num_subglyphs'. 3297049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3298049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @output: 3299049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * p_index :: 3300049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The glyph index of the subglyph. 3301049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3302049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * p_flags :: 3303049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The subglyph flags, see @FT_SUBGLYPH_FLAG_XXX. 3304049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3305049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * p_arg1 :: 3306049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The subglyph's first argument (if any). 3307049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3308049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * p_arg2 :: 3309049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The subglyph's second argument (if any). 3310049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3311049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * p_transform :: 3312049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The subglyph transformation (if any). 3313049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3314049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @return: 331577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * FreeType error code. 0~means success. 3316049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3317049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * @note: 3318049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * The values of `*p_arg1', `*p_arg2', and `*p_transform' must be 3319049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * interpreted depending on the flags returned in `*p_flags'. See the 3320049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * TrueType specification for details. 3321049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3322049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 3323049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Error ) 3324049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Get_SubGlyph_Info( FT_GlyphSlot glyph, 3325049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt sub_index, 3326049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int *p_index, 3327049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_UInt *p_flags, 3328049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int *p_arg1, 3329049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int *p_arg2, 3330049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Matrix *p_transform ); 333177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 333277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 333377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /*************************************************************************/ 333477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 333577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Enum> */ 333677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_XXX */ 333777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 333877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Description> */ 333977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* A list of bit flags used in the `fsType' field of the OS/2 table */ 334077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* in a TrueType or OpenType font and the `FSType' entry in a */ 334177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* PostScript font. These bit flags are returned by */ 334277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* @FT_Get_FSType_Flags; they inform client applications of embedding */ 334377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* and subsetting restrictions associated with a font. */ 334477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 334577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* See http://www.adobe.com/devnet/acrobat/pdfs/FontPolicies.pdf for */ 334677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* more details. */ 334777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 334877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Values> */ 334977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_INSTALLABLE_EMBEDDING :: */ 335077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Fonts with no fsType bit set may be embedded and permanently */ 335177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* installed on the remote system by an application. */ 335277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 335377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_RESTRICTED_LICENSE_EMBEDDING :: */ 335477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Fonts that have only this bit set must not be modified, embedded */ 335577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* or exchanged in any manner without first obtaining permission of */ 335677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* the font software copyright owner. */ 335777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 335877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_PREVIEW_AND_PRINT_EMBEDDING :: */ 335977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* If this bit is set, the font may be embedded and temporarily */ 336077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* loaded on the remote system. Documents containing Preview & */ 336177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Print fonts must be opened `read-only'; no edits can be applied */ 336277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* to the document. */ 336377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 336477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_EDITABLE_EMBEDDING :: */ 336577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* If this bit is set, the font may be embedded but must only be */ 336677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* installed temporarily on other systems. In contrast to Preview */ 336777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* & Print fonts, documents containing editable fonts may be opened */ 336877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* for reading, editing is permitted, and changes may be saved. */ 336977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 337077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_NO_SUBSETTING :: */ 337177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* If this bit is set, the font may not be subsetted prior to */ 337277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* embedding. */ 337377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 337477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_FSTYPE_BITMAP_EMBEDDING_ONLY :: */ 337577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* If this bit is set, only bitmaps contained in the font may be */ 337677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* embedded; no outline data may be embedded. If there are no */ 337777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* bitmaps available in the font, then the font is unembeddable. */ 337877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 337977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Note> */ 338077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* While the fsType flags can indicate that a font may be embedded, a */ 338177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* license with the font vendor may be separately required to use the */ 338277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* font in this way. */ 338377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 338477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_FSTYPE_INSTALLABLE_EMBEDDING 0x0000 338577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_FSTYPE_RESTRICTED_LICENSE_EMBEDDING 0x0002 338677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_FSTYPE_PREVIEW_AND_PRINT_EMBEDDING 0x0004 338777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_FSTYPE_EDITABLE_EMBEDDING 0x0008 338877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_FSTYPE_NO_SUBSETTING 0x0100 338977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_FSTYPE_BITMAP_EMBEDDING_ONLY 0x0200 339077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 339177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 339277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /*************************************************************************/ 339377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 339477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Function> */ 339577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* FT_Get_FSType_Flags */ 339677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 339777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Description> */ 339877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Return the fsType flags for a font. */ 339977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 340077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Input> */ 340177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* face :: A handle to the source face object. */ 340277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 340377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Return> */ 340477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The fsType flags, @FT_FSTYPE_XXX. */ 340577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 340677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* <Note> */ 340777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Use this function rather than directly reading the `fs_type' field */ 340877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* in the @PS_FontInfoRec structure which is only guaranteed to */ 340977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* return the correct results for Type~1 fonts. */ 341077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 3411c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* <Since> */ 3412c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* 2.3.8 */ 3413c3ee10bfa1f76a18500b487de9c85757375b48f3David 'Digit' Turner /* */ 341477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner FT_EXPORT( FT_UShort ) 341577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner FT_Get_FSType_Flags( FT_Face face ); 341677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 341777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 3418049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3419049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3420049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Section> */ 3421049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* glyph_variants */ 3422049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3423049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Title> */ 3424049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Glyph Variants */ 3425049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3426049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Abstract> */ 342777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The FreeType~2 interface to Unicode Ideographic Variation */ 342877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* Sequences (IVS), using the SFNT cmap format~14. */ 3429049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3430049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3431049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Many CJK characters have variant forms. They are a sort of grey */ 3432049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* area somewhere between being totally irrelevant and semantically */ 3433049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* distinct; for this reason, the Unicode consortium decided to */ 3434049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* introduce Ideographic Variation Sequences (IVS), consisting of a */ 3435049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Unicode base character and one of 240 variant selectors */ 3436049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (U+E0100-U+E01EF), instead of further extending the already huge */ 3437049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* code range for CJK characters. */ 3438049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3439049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* An IVS is registered and unique; for further details please refer */ 3440a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* to Unicode Technical Standard #37, the Ideographic Variation */ 3441a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* Database: */ 3442a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* */ 3443a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* http://www.unicode.org/reports/tr37/ */ 3444a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* */ 3445a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* To date (November 2012), the character with the most variants is */ 3446a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* U+9089, having 31 such IVS. */ 3447049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3448049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Adobe and MS decided to support IVS with a new cmap subtable */ 344977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* (format~14). It is an odd subtable because it is not a mapping of */ 3450049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* input code points to glyphs, but contains lists of all variants */ 3451049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* supported by the font. */ 3452049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3453049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A variant may be either `default' or `non-default'. A default */ 3454049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* variant is the one you will get for that code point if you look it */ 3455049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* up in the standard Unicode cmap. A non-default variant is a */ 3456049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* different glyph. */ 3457049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3458049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3459049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3460049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3461049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3462049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3463049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3464049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_GetCharVariantIndex */ 3465049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3466049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3467049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return the glyph index of a given character code as modified by */ 3468049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the variation selector. */ 3469049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3470049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3471049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: */ 3472049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to the source face object. */ 3473049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3474049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charcode :: */ 3475049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The character code point in Unicode. */ 3476049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3477049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* variantSelector :: */ 3478049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The Unicode code point of the variation selector. */ 3479049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3480049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 348177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The glyph index. 0~means either `undefined character code', or */ 3482049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* `undefined selector code', or `no variation selector cmap */ 3483049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* subtable', or `current CharMap is not Unicode'. */ 3484049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3485049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3486049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* If you use FreeType to manipulate the contents of font files */ 3487049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* directly, be aware that the glyph index returned by this function */ 3488049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* doesn't always correspond to the internal indices used within */ 348977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* the file. This is done to ensure that value~0 always corresponds */ 3490049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* to the `missing glyph'. */ 3491049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3492049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function is only meaningful if */ 3493049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a) the font has a variation selector cmap sub table, */ 3494049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* and */ 3495049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* b) the current charmap has a Unicode encoding. */ 3496049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3497049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Since> */ 3498049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 2.3.6 */ 3499049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3500049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_UInt ) 3501049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_GetCharVariantIndex( FT_Face face, 3502049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong charcode, 3503049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong variantSelector ); 3504049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3505049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3506049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3507049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3508049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3509049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_GetCharVariantIsDefault */ 3510049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3511049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3512049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Check whether this variant of this Unicode character is the one to */ 3513049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* be found in the `cmap'. */ 3514049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3515049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3516049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: */ 3517049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to the source face object. */ 3518049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3519049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charcode :: */ 3520049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The character codepoint in Unicode. */ 3521049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3522049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* variantSelector :: */ 3523049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The Unicode codepoint of the variation selector. */ 3524049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3525049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 352677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* 1~if found in the standard (Unicode) cmap, 0~if found in the */ 3527049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* variation selector cmap, or -1 if it is not a variant. */ 3528049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3529049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3530049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function is only meaningful if the font has a variation */ 3531049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* selector cmap subtable. */ 3532049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3533049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Since> */ 3534049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 2.3.6 */ 3535049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3536049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Int ) 3537049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_GetCharVariantIsDefault( FT_Face face, 3538049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong charcode, 3539049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong variantSelector ); 3540049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3541049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3542049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3543049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3544049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3545049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_GetVariantSelectors */ 3546049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3547049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3548049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return a zero-terminated list of Unicode variant selectors found */ 3549049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* in the font. */ 3550049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3551049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3552049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: */ 3553049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to the source face object. */ 3554049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3555049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3556049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A pointer to an array of selector code points, or NULL if there is */ 3557049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* no valid variant selector cmap subtable. */ 3558049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3559049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 356077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The last item in the array is~0; the array is owned by the */ 3561049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Face object but can be overwritten or released on the next */ 3562049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* call to a FreeType function. */ 3563049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3564049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Since> */ 3565049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 2.3.6 */ 3566049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3567049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_UInt32* ) 3568049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_GetVariantSelectors( FT_Face face ); 3569049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3570049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3571049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3572049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3573049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3574049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_GetVariantsOfChar */ 3575049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3576049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3577049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return a zero-terminated list of Unicode variant selectors found */ 3578049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* for the specified character code. */ 3579049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3580049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3581049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: */ 3582049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to the source face object. */ 3583049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3584049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* charcode :: */ 3585049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The character codepoint in Unicode. */ 3586049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3587049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3588049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A pointer to an array of variant selector code points which are */ 3589049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* active for the given character, or NULL if the corresponding list */ 3590049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is empty. */ 3591049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3592049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 359377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The last item in the array is~0; the array is owned by the */ 3594049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Face object but can be overwritten or released on the next */ 3595049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* call to a FreeType function. */ 3596049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3597049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Since> */ 3598049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 2.3.6 */ 3599049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3600049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_UInt32* ) 3601049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_GetVariantsOfChar( FT_Face face, 3602049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong charcode ); 3603049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3604049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3605049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3606049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3607049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3608049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_GetCharsOfVariant */ 3609049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3610049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3611049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return a zero-terminated list of Unicode character codes found for */ 3612049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the specified variant selector. */ 3613049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3614049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3615049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: */ 3616049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A handle to the source face object. */ 3617049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3618049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* variantSelector :: */ 3619049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The variant selector code point in Unicode. */ 3620049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3621049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3622049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A list of all the code points which are specified by this selector */ 3623049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* (both default and non-default codes are returned) or NULL if there */ 3624049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* is no valid cmap or the variant selector is invalid. */ 3625049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3626049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 362777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The last item in the array is~0; the array is owned by the */ 3628049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FT_Face object but can be overwritten or released on the next */ 3629049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* call to a FreeType function. */ 3630049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3631049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Since> */ 3632049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 2.3.6 */ 3633049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3634049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_UInt32* ) 3635049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_GetCharsOfVariant( FT_Face face, 3636049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_ULong variantSelector ); 3637049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3638049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3639049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3640049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3641049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Section> */ 3642049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* computations */ 3643049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3644049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Title> */ 3645049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Computations */ 3646049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3647049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Abstract> */ 3648049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Crunching fixed numbers and vectors. */ 3649049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3650049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3651049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This section contains various functions used to perform */ 3652049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* computations on 16.16 fixed-float numbers or 2d vectors. */ 3653049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3654049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Order> */ 3655049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_MulDiv */ 3656049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_MulFix */ 3657049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_DivFix */ 3658049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_RoundFix */ 3659049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_CeilFix */ 3660049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FloorFix */ 3661049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Vector_Transform */ 3662049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Matrix_Multiply */ 3663049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Matrix_Invert */ 3664049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3665049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3666049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3667049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3668049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3669049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3670049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3671049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_MulDiv */ 3672049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3673049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3674049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A very simple function used to perform the computation `(a*b)/c' */ 3675a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* with maximum accuracy (it uses a 64-bit intermediate integer */ 3676049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* whenever necessary). */ 3677049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3678049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function isn't necessarily as fast as some processor specific */ 3679049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* operations, but is at least completely portable. */ 3680049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3681049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3682049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a :: The first multiplier. */ 3683049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* b :: The second multiplier. */ 3684049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* c :: The divisor. */ 3685049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3686049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3687049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The result of `(a*b)/c'. This function never traps when trying to */ 3688049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* divide by zero; it simply returns `MaxInt' or `MinInt' depending */ 3689049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* on the signs of `a' and `b'. */ 3690049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3691049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Long ) 3692049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_MulDiv( FT_Long a, 3693049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long b, 3694049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long c ); 3695049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3696049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 369777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 369877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 369977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The following #if 0 ... #endif is for the documentation formatter, */ 370077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* hiding the internal `FT_MULFIX_INLINED' macro. */ 370177f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 370277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#if 0 3703049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3704049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3705049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3706049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_MulFix */ 3707049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3708049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3709049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A very simple function used to perform the computation */ 3710a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* `(a*b)/0x10000' with maximum accuracy. Most of the time this is */ 3711a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* used to multiply a given value by a 16.16 fixed-point factor. */ 3712049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3713049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3714049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a :: The first multiplier. */ 3715049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* b :: The second multiplier. Use a 16.16 factor here whenever */ 3716049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* possible (see note below). */ 3717049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3718049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3719049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The result of `(a*b)/0x10000'. */ 3720049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3721049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3722049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* This function has been optimized for the case where the absolute */ 3723049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* value of `a' is less than 2048, and `b' is a 16.16 scaling factor. */ 3724049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* As this happens mainly when scaling from notional units to */ 3725049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* fractional pixels in FreeType, it resulted in noticeable speed */ 3726049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* improvements between versions 2.x and 1.x. */ 3727049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3728049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* As a conclusion, always try to place a 16.16 factor as the */ 3729049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* _second_ argument of this function; this can make a great */ 3730049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* difference. */ 3731049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 373277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner FT_EXPORT( FT_Long ) 373377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner FT_MulFix( FT_Long a, 373477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner FT_Long b ); 373577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 373677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* */ 373777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#endif 373877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 3739049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#ifdef FT_MULFIX_INLINED 374077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner#define FT_MulFix( a, b ) FT_MULFIX_INLINED( a, b ) 3741049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#else 3742049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Long ) 3743049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_MulFix( FT_Long a, 3744049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long b ); 3745049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#endif 3746049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 374777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner 3748049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3749049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3750049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3751049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_DivFix */ 3752049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3753049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3754049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A very simple function used to perform the computation */ 3755a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* `(a*0x10000)/b' with maximum accuracy. Most of the time, this is */ 3756a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* used to divide a given value by a 16.16 fixed-point factor. */ 3757049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3758049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3759049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a :: The first multiplier. */ 3760049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* b :: The second multiplier. Use a 16.16 factor here whenever */ 3761049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* possible (see note below). */ 3762049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3763049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3764049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The result of `(a*0x10000)/b'. */ 3765049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3766049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 376777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* The optimization for FT_DivFix() is simple: If (a~<<~16) fits in */ 376877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* 32~bits, then the division is computed directly. Otherwise, we */ 3769049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* use a specialized version of @FT_MulDiv. */ 3770049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3771049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Long ) 3772049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_DivFix( FT_Long a, 3773049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Long b ); 3774049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3775049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3776049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3777049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3778049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3779049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_RoundFix */ 3780049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3781049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3782049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A very simple function used to round a 16.16 fixed number. */ 3783049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3784049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3785049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a :: The number to be rounded. */ 3786049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3787049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3788049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The result of `(a + 0x8000) & -0x10000'. */ 3789049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3790049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Fixed ) 3791049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_RoundFix( FT_Fixed a ); 3792049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3793049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3794049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3795049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3796049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3797049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_CeilFix */ 3798049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3799049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3800049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A very simple function used to compute the ceiling function of a */ 3801049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 16.16 fixed number. */ 3802049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3803049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3804049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a :: The number for which the ceiling function is to be computed. */ 3805049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3806049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3807049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The result of `(a + 0x10000 - 1) & -0x10000'. */ 3808049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3809049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Fixed ) 3810049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_CeilFix( FT_Fixed a ); 3811049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3812049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3813049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3814049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3815049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3816049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_FloorFix */ 3817049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3818049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3819049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* A very simple function used to compute the floor function of a */ 3820049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 16.16 fixed number. */ 3821049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3822049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3823049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* a :: The number for which the floor function is to be computed. */ 3824049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3825049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3826049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The result of `a & -0x10000'. */ 3827049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3828049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Fixed ) 3829049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_FloorFix( FT_Fixed a ); 3830049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3831049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3832049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3833049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3834049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3835049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Vector_Transform */ 3836049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3837049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3838049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Transform a single vector through a 2x2 matrix. */ 3839049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3840049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <InOut> */ 3841049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* vector :: The target vector to transform. */ 3842049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3843049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3844049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* matrix :: A pointer to the source 2x2 matrix. */ 3845049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3846049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3847049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The result is undefined if either `vector' or `matrix' is invalid. */ 3848049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3849049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( void ) 3850049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Vector_Transform( FT_Vector* vec, 3851049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project const FT_Matrix* matrix ); 3852049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3853049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3854049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3855049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3856049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Section> */ 3857049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* version */ 3858049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3859049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Title> */ 3860049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FreeType Version */ 3861049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3862049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Abstract> */ 3863049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Functions and macros related to FreeType versions. */ 3864049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3865049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3866049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Note that those functions and macros are of limited use because */ 3867049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* even a new release of FreeType with only documentation changes */ 3868049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* increases the version number. */ 3869049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3870049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3871049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3872049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3873049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /************************************************************************* 3874049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 387577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * @enum: 387677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * FREETYPE_XXX 3877049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 387877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * @description: 387977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * These three macros identify the FreeType source code version. 388077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * Use @FT_Library_Version to access them at runtime. 3881049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 388277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * @values: 388377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * FREETYPE_MAJOR :: The major version number. 388477f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * FREETYPE_MINOR :: The minor version number. 388577f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * FREETYPE_PATCH :: The patch level. 388677f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * 388777f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * @note: 388877f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * The version number of FreeType if built as a dynamic link library 388977f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * with the `libtool' package is _not_ controlled by these three 389077f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner * macros. 3891049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project * 3892049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project */ 3893049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#define FREETYPE_MAJOR 2 3894aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich#define FREETYPE_MINOR 4 3895a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#define FREETYPE_PATCH 12 3896049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3897049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3898049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3899049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3900049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3901049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Library_Version */ 3902049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3903049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3904049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Return the version of the FreeType library being used. This is */ 3905049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* useful when dynamically linking to the library, since one cannot */ 3906049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* use the macros @FREETYPE_MAJOR, @FREETYPE_MINOR, and */ 3907049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* @FREETYPE_PATCH. */ 3908049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3909049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3910049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* library :: A source library handle. */ 3911049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3912049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Output> */ 3913049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* amajor :: The major version number. */ 3914049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3915049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* aminor :: The minor version number. */ 3916049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3917049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* apatch :: The patch version number. */ 3918049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3919049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Note> */ 3920049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The reason why this function takes a `library' argument is because */ 3921049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* certain programs implement library initialization in a custom way */ 3922049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* that doesn't use @FT_Init_FreeType. */ 3923049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3924049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* In such cases, the library version might not be available before */ 3925049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* the library object has been created. */ 3926049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3927049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( void ) 3928049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Library_Version( FT_Library library, 3929049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int *amajor, 3930049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int *aminor, 3931049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Int *apatch ); 3932049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3933049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3934049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3935049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3936049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3937049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_CheckTrueTypePatents */ 3938049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3939049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3940049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Parse all bytecode instructions of a TrueType font file to check */ 3941049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* whether any of the patented opcodes are used. This is only useful */ 3942049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* if you want to be able to use the unpatented hinter with */ 3943049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* fonts that do *not* use these opcodes. */ 3944049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3945049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Note that this function parses *all* glyph instructions in the */ 3946049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* font file, which may be slow. */ 3947049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3948049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3949049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A face handle. */ 3950049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3951049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 395277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* 1~if this is a TrueType font that uses one of the patented */ 395377f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* opcodes, 0~otherwise. */ 3954049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3955aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Note> */ 3956aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* Since May 2010, TrueType hinting is no longer patented. */ 3957aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 3958049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Since> */ 3959049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 2.3.5 */ 3960049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3961049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Bool ) 3962049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_CheckTrueTypePatents( FT_Face face ); 3963049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3964049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3965049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /*************************************************************************/ 3966049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3967049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Function> */ 3968049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* FT_Face_SetUnpatentedHinting */ 3969049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3970049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Description> */ 3971049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Enable or disable the unpatented hinter for a given face. */ 3972049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* Only enable it if you have determined that the face doesn't */ 3973049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* use any patented opcodes (see @FT_Face_CheckTrueTypePatents). */ 3974049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3975049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Input> */ 3976049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* face :: A face handle. */ 3977049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3978049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* value :: New boolean setting. */ 3979049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3980049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Return> */ 3981049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* The old setting value. This will always be false if this is not */ 398277f63d23f7d380b0ff02c18fd6a154ab9063128aDavid 'Digit' Turner /* an SFNT font, or if the unpatented hinter is not compiled in this */ 3983049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* instance of the library. */ 3984049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3985aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* <Note> */ 3986aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* Since May 2010, TrueType hinting is no longer patented. */ 3987aacb8e1368a883fcbc9fe64fd0e460cef9c9b20cNick Kralevich /* */ 3988049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* <Since> */ 3989049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* 2.3.5 */ 3990049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3991049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_EXPORT( FT_Bool ) 3992049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Face_SetUnpatentedHinting( FT_Face face, 3993049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project FT_Bool value ); 3994049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3995049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project /* */ 3996049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3997049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 3998049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source ProjectFT_END_HEADER 3999049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 4000049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project#endif /* __FREETYPE_H__ */ 4001049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 4002049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project 4003049d6fea481044fcc000e7782e5bc7046fc70844The Android Open Source Project/* END */ 4004