Coverage Report

Created: 2026-05-16 06:15

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/harfbuzz/src/hb-ot-post-table.hh
Line
Count
Source
1
/*
2
 * Copyright © 2016  Google, Inc.
3
 *
4
 *  This is part of HarfBuzz, a text shaping library.
5
 *
6
 * Permission is hereby granted, without written agreement and without
7
 * license or royalty fees, to use, copy, modify, and distribute this
8
 * software and its documentation for any purpose, provided that the
9
 * above copyright notice and the following two paragraphs appear in
10
 * all copies of this software.
11
 *
12
 * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
13
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
14
 * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
15
 * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
16
 * DAMAGE.
17
 *
18
 * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
19
 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
20
 * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
21
 * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
22
 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
23
 *
24
 * Google Author(s): Behdad Esfahbod
25
 */
26
27
#ifndef HB_OT_POST_TABLE_HH
28
#define HB_OT_POST_TABLE_HH
29
30
#include "hb-open-type.hh"
31
#include "hb-ot-var-mvar-table.hh"
32
33
#define HB_STRING_ARRAY_NAME format1_names
34
#define HB_STRING_ARRAY_LIST "hb-ot-post-macroman.hh"
35
#include "hb-string-array.hh"
36
#undef HB_STRING_ARRAY_LIST
37
#undef HB_STRING_ARRAY_NAME
38
39
/*
40
 * post -- PostScript
41
 * https://docs.microsoft.com/en-us/typography/opentype/spec/post
42
 */
