xref: /aosp_15_r20/external/harfbuzz_ng/src/hb-ms-feature-ranges.hh (revision 2d1272b857b1f7575e6e246373e1cb218663db8a)
1*2d1272b8SAndroid Build Coastguard Worker /*
2*2d1272b8SAndroid Build Coastguard Worker  * Copyright © 2011,2012,2013  Google, Inc.
3*2d1272b8SAndroid Build Coastguard Worker  * Copyright © 2021  Khaled Hosny
4*2d1272b8SAndroid Build Coastguard Worker  *
5*2d1272b8SAndroid Build Coastguard Worker  *  This is part of HarfBuzz, a text shaping library.
6*2d1272b8SAndroid Build Coastguard Worker  *
7*2d1272b8SAndroid Build Coastguard Worker  * Permission is hereby granted, without written agreement and without
8*2d1272b8SAndroid Build Coastguard Worker  * license or royalty fees, to use, copy, modify, and distribute this
9*2d1272b8SAndroid Build Coastguard Worker  * software and its documentation for any purpose, provided that the
10*2d1272b8SAndroid Build Coastguard Worker  * above copyright notice and the following two paragraphs appear in
11*2d1272b8SAndroid Build Coastguard Worker  * all copies of this software.
12*2d1272b8SAndroid Build Coastguard Worker  *
13*2d1272b8SAndroid Build Coastguard Worker  * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
14*2d1272b8SAndroid Build Coastguard Worker  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
15*2d1272b8SAndroid Build Coastguard Worker  * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
16*2d1272b8SAndroid Build Coastguard Worker  * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
17*2d1272b8SAndroid Build Coastguard Worker  * DAMAGE.
18*2d1272b8SAndroid Build Coastguard Worker  *
19*2d1272b8SAndroid Build Coastguard Worker  * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
20*2d1272b8SAndroid Build Coastguard Worker  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
21*2d1272b8SAndroid Build Coastguard Worker  * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
22*2d1272b8SAndroid Build Coastguard Worker  * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
23*2d1272b8SAndroid Build Coastguard Worker  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
24*2d1272b8SAndroid Build Coastguard Worker  *
25*2d1272b8SAndroid Build Coastguard Worker  * Google Author(s): Behdad Esfahbod
26*2d1272b8SAndroid Build Coastguard Worker  */
27*2d1272b8SAndroid Build Coastguard Worker 
28*2d1272b8SAndroid Build Coastguard Worker #ifndef HB_MS_FEATURE_RANGES_HH
29*2d1272b8SAndroid Build Coastguard Worker #define HB_MS_FEATURE_RANGES_HH
30*2d1272b8SAndroid Build Coastguard Worker 
31*2d1272b8SAndroid Build Coastguard Worker #include "hb.hh"
32*2d1272b8SAndroid Build Coastguard Worker 
33*2d1272b8SAndroid Build Coastguard Worker /* Variations of this code exist in hb-coretext-shape.cc as well
34*2d1272b8SAndroid Build Coastguard Worker  * as hb-aat-map.cc... */
35*2d1272b8SAndroid Build Coastguard Worker 
36*2d1272b8SAndroid Build Coastguard Worker typedef struct hb_ms_feature_t {
37*2d1272b8SAndroid Build Coastguard Worker   uint32_t tag_le;
38*2d1272b8SAndroid Build Coastguard Worker   uint32_t value;
39*2d1272b8SAndroid Build Coastguard Worker } hb_ms_feature_t;
40*2d1272b8SAndroid Build Coastguard Worker 
41*2d1272b8SAndroid Build Coastguard Worker typedef struct hb_ms_features_t {
42*2d1272b8SAndroid Build Coastguard Worker   hb_ms_feature_t *features;
43*2d1272b8SAndroid Build Coastguard Worker   uint32_t         num_features;
44*2d1272b8SAndroid Build Coastguard Worker } hb_ms_features_t;
45*2d1272b8SAndroid Build Coastguard Worker 
46*2d1272b8SAndroid Build Coastguard Worker struct hb_ms_active_feature_t {
47*2d1272b8SAndroid Build Coastguard Worker   hb_ms_feature_t fea;
48*2d1272b8SAndroid Build Coastguard Worker   unsigned int order;
49*2d1272b8SAndroid Build Coastguard Worker 
cmphb_ms_active_feature_t50*2d1272b8SAndroid Build Coastguard Worker   HB_INTERNAL static int cmp (const void *pa, const void *pb) {
51*2d1272b8SAndroid Build Coastguard Worker     const auto *a = (const hb_ms_active_feature_t *) pa;
52*2d1272b8SAndroid Build Coastguard Worker     const auto *b = (const hb_ms_active_feature_t *) pb;
53*2d1272b8SAndroid Build Coastguard Worker     return a->fea.tag_le < b->fea.tag_le ? -1 : a->fea.tag_le > b->fea.tag_le ? 1 :
54*2d1272b8SAndroid Build Coastguard Worker 	   a->order < b->order ? -1 : a->order > b->order ? 1 :
55*2d1272b8SAndroid Build Coastguard Worker 	   a->fea.value < b->fea.value ? -1 : a->fea.value > b->fea.value ? 1 :
56*2d1272b8SAndroid Build Coastguard Worker 	   0;
57*2d1272b8SAndroid Build Coastguard Worker   }
operator ==hb_ms_active_feature_t58*2d1272b8SAndroid Build Coastguard Worker   bool operator== (const hb_ms_active_feature_t& f) const
59*2d1272b8SAndroid Build Coastguard Worker   { return cmp (this, &f) == 0; }
60*2d1272b8SAndroid Build Coastguard Worker };
61*2d1272b8SAndroid Build Coastguard Worker 
62*2d1272b8SAndroid Build Coastguard Worker struct hb_ms_feature_event_t {
63*2d1272b8SAndroid Build Coastguard Worker   unsigned int index;
64*2d1272b8SAndroid Build Coastguard Worker   bool start;
65*2d1272b8SAndroid Build Coastguard Worker   hb_ms_active_feature_t feature;
66*2d1272b8SAndroid Build Coastguard Worker 
cmphb_ms_feature_event_t67*2d1272b8SAndroid Build Coastguard Worker   HB_INTERNAL static int cmp (const void *pa, const void *pb)
68*2d1272b8SAndroid Build Coastguard Worker   {
69*2d1272b8SAndroid Build Coastguard Worker     const auto *a = (const hb_ms_feature_event_t *) pa;
70*2d1272b8SAndroid Build Coastguard Worker     const auto *b = (const hb_ms_feature_event_t *) pb;
71*2d1272b8SAndroid Build Coastguard Worker     return a->index < b->index ? -1 : a->index > b->index ? 1 :
72*2d1272b8SAndroid Build Coastguard Worker 	   a->start < b->start ? -1 : a->start > b->start ? 1 :
73*2d1272b8SAndroid Build Coastguard Worker 	   hb_ms_active_feature_t::cmp (&a->feature, &b->feature);
74*2d1272b8SAndroid Build Coastguard Worker   }
75*2d1272b8SAndroid Build Coastguard Worker };
76*2d1272b8SAndroid Build Coastguard Worker 
77*2d1272b8SAndroid Build Coastguard Worker struct hb_ms_range_record_t {
78*2d1272b8SAndroid Build Coastguard Worker   hb_ms_features_t features;
79*2d1272b8SAndroid Build Coastguard Worker   unsigned int index_first; /* == start */
80*2d1272b8SAndroid Build Coastguard Worker   unsigned int index_last;  /* == end - 1 */
81*2d1272b8SAndroid Build Coastguard Worker };
82*2d1272b8SAndroid Build Coastguard Worker 
83*2d1272b8SAndroid Build Coastguard Worker static inline bool
hb_ms_setup_features(const hb_feature_t * features,unsigned int num_features,hb_vector_t<hb_ms_feature_t> & feature_records,hb_vector_t<hb_ms_range_record_t> & range_records)84*2d1272b8SAndroid Build Coastguard Worker hb_ms_setup_features (const hb_feature_t                *features,
85*2d1272b8SAndroid Build Coastguard Worker 		      unsigned int                       num_features,
86*2d1272b8SAndroid Build Coastguard Worker 		      hb_vector_t<hb_ms_feature_t>      &feature_records, /* OUT */
87*2d1272b8SAndroid Build Coastguard Worker 		      hb_vector_t<hb_ms_range_record_t> &range_records /* OUT */)
88*2d1272b8SAndroid Build Coastguard Worker {
89*2d1272b8SAndroid Build Coastguard Worker   feature_records.shrink(0);
90*2d1272b8SAndroid Build Coastguard Worker   range_records.shrink(0);
91*2d1272b8SAndroid Build Coastguard Worker 
92*2d1272b8SAndroid Build Coastguard Worker   /* Sort features by start/end events. */
93*2d1272b8SAndroid Build Coastguard Worker   hb_vector_t<hb_ms_feature_event_t> feature_events;
94*2d1272b8SAndroid Build Coastguard Worker   for (unsigned int i = 0; i < num_features; i++)
95*2d1272b8SAndroid Build Coastguard Worker   {
96*2d1272b8SAndroid Build Coastguard Worker     hb_ms_active_feature_t feature;
97*2d1272b8SAndroid Build Coastguard Worker     feature.fea.tag_le = hb_uint32_swap (features[i].tag);
98*2d1272b8SAndroid Build Coastguard Worker     feature.fea.value = features[i].value;
99*2d1272b8SAndroid Build Coastguard Worker     feature.order = i;
100*2d1272b8SAndroid Build Coastguard Worker 
101*2d1272b8SAndroid Build Coastguard Worker     hb_ms_feature_event_t *event;
102*2d1272b8SAndroid Build Coastguard Worker 
103*2d1272b8SAndroid Build Coastguard Worker     event = feature_events.push ();
104*2d1272b8SAndroid Build Coastguard Worker     event->index = features[i].start;
105*2d1272b8SAndroid Build Coastguard Worker     event->start = true;
106*2d1272b8SAndroid Build Coastguard Worker     event->feature = feature;
107*2d1272b8SAndroid Build Coastguard Worker 
108*2d1272b8SAndroid Build Coastguard Worker     event = feature_events.push ();
109*2d1272b8SAndroid Build Coastguard Worker     event->index = features[i].end;
110*2d1272b8SAndroid Build Coastguard Worker     event->start = false;
111*2d1272b8SAndroid Build Coastguard Worker     event->feature = feature;
112*2d1272b8SAndroid Build Coastguard Worker   }
113*2d1272b8SAndroid Build Coastguard Worker   feature_events.qsort ();
114*2d1272b8SAndroid Build Coastguard Worker   /* Add a strategic final event. */
115*2d1272b8SAndroid Build Coastguard Worker   {
116*2d1272b8SAndroid Build Coastguard Worker     hb_ms_active_feature_t feature;
117*2d1272b8SAndroid Build Coastguard Worker     feature.fea.tag_le = 0;
118*2d1272b8SAndroid Build Coastguard Worker     feature.fea.value = 0;
119*2d1272b8SAndroid Build Coastguard Worker     feature.order = num_features + 1;
120*2d1272b8SAndroid Build Coastguard Worker 
121*2d1272b8SAndroid Build Coastguard Worker     auto *event = feature_events.push ();
122*2d1272b8SAndroid Build Coastguard Worker     event->index = 0; /* This value does magic. */
123*2d1272b8SAndroid Build Coastguard Worker     event->start = false;
124*2d1272b8SAndroid Build Coastguard Worker     event->feature = feature;
125*2d1272b8SAndroid Build Coastguard Worker   }
126*2d1272b8SAndroid Build Coastguard Worker 
127*2d1272b8SAndroid Build Coastguard Worker   /* Scan events and save features for each range. */
128*2d1272b8SAndroid Build Coastguard Worker   hb_vector_t<hb_ms_active_feature_t> active_features;
129*2d1272b8SAndroid Build Coastguard Worker   unsigned int last_index = 0;
130*2d1272b8SAndroid Build Coastguard Worker   for (unsigned int i = 0; i < feature_events.length; i++)
131*2d1272b8SAndroid Build Coastguard Worker   {
132*2d1272b8SAndroid Build Coastguard Worker     auto *event = &feature_events[i];
133*2d1272b8SAndroid Build Coastguard Worker 
134*2d1272b8SAndroid Build Coastguard Worker     if (event->index != last_index)
135*2d1272b8SAndroid Build Coastguard Worker     {
136*2d1272b8SAndroid Build Coastguard Worker       /* Save a snapshot of active features and the range. */
137*2d1272b8SAndroid Build Coastguard Worker       auto *range = range_records.push ();
138*2d1272b8SAndroid Build Coastguard Worker       auto offset = feature_records.length;
139*2d1272b8SAndroid Build Coastguard Worker 
140*2d1272b8SAndroid Build Coastguard Worker       active_features.qsort ();
141*2d1272b8SAndroid Build Coastguard Worker       for (unsigned int j = 0; j < active_features.length; j++)
142*2d1272b8SAndroid Build Coastguard Worker       {
143*2d1272b8SAndroid Build Coastguard Worker         if (!j || active_features[j].fea.tag_le != feature_records[feature_records.length - 1].tag_le)
144*2d1272b8SAndroid Build Coastguard Worker         {
145*2d1272b8SAndroid Build Coastguard Worker           feature_records.push (active_features[j].fea);
146*2d1272b8SAndroid Build Coastguard Worker         }
147*2d1272b8SAndroid Build Coastguard Worker         else
148*2d1272b8SAndroid Build Coastguard Worker         {
149*2d1272b8SAndroid Build Coastguard Worker           /* Overrides value for existing feature. */
150*2d1272b8SAndroid Build Coastguard Worker           feature_records[feature_records.length - 1].value = active_features[j].fea.value;
151*2d1272b8SAndroid Build Coastguard Worker         }
152*2d1272b8SAndroid Build Coastguard Worker       }
153*2d1272b8SAndroid Build Coastguard Worker 
154*2d1272b8SAndroid Build Coastguard Worker       /* Will convert to pointer after all is ready, since feature_records.array
155*2d1272b8SAndroid Build Coastguard Worker        * may move as we grow it. */
156*2d1272b8SAndroid Build Coastguard Worker       range->features.features = reinterpret_cast<hb_ms_feature_t *> (offset);
157*2d1272b8SAndroid Build Coastguard Worker       range->features.num_features = feature_records.length - offset;
158*2d1272b8SAndroid Build Coastguard Worker       range->index_first = last_index;
159*2d1272b8SAndroid Build Coastguard Worker       range->index_last  = event->index - 1;
160*2d1272b8SAndroid Build Coastguard Worker 
161*2d1272b8SAndroid Build Coastguard Worker       last_index = event->index;
162*2d1272b8SAndroid Build Coastguard Worker     }
163*2d1272b8SAndroid Build Coastguard Worker 
164*2d1272b8SAndroid Build Coastguard Worker     if (event->start)
165*2d1272b8SAndroid Build Coastguard Worker     {
166*2d1272b8SAndroid Build Coastguard Worker       active_features.push (event->feature);
167*2d1272b8SAndroid Build Coastguard Worker     }
168*2d1272b8SAndroid Build Coastguard Worker     else
169*2d1272b8SAndroid Build Coastguard Worker     {
170*2d1272b8SAndroid Build Coastguard Worker       auto *feature = active_features.lsearch (event->feature);
171*2d1272b8SAndroid Build Coastguard Worker       if (feature)
172*2d1272b8SAndroid Build Coastguard Worker         active_features.remove_ordered (feature - active_features.arrayZ);
173*2d1272b8SAndroid Build Coastguard Worker     }
174*2d1272b8SAndroid Build Coastguard Worker   }
175*2d1272b8SAndroid Build Coastguard Worker 
176*2d1272b8SAndroid Build Coastguard Worker   if (!range_records.length) /* No active feature found. */
177*2d1272b8SAndroid Build Coastguard Worker     num_features = 0;
178*2d1272b8SAndroid Build Coastguard Worker 
179*2d1272b8SAndroid Build Coastguard Worker   /* Fixup the pointers. */
180*2d1272b8SAndroid Build Coastguard Worker   for (unsigned int i = 0; i < range_records.length; i++)
181*2d1272b8SAndroid Build Coastguard Worker   {
182*2d1272b8SAndroid Build Coastguard Worker     auto *range = &range_records[i];
183*2d1272b8SAndroid Build Coastguard Worker     range->features.features = (hb_ms_feature_t *) feature_records + reinterpret_cast<uintptr_t> (range->features.features);
184*2d1272b8SAndroid Build Coastguard Worker   }
185*2d1272b8SAndroid Build Coastguard Worker 
186*2d1272b8SAndroid Build Coastguard Worker   return !!num_features;
187*2d1272b8SAndroid Build Coastguard Worker }
188*2d1272b8SAndroid Build Coastguard Worker 
189*2d1272b8SAndroid Build Coastguard Worker static inline void
hb_ms_make_feature_ranges(hb_vector_t<hb_ms_feature_t> & feature_records,hb_vector_t<hb_ms_range_record_t> & range_records,unsigned int chars_offset,unsigned int chars_len,uint16_t * log_clusters,hb_vector_t<hb_ms_features_t * > & range_features,hb_vector_t<uint32_t> & range_counts)190*2d1272b8SAndroid Build Coastguard Worker hb_ms_make_feature_ranges (hb_vector_t<hb_ms_feature_t>      &feature_records,
191*2d1272b8SAndroid Build Coastguard Worker 			   hb_vector_t<hb_ms_range_record_t> &range_records,
192*2d1272b8SAndroid Build Coastguard Worker 			   unsigned int                       chars_offset,
193*2d1272b8SAndroid Build Coastguard Worker 			   unsigned int                       chars_len,
194*2d1272b8SAndroid Build Coastguard Worker 			   uint16_t                          *log_clusters,
195*2d1272b8SAndroid Build Coastguard Worker 			   hb_vector_t<hb_ms_features_t*>    &range_features, /* OUT */
196*2d1272b8SAndroid Build Coastguard Worker 			   hb_vector_t<uint32_t>             &range_counts /* OUT */)
197*2d1272b8SAndroid Build Coastguard Worker {
198*2d1272b8SAndroid Build Coastguard Worker   range_features.shrink (0);
199*2d1272b8SAndroid Build Coastguard Worker   range_counts.shrink (0);
200*2d1272b8SAndroid Build Coastguard Worker 
201*2d1272b8SAndroid Build Coastguard Worker   auto *last_range = &range_records[0];
202*2d1272b8SAndroid Build Coastguard Worker   for (unsigned int i = chars_offset; i < chars_len; i++)
203*2d1272b8SAndroid Build Coastguard Worker   {
204*2d1272b8SAndroid Build Coastguard Worker     auto *range = last_range;
205*2d1272b8SAndroid Build Coastguard Worker     while (log_clusters[i] < range->index_first)
206*2d1272b8SAndroid Build Coastguard Worker       range--;
207*2d1272b8SAndroid Build Coastguard Worker     while (log_clusters[i] > range->index_last)
208*2d1272b8SAndroid Build Coastguard Worker       range++;
209*2d1272b8SAndroid Build Coastguard Worker     if (!range_features.length ||
210*2d1272b8SAndroid Build Coastguard Worker         &range->features != range_features[range_features.length - 1])
211*2d1272b8SAndroid Build Coastguard Worker     {
212*2d1272b8SAndroid Build Coastguard Worker       auto **features = range_features.push ();
213*2d1272b8SAndroid Build Coastguard Worker       auto *c = range_counts.push ();
214*2d1272b8SAndroid Build Coastguard Worker       if (unlikely (!features || !c))
215*2d1272b8SAndroid Build Coastguard Worker       {
216*2d1272b8SAndroid Build Coastguard Worker         range_features.shrink (0);
217*2d1272b8SAndroid Build Coastguard Worker         range_counts.shrink (0);
218*2d1272b8SAndroid Build Coastguard Worker         break;
219*2d1272b8SAndroid Build Coastguard Worker       }
220*2d1272b8SAndroid Build Coastguard Worker       *features = &range->features;
221*2d1272b8SAndroid Build Coastguard Worker       *c = 1;
222*2d1272b8SAndroid Build Coastguard Worker     }
223*2d1272b8SAndroid Build Coastguard Worker     else
224*2d1272b8SAndroid Build Coastguard Worker     {
225*2d1272b8SAndroid Build Coastguard Worker       range_counts[range_counts.length - 1]++;
226*2d1272b8SAndroid Build Coastguard Worker     }
227*2d1272b8SAndroid Build Coastguard Worker 
228*2d1272b8SAndroid Build Coastguard Worker     last_range = range;
229*2d1272b8SAndroid Build Coastguard Worker   }
230*2d1272b8SAndroid Build Coastguard Worker }
231*2d1272b8SAndroid Build Coastguard Worker 
232*2d1272b8SAndroid Build Coastguard Worker #endif /* HB_MS_FEATURE_RANGES_HH */
233