path: root/Build/source/texk/web2c/xetexdir/XeTeX_ext.h

/****************************************************************************\
 Part of the XeTeX typesetting system
 Copyright (c) 1994-2008 by SIL International
 Copyright (c) 2009, 2011 by Jonathan Kew
 Copyright (c) 2012, 2013 by Jiang Jiang
 Copyright (c) 2012-2015 by Khaled Hosny

 SIL Author(s): Jonathan Kew

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of the copyright holders
shall not be used in advertising or otherwise to promote the sale,
use or other dealings in this Software without prior written
authorization from the copyright holders.
\****************************************************************************/

#ifndef __XETEXEXT_H
#define __XETEXEXT_H

#include <unicode/utypes.h>

#ifndef XETEX_UNICODE_FILE_DEFINED
typedef struct UFILE* unicodefile;
#endif

#define AAT_FONT_FLAG   0xFFFFU
#define OTGR_FONT_FLAG  0xFFFEU

#define FONT_FLAGS_COLORED  0x01
#define FONT_FLAGS_VERTICAL 0x02

/* some typedefs that XeTeX uses - on Mac OS, we get these from Apple headers,
   but otherwise we'll need these substitute definitions */

#ifdef XETEX_MAC
#include <CoreFoundation/CoreFoundation.h>
#include <ApplicationServices/ApplicationServices.h>
#else
typedef int32_t         Fixed;
typedef struct {
    Fixed   x;
    Fixed   y;
} FixedPoint;
#endif

typedef uint32_t OTTag;
typedef uint16_t GlyphID;
typedef struct {
    float   x;
    float   y;
} FloatPoint;


/* these are also in xetex.web and must correspond! */

#define pdfbox_crop 1
#define pdfbox_media    2
#define pdfbox_bleed    3
#define pdfbox_trim 4
#define pdfbox_art  5


#define XeTeX_count_glyphs  1

#define XeTeX_count_features    8
#define XeTeX_feature_code  9
#define XeTeX_find_feature_by_name  10
#define XeTeX_is_exclusive_feature  11
#define XeTeX_count_selectors   12
#define XeTeX_selector_code 13
#define XeTeX_find_selector_by_name 14
#define XeTeX_is_default_selector   15

#define XeTeX_OT_count_scripts  16
#define XeTeX_OT_count_languages    17
#define XeTeX_OT_count_features 18
#define XeTeX_OT_script_code    19
#define XeTeX_OT_language_code  20
#define XeTeX_OT_feature_code   21

#define XeTeX_map_char_to_glyph_code    22

#define XeTeX_feature_name  8
#define XeTeX_selector_name 9


/* definitions used to access info in a native_word_node; must correspond with defines in xetex.web */
#define width_offset        1
#define depth_offset        2
#define height_offset       3
#define native_info_offset  4
#define native_glyph_info_offset    5

#define node_width(node)            node[width_offset].cint
#define node_depth(node)            node[depth_offset].cint
#define node_height(node)           node[height_offset].cint
#define native_length(node)         node[native_info_offset].qqqq.b2
#define native_font(node)           node[native_info_offset].qqqq.b1
#define native_glyph_count(node)    node[native_info_offset].qqqq.b3
#define native_glyph_info_ptr(node) node[native_glyph_info_offset].ptr
#define native_glyph_info_size      10  /* info for each glyph is location (FixedPoint) + glyph ID (uint16_t) */

#define native_glyph(p)     native_length(p)    /* glyph ID field in a glyph_node */

/* OT-related constants we need */
#define kGSUB   HB_TAG('G','S','U','B')
#define kGPOS   HB_TAG('G','P','O','S')

typedef struct
{
    float   xMin;
    float   yMin;
    float   xMax;
    float   yMax;
} GlyphBBox;


/* For Unicode encoding form interpretation... */
extern const uint32_t offsetsFromUTF8[6];
extern const uint8_t bytesFromUTF8[256];
extern const uint8_t firstByteMark[7];