43
#define HB_OT_TAG_post HB_TAG('p','o','s','t')
44
45
46
namespace OT {
47
48
49
struct postV2Tail
50
{
51
  friend struct post;
52
53
  bool sanitize (hb_sanitize_context_t *c) const
54
1.16k
  {
55
1.16k
    TRACE_SANITIZE (this);
56
1.16k
    return_trace (glyphNameIndex.sanitize (c));
57
1.16k
  }
58
59
  template<typename Iterator>
60
  bool serialize (hb_serialize_context_t *c,
61
                  Iterator it,
62
                  const void* _post) const;
63
64
  bool subset (hb_subset_context_t *c) const;
65
66
  protected:
67
  Array16Of<HBUINT16> glyphNameIndex; /* This is not an offset, but is the
68
           * ordinal number of the glyph in 'post'
69
           * string tables. */
70
/*UnsizedArrayOf<HBUINT8>
71
      namesX;*/ /* Glyph names with length bytes [variable]
72
           * (a Pascal string). */
73
74
  public:
75
  DEFINE_SIZE_ARRAY (2, glyphNameIndex);
76
};
77
78
struct post
79
{
80
  static constexpr hb_tag_t tableTag = HB_OT_TAG_post;
81
82
  bool serialize (hb_serialize_context_t *c, bool glyph_names) const
83
2.46k
  {
84
2.46k
    TRACE_SERIALIZE (this);
85
2.46k
    post *post_prime = c->allocate_min<post> ();
86
2.46k
    if (unlikely (!post_prime))  return_trace (false);
87
88
2.46k
    hb_memcpy (post_prime, this, post::min_size);
89
2.46k
    if (!glyph_names)
90
1.87k
      return_trace (c->check_assign (post_prime->version.major, 3,
91
2.46k
                                     HB_SERIALIZE_ERROR_INT_OVERFLOW)); // Version 3 does not have any glyph names.
92
93
2.46k
    return_trace (true);
94
2.46k
  }
95
96
  bool subset (hb_subset_context_t *c) const
97
2.46k
  {
98
2.46k
    TRACE_SUBSET (this);
99
2.46k
    auto *post_prime = c->serializer->start_embed<post> ();
100
101
2.46k
    bool glyph_names = c->plan->flags & HB_SUBSET_FLAGS_GLYPH_NAMES;
102
2.46k
    if (!serialize (c->serializer, glyph_names))
103
0
      return_trace (false);
104
105
2.46k
#ifndef HB_NO_VAR
106
2.46k
    if (c->plan->normalized_coords)
107
164
    {
108
164
      auto &MVAR = *c->plan->source->table.MVAR;
109
164
      auto *table = post_prime;
110
111
164
      HB_ADD_MVAR_VAR (HB_OT_METRICS_TAG_UNDERLINE_SIZE,   underlineThickness);
112
164
      HB_ADD_MVAR_VAR (HB_OT_METRICS_TAG_UNDERLINE_OFFSET, underlinePosition);
113
164
    }
114
2.46k
#endif
115
116
2.46k
    Triple *axis_range;
117
2.46k
    if (c->plan->user_axes_location.has (HB_TAG ('s','l','n','t'), &axis_range))
118
0
    {
119
0
      float italic_angle = hb_max (-90.0, hb_min (axis_range->middle, 90.0));
120
0
      if (post_prime->italicAngle.to_float () != italic_angle)
121
0
        post_prime->italicAngle.set_float (italic_angle);
122
0
    }
123
124
2.46k
    if (glyph_names && version.major == 2)
125
317
    {
126
317
      hb_barrier ();
127
317
      return_trace (v2X.subset (c));
128
317
    }
129
130
2.46k
    return_trace (true);
131
2.46k
  }
132
133
  struct accelerator_t
134
  {
135
    friend struct postV2Tail;
136
137
    accelerator_t (hb_face_t *face)
138
317
    {
139
317
      table = hb_sanitize_context_t ().reference_table<post> (face);
140
317
      unsigned int table_length = table.get_length ();
141
142
317
      version = table->version.to_int ();
143
317
      if (version != 0x00020000) return;
144
317
      hb_barrier ();
145
146
317
      const postV2Tail &v2 = table->v2X;
147
148
317
      glyphNameIndex = &v2.glyphNameIndex;
149
317
      pool = &StructAfter<uint8_t> (v2.glyphNameIndex);
150
151
317
      const uint8_t *end = (const uint8_t *) (const void *) table + table_length;
152
317
      index_to_offset.alloc (hb_min (face->get_num_glyphs (), table_length / 8));
153
317
      for (const uint8_t *data = pool;
154
579k
     index_to_offset.length < 65535 && data < end && data + *data < end;
155
578k
     data += 1 + *data)
156
578k
  index_to_offset.push (data - pool);
157
317
    }
158
    ~accelerator_t ()
159
317
    {
160
317
      hb_free (gids_sorted_by_name.get_acquire ());
161
317
      table.destroy ();
162
317
    }
163
164
    bool get_glyph_name (hb_codepoint_t glyph,
165
       char *buf, unsigned int buf_len) const
166
0
    {
167
0
      hb_bytes_t s = find_glyph_name (glyph);
168
0
      if (!s.length) return false;
169
0
      if (!buf_len) return true;
170
0
      unsigned int len = hb_min (buf_len - 1, s.length);
171
0
      strncpy (buf, s.arrayZ, len);
172
0
      buf[len] = '\0';
173
0
      return true;
174
0
    }
175
176
    bool get_glyph_from_name (const char *name, int len,
177
            hb_codepoint_t *glyph) const
178
0
    {
179
0
      unsigned int count = get_glyph_count ();
180
0
      if (unlikely (!count)) return false;
181
182
0
      if (len < 0) len = strlen (name);
183
184
0
      if (unlikely (!len)) return false;
185
186
0
    retry:
187
0
      uint16_t *gids = gids_sorted_by_name.get_acquire ();
188
189
0
      if (unlikely (!gids))
190
0
      {
191
0
  gids = (uint16_t *) hb_malloc (count * sizeof (gids[0]));
192
0
  if (unlikely (!gids))
193
0
    return false; /* Anything better?! */
194
195
0
  for (unsigned int i = 0; i < count; i++)
196
0
    gids[i] = i;
197
0
  auto thiz = this;
198
0
  hb_array_t<uint16_t> (gids, count)
199
0
    .qsort ([thiz] (const uint16_t &a, const uint16_t &b) {
200
      /* hb_array_t::cmp has reversed argument order, so
201
       * x.cmp(y) returns sign of (y - x).  Pass (b, a) to
202
       * get standard "negative when a < b" ordering. */
203
0
      return thiz->find_glyph_name (b).cmp (thiz->find_glyph_name (a));
204
0
    });
205
206
0
  if (unlikely (!gids_sorted_by_name.cmpexch (nullptr, gids)))
207
0
  {
208
0
    hb_free (gids);
209
0
    goto retry;
210
0
  }
211
0
      }
212
213
0
      hb_bytes_t st (name, len);
214
0
      auto* gid = hb_bsearch (st, gids, count, sizeof (gids[0]), cmp_key, (void *) this);
215
0
      if (gid)
216
0
      {
217
0
  *glyph = *gid;
218
0
  return true;
219
0
      }
220
221
0
      return false;
222
0
    }
223
224
    hb_blob_ptr_t<post> table;
225
226
    protected:
227
228
    unsigned int get_glyph_count () const
229
0
    {
230
0
      if (version == 0x00010000)
231
0
      {
232
0
        hb_barrier ();
233
0
  return format1_names_length;
234
0
      }
235
236
0
      if (version == 0x00020000)
237
0
      {
238
0
        hb_barrier ();
239
0
  return glyphNameIndex->len;
240
0
      }
241
242
0
      return 0;
243
0
    }
244
245
    static int cmp_key (const void *pk, const void *po, void *arg)
246
0
    {
247
0
      const accelerator_t *thiz = (const accelerator_t *) arg;
248
0
      const hb_bytes_t *key = (const hb_bytes_t *) pk;
249
0
      uint16_t o = * (const uint16_t *) po;
250
0
      return thiz->find_glyph_name (o).cmp (*key);
251
0
    }
252
253
    hb_bytes_t find_glyph_name (hb_codepoint_t glyph) const
254
1.75k
    {
255
1.75k
      if (version == 0x00010000)
256
0
      {
257
0
        hb_barrier ();
258
0
  if (glyph >= format1_names_length)
259
0
    return hb_bytes_t ();
260
261
0
  return format1_names (glyph);
262
0
      }
263
264
1.75k
      if (version != 0x00020000)
265
0
  return hb_bytes_t ();
266
1.75k
      hb_barrier ();
267
268
1.75k
      if (glyph >= glyphNameIndex->len)
269
0
  return hb_bytes_t ();
270
271
1.75k
      unsigned int index = glyphNameIndex->arrayZ[glyph];
272
1.75k
      if (index < format1_names_length)
273
0
  return format1_names (index);
274
1.75k
      index -= format1_names_length;
275
276
1.75k
      if (index >= index_to_offset.length)
277
614
  return hb_bytes_t ();
278
1.13k
      unsigned int offset = index_to_offset[index];
279
280
1.13k
      const uint8_t *data = pool + offset;
281
1.13k
      unsigned int name_length = *data;
282
1.13k
      data++;
283
284
1.13k
      return hb_bytes_t ((const char *) data, name_length);
285
1.75k
    }
286
287
    private:
288
    uint32_t version;
289
    const Array16Of<HBUINT16> *glyphNameIndex = nullptr;
290
    hb_vector_t<uint32_t> index_to_offset;
291
    const uint8_t *pool = nullptr;
292
    mutable hb_atomic_t<uint16_t *> gids_sorted_by_name;
293
  };
294
295
0
  bool has_data () const { return version.to_int (); }
296
297
  bool sanitize (hb_sanitize_context_t *c) const
298
2.81k
  {
299
2.81k
    TRACE_SANITIZE (this);
300
2.81k
    return_trace (c->check_struct (this) &&
301
2.81k
      hb_barrier () &&
302
2.81k
      (version.to_int () == 0x00010000 ||
303
2.81k
       (version.to_int () == 0x00020000 && hb_barrier () && v2X.sanitize (c)) ||
304
2.81k
       version.to_int () == 0x00030000));
305
2.81k
  }
306
307
  public:
308
  FixedVersion<>version;    /* 0x00010000 for version 1.0
309
           * 0x00020000 for version 2.0
310
           * 0x00025000 for version 2.5 (deprecated)
311
           * 0x00030000 for version 3.0 */
312
  F16DOT16  italicAngle;    /* Italic angle in counter-clockwise degrees
313
           * from the vertical. Zero for upright text,
314
           * negative for text that leans to the right
315
           * (forward). */
316
  FWORD   underlinePosition;  /* This is the suggested distance of the top
317
           * of the underline from the baseline
318
           * (negative values indicate below baseline).
319
           * The PostScript definition of this FontInfo
320
           * dictionary key (the y coordinate of the
321
           * center of the stroke) is not used for
322
           * historical reasons. The value of the
323
           * PostScript key may be calculated by
324
           * subtracting half the underlineThickness
325
           * from the value of this field. */
326
  FWORD   underlineThickness; /* Suggested values for the underline
327
             thickness. */
328
  HBUINT32  isFixedPitch;   /* Set to 0 if the font is proportionally
329
           * spaced, non-zero if the font is not
330
           * proportionally spaced (i.e. monospaced). */
331
  HBUINT32  minMemType42;   /* Minimum memory usage when an OpenType font
332
           * is downloaded. */
333
  HBUINT32  maxMemType42;   /* Maximum memory usage when an OpenType font
334
           * is downloaded. */
335
  HBUINT32  minMemType1;    /* Minimum memory usage when an OpenType font
336
           * is downloaded as a Type 1 font. */
337
  HBUINT32  maxMemType1;    /* Maximum memory usage when an OpenType font
338
           * is downloaded as a Type 1 font. */
339
  postV2Tail  v2X;
340
  DEFINE_SIZE_MIN (32);
341
};
342
343
struct post_accelerator_t : post::accelerator_t {
344
0
  post_accelerator_t (hb_face_t *face) : post::accelerator_t (face) {}
345
};
346
347
348
} /* namespace OT */
349
350
351
#endif /* HB_OT_POST_TABLE_HH */