-/* otf.h -- Header file for the OTF (OpenType font) library.
+/* otf.h -- Header file for libotf (OpenType font library).
-Copyright (C) 2002
- by AIST (National Institute of Advanced Industrial Science and Technology)
- Registration Number H14PRO???
+Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009
+ National Institute of Advanced Industrial Science and Technology (AIST)
+ Registration Number H15PRO167
-This file is part of the OTF library.
+This file is part of libotf.
-The OTF library is free software; you can redistribute it and/or
-modify it under the terms of the GNU General Public License as
-published by the Free Software Foundation; either version 2, or (at
-your option) any later version.
+Libotf is free software; you can redistribute it and/or modify it
+under the terms of the GNU Lesser General Public License as published
+by the Free Software Foundation; either version 2.1 of the License, or
+(at your option) any later version.
-The OTF library is distributed in the hope that it will be useful, but
-WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-General Public License for more details.
+Libotf is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
+License for more details.
-You should have received a copy of the GNU General Public License
-along with the OTF library; see the file COPYING. If not, write to
-the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-Boston, MA 02111-1307, USA. */
+You should have received a copy of the GNU Lesser General Public
+License along with this library, in a file named COPYING; if not,
+write to the Free Software Foundation, Inc., 59 Temple Place, Suite
+330, Boston, MA 02111-1307, USA. */
#ifndef _OTF_H_
#define _OTF_H_
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Version name of this library. */
+#define LIBOTF_VERSION "0.9.9"
+
+/* Major version number. */
+#define LIBOTF_MAJOR_VERSION 0
+/* Minor version number. */
+#define LIBOTF_MINOR_VERSION 9
+/* Release (i.e. patch level) number. */
+#define LIBOTF_RELEASE_NUMBER 9
+
/***
Table of contents:
- (1) Structures for OTF tables and OTF itself
+ (1) Structures for OTF Layout tables and OTF itself
(1-1) Basic types
(1-2) "head" table
(1-3) "name" table
(1-5) Structures common to GDEF, GSUB, and GPOS
(1-6) "GDEF" table
(1-7) Structures for ScriptList, FeatureList, and LookupList
- (1-8) "GSUB" table
- (1-9) "GPOS" table
- (1-9) Structure for OTF
+ (1-8) Structures common to GSUB and GPOS
+ (1-9) "GSUB" table
+ (1-10) "GPOS" table
+ (1-11) Structure for OTF
- (2) APIs for reading OTF
- (2-1) OTF_open()
+ (2) API for reading OTF
+ (2-1) OTF_open(), OTF_open_ft_face()
(2-2) OTF_close()
(2-3) OTF_get_table()
+ (2-4) OTF_check_table()
- (3) APIs for driving OTF
+ (3) API for driving OTF
(3-1) Structure for glyph string
(3-2) OTF_drive_cmap()
(3-3) OTF_drive_gdef()
(3-4) OTF_drive_gsub()
(3-5) OTF_drive_gpos()
(3-6) OTF_drive_tables()
+ (3-7) OTF_get_unicode()
+ (3-8) OTF_drive_gsub_alternate()
- (4) APIs for error handling
+ (4) API for error handling
(4-1) Error codes
(4-2) OTF_perror()
- (5) APIs miscellaneous
+ (5) API miscellaneous
*/
-/*** (1) Structures for OTF tables and OTF itself */
+\f
+/*** (1) Structures for OTF Layout tables and OTF itself */
/*** (1-1) Basic types */
int nameID;
int length;
int offset;
+
+ /* If nonzero, NAME is an ASCII string. */
+ int ascii;
+ unsigned char *name;
} OTF_NameRecord;
#define OTF_max_nameID 23
typedef struct
{
- unsigned subHeaderKeys[256];
+ unsigned short subHeaderKeys[256];
+ int subHeaderCount;
OTF_cmapSubHeader *subHeaders;
- unsigned *glyphIndexArray;
+ int glyphIndexCount;
+ OTF_GlyphID *glyphIndexArray;
} OTF_EncodingSubtable2;
typedef struct
unsigned endCount;
int idDelta;
unsigned idRangeOffset;
-} OTF_cmapSegument;
+} OTF_cmapSegment;
typedef struct
{
unsigned searchRange;
unsigned entrySelector;
unsigned rangeShift;
- OTF_cmapSegument *segments;
+ OTF_cmapSegment *segments;
int GlyphCount;
unsigned *glyphIdArray;
} OTF_EncodingSubtable4;
typedef struct
{
+ unsigned unicodeValue;
+ unsigned short glyphID;
+} OTF_UVSMapping;
+
+typedef struct
+{
+ unsigned startUnicodeValue;
+ unsigned short additionalCount;
+} OTF_UnicodeValueRange;
+
+typedef struct
+{
+ unsigned varSelector;
+ unsigned defaultUVSOffset;
+ unsigned nonDefaultUVSOffset;
+ /* DefaultUVS */
+ unsigned numUnicodeValueRanges;
+ OTF_UnicodeValueRange *unicodeValueRanges;
+ /* NonDefaultUVS */
+ unsigned numUVSMappings;
+ OTF_UVSMapping *uvsMappings;
+} OTF_VariationSelectorRecord;
+
+typedef struct
+{
+ unsigned nRecords;
+ OTF_VariationSelectorRecord *Records;
+} OTF_EncodingSubtable14;
+
+typedef struct
+{
unsigned format;
unsigned length;
unsigned language;
OTF_EncodingSubtable8 *f8;
OTF_EncodingSubtable10 *f10;
OTF_EncodingSubtable12 *f12;
+ OTF_EncodingSubtable14 *f14;
}f;
} OTF_EncodingSubtable;
unsigned version;
unsigned numTables;
OTF_EncodingRecord *EncodingRecord;
- OTF_EncodingRecord *Unicode;
+ /* Mapping table: Unicode->GlyphID (for BMP only) */
+ unsigned short *unicode_table;
+ int max_glyph_id;
+ /* Mapping table: GlyphID->Unicode */
+ unsigned short *decode_table;
+ /* Index of the EncodingRecord for Unicode->GlyphID mapping.
+ -1 means that the font supports only Unicode BMP characters. */
+ int table_index;
} OTF_cmap;
OTF_RightToLeft = 0x0001,
OTF_IgnoreBaseGlyphs = 0x0002,
OTF_IgnoreLigatures = 0x0004,
- OTF_IgnoreMarks = 0x8000,
+ OTF_IgnoreMarks = 0x0008,
OTF_Reserved = 0x00F0,
OTF_MarkAttachmentType = 0xFF00
};
-
+
+#define OTF_LookupFlagIgnoreMask \
+ (OTF_IgnoreBaseGlyphs | OTF_IgnoreLigatures | OTF_IgnoreMarks)
+
typedef struct
{
OTF_Offset offset;
OTF_Lookup *Lookup;
} OTF_LookupList;
-/*** (1-8) "GSUB" table */
+
+/*** (1-8) Structures common to GSUB and GPOS */
+
+/* For SubstLookupRecord (GSUB) and PosLookupRecord (GPOS). */
typedef struct
{
- int DeltaGlyphID;
-} OTF_GSUB_Single1;
+ unsigned SequenceIndex;
+ unsigned LookupListIndex;
+} OTF_LookupRecord;
typedef struct
{
+ OTF_Offset offset;
unsigned GlyphCount;
- OTF_GlyphID *Substitute;
-} OTF_GSUB_Single2;
-
-typedef struct OTF_Sequence OTF_Sequence;
+ unsigned LookupCount;
+ OTF_GlyphID *Input; /* [<GlyphCount> - 1] */
+ OTF_LookupRecord *LookupRecord; /* [<LookupCount>] */
+} OTF_Rule;
typedef struct
{
- unsigned SequenceCount;
- OTF_Sequence *Sequence;
-} OTF_GSUB_Multiple1;
+ OTF_Offset offset;
+ unsigned RuleCount;
+ OTF_Rule *Rule; /* [<RuleCount>] */
+} OTF_RuleSet;
-struct OTF_Sequence
+typedef struct
{
OTF_Offset offset;
unsigned GlyphCount;
- OTF_GlyphID *Substitute;
-};
-
-typedef struct OTF_AlternateSet OTF_AlternateSet;
+ unsigned LookupCount;
+ unsigned *Class; /* [<GlyphCount> - 1] */
+ OTF_LookupRecord *LookupRecord; /* [<LookupCount>] */
+} OTF_ClassRule;
typedef struct
{
- unsigned AlternateSetCount;
- OTF_AlternateSet *AlternateSet;
-} OTF_GSUB_Alternate1;
-
-struct OTF_AlternateSet
-{
OTF_Offset offset;
- unsigned GlyphCount;
- OTF_GlyphID *Alternate;
-};
-
-typedef struct OTF_LigatureSet OTF_LigatureSet;
-typedef struct OTF_Ligature OTF_Ligature;
+ unsigned ClassRuleCnt;
+ OTF_ClassRule *ClassRule; /* [<ClassRuleCnt>] */
+} OTF_ClassSet;
typedef struct
{
- unsigned LigSetCount;
- OTF_LigatureSet *LigatureSet;
-} OTF_GSUB_Ligature1;
+ OTF_Offset offset;
+ unsigned BacktrackGlyphCount;
+ OTF_GlyphID *Backtrack;
+ unsigned InputGlyphCount;
+ OTF_GlyphID *Input;
+ unsigned LookaheadGlyphCount;
+ OTF_GlyphID *LookAhead;
+ unsigned LookupCount;
+ OTF_LookupRecord *LookupRecord;
+} OTF_ChainRule;
-struct OTF_LigatureSet
+typedef struct
{
OTF_Offset offset;
- unsigned LigatureCount;
- OTF_Ligature *Ligature;
-};
+ unsigned ChainRuleCount;
+ OTF_ChainRule *ChainRule;
+} OTF_ChainRuleSet;
-struct OTF_Ligature
+typedef struct
{
OTF_Offset offset;
- OTF_GlyphID LigGlyph;
- unsigned CompCount;
- OTF_GlyphID *Component;
-};
+ unsigned BacktrackGlyphCount;
+ unsigned *Backtrack;
+ unsigned InputGlyphCount;
+ unsigned *Input;
+ unsigned LookaheadGlyphCount;
+ unsigned *LookAhead;
+ unsigned LookupCount;
+ OTF_LookupRecord *LookupRecord;
+} OTF_ChainClassRule;
typedef struct
{
- unsigned SequenceIndex;
- unsigned LookupListIndex;
-} OTF_LookupRecord;
+ OTF_Offset offset;
+ unsigned ChainClassRuleCnt;
+ OTF_ChainClassRule *ChainClassRule;
+} OTF_ChainClassSet;
+
-typedef struct OTF_RuleSet OTF_RuleSet;
+/* Common to OTF_GSUB/GPOS_Context1/2/3. */
typedef struct
{
- unsigned SubRuleSetCount;
- OTF_RuleSet *SubRuleSet; /* [<SubRuleSetCount>] */
-} OTF_GSUB_Context1;
+ unsigned RuleSetCount;
+ OTF_RuleSet *RuleSet; /* [<RuleSetCount>] */
+} OTF_Context1;
-typedef struct OTF_Rule OTF_Rule;
-
-struct OTF_RuleSet
+typedef struct
{
- OTF_Offset offset;
- unsigned RuleCount;
- OTF_Rule *Rule; /* [<RuleCount>] */
-};
+ OTF_ClassDef ClassDef;
+ unsigned ClassSetCnt;
+ OTF_ClassSet *ClassSet; /* [<ClassSetCnt>] */
+} OTF_Context2;
-struct OTF_Rule
+typedef struct
{
- OTF_Offset offset;
unsigned GlyphCount;
unsigned LookupCount;
- OTF_GlyphID *Input; /* [<GlyphCount> - 1] */
+ OTF_Coverage *Coverage; /* [<GlyphCount>] */
OTF_LookupRecord *LookupRecord; /* [<LookupCount>] */
-};
+} OTF_Context3;
+
-typedef struct OTF_ClassSet OTF_ClassSet;
+/* Common to OTF_GSUB/GPOS_ChainContext1/2/3. */
typedef struct
{
- OTF_ClassDef ClassDef;
- unsigned SubClassSetCnt;
- OTF_ClassSet *SubClassSet; /* [<ClassSetCnt>] */
-} OTF_GSUB_Context2;
+ unsigned ChainRuleSetCount;
+ OTF_ChainRuleSet *ChainRuleSet;
+} OTF_ChainContext1;
-typedef struct OTF_ClassRule OTF_ClassRule;
-
-struct OTF_ClassSet
+typedef struct
{
- OTF_Offset offset;
- unsigned ClassRuleCnt;
- OTF_ClassRule *ClassRule; /* [<ClassRuleCnt>] */
-};
+ OTF_ClassDef BacktrackClassDef;
+ OTF_ClassDef InputClassDef;
+ OTF_ClassDef LookaheadClassDef;
+ unsigned ChainClassSetCnt;
+ OTF_ChainClassSet *ChainClassSet;
+} OTF_ChainContext2;
-struct OTF_ClassRule
+typedef struct
{
- OTF_Offset offset;
- unsigned GlyphCount;
+ unsigned BacktrackGlyphCount;
+ OTF_Coverage *Backtrack;
+ unsigned InputGlyphCount;
+ OTF_Coverage *Input;
+ unsigned LookaheadGlyphCount;
+ OTF_Coverage *LookAhead;
unsigned LookupCount;
- unsigned *Class; /* [<GlyphCount> - 1] */
- OTF_LookupRecord *LookupRecord; /* [<LookupCount>] */
-};
+ OTF_LookupRecord *LookupRecord;
+} OTF_ChainContext3;
+
+/* Common to OTF_GSUB/GPOS. */
typedef struct
{
- unsigned GlyphCount;
- unsigned SubstCount;
- OTF_Coverage *Coverage;
- OTF_LookupRecord *LookupRecord;
-} OTF_GSUB_Context3;
+ OTF_Fixed Version;
+ OTF_ScriptList ScriptList;
+ OTF_FeatureList FeatureList;
+ OTF_LookupList LookupList;
+} OTF_GSUB_GPOS;
-typedef struct OTF_ChainRuleSet OTF_ChainRuleSet;
+/*** (1-9) "GSUB" table */
typedef struct
{
- unsigned ChainSubRuleSetCount;
- OTF_ChainRuleSet *ChainSubRuleSet;
-} OTF_GSUB_ChainContext1;
+ int DeltaGlyphID;
+} OTF_GSUB_Single1;
-typedef struct OTF_ChainRule OTF_ChainRule;
+typedef struct
+{
+ unsigned GlyphCount;
+ OTF_GlyphID *Substitute;
+} OTF_GSUB_Single2;
-struct OTF_ChainRuleSet
+typedef struct OTF_Sequence OTF_Sequence;
+
+typedef struct
+{
+ unsigned SequenceCount;
+ OTF_Sequence *Sequence;
+} OTF_GSUB_Multiple1;
+
+struct OTF_Sequence
{
OTF_Offset offset;
- unsigned ChainRuleCount;
- OTF_ChainRule *ChainRule;
+ unsigned GlyphCount;
+ OTF_GlyphID *Substitute;
};
-struct OTF_ChainRule
+typedef struct OTF_AlternateSet OTF_AlternateSet;
+
+typedef struct
+{
+ unsigned AlternateSetCount;
+ OTF_AlternateSet *AlternateSet;
+} OTF_GSUB_Alternate1;
+
+struct OTF_AlternateSet
{
OTF_Offset offset;
- unsigned BacktrackGlyphCount;
- OTF_GlyphID *Backtrack;
- unsigned InputGlyphCount;
- OTF_GlyphID *Input;
- unsigned LookaheadGlyphCount;
- OTF_GlyphID *LookAhead;
- unsigned LookupCount;
- OTF_LookupRecord *LookupRecord;
+ unsigned GlyphCount;
+ OTF_GlyphID *Alternate;
};
-typedef struct OTF_ChainClassSet OTF_ChainClassSet;
+typedef struct OTF_LigatureSet OTF_LigatureSet;
+typedef struct OTF_Ligature OTF_Ligature;
typedef struct
{
- OTF_ClassDef Backtrack;
- OTF_ClassDef Input;
- OTF_ClassDef LookAhead;
- unsigned ChainSubClassSetCnt;
- OTF_ChainClassSet *ChainSubClassSet;
-} OTF_GSUB_ChainContext2;
-
-typedef struct OTF_ChainClassRule OTF_ChainClassRule;
+ unsigned LigSetCount;
+ OTF_LigatureSet *LigatureSet;
+} OTF_GSUB_Ligature1;
-struct OTF_ChainClassSet
+struct OTF_LigatureSet
{
OTF_Offset offset;
- unsigned ChainClassRuleCnt;
- OTF_ChainClassRule *ChainClassRule;
+ unsigned LigatureCount;
+ OTF_Ligature *Ligature;
};
-struct OTF_ChainClassRule
+struct OTF_Ligature
{
OTF_Offset offset;
- unsigned BacktrackGlyphCount;
- unsigned *Backtrack;
- unsigned InputGlyphCount;
- unsigned *Input;
- unsigned LookaheadGlyphCount;
- unsigned *LookAhead;
- unsigned LookupCount;
- OTF_LookupRecord *LookupRecord;
+ OTF_GlyphID LigGlyph;
+ unsigned CompCount;
+ OTF_GlyphID *Component;
};
+typedef OTF_Context1 OTF_GSUB_Context1;
-typedef struct
-{
- unsigned BacktrackGlyphCount;
- OTF_Coverage *Backtrack;
- unsigned InputGlyphCount;
- OTF_Coverage *Input;
- unsigned LookaheadGlyphCount;
- OTF_Coverage *LookAhead;
- unsigned SubstCount;
- OTF_LookupRecord *LookupRecord;
-} OTF_GSUB_ChainContext3;
+typedef OTF_Context2 OTF_GSUB_Context2;
+
+typedef OTF_Context3 OTF_GSUB_Context3;
+
+typedef OTF_ChainContext1 OTF_GSUB_ChainContext1;
+
+typedef OTF_ChainContext2 OTF_GSUB_ChainContext2;
+
+typedef OTF_ChainContext3 OTF_GSUB_ChainContext3;
typedef struct
{
unsigned ExtensionLookupType;
- unsigned ExtentionOffset;
+ unsigned ExtensionOffset;
+ OTF_LookupSubTableGSUB *ExtensionSubtable;
} OTF_GSUB_Extension1;
typedef struct
OTF_Coverage *LookAhead;
unsigned GlyphCount;
OTF_GlyphID *Substitute;
-} OTF_GSUB_ReverseChainSingle1;
+} OTF_GSUB_ReverseChain1;
struct OTF_LookupSubTableGSUB
{
/* LookupType 7 */
OTF_GSUB_Extension1 extension1;
/* LookupType 8 */
- OTF_GSUB_ReverseChainSingle1 reverse_chain_single1;
+ OTF_GSUB_ReverseChain1 reverse_chain1;
} u;
};
-typedef struct
-{
- OTF_Fixed Version;
- OTF_ScriptList ScriptList;
- OTF_FeatureList FeatureList;
- OTF_LookupList LookupList;
-} OTF_GSUB;
+typedef OTF_GSUB_GPOS OTF_GSUB;
-/*** (1-8) "GPOS" table */
+/*** (1-10) "GPOS" table */
enum OTF_ValueFormat
{
int XCoordinate;
int YCoordinate;
union {
- union {
+ struct {
unsigned AnchorPoint;
} f1;
- union {
+ struct {
OTF_DeviceTable XDeviceTable;
OTF_DeviceTable YDeviceTable;
} f2;
typedef struct
{
unsigned ValueFormat;
- OTF_ValueRecord Value;
+ OTF_ValueRecord Value;
} OTF_GPOS_Single1;
typedef struct
typedef struct
{
- int dummy;
+ OTF_GlyphID SecondGlyph;
+ OTF_ValueRecord Value1;
+ OTF_ValueRecord Value2;
+} OTF_PairValueRecord;
+
+typedef struct
+{
+ OTF_Offset offset;
+ unsigned PairValueCount;
+ OTF_PairValueRecord *PairValueRecord;
+} OTF_PairSet;
+
+typedef struct
+{
+ unsigned ValueFormat1;
+ unsigned ValueFormat2;
+ unsigned PairSetCount;
+ OTF_PairSet *PairSet;
} OTF_GPOS_Pair1;
typedef struct
typedef struct
{
- int dummy;
+ OTF_Anchor EntryAnchor;
+ OTF_Anchor ExitAnchor;
+} OTF_EntryExitRecord;
+
+typedef struct
+{
+ unsigned EntryExitCount;
+ OTF_EntryExitRecord *EntryExitRecord;
} OTF_GPOS_Cursive1;
typedef struct
typedef struct
{
- int dummy;
-} OTF_GPOS_MarkLig1;
+ OTF_Anchor *LigatureAnchor; /* [<ClassCount>] */
+} OTF_ComponentRecord;
typedef struct
{
- OTF_Coverage Mark2Coverage;
- unsigned ClassCount;
- OTF_MarkArray Mark1Array;
- OTF_AnchorArray Mark2Array;
-} OTF_GPOS_MarkMark1;
-
+ OTF_Offset offset;
+ unsigned ComponentCount;
+ OTF_ComponentRecord *ComponentRecord; /* [<ComponentCount>] */
+} OTF_LigatureAttach;
typedef struct
{
- unsigned PosRuleSetCount;
- OTF_RuleSet *PosRuleSet;
-} OTF_GPOS_Context1;
+ OTF_Offset offset;
+ unsigned LigatureCount;
+ OTF_LigatureAttach *LigatureAttach; /* [<LiagureCount>] */
+} OTF_LigatureArray;
typedef struct
{
- OTF_ClassDef ClassDef;
- unsigned PosClassSetCnt;
- OTF_ClassSet *PosClassSet;
-} OTF_GPOS_Context2;
+ OTF_Coverage LigatureCoverage;
+ unsigned ClassCount;
+ OTF_MarkArray MarkArray;
+ OTF_LigatureArray LigatureArray;
+} OTF_GPOS_MarkLig1;
typedef struct
{
- unsigned GlyphCount;
- unsigned PosCount;
- OTF_Coverage *Coverage; /* [<GlyphCount>] */
- OTF_LookupRecord *LookupRecord; /* [<PosCount>] */
-} OTF_GPOS_Context3;
+ OTF_Coverage Mark2Coverage;
+ unsigned ClassCount;
+ OTF_MarkArray Mark1Array;
+ OTF_AnchorArray Mark2Array;
+} OTF_GPOS_MarkMark1;
-typedef struct
-{
- unsigned ChainPosRuleSetCount;
- OTF_ChainRuleSet *ChainPosRuleSet;
-} OTF_GPOS_ChainContext1;
+typedef OTF_Context1 OTF_GPOS_Context1;
-typedef struct
-{
- OTF_ClassDef Backtrack;
- OTF_ClassDef Input;
- OTF_ClassDef LookAhead;
- unsigned ChainPosClassSetCnt;
- OTF_ChainClassSet *ChainPosClassSet;
-} OTF_GPOS_ChainContext2;
+typedef OTF_Context2 OTF_GPOS_Context2;
-typedef struct
-{
- unsigned BacktrackGlyphCount;
- OTF_Coverage *Backtrack;
- unsigned InputGlyphCount;
- OTF_Coverage *Input;
- unsigned LookaheadGlyphCount;
- OTF_Coverage *LookAhead;
- unsigned PosCount;
- OTF_LookupRecord *LookupRecord;
-} OTF_GPOS_ChainContext3;
+typedef OTF_Context3 OTF_GPOS_Context3;
+
+typedef OTF_ChainContext1 OTF_GPOS_ChainContext1;
+
+typedef OTF_ChainContext2 OTF_GPOS_ChainContext2;
+
+typedef OTF_ChainContext3 OTF_GPOS_ChainContext3;
typedef struct
{
- int dummy;
+ unsigned ExtensionLookupType;
+ unsigned ExtensionOffset;
+ OTF_LookupSubTableGPOS *ExtensionSubtable;
} OTF_GPOS_Extension1;
} u;
};
-typedef struct
-{
- OTF_Fixed Version;
- OTF_ScriptList ScriptList;
- OTF_FeatureList FeatureList;
- OTF_LookupList LookupList;
-} OTF_GPOS;
+typedef OTF_GSUB_GPOS OTF_GPOS;
-/*** (1-9) Structure for OTF */
+/*** (1-11) Structure for OTF */
typedef struct
{
OTF_GSUB *gsub;
OTF_GPOS *gpos;
/* The following tables are not yet supported. */
- // OTF_BASE *base;
- // OTF_JSTF *jstf;
+ /* OTF_BASE *base; */
+ /* OTF_JSTF *jstf; */
OTF_InternalData *internal_data;
} OTF;
\f
-/*** (2) APIs for reading OTF */
+/*** (2) API for reading OTF */
/*** (2-1) otf_open () */
See also OTF_get_table() and OTF_close(). */
-extern OTF *OTF_open (char *name);
+extern OTF *OTF_open (const char *name);
+
+#include <ft2build.h>
+#include FT_FREETYPE_H
+
+extern OTF *OTF_open_ft_face (FT_Face face);
/*** (2-2) OTF_close () */
/***
Close OpenType font
- The OTF_close() function closes the OpenType font pointed by $OTF
- which must be what the OTF_open() returned.
+ The OTF_close() function closes the OpenType font $OTF which must
+ be what the OTF_open() function returned.
See also OTF_open(). */
/***
Get OpenType font table
- The OTF_get_table() function setups one of the OTF tables
- specified by $NAME in the structure pointed by $OTF.
+ The OTF_get_table() function setups one of the OTF table specified
+ by $NAME in the OpenType font $OTF.
$NAME must be one of "head", "name", "cmap", "GDEF", "GSUB", and
"GPOS", and a member of the same name is setup.
See also OTF_open(). */
-extern int OTF_get_table (OTF *otf, char *name);
+extern int OTF_get_table (OTF *otf, const char *name);
+
+/*** (2-4) OTF_check_table () */
+
+/***
+ Check the existence of OpenType font table
+
+ The OTF_check_table() function checks if the the OTF table
+ specified by $NAME exists in OpenType font $OTF.
+
+ If the table exists, return 0, else return -1.
+
+ See also OTF_open(). */
+
+extern int OTF_check_table (OTF *otf, const char *name);
+
+/*** (2-5) OTF_get_scripts () */
+
+/***
+ Get supported scripts.
+
+ The OTF_get_scripts() function setups OTF_ScriptList of GSUB (if
+ $GSUBP is nonzero) or GPOS (if $GSUBP is zero) table of the
+ OpenType font $OTF.
+
+ If the table is successfully setup, return 0. Otherwise, retrun
+ -1, and set the variable OTF_error to OTF_ERROR_TABLE. */
+extern int OTF_get_scripts (OTF *otf, int gsubp);
-/*** (3) APIs for driving OTF */
+/*** (2-6) OTF_get_features () */
+
+/***
+ Get supported features.
+
+ The OTF_get_features() function setups OTF_FeatureList of GSUB (if
+ $GSUBP is nonzero) or GPOS (if $GSUBP is zero) table of the
+ OpenType font $OTF.
+
+ If the table is successfully setup, return 0. Otherwise, retrun
+ -1, and set the variable OTF_error to OTF_ERROR_TABLE. */
+
+extern int OTF_get_features (OTF *otf, int gsubp);
+
+/*** (2-7) OTF_check_features */
+
+/***
+ Check supported features.
+
+ The OTF_check_features() function checks if or not the OpenType
+ font $OTF has, for $SCRIPT and $LANGUAGE, all features in the
+ array $FEATURES. The array size is $N_FEATURES. If $LANGUAGE is
+ zero or $OTF doesn't have LangSys for $SCRIPT, the default LangSys
+ is checked.
+
+ If $OTF has all the features, return 1. Otherwise, return 0. If
+ an error occurs, return -1, and set the variable OTF_error to
+ OTF_ERROR_TABLE. */
+
+extern int OTF_check_features (OTF *otf, int gsubp,
+ OTF_Tag script, OTF_Tag language,
+ const OTF_Tag *features, int n_features);
+
+/*** (3) API for driving OTF */
/*** (3-1) Structure for glyph string */
typedef struct
{
- /* Character code of the glyph. This is the only member that a
- client has to set before calling the function
- OTF_drive_XXX(). */
+ /** The first two members must be set by a clinet before calling the
+ function OTF_drive_XXX(). **/
+
+ /* Character code of the glyph. The value less than 32 is treated
+ as a place-holder in a glyph string, and OTF_drive_XXX ()
+ function just ignore the glyph as if it doesn't exist. */
int c;
- /* Glyph ID of the glyph. */
+ /* Glyph ID of the glyph. If the value is 0, the library gets a
+ correct value from the above character code via cmap if such a
+ glyph is available in the font.
+
+ The function OTF_drive_gpos2 may insert a glyph whose glyph_id is
+ 0 but positioning_type is positive. It is not an actual glyph
+ but just contains positioning information that should be
+ accumulated to the positioning information of the previous
+ glyphs. */
OTF_GlyphID glyph_id;
/* GlyphClass of the glyph. The value is extracted from the GDEF
/* MarkAttachClassDef of the glyph. The value is extracted from the
GDEF table. */
- unsigned MarkAttachClass;
+ unsigned MarkAttachClass;
/* Positioning format type of the glyph. The value specifies how
the glyph positioning information is encoded in the member <f>.
int positioning_type;
union {
struct {
+ int from, to;
+ } index;
+ struct {
enum OTF_ValueFormat format;
OTF_ValueRecord *value;
} f1;
/* How many glyphs are allocated at the memory pointed by the member
<glyphs>. */
int size;
- /* How many glyphs contains valid information. */
+ /* How many glyphs contain valid information. */
int used;
/* Array of glyphs. It must be allocated by malloc(). The
functions otf_drive_XXX() may reallocate it and increase the
/*** (3-2) OTF_drive_cmap() */
/***
- Process glyph string by cmap table.
+ Process glyph string by Unicode-based cmap table.
- The OTF_drive_cmap() function looks up the cmap table of OpenType
- font $OTF, and setup the member <glyhph_id> of all glhphs in the
- glyph string $GSTRING. */
+ The OTF_drive_cmap() function looks up a Unicode-based cmap table
+ of OpenType font $OTF, and setup the member <glyph_id> of all
+ glhphs in the glyph string $GSTRING if the value of the member is
+ not zero. */
extern int OTF_drive_cmap (OTF *otf, OTF_GlyphString *gstring);
+/***
+ Process glyph string by a specific cmap table.
+
+ The OTF_drive_cmap2() function looks up a cmap table (whose
+ Platform-ID is $PLATFORM_ID an Encoding-ID is $ENCODING_ID) of
+ OpenType font $OTF, and setup the member <glyph_id> of all glhphs
+ in the glyph string $GSTRING if the value of the member is not
+ zero. */
+
+extern int OTF_drive_cmap2 (OTF *otf, OTF_GlyphString *gstring,
+ int platform_id, int encoding_id);
+
+
+/***
+ Store variable glyphs of character C in the array CODE. The array
+ size must be 256. The Nth element of CODE is the glyph corresponding
+ to the variation selector (N + 1). The return value is the number
+ of variation glyphs. */
+
+extern int OTF_get_variation_glyphs (OTF *otf, int c, OTF_GlyphID code[256]);
+
+
/*** (3-3) OTF_drive_gdef() */
/***
font $OTF, and by using features the font has for script $SCRIPT
and language system $LANGSYS, update member <glyphs> of the glyph
string $GSTRING. It may substitute, delete, insert glyphs in that
- array. */
+ array. $FEATURES is a list of features to apply. This doesn't
+ perform a lookup of type 3 (Alternate Substitution). For that,
+ use OTF_drive_gsub_alternate(). */
extern int OTF_drive_gsub (OTF *otf, OTF_GlyphString *gstring,
- char *script, char *language, char *features);
+ const char *script, const char *language,
+ const char *features);
/*** (3-5) OTF_drive_gpos() */
/***
Process glyph string by GPOS table.
- The OTF_drive_gdef() function looks up the GPOS table of $OTF of
+ The OTF_drive_gpos() function is deprecated. Use
+ OTF_drive_gpos2() instread. */
+
+extern int OTF_drive_gpos (OTF *otf, OTF_GlyphString *gstring,
+ const char *script, const char *language,
+ const char *features);
+
+/***
+ Process glyph string by GPOS table.
+
+ The OTF_drive_gpos2() function looks up the GPOS table of $OTF of
OpenType font $OTF, and by using features the font has for script
$SCRIPT and language system $LANGSYS, setup members
<positioning_type> and <f> of all glhphs in the glyph string
- $GSTRING. */
+ $GSTRING. $FEATURES is a list of features to apply. */
-extern int OTF_drive_gpos (OTF *otf, OTF_GlyphString *gstring,
- char *script, char *language, char *features);
+extern int OTF_drive_gpos2 (OTF *otf, OTF_GlyphString *gstring,
+ const char *script, const char *language,
+ const char *features);
/*** (3-6) OTF_drive_tables() */
order, and update the glyphs string GSTRING. */
extern int OTF_drive_tables (OTF *otf, OTF_GlyphString *gstring,
- char *script, char *language,
- char *gsub_features, char *gpos_features);
+ const char *script, const char *language,
+ const char *gsub_features,
+ const char *gpos_features);
-/*** (4) APIs for error handling ***/
+/*** (3-7) OTF_get_unicode() */
+
+/***
+ Return Unicode code point corresponding to the glyph-id CODE.
+ */
+
+extern int OTF_get_unicode (OTF *otf, OTF_GlyphID code);
+
+/*** (3-8) OTF_drive_gsub_alternate() */
+
+/***
+ Find alternate glyphs.
+
+ This is like OTF_drive_gsub(), but perform only a lookup of type 3
+ (Alternate Substituion). */
+
+extern int OTF_drive_gsub_alternate (OTF *otf, OTF_GlyphString *gstring,
+ const char *script, const char *language,
+ const char *features);
+
+/*** (4) API for error handling ***/
/*** (4-1) Error codes ***/
See the function OTF_drive_gpos() for more detail. */
#define OTF_ERROR_GPOS_DRIVE 7
+/***
+ FT_Face access error.
+
+ This error indicates that the library fails in accessing Sfnt
+ tables via FT_Face. */
+#define OTF_ERROR_FT_FACE 8
+
/*** (4-2) OTF_perror() */
The OTF_perror() function produces a message on the standard error
output, describing the last error encountered during a call to the
- OTF library function. If $PREFIX is not NULL, is is printed
+ OTF library function. If $PREFIX is not NULL, it is printed
first, followed by a colon and a blank. Then the message and a
newline. */
-extern void OTF_perror (char *prefix);
+extern void OTF_perror (const char *prefix);
-/*** (5) APIs miscellaneous ***/
+/*** (5) API miscellaneous ***/
/***
Return OTF tag of a specified name string.
NULL, return 0. Otherwise, $NAME must be at least 4-byte length.
Only the first 4 characters are took into an account. */
-extern OTF_Tag OTF_tag (char *name);
+extern OTF_Tag OTF_tag (const char *name);
/***
Convert OTF tag to name string.
- The OTF_tag_name() function converts OTF tag $TAG to a 5-byte
- name string (including the terminating NUL), and store it in
- $NAME. At least 5-byte space must be at $NAME. */
+ The OTF_tag_name() function converts OTF tag $TAG to a 5-byte name
+ string (including the terminating NULL), and store it in $NAME.
+ At least 5-byte space must be at $NAME. */
extern void OTF_tag_name (OTF_Tag tag, char *name);
+#ifdef __cplusplus
+}
+#endif
#endif /* not _OTF_H_ */