extern const int halfShift;
extern const uint32_t halfBase;
extern const uint32_t halfMask;
extern const uint32_t kSurrogateHighStart;
extern const uint32_t kSurrogateHighEnd;
extern const uint32_t kSurrogateLowStart;
extern const uint32_t kSurrogateLowEnd;
extern const uint32_t byteMask;
extern const uint32_t byteMark;

extern const char *papersize;
extern const char *outputdriver;

/* gFreeTypeLibrary is defined in XeTeXFontInst_FT2.cpp,
 * also used in XeTeXFontMgr_FC.cpp and XeTeX_ext.c.  */
#include <ft2build.h>
#include FT_FREETYPE_H
#ifdef __cplusplus
extern "C" {
#endif
extern FT_Library gFreeTypeLibrary;
#ifdef __cplusplus
}
#endif

#include <stdio.h> /* for FILE */

#ifdef WIN32
#undef fputs
#undef putc
#define fputs win32_fputs
#define putc  win32_putc
#endif

#include "trans.h"

#ifdef HAVE_STDBOOL_H
# include <stdbool.h>
#else
/* boolean is an enum type from kpathsea/types.h loaded in
   kpathsea/kpathsea.h, use it as fallback */
#ifndef __cplusplus
# define bool boolean
#endif
#endif

#include "XeTeXLayoutInterface.h"

#ifdef XETEX_MAC
extern const CFStringRef kXeTeXEmboldenAttributeName;
#endif

