Coverage Report

Created: 2026-03-31 11:00

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/work/workdir/UnpackedTarball/harfbuzz/src/hb-ot-var-gvar-table.hh
Line
Count
Source
1
/*
2
 * Copyright © 2019  Adobe Inc.
3
 * Copyright © 2019  Ebrahim Byagowi
4
 *
5
 *  This is part of HarfBuzz, a text shaping library.
6
 *
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.
12
 *
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
17
 * DAMAGE.
18
 *
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.
24
 *
25
 * Adobe Author(s): Michiharu Ariza
26
 */
27
28
#ifndef HB_OT_VAR_GVAR_TABLE_HH
29
#define HB_OT_VAR_GVAR_TABLE_HH
30
31
#include "hb-decycler.hh"
32
#include "hb-open-type.hh"
33
#include "hb-ot-var-common.hh"
34
35
/*
36
 * gvar -- Glyph Variation Table
37
 * https://docs.microsoft.com/en-us/typography/opentype/spec/gvar
38
 */
39
#define HB_OT_TAG_gvar HB_TAG('g','v','a','r')
40
#define HB_OT_TAG_GVAR HB_TAG('G','V','A','R')
41
42
struct hb_glyf_scratch_t
43
{
44
  // glyf
45
  contour_point_vector_t all_points;
46
  contour_point_vector_t comp_points;
47
  hb_decycler_t decycler;
48
49
  // gvar
50
  contour_point_vector_t orig_points;
51
  hb_vector_t<int> x_deltas;
52
  hb_vector_t<int> y_deltas;
53
  contour_point_vector_t deltas;
54
  hb_vector_t<unsigned int> shared_indices;
55
  hb_vector_t<unsigned int> private_indices;
56
};
57
58
namespace OT {
59
60
template <typename OffsetType>
61
struct glyph_variations_t
62
{
63
  // TODO: Move tuple_variations_t to outside of TupleVariationData
64
  using tuple_variations_t = typename TupleVariationData<OffsetType>::tuple_variations_t;
65
  using GlyphVariationData = TupleVariationData<OffsetType>;
66
67
  hb_vector_t<tuple_variations_t> glyph_variations;
68
69
  hb_vector_t<F2DOT14> compiled_shared_tuples;
70
  private:
71
  unsigned shared_tuples_count = 0;
72
73
  /* shared coords-> index map after instantiation */
74
  hb_hashmap_t<const hb_vector_t<F2DOT14>*, unsigned> shared_tuples_idx_map;
75
76
  hb_alloc_pool_t pool;
77
78
  public:
79
  unsigned compiled_shared_tuples_count () const
80
0
  { return shared_tuples_count; }
81
82
  unsigned compiled_byte_size () const
83
0
  {
84
0
    unsigned byte_size = 0;
85
0
    for (const auto& _ : glyph_variations)
86
0
      byte_size += _.get_compiled_byte_size ();
87
88
0
    return byte_size;
89
0
  }
90
91
  bool create_from_glyphs_var_data (unsigned axis_count,
92
                                    const hb_array_t<const F2DOT14> shared_tuples,
93
                                    const hb_subset_plan_t *plan,
94
                                    const hb_hashmap_t<hb_codepoint_t, hb_bytes_t>& new_gid_var_data_map)
95
0
  {
96
0
    if (unlikely (!glyph_variations.alloc_exact (plan->new_to_old_gid_list.length)))
97
0
      return false;
98
99
0
    auto it = hb_iter (plan->new_to_old_gid_list);
100
0
    for (auto &_ : it)
101
0
    {
102
0
      hb_codepoint_t new_gid = _.first;
103
0
      contour_point_vector_t *all_contour_points;
104
0
      if (!new_gid_var_data_map.has (new_gid) ||
105
0
          !plan->new_gid_contour_points_map.has (new_gid, &all_contour_points))
106
0
        return false;
107
0
      hb_bytes_t var_data = new_gid_var_data_map.get (new_gid);
108
109
0
      const GlyphVariationData* p = reinterpret_cast<const GlyphVariationData*> (var_data.arrayZ);
110
0
      typename GlyphVariationData::tuple_iterator_t iterator;
111
0
      tuple_variations_t tuple_vars;
112
113
0
      hb_vector_t<unsigned> shared_indices;
114
115
      /* in case variation data is empty, push an empty struct into the vector,
116
       * keep the vector in sync with the new_to_old_gid_list */
117
0
      if (!var_data || ! p->has_data () || !all_contour_points->length ||
118
0
          !GlyphVariationData::get_tuple_iterator (var_data, axis_count,
119
0
                                                   var_data.arrayZ,
120
0
                                                   shared_indices, &iterator))
121
0
      {
122
0
        glyph_variations.push (std::move (tuple_vars));
123
0
        continue;
124
0
      }
125
126
0
      bool is_composite_glyph = false;
127
0
      is_composite_glyph = plan->composite_new_gids.has (new_gid);
128
129
0
      if (!p->decompile_tuple_variations (all_contour_points->length, true /* is_gvar */,
130
0
                                          iterator, &(plan->axes_old_index_tag_map),
131
0
                                          shared_indices, shared_tuples,
132
0
                                          tuple_vars, /* OUT */
133
0
            &pool,
134
0
                                          is_composite_glyph))
135
0
        return false;
136
0
      glyph_variations.push (std::move (tuple_vars));
137
0
    }
138
0
    return !glyph_variations.in_error () && glyph_variations.length == plan->new_to_old_gid_list.length;
139
0
  }
140
141
  bool instantiate (const hb_subset_plan_t *plan)
142
0
  {
143
0
    unsigned count = plan->new_to_old_gid_list.length;
144
0
    bool iup_optimize = false;
145
0
    optimize_scratch_t scratch;
146
0
    iup_optimize = plan->flags & HB_SUBSET_FLAGS_OPTIMIZE_IUP_DELTAS;
147
0
    for (unsigned i = 0; i < count; i++)
148
0
    {
149
0
      hb_codepoint_t new_gid = plan->new_to_old_gid_list[i].first;
150
0
      contour_point_vector_t *all_points;
151
0
      if (!plan->new_gid_contour_points_map.has (new_gid, &all_points))
152
0
        return false;
153
0
      if (!glyph_variations[i].instantiate (plan->axes_location, plan->axes_triple_distances, scratch, &pool, all_points, iup_optimize))
154
0
        return false;
155
0
    }
156
0
    return true;
157
0
  }
158
159
  bool compile_bytes (const hb_map_t& axes_index_map,
160
                      const hb_map_t& axes_old_index_tag_map)
161
0
  {
162
0
    if (!compile_shared_tuples (axes_index_map, axes_old_index_tag_map))
163
0
      return false;
164
0
    for (tuple_variations_t& vars: glyph_variations)
165
0
      if (!vars.compile_bytes (axes_index_map, axes_old_index_tag_map,
166
0
                               true, /* use shared points*/
167
0
                               true,
168
0
                               &shared_tuples_idx_map,
169
0
             &pool))
170
0
        return false;
171
172
0
    return true;
173
0
  }
174
175
  bool compile_shared_tuples (const hb_map_t& axes_index_map,
176
                              const hb_map_t& axes_old_index_tag_map)
177
0
  {
178
    /* key is pointer to compiled_peak_coords inside each tuple, hashing
179
     * function will always deref pointers first */
180
0
    hb_hashmap_t<const hb_vector_t<F2DOT14>*, unsigned> coords_count_map;
181
182
    /* count the num of shared coords */
183
0
    for (tuple_variations_t& vars: glyph_variations)
184
0
    {
185
0
      for (tuple_delta_t& var : vars.tuple_vars)
186
0
      {
187
0
        if (!var.compile_coords (axes_index_map, axes_old_index_tag_map, &pool))
188
0
          return false;
189
0
        unsigned *count;
190
0
  unsigned hash = hb_hash (&var.compiled_peak_coords);
191
0
        if (coords_count_map.has_with_hash (&(var.compiled_peak_coords), hash, &count))
192
0
    (*count)++;
193
0
        else
194
0
          coords_count_map.set_with_hash (&(var.compiled_peak_coords), hash, 1);
195
0
      }
196
0
    }
197
198
0
    if (!coords_count_map || coords_count_map.in_error ())
199
0
      return false;
200
201
    /* add only those coords that are used more than once into the vector and sort */
202
0
    hb_vector_t<hb_pair_t<const hb_vector_t<F2DOT14>*, unsigned>> shared_coords {
203
0
      + hb_iter (coords_count_map)
204
0
      | hb_filter ([] (const hb_pair_t<const hb_vector_t<F2DOT14>*, unsigned>& p) { return p.second > 1; })
205
0
    };
206
0
    if (unlikely (shared_coords.in_error ())) return false;
207
208
    /* no shared tuples: no coords are used more than once */
209
0
    if (!shared_coords) return true;
210
    /* sorting based on the coords frequency first (high to low), then compare
211
     * the coords bytes */
212
0
    shared_coords.qsort (_cmp_coords);
213
214
    /* build shared_coords->idx map and shared tuples byte array */
215
216
0
    shared_tuples_count = hb_min (0xFFFu + 1, shared_coords.length);
217
0
    unsigned len = shared_tuples_count * (shared_coords[0].first->length);
218
0
    if (unlikely (!compiled_shared_tuples.alloc (len)))
219
0
      return false;
220
221
0
    for (unsigned i = 0; i < shared_tuples_count; i++)
222
0
    {
223
0
      shared_tuples_idx_map.set (shared_coords[i].first, i);
224
      /* add a concat() in hb_vector_t? */
225
0
      for (auto c : shared_coords[i].first->iter ())
226
0
        compiled_shared_tuples.push (c);
227
0
    }
228
229
0
    return true;
230
0
  }
231
232
  static int _cmp_coords (const void *pa, const void *pb)
233
0
  {
234
0
    const hb_pair_t<hb_vector_t<F2DOT14> *, unsigned> *a = (const hb_pair_t<hb_vector_t<F2DOT14> *, unsigned> *) pa;
235
0
    const hb_pair_t<hb_vector_t<F2DOT14> *, unsigned> *b = (const hb_pair_t<hb_vector_t<F2DOT14> *, unsigned> *) pb;
236
237
0
    if (a->second != b->second)
238
0
      return b->second - a->second; // high to low
239
240
0
    return b->first->as_array().cmp (a->first->as_array ());
241
0
  }
242
243
  template<typename Iterator,
244
           hb_requires (hb_is_iterator (Iterator))>
245
  bool serialize_glyph_var_data (hb_serialize_context_t *c,
246
                                 Iterator it,
247
                                 bool long_offset,
248
                                 unsigned num_glyphs,
249
                                 char* glyph_var_data_offsets /* OUT: glyph var data offsets array */) const
250
0
  {
251
0
    TRACE_SERIALIZE (this);
252
253
0
    if (long_offset)
254
0
    {
255
0
      ((HBUINT32 *) glyph_var_data_offsets)[0] = 0;
256
0
      glyph_var_data_offsets += 4;
257
0
    }
258
0
    else
259
0
    {
260
0
      ((HBUINT16 *) glyph_var_data_offsets)[0] = 0;
261
0
      glyph_var_data_offsets += 2;
262
0
    }
263
0
    unsigned glyph_offset = 0;
264
0
    hb_codepoint_t last_gid = 0;
265
0
    unsigned idx = 0;
266
267
0
    GlyphVariationData* cur_glyph = c->start_embed<GlyphVariationData> ();
268
0
    if (!cur_glyph) return_trace (false);
269
0
    for (auto &_ : it)
270
0
    {
271
0
      hb_codepoint_t gid = _.first;
272
0
      if (long_offset)
273
0
        for (; last_gid < gid; last_gid++)
274
0
          ((HBUINT32 *) glyph_var_data_offsets)[last_gid] = glyph_offset;
275
0
      else
276
0
        for (; last_gid < gid; last_gid++)
277
0
          ((HBUINT16 *) glyph_var_data_offsets)[last_gid] = glyph_offset / 2;
278
279
0
      if (idx >= glyph_variations.length) return_trace (false);
280
0
      if (!cur_glyph->serialize (c, true, glyph_variations[idx])) return_trace (false);
281
0
      GlyphVariationData* next_glyph = c->start_embed<GlyphVariationData> ();
282
0
      glyph_offset += (char *) next_glyph - (char *) cur_glyph;
283
284
0
      if (long_offset)
285
0
        ((HBUINT32 *) glyph_var_data_offsets)[gid] = glyph_offset;
286
0
      else
287
0
        ((HBUINT16 *) glyph_var_data_offsets)[gid] = glyph_offset / 2;
288
289
0
      last_gid++;
290
0
      idx++;
291
0
      cur_glyph = next_glyph;
292
0
    }
293
294
0
    if (long_offset)
295
0
      for (; last_gid < num_glyphs; last_gid++)
296
0
        ((HBUINT32 *) glyph_var_data_offsets)[last_gid] = glyph_offset;
297
0
    else
298
0
      for (; last_gid < num_glyphs; last_gid++)
299
0
        ((HBUINT16 *) glyph_var_data_offsets)[last_gid] = glyph_offset / 2;
300
0
    return_trace (true);
301
0
  }
302
};
303
304
template <typename GidOffsetType, unsigned TableTag>
305
struct gvar_GVAR
306
{
307
  static constexpr hb_tag_t tableTag = TableTag;
308
309
  using GlyphVariationData = TupleVariationData<GidOffsetType>;
310
311
0
  bool has_data () const { return version.to_int () != 0; }
312
313
  bool sanitize_shallow (hb_sanitize_context_t *c) const
314
0
  {
315
0
    TRACE_SANITIZE (this);
316
0
    return_trace (c->check_struct (this) &&
317
0
      hb_barrier () &&
318
0
      (version.major == 1) &&
319
0
      sharedTuples.sanitize (c, this, axisCount * sharedTupleCount) &&
320
0
      (is_long_offset () ?
321
0
         c->check_array (get_long_offset_array (), c->get_num_glyphs () + 1) :
322
0
         c->check_array (get_short_offset_array (), c->get_num_glyphs () + 1)));
323
0
  }
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned short, 2u>, 1735811442u>::sanitize_shallow(hb_sanitize_context_t*) const
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned int, 3u>, 1196835154u>::sanitize_shallow(hb_sanitize_context_t*) const
324
325
  /* GlyphVariationData not sanitized here; must be checked while accessing each glyph variation data */
326
  bool sanitize (hb_sanitize_context_t *c) const
327
0
  { return sanitize_shallow (c); }
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned short, 2u>, 1735811442u>::sanitize(hb_sanitize_context_t*) const
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned int, 3u>, 1196835154u>::sanitize(hb_sanitize_context_t*) const
328
329
  bool decompile_glyph_variations (hb_subset_context_t *c,
330
                                   glyph_variations_t<GidOffsetType>& glyph_vars /* OUT */) const
331
0
  {
332
0
    hb_hashmap_t<hb_codepoint_t, hb_bytes_t> new_gid_var_data_map;
333
0
    auto it = hb_iter (c->plan->new_to_old_gid_list);
334
0
    if (it->first == 0 && !(c->plan->flags & HB_SUBSET_FLAGS_NOTDEF_OUTLINE))
335
0
    {
336
0
      new_gid_var_data_map.set (0, hb_bytes_t ());
337
0
      it++;
338
0
    }
339
340
0
    for (auto &_ : it)
341
0
    {
342
0
      hb_codepoint_t new_gid = _.first;
343
0
      hb_codepoint_t old_gid = _.second;
344
0
      hb_bytes_t var_data_bytes = get_glyph_var_data_bytes (c->source_blob, glyphCountX, old_gid);
345
0
      new_gid_var_data_map.set (new_gid, var_data_bytes);
346
0
    }
347
348
0
    if (new_gid_var_data_map.in_error ()) return false;
349
350
0
    hb_array_t<const F2DOT14> shared_tuples = (this+sharedTuples).as_array ((unsigned) sharedTupleCount * (unsigned) axisCount);
351
0
    return glyph_vars.create_from_glyphs_var_data (axisCount, shared_tuples, c->plan, new_gid_var_data_map);
352
0
  }
353
354
  template<typename Iterator,
355
           hb_requires (hb_is_iterator (Iterator))>
356
  bool serialize (hb_serialize_context_t *c,
357
                  const glyph_variations_t<GidOffsetType>& glyph_vars,
358
                  Iterator it,
359
                  unsigned axis_count,
360
                  unsigned num_glyphs,
361
                  bool force_long_offsets) const
362
0
  {
363
0
    TRACE_SERIALIZE (this);
364
0
    gvar_GVAR *out = c->allocate_min<gvar_GVAR> ();
365
0
    if (unlikely (!out)) return_trace (false);
366
367
0
    out->version.major = 1;
368
0
    out->version.minor = 0;
369
0
    out->axisCount = axis_count;
370
0
    out->glyphCountX = hb_min (0xFFFFu, num_glyphs);
371
372
0
    unsigned glyph_var_data_size = glyph_vars.compiled_byte_size ();
373
    /* According to the spec: If the short format (Offset16) is used for offsets,
374
     * the value stored is the offset divided by 2, so the maximum data size should
375
     * be 2 * 0xFFFFu, which is 0x1FFFEu */
376
0
    bool long_offset = glyph_var_data_size > 0x1FFFEu || force_long_offsets;
377
0
    out->flags = long_offset ? 1 : 0;
378
379
0
    HBUINT8 *glyph_var_data_offsets = c->allocate_size<HBUINT8> ((long_offset ? 4 : 2) * (num_glyphs + 1), false);
380
0
    if (!glyph_var_data_offsets) return_trace (false);
381
382
    /* shared tuples */
383
0
    unsigned shared_tuple_count = glyph_vars.compiled_shared_tuples_count ();
384
0
    out->sharedTupleCount = shared_tuple_count;
385
386
0
    if (!shared_tuple_count)
387
0
      out->sharedTuples = 0;
388
0
    else
389
0
    {
390
0
      hb_array_t<const F2DOT14> shared_tuples = glyph_vars.compiled_shared_tuples.as_array ().copy (c);
391
0
      if (!shared_tuples.arrayZ) return_trace (false);
392
0
      out->sharedTuples = (const char *) shared_tuples.arrayZ - (char *) out;
393
0
    }
394
395
0
    char *glyph_var_data = c->start_embed<char> ();
396
0
    if (!glyph_var_data) return_trace (false);
397
0
    out->dataZ = glyph_var_data - (char *) out;
398
399
0
    return_trace (glyph_vars.serialize_glyph_var_data (c, it, long_offset, num_glyphs,
400
0
                                                       (char *) glyph_var_data_offsets));
401
0
  }
402
403
  bool instantiate (hb_subset_context_t *c) const
404
0
  {
405
0
    TRACE_SUBSET (this);
406
0
    glyph_variations_t<GidOffsetType> glyph_vars;
407
0
    if (!decompile_glyph_variations (c, glyph_vars))
408
0
      return_trace (false);
409
410
0
    if (!glyph_vars.instantiate (c->plan)) return_trace (false);
411
0
    if (!glyph_vars.compile_bytes (c->plan->axes_index_map, c->plan->axes_old_index_tag_map))
412
0
      return_trace (false);
413
414
0
    unsigned axis_count = c->plan->axes_index_map.get_population ();
415
0
    unsigned num_glyphs = c->plan->num_output_glyphs ();
416
0
    auto it = hb_iter (c->plan->new_to_old_gid_list);
417
418
0
    bool force_long_offsets = false;
419
#ifdef HB_EXPERIMENTAL_API
420
    force_long_offsets = c->plan->flags & HB_SUBSET_FLAGS_IFTB_REQUIREMENTS;
421
#endif
422
0
    return_trace (serialize (c->serializer, glyph_vars, it, axis_count, num_glyphs, force_long_offsets));
423
0
  }
424
425
  bool subset (hb_subset_context_t *c) const
426
0
  {
427
0
    TRACE_SUBSET (this);
428
0
    if (c->plan->all_axes_pinned)
429
0
      return_trace (false);
430
431
0
    if (c->plan->normalized_coords)
432
0
      return_trace (instantiate (c));
433
434
0
    unsigned glyph_count = version.to_int () ? c->plan->source->get_num_glyphs () : 0;
435
436
0
    gvar_GVAR *out = c->serializer->allocate_min<gvar_GVAR> ();
437
0
    if (unlikely (!out)) return_trace (false);
438
439
0
    out->version.major = 1;
440
0
    out->version.minor = 0;
441
0
    out->axisCount = axisCount;
442
0
    out->sharedTupleCount = sharedTupleCount;
443
444
0
    unsigned int num_glyphs = c->plan->num_output_glyphs ();
445
0
    out->glyphCountX = hb_min (0xFFFFu, num_glyphs);
446
447
0
    auto it = hb_iter (c->plan->new_to_old_gid_list);
448
0
    if (it->first == 0 && !(c->plan->flags & HB_SUBSET_FLAGS_NOTDEF_OUTLINE))
449
0
      it++;
450
0
    unsigned int subset_data_size = 0;
451
0
    unsigned padding_size = 0;
452
0
    for (auto &_ : it)
453
0
    {
454
0
      hb_codepoint_t old_gid = _.second;
455
0
      unsigned glyph_data_size = get_glyph_var_data_bytes (c->source_blob, glyph_count, old_gid).length;
456
0
      if (glyph_data_size % 2)
457
0
      {
458
0
        glyph_data_size++;
459
0
        padding_size++;
460
0
      }
461
462
0
      subset_data_size += glyph_data_size;
463
0
    }
464
465
    /* According to the spec: If the short format (Offset16) is used for offsets,
466
     * the value stored is the offset divided by 2, so the maximum data size should
467
     * be 2 * 0xFFFFu, which is 0x1FFFEu */
468
0
    bool long_offset = subset_data_size > 0x1FFFEu;
469
#ifdef HB_EXPERIMENTAL_API
470
    long_offset = long_offset || (c->plan->flags & HB_SUBSET_FLAGS_IFTB_REQUIREMENTS);
471
#endif
472
0
    out->flags = long_offset ? 1 : 0;
473
474
0
    HBUINT8 *subset_offsets = c->serializer->allocate_size<HBUINT8> ((long_offset ? 4 : 2) * (num_glyphs + 1), false);
475
0
    if (!subset_offsets) return_trace (false);
476
477
    /* shared tuples */
478
0
    if (!sharedTupleCount || !sharedTuples)
479
0
      out->sharedTuples = 0;
480
0
    else
481
0
    {
482
0
      unsigned int shared_tuple_size = F2DOT14::static_size * axisCount * sharedTupleCount;
483
0
      F2DOT14 *tuples = c->serializer->allocate_size<F2DOT14> (shared_tuple_size);
484
0
      if (!tuples) return_trace (false);
485
0
      out->sharedTuples = (char *) tuples - (char *) out;
486
0
      hb_memcpy (tuples, this+sharedTuples, shared_tuple_size);
487
0
    }
488
489
    /* This ordering relative to the shared tuples array, which puts the glyphVariationData
490
       last in the table, is required when HB_SUBSET_FLAGS_IFTB_REQUIREMENTS is set */
491
0
    if (long_offset)
492
0
      subset_data_size -= padding_size;
493
0
    char *subset_data = c->serializer->allocate_size<char> (subset_data_size, false);
494
0
    if (!subset_data) return_trace (false);
495
0
    out->dataZ = subset_data - (char *) out;
496
497
498
0
    if (long_offset)
499
0
    {
500
0
      ((HBUINT32 *) subset_offsets)[0] = 0;
501
0
      subset_offsets += 4;
502
0
    }
503
0
    else
504
0
    {
505
0
      ((HBUINT16 *) subset_offsets)[0] = 0;
506
0
      subset_offsets += 2;
507
0
    }
508
0
    unsigned int glyph_offset = 0;
509
510
0
    hb_codepoint_t last = 0;
511
0
    it = hb_iter (c->plan->new_to_old_gid_list);
512
0
    if (it->first == 0 && !(c->plan->flags & HB_SUBSET_FLAGS_NOTDEF_OUTLINE))
513
0
      it++;
514
0
    for (auto &_ : it)
515
0
    {
516
0
      hb_codepoint_t gid = _.first;
517
0
      hb_codepoint_t old_gid = _.second;
518
519
0
      if (long_offset)
520
0
  for (; last < gid; last++)
521
0
    ((HBUINT32 *) subset_offsets)[last] = glyph_offset;
522
0
      else
523
0
  for (; last < gid; last++)
524
0
    ((HBUINT16 *) subset_offsets)[last] = glyph_offset / 2;
525
526
0
      hb_bytes_t var_data_bytes = get_glyph_var_data_bytes (c->source_blob,
527
0
                  glyph_count,
528
0
                  old_gid);
529
530
0
      hb_memcpy (subset_data, var_data_bytes.arrayZ, var_data_bytes.length);
531
0
      unsigned glyph_data_size = var_data_bytes.length;
532
0
      subset_data += glyph_data_size;
533
0
      glyph_offset += glyph_data_size;
534
535
0
      if (!long_offset && (glyph_data_size % 2))
536
0
      {
537
0
        *subset_data = 0;
538
0
        subset_data++;
539
0
        glyph_offset++;
540
0
      }
541
542
0
      if (long_offset)
543
0
  ((HBUINT32 *) subset_offsets)[gid] = glyph_offset;
544
0
      else
545
0
  ((HBUINT16 *) subset_offsets)[gid] = glyph_offset / 2;
546
547
0
      last++; // Skip over gid
548
0
    }
549
550
0
    if (long_offset)
551
0
      for (; last < num_glyphs; last++)
552
0
  ((HBUINT32 *) subset_offsets)[last] = glyph_offset;
553
0
    else
554
0
      for (; last < num_glyphs; last++)
555
0
  ((HBUINT16 *) subset_offsets)[last] = glyph_offset / 2;
556
557
0
    return_trace (true);
558
0
  }
559
560
  protected:
561
  const hb_bytes_t get_glyph_var_data_bytes (hb_blob_t *blob,
562
               unsigned glyph_count,
563
               hb_codepoint_t glyph) const
564
0
  {
565
0
    unsigned start_offset = get_offset (glyph_count, glyph);
566
0
    unsigned end_offset = get_offset (glyph_count, glyph+1);
567
0
    if (unlikely (end_offset < start_offset)) return hb_bytes_t ();
568
0
    unsigned length = end_offset - start_offset;
569
0
    hb_bytes_t var_data = blob->as_bytes ().sub_array (((unsigned) dataZ) + start_offset, length);
570
0
    return likely (var_data.length >= GlyphVariationData::min_size) ? var_data : hb_bytes_t ();
571
0
  }
572
573
0
  bool is_long_offset () const { return flags & 1; }
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned short, 2u>, 1735811442u>::is_long_offset() const
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned int, 3u>, 1196835154u>::is_long_offset() const
574
575
  unsigned get_offset (unsigned glyph_count, unsigned i) const
576
0
  {
577
0
    if (unlikely (i > glyph_count)) return 0;
578
0
    hb_barrier ();
579
0
    return is_long_offset () ? get_long_offset_array ()[i] : get_short_offset_array ()[i] * 2;
580
0
  }
581
582
0
  const HBUINT32 * get_long_offset_array () const { return (const HBUINT32 *) &offsetZ; }
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned short, 2u>, 1735811442u>::get_long_offset_array() const
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned int, 3u>, 1196835154u>::get_long_offset_array() const
583
0
  const HBUINT16 *get_short_offset_array () const { return (const HBUINT16 *) &offsetZ; }
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned short, 2u>, 1735811442u>::get_short_offset_array() const
Unexecuted instantiation: OT::gvar_GVAR<OT::NumType<true, unsigned int, 3u>, 1196835154u>::get_short_offset_array() const
584
585
  public:
586
  struct accelerator_t
587
  {
588
589
    hb_scalar_cache_t *create_cache () const
590
0
    {
591
0
      return hb_scalar_cache_t::create (table->sharedTupleCount);
592
0
    }
593
594
    static void destroy_cache (hb_scalar_cache_t *cache)
595
0
    {
596
0
      hb_scalar_cache_t::destroy (cache);
597
0
    }
598
599
0
    bool has_data () const { return table->has_data (); }
600
601
    accelerator_t (hb_face_t *face)
602
30
    {
603
30
      table = hb_sanitize_context_t ().reference_table<gvar_GVAR> (face);
604
      /* If sanitize failed, set glyphCount to 0. */
605
30
      glyphCount = table->version.to_int () ? face->get_num_glyphs () : 0;
606
30
    }
607
0
    ~accelerator_t () { table.destroy (); }
608
609
    private:
610
611
    static float infer_delta (const hb_array_t<contour_point_t> points,
612
            const hb_array_t<contour_point_t> deltas,
613
            unsigned int target, unsigned int prev, unsigned int next,
614
            float contour_point_t::*m)
615
0
    {
616
0
      float target_val = points.arrayZ[target].*m;
617
0
      float prev_val = points.arrayZ[prev].*m;
618
0
      float next_val = points.arrayZ[next].*m;
619
0
      float prev_delta =  deltas.arrayZ[prev].*m;
620
0
      float next_delta =  deltas.arrayZ[next].*m;
621
622
0
      if (prev_val == next_val)
623
0
  return (prev_delta == next_delta) ? prev_delta : 0.f;
624
0
      else if (target_val <= hb_min (prev_val, next_val))
625
0
  return (prev_val < next_val) ? prev_delta : next_delta;
626
0
      else if (target_val >= hb_max (prev_val, next_val))
627
0
  return (prev_val > next_val) ? prev_delta : next_delta;
628
629
      /* linear interpolation */
630
0
      float r = (target_val - prev_val) / (next_val - prev_val);
631
0
      return prev_delta + r * (next_delta - prev_delta);
632
0
    }
633
634
    static unsigned int next_index (unsigned int i, unsigned int start, unsigned int end)
635
0
    { return (i >= end) ? start : (i + 1); }
636
637
#ifndef HB_OPTIMIZE_SIZE
638
    template <bool is_x>
639
#endif
640
    static bool decompile_deltas_add_to_points (const HBUINT8 *&p /* IN/OUT */,
641
            hb_array_t<contour_point_t> points,
642
            float scalar,
643
            const HBUINT8 *end,
644
            unsigned start
645
#ifdef HB_OPTIMIZE_SIZE
646
            , bool is_x
647
#endif
648
            )
649
0
    {
650
0
      unsigned i = 0;
651
0
      unsigned count = points.length;
652
0
      while (i < count)
653
0
      {
654
0
  if (unlikely (p + 1 > end)) return false;
655
0
  unsigned control = *p++;
656
0
  unsigned run_count = (control & TupleValues::VALUE_RUN_COUNT_MASK) + 1;
657
0
  unsigned stop = i + run_count;
658
0
  if (unlikely (stop > count)) return false;
659
660
0
  unsigned skip = i < start ? hb_min (start - i, run_count) : 0;
661
0
  i += skip;
662
663
0
  switch (control & TupleValues::VALUES_SIZE_MASK)
664
0
  {
665
0
    case TupleValues::VALUES_ARE_ZEROS:
666
0
      i = stop;
667
0
      break;
668
0
    case TupleValues::VALUES_ARE_WORDS:
669
0
    {
670
0
      if (unlikely (p + run_count * HBINT16::static_size > end)) return false;
671
0
      p += skip * HBINT16::static_size;
672
0
      const auto *pp = (const HBINT16 *) p;
673
0
      for (; i < stop; i++)
674
0
      {
675
0
        float v = *pp++ * scalar;
676
0
        if (is_x) points.arrayZ[i].x += v;
677
0
        else points.arrayZ[i].y += v;
678
0
      }
679
0
      p = (const HBUINT8 *) pp;
680
0
    }
681
0
    break;
682
0
    case TupleValues::VALUES_ARE_LONGS:
683
0
    {
684
0
      if (unlikely (p + run_count * HBINT32::static_size > end)) return false;
685
0
      p += skip * HBINT32::static_size;
686
0
      const auto *pp = (const HBINT32 *) p;
687
0
      for (; i < stop; i++)
688
0
      {
689
0
        float v = *pp++ * scalar;
690
0
        if (is_x) points.arrayZ[i].x += v;
691
0
        else points.arrayZ[i].y += v;
692
0
      }
693
0
      p = (const HBUINT8 *) pp;
694
0
    }
695
0
    break;
696
0
    case TupleValues::VALUES_ARE_BYTES:
697
0
    {
698
0
      if (unlikely (p + run_count > end)) return false;
699
0
      p += skip * HBINT8::static_size;
700
0
      const auto *pp = (const HBINT8 *) p;
701
0
      for (; i < stop; i++)
702
0
      {
703
0
        float v = *pp++ * scalar;
704
0
        if (is_x) points.arrayZ[i].x += v;
705
0
        else points.arrayZ[i].y += v;
706
0
      }
707
0
      p = (const HBUINT8 *) pp;
708
0
    }
709
0
    break;
710
0
  }
711
0
      }
712
0
      return true;
713
0
    }
Unexecuted instantiation: bool OT::gvar_GVAR<OT::NumType<true, unsigned short, 2u>, 1735811442u>::accelerator_t::decompile_deltas_add_to_points<true>(OT::NumType<true, unsigned char, 1u> const*&, hb_array_t<contour_point_t>, float, OT::NumType<true, unsigned char, 1u> const*, unsigned int)
Unexecuted instantiation: bool OT::gvar_GVAR<OT::NumType<true, unsigned short, 2u>, 1735811442u>::accelerator_t::decompile_deltas_add_to_points<false>(OT::NumType<true, unsigned char, 1u> const*&, hb_array_t<contour_point_t>, float, OT::NumType<true, unsigned char, 1u> const*, unsigned int)
714
    public:
715
    bool apply_deltas_to_points (hb_codepoint_t glyph,
716
         hb_array_t<const int> coords,
717
         const hb_array_t<contour_point_t> points,
718
         hb_glyf_scratch_t &scratch,
719
         hb_scalar_cache_t *gvar_cache = nullptr,
720
         bool phantom_only = false) const
721
0
    {
722
0
      if (unlikely (glyph >= glyphCount)) return true;
723
724
0
      hb_bytes_t var_data_bytes = table->get_glyph_var_data_bytes (table.get_blob (), glyphCount, glyph);
725
0
      if (!var_data_bytes.as<GlyphVariationData> ()->has_data ()) return true;
726
727
0
      auto &shared_indices = scratch.shared_indices;
728
0
      shared_indices.clear ();
729
730
0
      typename GlyphVariationData::tuple_iterator_t iterator;
731
0
      if (!GlyphVariationData::get_tuple_iterator (var_data_bytes, table->axisCount,
732
0
               var_data_bytes.arrayZ,
733
0
               shared_indices, &iterator))
734
0
  return true; /* so isn't applied at all */
735
736
0
      bool any_private_points = false;
737
0
      bool private_points_checked = false;
738
739
      /* Save original points for inferred delta calculation */
740
0
      auto &orig_points_vec = scratch.orig_points;
741
0
      orig_points_vec.clear (); // Populated lazily
742
0
      auto orig_points = orig_points_vec.as_array ();
743
744
      /* flag is used to indicate referenced point */
745
0
      auto &deltas_vec = scratch.deltas;
746
0
      deltas_vec.clear (); // Populated lazily
747
0
      auto deltas = deltas_vec.as_array ();
748
749
0
      unsigned num_coords = table->axisCount;
750
0
      hb_array_t<const F2DOT14> shared_tuples = (table+table->sharedTuples).as_array (table->sharedTupleCount * num_coords);
751
752
0
      auto &private_indices = scratch.private_indices;
753
0
      auto &x_deltas = scratch.x_deltas;
754
0
      auto &y_deltas = scratch.y_deltas;
755
756
0
      unsigned count = points.length;
757
0
      bool flush = false;
758
759
0
      do
760
0
      {
761
0
  float scalar = iterator.current_tuple->calculate_scalar (coords, num_coords, shared_tuples,
762
0
                 gvar_cache);
763
764
0
  if (scalar == 0.f) continue;
765
766
0
  if (!private_points_checked)
767
0
  {
768
0
    auto scan = iterator;
769
0
    do
770
0
    {
771
0
      if (scan.current_tuple->has_private_points ())
772
0
      {
773
0
        any_private_points = true;
774
0
        break;
775
0
      }
776
0
    } while (scan.move_to_next ());
777
0
    private_points_checked = true;
778
0
  }
779
0
  const HBUINT8 *p = iterator.get_serialized_data ();
780
0
  unsigned int length = iterator.current_tuple->get_data_size ();
781
0
  if (unlikely (!iterator.var_data_bytes.check_range (p, length)))
782
0
    return false;
783
784
0
  if (!deltas)
785
0
  {
786
0
    if (unlikely (!deltas_vec.resize_dirty  (count))) return false;
787
0
    deltas = deltas_vec.as_array ();
788
0
    hb_memset (deltas.arrayZ + (phantom_only ? count - 4 : 0), 0,
789
0
         (phantom_only ? 4 : count) * sizeof (deltas[0]));
790
0
  }
791
792
0
  const HBUINT8 *end = p + length;
793
794
0
  bool has_private_points = iterator.current_tuple->has_private_points ();
795
0
  if (has_private_points &&
796
0
      !GlyphVariationData::decompile_points (p, private_indices, end))
797
0
    return false;
798
0
  const hb_array_t<unsigned int> &indices = has_private_points ? private_indices : shared_indices;
799
800
0
  bool apply_to_all = (indices.length == 0);
801
0
  unsigned num_deltas = apply_to_all ? points.length : indices.length;
802
0
  unsigned start_deltas = (apply_to_all && phantom_only && num_deltas >= 4 ? num_deltas - 4 : 0);
803
804
0
  if (apply_to_all && !any_private_points)
805
0
  {
806
#ifdef HB_OPTIMIZE_SIZE
807
    if (unlikely (!decompile_deltas_add_to_points (p, points, scalar, end, start_deltas, true))) return false;
808
    if (unlikely (!decompile_deltas_add_to_points (p, points, scalar, end, start_deltas, false))) return false;
809
#else
810
0
    if (unlikely (!decompile_deltas_add_to_points<true> (p, points, scalar, end, start_deltas))) return false;
811
0
    if (unlikely (!decompile_deltas_add_to_points<false> (p, points, scalar, end, start_deltas))) return false;
812
0
#endif
813
0
    continue;
814
0
  }
815
816
0
  if (unlikely (!x_deltas.resize_dirty  (num_deltas))) return false;
817
0
  if (unlikely (!GlyphVariationData::decompile_deltas (p, x_deltas, end, false, start_deltas))) return false;
818
0
  if (unlikely (!y_deltas.resize_dirty  (num_deltas))) return false;
819
0
  if (unlikely (!GlyphVariationData::decompile_deltas (p, y_deltas, end, false, start_deltas))) return false;
820
821
0
  if (!apply_to_all)
822
0
  {
823
0
    if (!orig_points && !phantom_only)
824
0
    {
825
0
      orig_points_vec.extend (points);
826
0
      if (unlikely (orig_points_vec.in_error ())) return false;
827
0
      orig_points = orig_points_vec.as_array ();
828
0
    }
829
830
0
    if (flush)
831
0
    {
832
0
      for (unsigned int i = phantom_only ? count - 4 : 0; i < count; i++)
833
0
        points.arrayZ[i].translate (deltas.arrayZ[i]);
834
0
    }
835
0
    hb_memset (deltas.arrayZ + (phantom_only ? count - 4 : 0), 0,
836
0
         (phantom_only ? 4 : count) * sizeof (deltas[0]));
837
0
  }
838
839
0
  if (HB_OPTIMIZE_SIZE_VAL)
840
0
  {
841
0
    for (unsigned int i = 0; i < num_deltas; i++)
842
0
    {
843
0
      unsigned int pt_index;
844
0
      if (apply_to_all)
845
0
        pt_index = i;
846
0
      else
847
0
      {
848
0
        pt_index = indices[i];
849
0
        if (unlikely (pt_index >= deltas.length)) continue;
850
0
      }
851
0
      if (phantom_only && pt_index < count - 4) continue;
852
0
      auto &delta = deltas.arrayZ[pt_index];
853
0
      delta.flag = 1; /* this point is referenced, i.e., explicit deltas specified */
854
0
      delta.add_delta (x_deltas.arrayZ[i] * scalar,
855
0
           y_deltas.arrayZ[i] * scalar);
856
0
    }
857
0
  }
858
0
  else
859
0
  {
860
    /* Ouch. Four cases... for optimization. */
861
0
    if (scalar != 1.0f)
862
0
    {
863
0
      if (apply_to_all)
864
0
        for (unsigned int i = phantom_only ? count - 4 : 0; i < count; i++)
865
0
        {
866
0
    auto &delta = deltas.arrayZ[i];
867
0
    delta.add_delta (x_deltas.arrayZ[i] * scalar,
868
0
         y_deltas.arrayZ[i] * scalar);
869
0
        }
870
0
      else
871
0
        for (unsigned int i = 0; i < num_deltas; i++)
872
0
        {
873
0
    unsigned int pt_index = indices[i];
874
0
    if (unlikely (pt_index >= deltas.length)) continue;
875
0
    if (phantom_only && pt_index < count - 4) continue;
876
0
    auto &delta = deltas.arrayZ[pt_index];
877
0
    delta.flag = 1; /* this point is referenced, i.e., explicit deltas specified */
878
0
    delta.add_delta (x_deltas.arrayZ[i] * scalar,
879
0
         y_deltas.arrayZ[i] * scalar);
880
0
        }
881
0
    }
882
0
    else
883
0
    {
884
0
      if (apply_to_all)
885
0
        for (unsigned int i = phantom_only ? count - 4 : 0; i < count; i++)
886
0
        {
887
0
    auto &delta = deltas.arrayZ[i];
888
0
    delta.add_delta (x_deltas.arrayZ[i],
889
0
         y_deltas.arrayZ[i]);
890
0
        }
891
0
      else
892
0
        for (unsigned int i = 0; i < num_deltas; i++)
893
0
        {
894
0
    unsigned int pt_index = indices[i];
895
0
    if (unlikely (pt_index >= deltas.length)) continue;
896
0
    if (phantom_only && pt_index < count - 4) continue;
897
0
    auto &delta = deltas.arrayZ[pt_index];
898
0
    delta.flag = 1; /* this point is referenced, i.e., explicit deltas specified */
899
0
    delta.add_delta (x_deltas.arrayZ[i],
900
0
         y_deltas.arrayZ[i]);
901
0
        }
902
0
    }
903
0
  }
904
905
  /* infer deltas for unreferenced points */
906
0
  if (!apply_to_all && !phantom_only)
907
0
  {
908
0
    unsigned start_point = 0;
909
0
    unsigned end_point = 0;
910
0
    while (true)
911
0
    {
912
0
      while (end_point < count && !points.arrayZ[end_point].is_end_point)
913
0
        end_point++;
914
0
      if (unlikely (end_point == count)) break;
915
916
      /* Check the number of unreferenced points in a contour. If no unref points or no ref points, nothing to do. */
917
0
      unsigned unref_count = 0;
918
0
      for (unsigned i = start_point; i < end_point + 1; i++)
919
0
        unref_count += deltas.arrayZ[i].flag;
920
0
      unref_count = (end_point - start_point + 1) - unref_count;
921
922
0
      unsigned j = start_point;
923
0
      if (unref_count == 0 || unref_count > end_point - start_point)
924
0
        goto no_more_gaps;
925
926
0
      for (;;)
927
0
      {
928
        /* Locate the next gap of unreferenced points between two referenced points prev and next.
929
         * Note that a gap may wrap around at left (start_point) and/or at right (end_point).
930
         */
931
0
        unsigned int prev, next, i;
932
0
        for (;;)
933
0
        {
934
0
    i = j;
935
0
    j = next_index (i, start_point, end_point);
936
0
    if (deltas.arrayZ[i].flag && !deltas.arrayZ[j].flag) break;
937
0
        }
938
0
        prev = j = i;
939
0
        for (;;)
940
0
        {
941
0
    i = j;
942
0
    j = next_index (i, start_point, end_point);
943
0
    if (!deltas.arrayZ[i].flag && deltas.arrayZ[j].flag) break;
944
0
        }
945
0
        next = j;
946
        /* Infer deltas for all unref points in the gap between prev and next */
947
0
        i = prev;
948
0
        for (;;)
949
0
        {
950
0
    i = next_index (i, start_point, end_point);
951
0
    if (i == next) break;
952
0
    deltas.arrayZ[i].x = infer_delta (orig_points, deltas, i, prev, next, &contour_point_t::x);
953
0
    deltas.arrayZ[i].y = infer_delta (orig_points, deltas, i, prev, next, &contour_point_t::y);
954
0
    if (--unref_count == 0) goto no_more_gaps;
955
0
        }
956
0
      }
957
0
    no_more_gaps:
958
0
      start_point = end_point = end_point + 1;
959
0
    }
960
0
  }
961
962
0
  flush = true;
963
964
0
      } while (iterator.move_to_next ());
965
966
0
      if (flush)
967
0
      {
968
0
  for (unsigned int i = phantom_only ? count - 4 : 0; i < count; i++)
969
0
    points.arrayZ[i].translate (deltas.arrayZ[i]);
970
0
      }
971
972
0
      return true;
973
0
    }
974
975
    unsigned int get_axis_count () const { return table->axisCount; }
976
977
    private:
978
    hb_blob_ptr_t<gvar_GVAR> table;
979
    unsigned glyphCount;
980
  };
981
982
  protected:
983
  FixedVersion<>version;  /* Version number of the glyph variations table
984
         * Set to 0x00010000u. */
985
  HBUINT16  axisCount;  /* The number of variation axes for this font. This must be
986
         * the same number as axisCount in the 'fvar' table. */
987
  HBUINT16  sharedTupleCount;
988
        /* The number of shared tuple records. Shared tuple records
989
         * can be referenced within glyph variation data tables for
990
         * multiple glyphs, as opposed to other tuple records stored
991
         * directly within a glyph variation data table. */
992
  NNOffset32To<UnsizedArrayOf<F2DOT14>>
993
    sharedTuples; /* Offset from the start of this table to the shared tuple records.
994
         * Array of tuple records shared across all glyph variation data tables. */
995
  GidOffsetType glyphCountX;  /* The number of glyphs in this font. This must match the number of
996
         * glyphs stored elsewhere in the font. */
997
  HBUINT16  flags;    /* Bit-field that gives the format of the offset array that follows.
998
         * If bit 0 is clear, the offsets are uint16; if bit 0 is set, the
999
         * offsets are uint32. */
1000
  Offset32To<GlyphVariationData>
1001
    dataZ;    /* Offset from the start of this table to the array of
1002
         * GlyphVariationData tables. */
1003
  UnsizedArrayOf<HBUINT8>
1004
    offsetZ;  /* Offsets from the start of the GlyphVariationData array
1005
         * to each GlyphVariationData table. */
1006
  public:
1007
  DEFINE_SIZE_ARRAY (20, offsetZ);
1008
};
1009
1010
using gvar = gvar_GVAR<HBUINT16, HB_OT_TAG_gvar>;
1011
using GVAR = gvar_GVAR<HBUINT24, HB_OT_TAG_GVAR>;
1012
1013
struct gvar_accelerator_t : gvar::accelerator_t {
1014
30
  gvar_accelerator_t (hb_face_t *face) : gvar::accelerator_t (face) {}
1015
};
1016
struct GVAR_accelerator_t : GVAR::accelerator_t {
1017
0
  GVAR_accelerator_t (hb_face_t *face) : GVAR::accelerator_t (face) {}
1018
};
1019
1020
} /* namespace OT */
1021
1022
#endif /* HB_OT_VAR_GVAR_TABLE_HH */