2 * Copyright © 2007,2008,2009 Red Hat, Inc.
3 * Copyright © 2010,2012 Google, Inc.
5 * This is part of HarfBuzz, a text shaping library.
7 * Permission is hereby granted, without written agreement and without
8 * license or royalty fees, to use, copy, modify, and distribute this
9 * software and its documentation for any purpose, provided that the
10 * above copyright notice and the following two paragraphs appear in
11 * all copies of this software.
13 * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
14 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
15 * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
16 * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
19 * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
20 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
21 * FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
22 * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
23 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
25 * Red Hat Author(s): Behdad Esfahbod
26 * Google Author(s): Behdad Esfahbod
29 #ifndef HB_OT_LAYOUT_COMMON_PRIVATE_HH
30 #define HB_OT_LAYOUT_COMMON_PRIVATE_HH
32 #include "hb-ot-layout-private.hh"
33 #include "hb-open-type-private.hh"
34 #include "hb-set-private.hh"
37 #ifndef HB_MAX_NESTING_LEVEL
38 #define HB_MAX_NESTING_LEVEL 6
40 #ifndef HB_MAX_CONTEXT_LENGTH
41 #define HB_MAX_CONTEXT_LENGTH 64
48 #define TRACE_DISPATCH(this, format) \
49 hb_auto_trace_t<context_t::max_debug_depth, typename context_t::return_t> trace \
50 (&c->debug_depth, c->get_name (), this, HB_FUNC, \
51 "format %d", (int) format);
54 #define NOT_COVERED ((unsigned int) -1)
60 * OpenType Layout Common Table Formats
66 * Script, ScriptList, LangSys, Feature, FeatureList, Lookup, LookupList
69 template <typename Type>
72 inline int cmp (hb_tag_t a) const {
76 struct sanitize_closure_t {
78 const void *list_base;
80 inline bool sanitize (hb_sanitize_context_t *c, const void *base) const
82 TRACE_SANITIZE (this);
83 const sanitize_closure_t closure = {tag, base};
84 return_trace (c->check_struct (this) && offset.sanitize (c, base, &closure));
87 Tag tag; /* 4-byte Tag identifier */
89 offset; /* Offset from beginning of object holding
92 DEFINE_SIZE_STATIC (6);
95 template <typename Type>
96 struct RecordArrayOf : SortedArrayOf<Record<Type> > {
97 inline const Tag& get_tag (unsigned int i) const
99 /* We cheat slightly and don't define separate Null objects
100 * for Record types. Instead, we return the correct Null(Tag)
102 if (unlikely (i >= this->len)) return Null(Tag);
103 return (*this)[i].tag;
105 inline unsigned int get_tags (unsigned int start_offset,
106 unsigned int *record_count /* IN/OUT */,
107 hb_tag_t *record_tags /* OUT */) const
110 const Record<Type> *arr = this->sub_array (start_offset, record_count);
111 unsigned int count = *record_count;
112 for (unsigned int i = 0; i < count; i++)
113 record_tags[i] = arr[i].tag;
117 inline bool find_index (hb_tag_t tag, unsigned int *index) const
119 /* If we want to allow non-sorted data, we can lsearch(). */
120 int i = this->/*lsearch*/bsearch (tag);
122 if (index) *index = i;
125 if (index) *index = Index::NOT_FOUND_INDEX;
131 template <typename Type>
132 struct RecordListOf : RecordArrayOf<Type>
134 inline const Type& operator [] (unsigned int i) const
135 { return this+RecordArrayOf<Type>::operator [](i).offset; }
137 inline bool sanitize (hb_sanitize_context_t *c) const
139 TRACE_SANITIZE (this);
140 return_trace (RecordArrayOf<Type>::sanitize (c, this));
147 inline int cmp (hb_codepoint_t g) const {
148 return g < start ? -1 : g <= end ? 0 : +1 ;
151 inline bool sanitize (hb_sanitize_context_t *c) const
153 TRACE_SANITIZE (this);
154 return_trace (c->check_struct (this));
157 inline bool intersects (const hb_set_t *glyphs) const {
158 return glyphs->intersects (start, end);
161 template <typename set_t>
162 inline void add_coverage (set_t *glyphs) const {
163 glyphs->add_range (start, end);
166 GlyphID start; /* First GlyphID in the range */
167 GlyphID end; /* Last GlyphID in the range */
168 USHORT value; /* Value */
170 DEFINE_SIZE_STATIC (6);
172 DEFINE_NULL_DATA (RangeRecord, "\000\001");
175 struct IndexArray : ArrayOf<Index>
177 inline unsigned int get_indexes (unsigned int start_offset,
178 unsigned int *_count /* IN/OUT */,
179 unsigned int *_indexes /* OUT */) const
182 const USHORT *arr = this->sub_array (start_offset, _count);
183 unsigned int count = *_count;
184 for (unsigned int i = 0; i < count; i++)
185 _indexes[i] = arr[i];
199 inline unsigned int get_feature_count (void) const
200 { return featureIndex.len; }
201 inline hb_tag_t get_feature_index (unsigned int i) const
202 { return featureIndex[i]; }
203 inline unsigned int get_feature_indexes (unsigned int start_offset,
204 unsigned int *feature_count /* IN/OUT */,
205 unsigned int *feature_indexes /* OUT */) const
206 { return featureIndex.get_indexes (start_offset, feature_count, feature_indexes); }
208 inline bool has_required_feature (void) const { return reqFeatureIndex != 0xFFFFu; }
209 inline unsigned int get_required_feature_index (void) const
211 if (reqFeatureIndex == 0xFFFFu)
212 return Index::NOT_FOUND_INDEX;
213 return reqFeatureIndex;;
216 inline bool sanitize (hb_sanitize_context_t *c,
217 const Record<LangSys>::sanitize_closure_t * = NULL) const
219 TRACE_SANITIZE (this);
220 return_trace (c->check_struct (this) && featureIndex.sanitize (c));
223 Offset<> lookupOrderZ; /* = Null (reserved for an offset to a
224 * reordering table) */
225 USHORT reqFeatureIndex;/* Index of a feature required for this
226 * language system--if no required features
228 IndexArray featureIndex; /* Array of indices into the FeatureList */
230 DEFINE_SIZE_ARRAY (6, featureIndex);
232 DEFINE_NULL_DATA (LangSys, "\0\0\xFF\xFF");
237 inline unsigned int get_lang_sys_count (void) const
238 { return langSys.len; }
239 inline const Tag& get_lang_sys_tag (unsigned int i) const
240 { return langSys.get_tag (i); }
241 inline unsigned int get_lang_sys_tags (unsigned int start_offset,
242 unsigned int *lang_sys_count /* IN/OUT */,
243 hb_tag_t *lang_sys_tags /* OUT */) const
244 { return langSys.get_tags (start_offset, lang_sys_count, lang_sys_tags); }
245 inline const LangSys& get_lang_sys (unsigned int i) const
247 if (i == Index::NOT_FOUND_INDEX) return get_default_lang_sys ();
248 return this+langSys[i].offset;
250 inline bool find_lang_sys_index (hb_tag_t tag, unsigned int *index) const
251 { return langSys.find_index (tag, index); }
253 inline bool has_default_lang_sys (void) const { return defaultLangSys != 0; }
254 inline const LangSys& get_default_lang_sys (void) const { return this+defaultLangSys; }
256 inline bool sanitize (hb_sanitize_context_t *c,
257 const Record<Script>::sanitize_closure_t * = NULL) const
259 TRACE_SANITIZE (this);
260 return_trace (defaultLangSys.sanitize (c, this) && langSys.sanitize (c, this));
265 defaultLangSys; /* Offset to DefaultLangSys table--from
266 * beginning of Script table--may be Null */
267 RecordArrayOf<LangSys>
268 langSys; /* Array of LangSysRecords--listed
269 * alphabetically by LangSysTag */
271 DEFINE_SIZE_ARRAY (4, langSys);
274 typedef RecordListOf<Script> ScriptList;
277 /* http://www.microsoft.com/typography/otspec/features_pt.htm#size */
278 struct FeatureParamsSize
280 inline bool sanitize (hb_sanitize_context_t *c) const
282 TRACE_SANITIZE (this);
283 if (unlikely (!c->check_struct (this))) return_trace (false);
285 /* This subtable has some "history", if you will. Some earlier versions of
286 * Adobe tools calculated the offset of the FeatureParams sutable from the
287 * beginning of the FeatureList table! Now, that is dealt with in the
288 * Feature implementation. But we still need to be able to tell junk from
289 * real data. Note: We don't check that the nameID actually exists.
291 * Read Roberts wrote on 9/15/06 on opentype-list@indx.co.uk :
293 * Yes, it is correct that a new version of the AFDKO (version 2.0) will be
294 * coming out soon, and that the makeotf program will build a font with a
295 * 'size' feature that is correct by the specification.
297 * The specification for this feature tag is in the "OpenType Layout Tag
298 * Registry". You can see a copy of this at:
299 * http://partners.adobe.com/public/developer/opentype/index_tag8.html#size
301 * Here is one set of rules to determine if the 'size' feature is built
302 * correctly, or as by the older versions of MakeOTF. You may be able to do
305 * Assume that the offset to the size feature is according to specification,
306 * and make the following value checks. If it fails, assume the the size
307 * feature is calculated as versions of MakeOTF before the AFDKO 2.0 built it.
308 * If this fails, reject the 'size' feature. The older makeOTF's calculated the
309 * offset from the beginning of the FeatureList table, rather than from the
310 * beginning of the 'size' Feature table.
312 * If "design size" == 0:
315 * Else if ("subfamily identifier" == 0 and
316 * "range start" == 0 and
317 * "range end" == 0 and
318 * "range start" == 0 and
319 * "menu name ID" == 0)
320 * passes check: this is the format used when there is a design size
321 * specified, but there is no recommended size range.
323 * Else if ("design size" < "range start" or
324 * "design size" > "range end" or
325 * "range end" <= "range start" or
326 * "menu name ID" < 256 or
327 * "menu name ID" > 32767 or
328 * menu name ID is not a name ID which is actually in the name table)
335 return_trace (false);
336 else if (subfamilyID == 0 &&
337 subfamilyNameID == 0 &&
341 else if (designSize < rangeStart ||
342 designSize > rangeEnd ||
343 subfamilyNameID < 256 ||
344 subfamilyNameID > 32767)
345 return_trace (false);
350 USHORT designSize; /* Represents the design size in 720/inch
351 * units (decipoints). The design size entry
352 * must be non-zero. When there is a design
353 * size but no recommended size range, the
354 * rest of the array will consist of zeros. */
355 USHORT subfamilyID; /* Has no independent meaning, but serves
356 * as an identifier that associates fonts
357 * in a subfamily. All fonts which share a
358 * Preferred or Font Family name and which
359 * differ only by size range shall have the
360 * same subfamily value, and no fonts which
361 * differ in weight or style shall have the
362 * same subfamily value. If this value is
363 * zero, the remaining fields in the array
364 * will be ignored. */
365 USHORT subfamilyNameID;/* If the preceding value is non-zero, this
366 * value must be set in the range 256 - 32767
367 * (inclusive). It records the value of a
368 * field in the name table, which must
369 * contain English-language strings encoded
370 * in Windows Unicode and Macintosh Roman,
371 * and may contain additional strings
372 * localized to other scripts and languages.
373 * Each of these strings is the name an
374 * application should use, in combination
375 * with the family name, to represent the
376 * subfamily in a menu. Applications will
377 * choose the appropriate version based on
378 * their selection criteria. */
379 USHORT rangeStart; /* Large end of the recommended usage range
380 * (inclusive), stored in 720/inch units
382 USHORT rangeEnd; /* Small end of the recommended usage range
383 (exclusive), stored in 720/inch units
386 DEFINE_SIZE_STATIC (10);
389 /* http://www.microsoft.com/typography/otspec/features_pt.htm#ssxx */
390 struct FeatureParamsStylisticSet
392 inline bool sanitize (hb_sanitize_context_t *c) const
394 TRACE_SANITIZE (this);
395 /* Right now minorVersion is at zero. Which means, any table supports
396 * the uiNameID field. */
397 return_trace (c->check_struct (this));
400 USHORT version; /* (set to 0): This corresponds to a “minor”
401 * version number. Additional data may be
402 * added to the end of this Feature Parameters
403 * table in the future. */
405 USHORT uiNameID; /* The 'name' table name ID that specifies a
406 * string (or strings, for multiple languages)
407 * for a user-interface label for this
408 * feature. The values of uiLabelNameId and
409 * sampleTextNameId are expected to be in the
410 * font-specific name ID range (256-32767),
411 * though that is not a requirement in this
412 * Feature Parameters specification. The
413 * user-interface label for the feature can
414 * be provided in multiple languages. An
415 * English string should be included as a
416 * fallback. The string should be kept to a
417 * minimal length to fit comfortably with
418 * different application interfaces. */
420 DEFINE_SIZE_STATIC (4);
423 /* http://www.microsoft.com/typography/otspec/features_ae.htm#cv01-cv99 */
424 struct FeatureParamsCharacterVariants
426 inline bool sanitize (hb_sanitize_context_t *c) const
428 TRACE_SANITIZE (this);
429 return_trace (c->check_struct (this) &&
430 characters.sanitize (c));
433 USHORT format; /* Format number is set to 0. */
434 USHORT featUILableNameID; /* The ‘name’ table name ID that
435 * specifies a string (or strings,
436 * for multiple languages) for a
437 * user-interface label for this
438 * feature. (May be NULL.) */
439 USHORT featUITooltipTextNameID;/* The ‘name’ table name ID that
440 * specifies a string (or strings,
441 * for multiple languages) that an
442 * application can use for tooltip
443 * text for this feature. (May be
445 USHORT sampleTextNameID; /* The ‘name’ table name ID that
446 * specifies sample text that
447 * illustrates the effect of this
448 * feature. (May be NULL.) */
449 USHORT numNamedParameters; /* Number of named parameters. (May
451 USHORT firstParamUILabelNameID;/* The first ‘name’ table name ID
452 * used to specify strings for
453 * user-interface labels for the
454 * feature parameters. (Must be zero
455 * if numParameters is zero.) */
457 characters; /* Array of the Unicode Scalar Value
458 * of the characters for which this
459 * feature provides glyph variants.
462 DEFINE_SIZE_ARRAY (14, characters);
467 inline bool sanitize (hb_sanitize_context_t *c, hb_tag_t tag) const
469 TRACE_SANITIZE (this);
470 if (tag == HB_TAG ('s','i','z','e'))
471 return_trace (u.size.sanitize (c));
472 if ((tag & 0xFFFF0000u) == HB_TAG ('s','s','\0','\0')) /* ssXX */
473 return_trace (u.stylisticSet.sanitize (c));
474 if ((tag & 0xFFFF0000u) == HB_TAG ('c','v','\0','\0')) /* cvXX */
475 return_trace (u.characterVariants.sanitize (c));
479 inline const FeatureParamsSize& get_size_params (hb_tag_t tag) const
481 if (tag == HB_TAG ('s','i','z','e'))
483 return Null(FeatureParamsSize);
488 FeatureParamsSize size;
489 FeatureParamsStylisticSet stylisticSet;
490 FeatureParamsCharacterVariants characterVariants;
492 DEFINE_SIZE_STATIC (17);
497 inline unsigned int get_lookup_count (void) const
498 { return lookupIndex.len; }
499 inline hb_tag_t get_lookup_index (unsigned int i) const
500 { return lookupIndex[i]; }
501 inline unsigned int get_lookup_indexes (unsigned int start_index,
502 unsigned int *lookup_count /* IN/OUT */,
503 unsigned int *lookup_tags /* OUT */) const
504 { return lookupIndex.get_indexes (start_index, lookup_count, lookup_tags); }
506 inline const FeatureParams &get_feature_params (void) const
507 { return this+featureParams; }
509 inline bool sanitize (hb_sanitize_context_t *c,
510 const Record<Feature>::sanitize_closure_t *closure) const
512 TRACE_SANITIZE (this);
513 if (unlikely (!(c->check_struct (this) && lookupIndex.sanitize (c))))
514 return_trace (false);
516 /* Some earlier versions of Adobe tools calculated the offset of the
517 * FeatureParams subtable from the beginning of the FeatureList table!
519 * If sanitizing "failed" for the FeatureParams subtable, try it with the
520 * alternative location. We would know sanitize "failed" if old value
521 * of the offset was non-zero, but it's zeroed now.
523 * Only do this for the 'size' feature, since at the time of the faulty
524 * Adobe tools, only the 'size' feature had FeatureParams defined.
527 OffsetTo<FeatureParams> orig_offset = featureParams;
528 if (unlikely (!featureParams.sanitize (c, this, closure ? closure->tag : HB_TAG_NONE)))
529 return_trace (false);
531 if (likely (orig_offset.is_null ()))
534 if (featureParams == 0 && closure &&
535 closure->tag == HB_TAG ('s','i','z','e') &&
536 closure->list_base && closure->list_base < this)
538 unsigned int new_offset_int = (unsigned int) orig_offset -
539 (((char *) this) - ((char *) closure->list_base));
541 OffsetTo<FeatureParams> new_offset;
542 /* Check that it did not overflow. */
543 new_offset.set (new_offset_int);
544 if (new_offset == new_offset_int &&
545 c->try_set (&featureParams, new_offset) &&
546 !featureParams.sanitize (c, this, closure ? closure->tag : HB_TAG_NONE))
547 return_trace (false);
549 if (c->edit_count > 1)
550 c->edit_count--; /* This was a "legitimate" edit; don't contribute to error count. */
556 OffsetTo<FeatureParams>
557 featureParams; /* Offset to Feature Parameters table (if one
558 * has been defined for the feature), relative
559 * to the beginning of the Feature Table; = Null
561 IndexArray lookupIndex; /* Array of LookupList indices */
563 DEFINE_SIZE_ARRAY (4, lookupIndex);
566 typedef RecordListOf<Feature> FeatureList;
569 struct LookupFlag : USHORT
572 RightToLeft = 0x0001u,
573 IgnoreBaseGlyphs = 0x0002u,
574 IgnoreLigatures = 0x0004u,
575 IgnoreMarks = 0x0008u,
576 IgnoreFlags = 0x000Eu,
577 UseMarkFilteringSet = 0x0010u,
579 MarkAttachmentType = 0xFF00u
582 DEFINE_SIZE_STATIC (2);
586 /* This has to be outside the namespace. */
587 HB_MARK_AS_FLAG_T (OT::LookupFlag::Flags);
592 inline unsigned int get_subtable_count (void) const { return subTable.len; }
594 template <typename SubTableType>
595 inline const SubTableType& get_subtable (unsigned int i) const
596 { return this+CastR<OffsetArrayOf<SubTableType> > (subTable)[i]; }
598 template <typename SubTableType>
599 inline const OffsetArrayOf<SubTableType>& get_subtables (void) const
600 { return CastR<OffsetArrayOf<SubTableType> > (subTable); }
601 template <typename SubTableType>
602 inline OffsetArrayOf<SubTableType>& get_subtables (void)
603 { return CastR<OffsetArrayOf<SubTableType> > (subTable); }
605 inline unsigned int get_type (void) const { return lookupType; }
607 /* lookup_props is a 32-bit integer where the lower 16-bit is LookupFlag and
608 * higher 16-bit is mark-filtering-set if the lookup uses one.
609 * Not to be confused with glyph_props which is very similar. */
610 inline uint32_t get_props (void) const
612 unsigned int flag = lookupFlag;
613 if (unlikely (flag & LookupFlag::UseMarkFilteringSet))
615 const USHORT &markFilteringSet = StructAfter<USHORT> (subTable);
616 flag += (markFilteringSet << 16);
621 template <typename SubTableType, typename context_t>
622 inline typename context_t::return_t dispatch (context_t *c) const
624 unsigned int lookup_type = get_type ();
625 TRACE_DISPATCH (this, lookup_type);
626 unsigned int count = get_subtable_count ();
627 for (unsigned int i = 0; i < count; i++) {
628 typename context_t::return_t r = get_subtable<SubTableType> (i).dispatch (c, lookup_type);
629 if (c->stop_sublookup_iteration (r))
632 return_trace (c->default_return_value ());
635 inline bool serialize (hb_serialize_context_t *c,
636 unsigned int lookup_type,
637 uint32_t lookup_props,
638 unsigned int num_subtables)
640 TRACE_SERIALIZE (this);
641 if (unlikely (!c->extend_min (*this))) return_trace (false);
642 lookupType.set (lookup_type);
643 lookupFlag.set (lookup_props & 0xFFFFu);
644 if (unlikely (!subTable.serialize (c, num_subtables))) return_trace (false);
645 if (lookupFlag & LookupFlag::UseMarkFilteringSet)
647 USHORT &markFilteringSet = StructAfter<USHORT> (subTable);
648 markFilteringSet.set (lookup_props >> 16);
653 inline bool sanitize (hb_sanitize_context_t *c) const
655 TRACE_SANITIZE (this);
656 /* Real sanitize of the subtables is done by GSUB/GPOS/... */
657 if (!(c->check_struct (this) && subTable.sanitize (c))) return_trace (false);
658 if (lookupFlag & LookupFlag::UseMarkFilteringSet)
660 const USHORT &markFilteringSet = StructAfter<USHORT> (subTable);
661 if (!markFilteringSet.sanitize (c)) return_trace (false);
667 USHORT lookupType; /* Different enumerations for GSUB and GPOS */
668 USHORT lookupFlag; /* Lookup qualifiers */
670 subTable; /* Array of SubTables */
671 USHORT markFilteringSetX[VAR]; /* Index (base 0) into GDEF mark glyph sets
672 * structure. This field is only present if bit
673 * UseMarkFilteringSet of lookup flags is set. */
675 DEFINE_SIZE_ARRAY2 (6, subTable, markFilteringSetX);
678 typedef OffsetListOf<Lookup> LookupList;
685 struct CoverageFormat1
687 friend struct Coverage;
690 inline unsigned int get_coverage (hb_codepoint_t glyph_id) const
692 int i = glyphArray.bsearch (glyph_id);
693 ASSERT_STATIC (((unsigned int) -1) == NOT_COVERED);
697 inline bool serialize (hb_serialize_context_t *c,
698 Supplier<GlyphID> &glyphs,
699 unsigned int num_glyphs)
701 TRACE_SERIALIZE (this);
702 if (unlikely (!c->extend_min (*this))) return_trace (false);
703 glyphArray.len.set (num_glyphs);
704 if (unlikely (!c->extend (glyphArray))) return_trace (false);
705 for (unsigned int i = 0; i < num_glyphs; i++)
706 glyphArray[i] = glyphs[i];
707 glyphs.advance (num_glyphs);
711 inline bool sanitize (hb_sanitize_context_t *c) const
713 TRACE_SANITIZE (this);
714 return_trace (glyphArray.sanitize (c));
717 inline bool intersects_coverage (const hb_set_t *glyphs, unsigned int index) const {
718 return glyphs->has (glyphArray[index]);
721 template <typename set_t>
722 inline void add_coverage (set_t *glyphs) const {
723 unsigned int count = glyphArray.len;
724 for (unsigned int i = 0; i < count; i++)
725 glyphs->add (glyphArray[i]);
729 /* Older compilers need this to be public. */
731 inline void init (const struct CoverageFormat1 &c_) { c = &c_; i = 0; };
732 inline bool more (void) { return i < c->glyphArray.len; }
733 inline void next (void) { i++; }
734 inline uint16_t get_glyph (void) { return c->glyphArray[i]; }
735 inline uint16_t get_coverage (void) { return i; }
738 const struct CoverageFormat1 *c;
744 USHORT coverageFormat; /* Format identifier--format = 1 */
745 SortedArrayOf<GlyphID>
746 glyphArray; /* Array of GlyphIDs--in numerical order */
748 DEFINE_SIZE_ARRAY (4, glyphArray);
751 struct CoverageFormat2
753 friend struct Coverage;
756 inline unsigned int get_coverage (hb_codepoint_t glyph_id) const
758 int i = rangeRecord.bsearch (glyph_id);
760 const RangeRecord &range = rangeRecord[i];
761 return (unsigned int) range.value + (glyph_id - range.start);
766 inline bool serialize (hb_serialize_context_t *c,
767 Supplier<GlyphID> &glyphs,
768 unsigned int num_glyphs)
770 TRACE_SERIALIZE (this);
771 if (unlikely (!c->extend_min (*this))) return_trace (false);
773 if (unlikely (!num_glyphs))
775 rangeRecord.len.set (0);
779 unsigned int num_ranges = 1;
780 for (unsigned int i = 1; i < num_glyphs; i++)
781 if (glyphs[i - 1] + 1 != glyphs[i])
783 rangeRecord.len.set (num_ranges);
784 if (unlikely (!c->extend (rangeRecord))) return_trace (false);
786 unsigned int range = 0;
787 rangeRecord[range].start = glyphs[0];
788 rangeRecord[range].value.set (0);
789 for (unsigned int i = 1; i < num_glyphs; i++)
790 if (glyphs[i - 1] + 1 != glyphs[i]) {
792 rangeRecord[range].start = glyphs[i];
793 rangeRecord[range].value.set (i);
794 rangeRecord[range].end = glyphs[i];
796 rangeRecord[range].end = glyphs[i];
798 glyphs.advance (num_glyphs);
802 inline bool sanitize (hb_sanitize_context_t *c) const
804 TRACE_SANITIZE (this);
805 return_trace (rangeRecord.sanitize (c));
808 inline bool intersects_coverage (const hb_set_t *glyphs, unsigned int index) const {
810 unsigned int count = rangeRecord.len;
811 for (i = 0; i < count; i++) {
812 const RangeRecord &range = rangeRecord[i];
813 if (range.value <= index &&
814 index < (unsigned int) range.value + (range.end - range.start) &&
815 range.intersects (glyphs))
817 else if (index < range.value)
823 template <typename set_t>
824 inline void add_coverage (set_t *glyphs) const {
825 unsigned int count = rangeRecord.len;
826 for (unsigned int i = 0; i < count; i++)
827 rangeRecord[i].add_coverage (glyphs);
831 /* Older compilers need this to be public. */
833 inline void init (const CoverageFormat2 &c_) {
837 j = c->rangeRecord.len ? c_.rangeRecord[0].start : 0;
839 inline bool more (void) { return i < c->rangeRecord.len; }
840 inline void next (void) {
842 if (j == c->rangeRecord[i].end) {
845 j = c->rangeRecord[i].start;
850 inline uint16_t get_glyph (void) { return j; }
851 inline uint16_t get_coverage (void) { return coverage; }
854 const struct CoverageFormat2 *c;
855 unsigned int i, j, coverage;
860 USHORT coverageFormat; /* Format identifier--format = 2 */
861 SortedArrayOf<RangeRecord>
862 rangeRecord; /* Array of glyph ranges--ordered by
863 * Start GlyphID. rangeCount entries
866 DEFINE_SIZE_ARRAY (4, rangeRecord);
871 inline unsigned int get_coverage (hb_codepoint_t glyph_id) const
874 case 1: return u.format1.get_coverage(glyph_id);
875 case 2: return u.format2.get_coverage(glyph_id);
876 default:return NOT_COVERED;
880 inline bool serialize (hb_serialize_context_t *c,
881 Supplier<GlyphID> &glyphs,
882 unsigned int num_glyphs)
884 TRACE_SERIALIZE (this);
885 if (unlikely (!c->extend_min (*this))) return_trace (false);
886 unsigned int num_ranges = 1;
887 for (unsigned int i = 1; i < num_glyphs; i++)
888 if (glyphs[i - 1] + 1 != glyphs[i])
890 u.format.set (num_glyphs * 2 < num_ranges * 3 ? 1 : 2);
892 case 1: return_trace (u.format1.serialize (c, glyphs, num_glyphs));
893 case 2: return_trace (u.format2.serialize (c, glyphs, num_glyphs));
894 default:return_trace (false);
898 inline bool sanitize (hb_sanitize_context_t *c) const
900 TRACE_SANITIZE (this);
901 if (!u.format.sanitize (c)) return_trace (false);
903 case 1: return_trace (u.format1.sanitize (c));
904 case 2: return_trace (u.format2.sanitize (c));
905 default:return_trace (true);
909 inline bool intersects (const hb_set_t *glyphs) const {
910 /* TODO speed this up */
912 for (iter.init (*this); iter.more (); iter.next ()) {
913 if (glyphs->has (iter.get_glyph ()))
919 inline bool intersects_coverage (const hb_set_t *glyphs, unsigned int index) const {
921 case 1: return u.format1.intersects_coverage (glyphs, index);
922 case 2: return u.format2.intersects_coverage (glyphs, index);
923 default:return false;
927 template <typename set_t>
928 inline void add_coverage (set_t *glyphs) const {
930 case 1: u.format1.add_coverage (glyphs); break;
931 case 2: u.format2.add_coverage (glyphs); break;
937 Iter (void) : format (0) {};
938 inline void init (const Coverage &c_) {
939 format = c_.u.format;
941 case 1: u.format1.init (c_.u.format1); return;
942 case 2: u.format2.init (c_.u.format2); return;
946 inline bool more (void) {
948 case 1: return u.format1.more ();
949 case 2: return u.format2.more ();
950 default:return false;
953 inline void next (void) {
955 case 1: u.format1.next (); break;
956 case 2: u.format2.next (); break;
960 inline uint16_t get_glyph (void) {
962 case 1: return u.format1.get_glyph ();
963 case 2: return u.format2.get_glyph ();
967 inline uint16_t get_coverage (void) {
969 case 1: return u.format1.get_coverage ();
970 case 2: return u.format2.get_coverage ();
978 CoverageFormat1::Iter format1;
979 CoverageFormat2::Iter format2;
985 USHORT format; /* Format identifier */
986 CoverageFormat1 format1;
987 CoverageFormat2 format2;
990 DEFINE_SIZE_UNION (2, format);
995 * Class Definition Table
998 struct ClassDefFormat1
1000 friend struct ClassDef;
1003 inline unsigned int get_class (hb_codepoint_t glyph_id) const
1005 unsigned int i = (unsigned int) (glyph_id - startGlyph);
1006 if (unlikely (i < classValue.len))
1007 return classValue[i];
1011 inline bool sanitize (hb_sanitize_context_t *c) const
1013 TRACE_SANITIZE (this);
1014 return_trace (c->check_struct (this) && classValue.sanitize (c));
1017 template <typename set_t>
1018 inline void add_class (set_t *glyphs, unsigned int klass) const {
1019 unsigned int count = classValue.len;
1020 for (unsigned int i = 0; i < count; i++)
1021 if (classValue[i] == klass)
1022 glyphs->add (startGlyph + i);
1025 inline bool intersects_class (const hb_set_t *glyphs, unsigned int klass) const {
1026 unsigned int count = classValue.len;
1029 /* Match if there's any glyph that is not listed! */
1030 hb_codepoint_t g = -1;
1031 if (!hb_set_next (glyphs, &g))
1035 g = startGlyph + count - 1;
1036 if (hb_set_next (glyphs, &g))
1040 for (unsigned int i = 0; i < count; i++)
1041 if (classValue[i] == klass && glyphs->has (startGlyph + i))
1047 USHORT classFormat; /* Format identifier--format = 1 */
1048 GlyphID startGlyph; /* First GlyphID of the classValueArray */
1050 classValue; /* Array of Class Values--one per GlyphID */
1052 DEFINE_SIZE_ARRAY (6, classValue);
1055 struct ClassDefFormat2
1057 friend struct ClassDef;
1060 inline unsigned int get_class (hb_codepoint_t glyph_id) const
1062 int i = rangeRecord.bsearch (glyph_id);
1063 if (unlikely (i != -1))
1064 return rangeRecord[i].value;
1068 inline bool sanitize (hb_sanitize_context_t *c) const
1070 TRACE_SANITIZE (this);
1071 return_trace (rangeRecord.sanitize (c));
1074 template <typename set_t>
1075 inline void add_class (set_t *glyphs, unsigned int klass) const {
1076 unsigned int count = rangeRecord.len;
1077 for (unsigned int i = 0; i < count; i++)
1078 if (rangeRecord[i].value == klass)
1079 rangeRecord[i].add_coverage (glyphs);
1082 inline bool intersects_class (const hb_set_t *glyphs, unsigned int klass) const {
1083 unsigned int count = rangeRecord.len;
1086 /* Match if there's any glyph that is not listed! */
1087 hb_codepoint_t g = (hb_codepoint_t) -1;
1088 for (unsigned int i = 0; i < count; i++)
1090 if (!hb_set_next (glyphs, &g))
1092 if (g < rangeRecord[i].start)
1094 g = rangeRecord[i].end;
1096 if (g != (hb_codepoint_t) -1 && hb_set_next (glyphs, &g))
1100 for (unsigned int i = 0; i < count; i++)
1101 if (rangeRecord[i].value == klass && rangeRecord[i].intersects (glyphs))
1107 USHORT classFormat; /* Format identifier--format = 2 */
1108 SortedArrayOf<RangeRecord>
1109 rangeRecord; /* Array of glyph ranges--ordered by
1112 DEFINE_SIZE_ARRAY (4, rangeRecord);
1117 inline unsigned int get_class (hb_codepoint_t glyph_id) const
1120 case 1: return u.format1.get_class(glyph_id);
1121 case 2: return u.format2.get_class(glyph_id);
1126 inline bool sanitize (hb_sanitize_context_t *c) const
1128 TRACE_SANITIZE (this);
1129 if (!u.format.sanitize (c)) return_trace (false);
1131 case 1: return_trace (u.format1.sanitize (c));
1132 case 2: return_trace (u.format2.sanitize (c));
1133 default:return_trace (true);
1137 inline void add_class (hb_set_t *glyphs, unsigned int klass) const {
1139 case 1: u.format1.add_class (glyphs, klass); return;
1140 case 2: u.format2.add_class (glyphs, klass); return;
1145 inline bool intersects_class (const hb_set_t *glyphs, unsigned int klass) const {
1147 case 1: return u.format1.intersects_class (glyphs, klass);
1148 case 2: return u.format2.intersects_class (glyphs, klass);
1149 default:return false;
1155 USHORT format; /* Format identifier */
1156 ClassDefFormat1 format1;
1157 ClassDefFormat2 format2;
1160 DEFINE_SIZE_UNION (2, format);
1171 inline hb_position_t get_x_delta (hb_font_t *font) const
1172 { return get_delta (font->x_ppem, font->x_scale); }
1174 inline hb_position_t get_y_delta (hb_font_t *font) const
1175 { return get_delta (font->y_ppem, font->y_scale); }
1177 inline unsigned int get_size (void) const
1179 unsigned int f = deltaFormat;
1180 if (unlikely (f < 1 || f > 3 || startSize > endSize)) return 3 * USHORT::static_size;
1181 return USHORT::static_size * (4 + ((endSize - startSize) >> (4 - f)));
1184 inline bool sanitize (hb_sanitize_context_t *c) const
1186 TRACE_SANITIZE (this);
1187 return_trace (c->check_struct (this) && c->check_range (this, this->get_size ()));
1192 inline int get_delta (unsigned int ppem, int scale) const
1194 if (!ppem) return 0;
1196 int pixels = get_delta_pixels (ppem);
1198 if (!pixels) return 0;
1200 return (int) (pixels * (int64_t) scale / ppem);
1202 inline int get_delta_pixels (unsigned int ppem_size) const
1204 unsigned int f = deltaFormat;
1205 if (unlikely (f < 1 || f > 3))
1208 if (ppem_size < startSize || ppem_size > endSize)
1211 unsigned int s = ppem_size - startSize;
1213 unsigned int byte = deltaValue[s >> (4 - f)];
1214 unsigned int bits = (byte >> (16 - (((s & ((1 << (4 - f)) - 1)) + 1) << f)));
1215 unsigned int mask = (0xFFFFu >> (16 - (1 << f)));
1217 int delta = bits & mask;
1219 if ((unsigned int) delta >= ((mask + 1) >> 1))
1226 USHORT startSize; /* Smallest size to correct--in ppem */
1227 USHORT endSize; /* Largest size to correct--in ppem */
1228 USHORT deltaFormat; /* Format of DeltaValue array data: 1, 2, or 3
1229 * 1 Signed 2-bit value, 8 values per uint16
1230 * 2 Signed 4-bit value, 4 values per uint16
1231 * 3 Signed 8-bit value, 2 values per uint16
1233 USHORT deltaValue[VAR]; /* Array of compressed data */
1235 DEFINE_SIZE_ARRAY (6, deltaValue);
1239 } /* namespace OT */
1242 #endif /* HB_OT_LAYOUT_COMMON_PRIVATE_HH */