#ifdef __cplusplus
extern "C" {
#endif
    void initversionstring(char **versions);

    void setinputfileencoding(unicodefile f, integer mode, integer encodingData);
    void linebreakstart(int f, integer localeStrNum, uint16_t* text, integer textLength);
    int linebreaknext(void);
    int getencodingmodeandinfo(integer* info);
    void printutf8str(const unsigned char* str, int len);
    void printchars(const unsigned short* str, int len);
    void* findnativefont(unsigned char* name, integer scaled_size);
    void releasefontengine(void* engine, int type_flag);
    int readCommonFeatures(const char* feat, const char* end, float* extend, float* slant, float* embolden, float* letterspace, uint32_t* rgbValue);

    /* the metrics params here are really TeX 'scaled' values, but that typedef isn't available every place this is included */
    void otgetfontmetrics(void* engine, integer* ascent, integer* descent, integer* xheight, integer* capheight, integer* slant);
    void getnativecharheightdepth(integer font, integer ch, integer* height, integer* depth);
    void getnativecharsidebearings(integer font, integer ch, integer* lsb, integer* rsb);

    /* single-purpose metrics accessors */
    integer getnativecharwd(integer font, integer ch);
    integer getnativecharht(integer font, integer ch);
    integer getnativechardp(integer font, integer ch);
    integer getnativecharic(integer font, integer ch);

    integer getglyphbounds(integer font, integer edge, integer gid);

    integer otfontget(integer what, void* engine);
    integer otfontget1(integer what, void* engine, integer param);
    integer otfontget2(integer what, void* engine, integer param1, integer param2);
    integer otfontget3(integer what, void* engine, integer param1, integer param2, integer param3);
    int makeXDVGlyphArrayData(void* p);
    int makefontdef(integer f);
    int applymapping(void* cnv, uint16_t* txtPtr, int txtLen);
    void store_justified_native_glyphs(void* node);
    void measure_native_node(void* node, int use_glyph_metrics);
    Fixed get_native_italic_correction(void* node);
    Fixed get_native_glyph_italic_correction(void* node);
    integer get_native_word_cp(void* node, int side);
    void measure_native_glyph(void* node, int use_glyph_metrics);
    integer mapchartoglyph(integer font, integer ch);
    integer mapglyphtoindex(integer font);
    integer getfontcharrange(integer font, int first);
    void printglyphname(integer font, integer gid);
    uint16_t get_native_glyph(void* pNode, unsigned index);

    void grprintfontname(integer what, void* pEngine, integer param1, integer param2);
    integer grfontgetnamed(integer what, void* pEngine);
    integer grfontgetnamed1(integer what, void* pEngine, integer param);

    double read_double(const char** s);
    unsigned int read_rgb_a(const char** cp);

    int countpdffilepages(void);
    int find_pic_file(char** path, realrect* bounds, int pdfBoxType, int page);
    int u_open_in(unicodefile* f, integer filefmt, const char* fopen_mode, integer mode, integer encodingData);
    void u_close_inout(unicodefile* f);
    int open_dvi_output(FILE** fptr);
    int dviclose(FILE* fptr);
    int get_uni_c(UFILE* f);
    int input_line(UFILE* f);
    void makeutf16name(void);

    void terminatefontmanager(void);
    int maketexstring(const char* s);

    void checkfortfmfontmapping(void);
    void* loadtfmfontmapping(void);
    int applytfmfontmapping(void* mapping, int c);

#ifndef XETEX_MAC
typedef void* CFDictionaryRef; /* dummy declaration just so the stubs can compile */
#endif

    int aatfontget(int what, CFDictionaryRef attrs);
    int aatfontget1(int what, CFDictionaryRef attrs, int param);
    int aatfontget2(int what, CFDictionaryRef attrs, int param1, int param2);
    int aatfontgetnamed(int what, CFDictionaryRef attrs);
    int aatfontgetnamed1(int what, CFDictionaryRef attrs, int param);
    void aatprintfontname(int what, CFDictionaryRef attrs, int param1, int param2);
    /* the metrics params here are really TeX 'scaled' (or MacOS 'Fixed') values, but that typedef isn't available every place this is included */
    void aatgetfontmetrics(CFDictionaryRef attrs, integer* ascent, integer* descent, integer* xheight, integer* capheight, integer* slant);

    void set_cp_code(int fontNum, unsigned int code, int side, int value);
    int get_cp_code(int fontNum, unsigned int code, int side);

#ifdef XETEX_MAC

/* functions in XeTeX_mac.c */
    void* loadAATfont(CTFontDescriptorRef descriptor, integer scaled_size, const char* cp1);
    void DoAATLayout(void* node, int justify);
    void GetGlyphBBox_AAT(CFDictionaryRef fontAttrs, uint16_t gid, GlyphBBox* bbox);
    double GetGlyphWidth_AAT(CFDictionaryRef fontAttrs, uint16_t gid);
    void GetGlyphHeightDepth_AAT(CFDictionaryRef fontAttrs, uint16_t gid, float* ht, float* dp);
    void GetGlyphSidebearings_AAT(CFDictionaryRef fontAttrs, uint16_t gid, float* lsb, float* rsb);
    double GetGlyphItalCorr_AAT(CFDictionaryRef fontAttrs, uint16_t gid);
    int MapCharToGlyph_AAT(CFDictionaryRef fontAttrs, UInt32 ch);
    int MapGlyphToIndex_AAT(CFDictionaryRef attributes, const char* glyphName);
    char* GetGlyphNameFromCTFont(CTFontRef ctFontRef, uint16_t gid, int* len);
    CFDictionaryRef findDictionaryInArray(CFArrayRef array, const void* nameKey, const char* name, int nameLength);
    CFDictionaryRef findDictionaryInArrayWithIdentifier(CFArrayRef array, const void* identifierKey, int identifier);
    CFNumberRef findSelectorByName(CFDictionaryRef feature, const char* name, int nameLength);
    char* getNameFromCTFont(CTFontRef ctFontRef, CFStringRef nameKey);
    char* getFileNameFromCTFont(CTFontRef ctFontRef, uint32_t* index);
    int GetFontCharRange_AAT(CFDictionaryRef fontAttrs, int reqFirst);
    CTFontRef fontFromAttributes(CFDictionaryRef fontAttrs);
    CTFontRef fontFromInteger(integer font);
#endif
#ifdef __cplusplus
};
#endif

#ifdef __cplusplus
extern "C" {
#endif
    double  Fix2D(Fixed f);
    Fixed   D2Fix(double d);
#ifdef __cplusplus
};
#endif

// copied from xetex.web
#define LEFT_SIDE  0
#define RIGHT_SIDE 1

#endif /* __XETEX_EXT_H */