michael@0: /***************************************************************************/ michael@0: /* */ michael@0: /* ftcid.h */ michael@0: /* */ michael@0: /* FreeType API for accessing CID font information (specification). */ michael@0: /* */ michael@0: /* Copyright 2007, 2009 by Dereg Clegg, Michael Toftdal. */ michael@0: /* */ michael@0: /* This file is part of the FreeType project, and may only be used, */ michael@0: /* modified, and distributed under the terms of the FreeType project */ michael@0: /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ michael@0: /* this file you indicate that you have read the license and */ michael@0: /* understand and accept it fully. */ michael@0: /* */ michael@0: /***************************************************************************/ michael@0: michael@0: michael@0: #ifndef __FTCID_H__ michael@0: #define __FTCID_H__ michael@0: michael@0: #include michael@0: #include FT_FREETYPE_H michael@0: michael@0: #ifdef FREETYPE_H michael@0: #error "freetype.h of FreeType 1 has been loaded!" michael@0: #error "Please fix the directory search order for header files" michael@0: #error "so that freetype.h of FreeType 2 is found first." michael@0: #endif michael@0: michael@0: michael@0: FT_BEGIN_HEADER michael@0: michael@0: michael@0: /*************************************************************************/ michael@0: /* */ michael@0: /*
*/ michael@0: /* cid_fonts */ michael@0: /* */ michael@0: /* */ michael@0: /* CID Fonts */ michael@0: /* */ michael@0: /* <Abstract> */ michael@0: /* CID-keyed font specific API. */ michael@0: /* */ michael@0: /* <Description> */ michael@0: /* This section contains the declaration of CID-keyed font specific */ michael@0: /* functions. */ michael@0: /* */ michael@0: /*************************************************************************/ michael@0: michael@0: michael@0: /********************************************************************** michael@0: * michael@0: * @function: michael@0: * FT_Get_CID_Registry_Ordering_Supplement michael@0: * michael@0: * @description: michael@0: * Retrieve the Registry/Ordering/Supplement triple (also known as the michael@0: * "R/O/S") from a CID-keyed font. michael@0: * michael@0: * @input: michael@0: * face :: michael@0: * A handle to the input face. michael@0: * michael@0: * @output: michael@0: * registry :: michael@0: * The registry, as a C~string, owned by the face. michael@0: * michael@0: * ordering :: michael@0: * The ordering, as a C~string, owned by the face. michael@0: * michael@0: * supplement :: michael@0: * The supplement. michael@0: * michael@0: * @return: michael@0: * FreeType error code. 0~means success. michael@0: * michael@0: * @note: michael@0: * This function only works with CID faces, returning an error michael@0: * otherwise. michael@0: * michael@0: * @since: michael@0: * 2.3.6 michael@0: */ michael@0: FT_EXPORT( FT_Error ) michael@0: FT_Get_CID_Registry_Ordering_Supplement( FT_Face face, michael@0: const char* *registry, michael@0: const char* *ordering, michael@0: FT_Int *supplement); michael@0: michael@0: michael@0: /********************************************************************** michael@0: * michael@0: * @function: michael@0: * FT_Get_CID_Is_Internally_CID_Keyed michael@0: * michael@0: * @description: michael@0: * Retrieve the type of the input face, CID keyed or not. In michael@0: * constrast to the @FT_IS_CID_KEYED macro this function returns michael@0: * successfully also for CID-keyed fonts in an SNFT wrapper. michael@0: * michael@0: * @input: michael@0: * face :: michael@0: * A handle to the input face. michael@0: * michael@0: * @output: michael@0: * is_cid :: michael@0: * The type of the face as an @FT_Bool. michael@0: * michael@0: * @return: michael@0: * FreeType error code. 0~means success. michael@0: * michael@0: * @note: michael@0: * This function only works with CID faces and OpenType fonts, michael@0: * returning an error otherwise. michael@0: * michael@0: * @since: michael@0: * 2.3.9 michael@0: */ michael@0: FT_EXPORT( FT_Error ) michael@0: FT_Get_CID_Is_Internally_CID_Keyed( FT_Face face, michael@0: FT_Bool *is_cid ); michael@0: michael@0: michael@0: /********************************************************************** michael@0: * michael@0: * @function: michael@0: * FT_Get_CID_From_Glyph_Index michael@0: * michael@0: * @description: michael@0: * Retrieve the CID of the input glyph index. michael@0: * michael@0: * @input: michael@0: * face :: michael@0: * A handle to the input face. michael@0: * michael@0: * glyph_index :: michael@0: * The input glyph index. michael@0: * michael@0: * @output: michael@0: * cid :: michael@0: * The CID as an @FT_UInt. michael@0: * michael@0: * @return: michael@0: * FreeType error code. 0~means success. michael@0: * michael@0: * @note: michael@0: * This function only works with CID faces and OpenType fonts, michael@0: * returning an error otherwise. michael@0: * michael@0: * @since: michael@0: * 2.3.9 michael@0: */ michael@0: FT_EXPORT( FT_Error ) michael@0: FT_Get_CID_From_Glyph_Index( FT_Face face, michael@0: FT_UInt glyph_index, michael@0: FT_UInt *cid ); michael@0: michael@0: /* */ michael@0: michael@0: FT_END_HEADER michael@0: michael@0: #endif /* __FTCID_H__ */ michael@0: michael@0: michael@0: /* END */