| // Copyright 2014 PDFium Authors. All rights reserved. | |
| // Use of this source code is governed by a BSD-style license that can be | |
| // found in the LICENSE file. | |
| // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com | |
| #ifndef PUBLIC_FPDF_SYSFONTINFO_H_ | |
| #define PUBLIC_FPDF_SYSFONTINFO_H_ | |
| // clang-format off | |
| // NOLINTNEXTLINE(build/include) | |
| #include "fpdfview.h" | |
| /* Character sets for the font */ | |
| #define FXFONT_ANSI_CHARSET 0 | |
| #define FXFONT_DEFAULT_CHARSET 1 | |
| #define FXFONT_SYMBOL_CHARSET 2 | |
| #define FXFONT_SHIFTJIS_CHARSET 128 | |
| #define FXFONT_HANGEUL_CHARSET 129 | |
| #define FXFONT_GB2312_CHARSET 134 | |
| #define FXFONT_CHINESEBIG5_CHARSET 136 | |
| #define FXFONT_ARABIC_CHARSET 178 | |
| #define FXFONT_CYRILLIC_CHARSET 204 | |
| #define FXFONT_EASTERNEUROPEAN_CHARSET 238 | |
| /* Font pitch and family flags */ | |
| #define FXFONT_FF_FIXEDPITCH (1 << 0) | |
| #define FXFONT_FF_ROMAN (1 << 4) | |
| #define FXFONT_FF_SCRIPT (4 << 4) | |
| /* Typical weight values */ | |
| #define FXFONT_FW_NORMAL 400 | |
| #define FXFONT_FW_BOLD 700 | |
| // Exported Functions | |
| #ifdef __cplusplus | |
| extern "C" { | |
| #endif | |
| /* | |
| * Interface: FPDF_SYSFONTINFO | |
| * Interface for getting system font information and font mapping | |
| */ | |
| typedef struct _FPDF_SYSFONTINFO { | |
| /* | |
| * Version number of the interface. Currently must be 1. | |
| */ | |
| int version; | |
| /* | |
| * Method: Release | |
| * Give implementation a chance to release any data after the | |
| * interface is no longer used. | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * No | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * Return Value: | |
| * None | |
| * Comments: | |
| * Called by PDFium during the final cleanup process. | |
| */ | |
| void (*Release)(struct _FPDF_SYSFONTINFO* pThis); | |
| /* | |
| * Method: EnumFonts | |
| * Enumerate all fonts installed on the system | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * No | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * pMapper - An opaque pointer to internal font mapper, used | |
| * when calling FPDF_AddInstalledFont(). | |
| * Return Value: | |
| * None | |
| * Comments: | |
| * Implementations should call FPDF_AddIntalledFont() function for | |
| * each font found. Only TrueType/OpenType and Type1 fonts are accepted | |
| * by PDFium. | |
| */ | |
| void (*EnumFonts)(struct _FPDF_SYSFONTINFO* pThis, void* pMapper); | |
| /* | |
| * Method: MapFont | |
| * Use the system font mapper to get a font handle from requested | |
| * parameters. | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * Required if GetFont method is not implemented. | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * weight - Weight of the requested font. 400 is normal and | |
| * 700 is bold. | |
| * bItalic - Italic option of the requested font, TRUE or | |
| * FALSE. | |
| * charset - Character set identifier for the requested font. | |
| * See above defined constants. | |
| * pitch_family - A combination of flags. See above defined | |
| * constants. | |
| * face - Typeface name. Currently use system local encoding | |
| * only. | |
| * bExact - Obsolete: this parameter is now ignored. | |
| * Return Value: | |
| * An opaque pointer for font handle, or NULL if system mapping is | |
| * not supported. | |
| * Comments: | |
| * If the system supports native font mapper (like Windows), | |
| * implementation can implement this method to get a font handle. | |
| * Otherwise, PDFium will do the mapping and then call GetFont | |
| * method. Only TrueType/OpenType and Type1 fonts are accepted | |
| * by PDFium. | |
| */ | |
| void* (*MapFont)(struct _FPDF_SYSFONTINFO* pThis, | |
| int weight, | |
| FPDF_BOOL bItalic, | |
| int charset, | |
| int pitch_family, | |
| const char* face, | |
| FPDF_BOOL* bExact); | |
| /* | |
| * Method: GetFont | |
| * Get a handle to a particular font by its internal ID | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * Required if MapFont method is not implemented. | |
| * Return Value: | |
| * An opaque pointer for font handle. | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * face - Typeface name in system local encoding. | |
| * Comments: | |
| * If the system mapping not supported, PDFium will do the font | |
| * mapping and use this method to get a font handle. | |
| */ | |
| void* (*GetFont)(struct _FPDF_SYSFONTINFO* pThis, const char* face); | |
| /* | |
| * Method: GetFontData | |
| * Get font data from a font | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * Yes | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * hFont - Font handle returned by MapFont or GetFont method | |
| * table - TrueType/OpenType table identifier (refer to | |
| * TrueType specification), or 0 for the whole file. | |
| * buffer - The buffer receiving the font data. Can be NULL if | |
| * not provided. | |
| * buf_size - Buffer size, can be zero if not provided. | |
| * Return Value: | |
| * Number of bytes needed, if buffer not provided or not large | |
| * enough, or number of bytes written into buffer otherwise. | |
| * Comments: | |
| * Can read either the full font file, or a particular | |
| * TrueType/OpenType table. | |
| */ | |
| unsigned long (*GetFontData)(struct _FPDF_SYSFONTINFO* pThis, | |
| void* hFont, | |
| unsigned int table, | |
| unsigned char* buffer, | |
| unsigned long buf_size); | |
| /* | |
| * Method: GetFaceName | |
| * Get face name from a font handle | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * No | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * hFont - Font handle returned by MapFont or GetFont method | |
| * buffer - The buffer receiving the face name. Can be NULL if | |
| * not provided | |
| * buf_size - Buffer size, can be zero if not provided | |
| * Return Value: | |
| * Number of bytes needed, if buffer not provided or not large | |
| * enough, or number of bytes written into buffer otherwise. | |
| */ | |
| unsigned long (*GetFaceName)(struct _FPDF_SYSFONTINFO* pThis, | |
| void* hFont, | |
| char* buffer, | |
| unsigned long buf_size); | |
| /* | |
| * Method: GetFontCharset | |
| * Get character set information for a font handle | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * No | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * hFont - Font handle returned by MapFont or GetFont method | |
| * Return Value: | |
| * Character set identifier. See defined constants above. | |
| */ | |
| int (*GetFontCharset)(struct _FPDF_SYSFONTINFO* pThis, void* hFont); | |
| /* | |
| * Method: DeleteFont | |
| * Delete a font handle | |
| * Interface Version: | |
| * 1 | |
| * Implementation Required: | |
| * Yes | |
| * Parameters: | |
| * pThis - Pointer to the interface structure itself | |
| * hFont - Font handle returned by MapFont or GetFont method | |
| * Return Value: | |
| * None | |
| */ | |
| void (*DeleteFont)(struct _FPDF_SYSFONTINFO* pThis, void* hFont); | |
| } FPDF_SYSFONTINFO; | |
| /* | |
| * Struct: FPDF_CharsetFontMap | |
| * Provides the name of a font to use for a given charset value. | |
| */ | |
| typedef struct FPDF_CharsetFontMap_ { | |
| int charset; // Character Set Enum value, see FXFONT_*_CHARSET above. | |
| const char* fontname; // Name of default font to use with that charset. | |
| } FPDF_CharsetFontMap; | |
| /* | |
| * Function: FPDF_GetDefaultTTFMap | |
| * Returns a pointer to the default character set to TT Font name map. The | |
| * map is an array of FPDF_CharsetFontMap structs, with its end indicated | |
| * by a { -1, NULL } entry. | |
| * Parameters: | |
| * None. | |
| * Return Value: | |
| * Pointer to the Charset Font Map. | |
| */ | |
| FPDF_EXPORT const FPDF_CharsetFontMap* FPDF_CALLCONV FPDF_GetDefaultTTFMap(); | |
| /* | |
| * Function: FPDF_AddInstalledFont | |
| * Add a system font to the list in PDFium. | |
| * Comments: | |
| * This function is only called during the system font list building | |
| * process. | |
| * Parameters: | |
| * mapper - Opaque pointer to Foxit font mapper | |
| * face - The font face name | |
| * charset - Font character set. See above defined constants. | |
| * Return Value: | |
| * None. | |
| */ | |
| FPDF_EXPORT void FPDF_CALLCONV FPDF_AddInstalledFont(void* mapper, | |
| const char* face, | |
| int charset); | |
| /* | |
| * Function: FPDF_SetSystemFontInfo | |
| * Set the system font info interface into PDFium | |
| * Parameters: | |
| * pFontInfo - Pointer to a FPDF_SYSFONTINFO structure | |
| * Return Value: | |
| * None | |
| * Comments: | |
| * Platform support implementation should implement required methods of | |
| * FFDF_SYSFONTINFO interface, then call this function during PDFium | |
| * initialization process. | |
| */ | |
| FPDF_EXPORT void FPDF_CALLCONV | |
| FPDF_SetSystemFontInfo(FPDF_SYSFONTINFO* pFontInfo); | |
| /* | |
| * Function: FPDF_GetDefaultSystemFontInfo | |
| * Get default system font info interface for current platform | |
| * Parameters: | |
| * None | |
| * Return Value: | |
| * Pointer to a FPDF_SYSFONTINFO structure describing the default | |
| * interface, or NULL if the platform doesn't have a default interface. | |
| * Application should call FPDF_FreeDefaultSystemFontInfo to free the | |
| * returned pointer. | |
| * Comments: | |
| * For some platforms, PDFium implements a default version of system | |
| * font info interface. The default implementation can be passed to | |
| * FPDF_SetSystemFontInfo(). | |
| */ | |
| FPDF_EXPORT FPDF_SYSFONTINFO* FPDF_CALLCONV FPDF_GetDefaultSystemFontInfo(); | |
| /* | |
| * Function: FPDF_FreeDefaultSystemFontInfo | |
| * Free a default system font info interface | |
| * Parameters: | |
| * pFontInfo - Pointer to a FPDF_SYSFONTINFO structure | |
| * Return Value: | |
| * None | |
| * Comments: | |
| * This function should be called on the output from | |
| * FPDF_SetSystemFontInfo() once it is no longer needed. | |
| */ | |
| FPDF_EXPORT void FPDF_CALLCONV | |
| FPDF_FreeDefaultSystemFontInfo(FPDF_SYSFONTINFO* pFontInfo); | |
| #ifdef __cplusplus | |
| } | |
| #endif | |
| #endif // PUBLIC_FPDF_SYSFONTINFO_H_ |