Coverage Report

Created: 2026-10-14 06:45

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libjxl/lib/jxl/dec_modular.cc
Line
Count
Source
1
// Copyright (c) the JPEG XL Project Authors. All rights reserved.
2
//
3
// Use of this source code is governed by a BSD-style
4
// license that can be found in the LICENSE file.
5
6
#include "lib/jxl/dec_modular.h"
7
8
#include <jxl/memory_manager.h>
9
10
#include <algorithm>
11
#include <cstddef>
12
#include <cstdint>
13
#include <cstring>
14
#include <utility>
15
#include <vector>
16
17
#include "lib/jxl/ac_strategy.h"
18
#include "lib/jxl/base/bits.h"
19
#include "lib/jxl/base/common.h"
20
#include "lib/jxl/base/data_parallel.h"
21
#include "lib/jxl/chroma_from_luma.h"
22
#include "lib/jxl/dec_ans.h"
23
#include "lib/jxl/dec_cache.h"
24
#include "lib/jxl/fields.h"
25
#include "lib/jxl/frame_dimensions.h"
26
#include "lib/jxl/frame_header.h"
27
#include "lib/jxl/image.h"
28
#include "lib/jxl/image_metadata.h"
29
#include "lib/jxl/image_ops.h"
30
#include "lib/jxl/loop_filter.h"
31
#include "lib/jxl/modular/encoding/dec_ma.h"
32
#include "lib/jxl/modular/options.h"
33
#include "lib/jxl/quant_weights.h"
34
#include "lib/jxl/quantizer.h"
35
#include "lib/jxl/render_pipeline/render_pipeline.h"
36
37
#undef HWY_TARGET_INCLUDE
38
#define HWY_TARGET_INCLUDE "lib/jxl/dec_modular.cc"
39
#include <hwy/foreach_target.h>
40
#include <hwy/highway.h>
41
42
#include "lib/jxl/base/compiler_specific.h"
43
#include "lib/jxl/base/printf_macros.h"
44
#include "lib/jxl/base/rect.h"
45
#include "lib/jxl/base/status.h"
46
#include "lib/jxl/compressed_dc.h"
47
#include "lib/jxl/epf.h"
48
#include "lib/jxl/modular/encoding/encoding.h"
49
#include "lib/jxl/modular/modular_image.h"
50
#include "lib/jxl/modular/transform/transform.h"
51
52
HWY_BEFORE_NAMESPACE();
53
namespace jxl {
54
namespace HWY_NAMESPACE {
55
56
// These templates are not found via ADL.
57
using hwy::HWY_NAMESPACE::Add;
58
using hwy::HWY_NAMESPACE::Mul;
59
using hwy::HWY_NAMESPACE::Rebind;
60
61
void MultiplySum(const size_t xsize,
62
                 const pixel_type* const JXL_RESTRICT row_in,
63
                 const pixel_type* const JXL_RESTRICT row_in_Y,
64
613k
                 const float factor, float* const JXL_RESTRICT row_out) {
65
613k
  const HWY_FULL(float) df;
66
613k
  const Rebind<pixel_type, HWY_FULL(float)> di;  // assumes pixel_type <= float
67
613k
  const auto factor_v = Set(df, factor);
68
26.9M
  for (size_t x = 0; x < xsize; x += Lanes(di)) {
69
26.2M
    const auto in = Add(Load(di, row_in + x), Load(di, row_in_Y + x));
70
26.2M
    const auto out = Mul(ConvertTo(df, in), factor_v);
71
26.2M
    Store(out, df, row_out + x);
72
26.2M
  }
73
613k
}
74
75
void RgbFromSingle(const size_t xsize,
76
                   const pixel_type* const JXL_RESTRICT row_in,
77
                   const float factor, float* out_r, float* out_g,
78
3.90k
                   float* out_b) {
79
3.90k
  const HWY_FULL(float) df;
80
3.90k
  const Rebind<pixel_type, HWY_FULL(float)> di;  // assumes pixel_type <= float
81
82
3.90k
  const auto factor_v = Set(df, factor);
83
74.4k
  for (size_t x = 0; x < xsize; x += Lanes(di)) {
84
70.5k
    const auto in = Load(di, row_in + x);
85
70.5k
    const auto out = Mul(ConvertTo(df, in), factor_v);
86
70.5k
    Store(out, df, out_r + x);
87
70.5k
    Store(out, df, out_g + x);
88
70.5k
    Store(out, df, out_b + x);
89
70.5k
  }
90
3.90k
}
91
92
void SingleFromSingle(const size_t xsize,
93
                      const pixel_type* const JXL_RESTRICT row_in,
94
2.81M
                      const float factor, float* row_out) {
95
2.81M
  const HWY_FULL(float) df;
96
2.81M
  const Rebind<pixel_type, HWY_FULL(float)> di;  // assumes pixel_type <= float
97
98
2.81M
  const auto factor_v = Set(df, factor);
99
87.5M
  for (size_t x = 0; x < xsize; x += Lanes(di)) {
100
84.7M
    const auto in = Load(di, row_in + x);
101
84.7M
    const auto out = Mul(ConvertTo(df, in), factor_v);
102
84.7M
    Store(out, df, row_out + x);
103
84.7M
  }
104
2.81M
}
105
// NOLINTNEXTLINE(google-readability-namespace-comments)
106
}  // namespace HWY_NAMESPACE
107
}  // namespace jxl
108
HWY_AFTER_NAMESPACE();
109
110
#if HWY_ONCE
111
namespace jxl {
112
HWY_EXPORT(MultiplySum);       // Local function
113
HWY_EXPORT(RgbFromSingle);     // Local function
114
HWY_EXPORT(SingleFromSingle);  // Local function
115
116
// Slow conversion using double precision multiplication, only
117
// needed when the bit depth is too high for single precision
118
void SingleFromSingleAccurate(const size_t xsize,
119
                              const pixel_type* const JXL_RESTRICT row_in,
120
40.3k
                              const double factor, float* row_out) {
121
3.51M
  for (size_t x = 0; x < xsize; x++) {
122
3.47M
    row_out[x] = row_in[x] * factor;
123
3.47M
  }
124
40.3k
}
125
126
// convert custom [bits]-bit float (with [exp_bits] exponent bits) stored as int
127
// back to binary32 float
128
Status int_to_float(const pixel_type* const JXL_RESTRICT row_in,
129
                    float* const JXL_RESTRICT row_out, const size_t xsize,
130
137k
                    const int bits, const int exp_bits) {
131
137k
  static_assert(sizeof(pixel_type) == sizeof(float), "32-bit input is assumed");
132
137k
  if (bits == 32) {
133
98.9k
    JXL_ENSURE(exp_bits == 8);
134
98.9k
    memcpy(row_out, row_in, xsize * sizeof(float));
135
98.9k
    return true;
136
98.9k
  }
137
38.6k
  int exp_bias = (1 << (exp_bits - 1)) - 1;
138
38.6k
  int sign_shift = bits - 1;
139
38.6k
  int mant_bits = bits - exp_bits - 1;
140
38.6k
  int mant_shift = 23 - mant_bits;
141
1.49M
  for (size_t x = 0; x < xsize; ++x) {
142
1.45M
    uint32_t f;
143
1.45M
    memcpy(&f, &row_in[x], 4);
144
1.45M
    int signbit = (f >> sign_shift);
145
1.45M
    f &= (1 << sign_shift) - 1;
146
1.45M
    if (f == 0) {
147
259k
      row_out[x] = (signbit ? -0.f : 0.f);
148
259k
      continue;
149
259k
    }
150
1.19M
    int exp = (f >> mant_bits);
151
1.19M
    int mantissa = (f & ((1 << mant_bits) - 1));
152
1.19M
    if (exp == (1 << exp_bits) - 1) {
153
      // NaN or infinity
154
85.2k
      f = (signbit ? 0x80000000 : 0);
155
85.2k
      f |= 0b11111111 << 23;
156
85.2k
      f |= mantissa << mant_shift;
157
85.2k
      memcpy(&row_out[x], &f, 4);
158
85.2k
      continue;
159
85.2k
    }
160
1.10M
    mantissa <<= mant_shift;
161
    // Try to normalize only if there is space for maneuver.
162
1.10M
    if (exp == 0 && exp_bits < 8) {
163
      // subnormal number
164
789k
      while ((mantissa & 0x800000) == 0) {
165
722k
        mantissa <<= 1;
166
722k
        exp--;
167
722k
      }
168
67.0k
      exp++;
169
      // remove leading 1 because it is implicit now
170
67.0k
      mantissa &= 0x7fffff;
171
67.0k
    }
172
1.10M
    exp -= exp_bias;
173
    // broke up the arbitrary float into its parts, now reassemble into
174
    // binary32
175
1.10M
    exp += 127;
176
1.10M
    JXL_ENSURE(exp >= 0);
177
1.10M
    f = (signbit ? 0x80000000 : 0);
178
1.10M
    f |= (exp << 23);
179
1.10M
    f |= mantissa;
180
1.10M
    memcpy(&row_out[x], &f, 4);
181
1.10M
  }
182
38.6k
  return true;
183
38.6k
}
184
185
#if JXL_DEBUG_V_LEVEL >= 1
186
std::string ModularStreamId::DebugString() const {
187
  std::ostringstream os;
188
  os << (kind == Kind::GlobalData   ? "ModularGlobal"
189
         : kind == Kind::VarDCTDC   ? "VarDCTDC"
190
         : kind == Kind::ModularDC  ? "ModularDC"
191
         : kind == Kind::ACMetadata ? "ACMeta"
192
         : kind == Kind::QuantTable ? "QuantTable"
193
         : kind == Kind::ModularAC  ? "ModularAC"
194
                                    : "");
195
  if (kind == Kind::VarDCTDC || kind == Kind::ModularDC ||
196
      kind == Kind::ACMetadata || kind == Kind::ModularAC) {
197
    os << " group " << group_id;
198
  }
199
  if (kind == Kind::ModularAC) {
200
    os << " pass " << pass_id;
201
  }
202
  if (kind == Kind::QuantTable) {
203
    os << " " << quant_table_id;
204
  }
205
  return os.str();
206
}
207
#endif
208
209
Status ModularFrameDecoder::DecodeGlobalInfo(BitReader* reader,
210
                                             const FrameHeader& frame_header,
211
17.3k
                                             bool allow_truncated_group) {
212
17.3k
  JxlMemoryManager* memory_manager = this->memory_manager();
213
17.3k
  bool decode_color = frame_header.encoding == FrameEncoding::kModular;
214
17.3k
  const auto& metadata = frame_header.nonserialized_metadata->m;
215
17.3k
  bool is_gray = metadata.color_encoding.IsGray();
216
17.3k
  size_t nb_chans = 3;
217
17.3k
  if (is_gray && frame_header.color_transform == ColorTransform::kNone) {
218
447
    nb_chans = 1;
219
447
  }
220
17.3k
  do_color = decode_color;
221
17.3k
  size_t nb_extra = metadata.extra_channel_info.size();
222
17.3k
  bool has_tree = static_cast<bool>(reader->ReadBits(1));
223
17.3k
  if (!allow_truncated_group ||
224
17.3k
      reader->TotalBitsConsumed() < reader->TotalBytes() * kBitsPerByte) {
225
17.3k
    if (has_tree) {
226
14.9k
      size_t tree_size_limit =
227
14.9k
          std::min(static_cast<size_t>(1 << 22),
228
14.9k
                   1024 + frame_dim.xsize * frame_dim.ysize *
229
14.9k
                              (nb_chans + nb_extra) / 16);
230
14.9k
      JXL_RETURN_IF_ERROR(
231
14.9k
          DecodeTree(memory_manager, reader, &tree, tree_size_limit));
232
14.9k
      JXL_RETURN_IF_ERROR(DecodeHistograms(
233
14.9k
          memory_manager, reader, (tree.size() + 1) / 2, &code, &context_map));
234
14.9k
    }
235
17.3k
  }
236
17.3k
  if (!do_color) nb_chans = 0;
237
238
17.3k
  bool fp = metadata.bit_depth.floating_point_sample;
239
240
  // bits_per_sample is just metadata for XYB images.
241
17.3k
  if (metadata.bit_depth.bits_per_sample >= 32 && do_color &&
242
2.08k
      frame_header.color_transform != ColorTransform::kXYB) {
243
1.40k
    if (metadata.bit_depth.bits_per_sample == 32 && fp == false) {
244
0
      return JXL_FAILURE("uint32_t not supported in dec_modular");
245
1.40k
    } else if (metadata.bit_depth.bits_per_sample > 32) {
246
0
      return JXL_FAILURE("bits_per_sample > 32 not supported");
247
0
    }
248
1.40k
  }
249
250
34.6k
  JXL_ASSIGN_OR_RETURN(
251
34.6k
      Image gi,
252
34.6k
      Image::Create(memory_manager, frame_dim.xsize, frame_dim.ysize,
253
34.6k
                    metadata.bit_depth.bits_per_sample, nb_chans + nb_extra));
254
255
34.6k
  all_same_shift = true;
256
34.6k
  if (frame_header.color_transform == ColorTransform::kYCbCr) {
257
7.18k
    for (size_t c = 0; c < nb_chans; c++) {
258
4.99k
      gi.channel[c].hshift = frame_header.chroma_subsampling.HShift(c);
259
4.99k
      gi.channel[c].vshift = frame_header.chroma_subsampling.VShift(c);
260
4.99k
      size_t xsize_shifted =
261
4.99k
          DivCeil(frame_dim.xsize, 1 << gi.channel[c].hshift);
262
4.99k
      size_t ysize_shifted =
263
4.99k
          DivCeil(frame_dim.ysize, 1 << gi.channel[c].vshift);
264
4.99k
      JXL_RETURN_IF_ERROR(gi.channel[c].shrink(xsize_shifted, ysize_shifted));
265
4.99k
      if (gi.channel[c].hshift != gi.channel[0].hshift ||
266
2.59k
          gi.channel[c].vshift != gi.channel[0].vshift)
267
2.66k
        all_same_shift = false;
268
4.99k
    }
269
2.18k
  }
270
271
22.8k
  for (size_t ec = 0, c = nb_chans; ec < nb_extra; ec++, c++) {
272
5.52k
    size_t ecups = frame_header.extra_channel_upsampling[ec];
273
5.52k
    JXL_RETURN_IF_ERROR(
274
5.52k
        gi.channel[c].shrink(DivCeil(frame_dim.xsize_upsampled, ecups),
275
5.52k
                             DivCeil(frame_dim.ysize_upsampled, ecups)));
276
5.52k
    gi.channel[c].hshift = gi.channel[c].vshift =
277
5.52k
        CeilLog2Nonzero(ecups) - CeilLog2Nonzero(frame_header.upsampling);
278
5.52k
    if (gi.channel[c].hshift != gi.channel[0].hshift ||
279
3.80k
        gi.channel[c].vshift != gi.channel[0].vshift)
280
1.71k
      all_same_shift = false;
281
5.52k
  }
282
283
17.3k
  JXL_DEBUG_V(6, "DecodeGlobalInfo: full_image (w/o transforms) %s",
284
17.3k
              gi.DebugString().c_str());
285
17.3k
  ModularOptions options;
286
17.3k
  options.max_chan_size = frame_dim.group_dim;
287
17.3k
  options.group_dim = frame_dim.group_dim;
288
17.3k
  Status dec_status = ModularGenericDecompress(
289
17.3k
      reader, gi, &global_header, ModularStreamId::Global().ID(frame_dim),
290
17.3k
      &options,
291
17.3k
      /*undo_transforms=*/false, &tree, &code, &context_map,
292
17.3k
      allow_truncated_group);
293
17.3k
  if (!allow_truncated_group) JXL_RETURN_IF_ERROR(dec_status);
294
17.3k
  if (dec_status.IsFatalError()) {
295
0
    return JXL_FAILURE("Failed to decode global modular info");
296
0
  }
297
298
  // TODO(eustas): are we sure this can be done after partial decode?
299
17.3k
  have_something = false;
300
73.6k
  for (size_t c = 0; c < gi.channel.size(); c++) {
301
56.3k
    Channel& gic = gi.channel[c];
302
56.3k
    if (c >= gi.nb_meta_channels && gic.w <= frame_dim.group_dim &&
303
50.4k
        gic.h <= frame_dim.group_dim)
304
48.2k
      have_something = true;
305
56.3k
  }
306
  // move global transforms to groups if possible
307
17.3k
  if (!have_something && all_same_shift) {
308
7.32k
    if (gi.transform.size() == 1 && gi.transform[0].id == TransformId::kRCT) {
309
16
      global_transform = gi.transform;
310
16
      gi.transform.clear();
311
      // TODO(jon): also move no-delta-palette out (trickier though)
312
16
    }
313
7.32k
  }
314
17.3k
  full_image = std::move(gi);
315
17.3k
  JXL_DEBUG_V(6, "DecodeGlobalInfo: full_image (with transforms) %s",
316
17.3k
              full_image.DebugString().c_str());
317
17.3k
  return dec_status;
318
17.3k
}
319
320
17.2k
void ModularFrameDecoder::MaybeDropFullImage() {
321
17.2k
  if (full_image.transform.empty() && !have_something && all_same_shift) {
322
7.27k
    use_full_image = false;
323
7.27k
    JXL_DEBUG_V(6, "Dropping full image");
324
7.27k
    for (auto& ch : full_image.channel) {
325
      // keep metadata on channels around, but dealloc their planes
326
659
      ch.plane = Plane<pixel_type>();
327
659
    }
328
7.27k
  }
329
17.2k
}
330
331
Status ModularFrameDecoder::DecodeGroup(
332
    const FrameHeader& frame_header, const Rect& rect, BitReader* reader,
333
    int minShift, int maxShift, const ModularStreamId& stream, bool zerofill,
334
    PassesDecoderState* dec_state, RenderPipelineInput* render_pipeline_input,
335
46.1k
    bool allow_truncated, bool* should_run_pipeline) {
336
46.1k
  JXL_DEBUG_V(6, "Decoding %s with rect %s and shift bracket %d..%d %s",
337
46.1k
              stream.DebugString().c_str(), Description(rect).c_str(), minShift,
338
46.1k
              maxShift, zerofill ? "using zerofill" : "");
339
46.1k
  JXL_ENSURE(stream.kind == ModularStreamId::Kind::ModularDC ||
340
46.1k
             stream.kind == ModularStreamId::Kind::ModularAC);
341
46.1k
  const size_t xsize = rect.xsize();
342
46.1k
  const size_t ysize = rect.ysize();
343
46.1k
  JXL_ASSIGN_OR_RETURN(Image gi, Image::Create(memory_manager_, xsize, ysize,
344
46.1k
                                               full_image.bitdepth, 0));
345
  // start at the first bigger-than-groupsize non-metachannel
346
46.1k
  size_t c = full_image.nb_meta_channels;
347
132k
  for (; c < full_image.channel.size(); c++) {
348
95.9k
    Channel& fc = full_image.channel[c];
349
95.9k
    if (fc.w > frame_dim.group_dim || fc.h > frame_dim.group_dim) break;
350
95.9k
  }
351
46.1k
  size_t beginc = c;
352
96.6k
  for (; c < full_image.channel.size(); c++) {
353
50.5k
    Channel& fc = full_image.channel[c];
354
50.5k
    int shift = std::min(fc.hshift, fc.vshift);
355
50.5k
    if (shift > maxShift) continue;
356
48.9k
    if (shift < minShift) continue;
357
34.8k
    Rect r(rect.x0() >> fc.hshift, rect.y0() >> fc.vshift,
358
34.8k
           rect.xsize() >> fc.hshift, rect.ysize() >> fc.vshift, fc.w, fc.h);
359
34.8k
    if (r.xsize() == 0 || r.ysize() == 0) continue;
360
34.8k
    if (zerofill && use_full_image) {
361
0
      for (size_t y = 0; y < r.ysize(); ++y) {
362
0
        pixel_type* const JXL_RESTRICT row_out = r.Row(&fc.plane, y);
363
0
        memset(row_out, 0, r.xsize() * sizeof(*row_out));
364
0
      }
365
34.8k
    } else {
366
34.8k
      JXL_ASSIGN_OR_RETURN(
367
34.8k
          Channel gc, Channel::Create(memory_manager_, r.xsize(), r.ysize()));
368
34.8k
      if (zerofill) ZeroFillImage(&gc.plane);
369
34.8k
      gc.hshift = fc.hshift;
370
34.8k
      gc.vshift = fc.vshift;
371
34.8k
      gi.channel.emplace_back(std::move(gc));
372
34.8k
    }
373
34.8k
  }
374
46.1k
  if (zerofill && use_full_image) return true;
375
  // Return early if there's nothing to decode. Otherwise there might be
376
  // problems later (in ModularImageToDecodedRect).
377
46.1k
  if (gi.channel.empty()) {
378
38.1k
    if (dec_state && should_run_pipeline) {
379
19.8k
      const auto* metadata = frame_header.nonserialized_metadata;
380
19.8k
      if (do_color || metadata->m.num_extra_channels > 0) {
381
        // Signal to FrameDecoder that we do not have some of the required input
382
        // for the render pipeline.
383
9.28k
        *should_run_pipeline = false;
384
9.28k
      }
385
19.8k
    }
386
38.1k
    JXL_DEBUG_V(6, "Nothing to decode, returning early.");
387
38.1k
    return true;
388
38.1k
  }
389
7.91k
  ModularOptions options;
390
7.91k
  if (!zerofill) {
391
7.91k
    auto status = ModularGenericDecompress(
392
7.91k
        reader, gi, /*header=*/nullptr, stream.ID(frame_dim), &options,
393
7.91k
        /*undo_transforms=*/true, &tree, &code, &context_map, allow_truncated);
394
7.91k
    if (!allow_truncated) JXL_RETURN_IF_ERROR(status);
395
7.81k
    if (status.IsFatalError()) return status;
396
7.81k
  }
397
  // Undo global transforms that have been pushed to the group level
398
7.80k
  if (!use_full_image) {
399
5.09k
    JXL_ENSURE(render_pipeline_input);
400
5.09k
    for (const auto& t : global_transform) {
401
1.93k
      JXL_RETURN_IF_ERROR(t.Inverse(gi, global_header.wp_header));
402
1.93k
    }
403
5.09k
    JXL_RETURN_IF_ERROR(ModularImageToDecodedRect(
404
5.09k
        frame_header, gi, dec_state, nullptr, *render_pipeline_input,
405
5.09k
        Rect(0, 0, gi.w, gi.h)));
406
5.09k
    return true;
407
5.09k
  }
408
2.71k
  int gic = 0;
409
29.3k
  for (c = beginc; c < full_image.channel.size(); c++) {
410
26.6k
    Channel& fc = full_image.channel[c];
411
26.6k
    int shift = std::min(fc.hshift, fc.vshift);
412
26.6k
    if (shift > maxShift) continue;
413
25.0k
    if (shift < minShift) continue;
414
17.7k
    Rect r(rect.x0() >> fc.hshift, rect.y0() >> fc.vshift,
415
17.7k
           rect.xsize() >> fc.hshift, rect.ysize() >> fc.vshift, fc.w, fc.h);
416
17.7k
    if (r.xsize() == 0 || r.ysize() == 0) continue;
417
17.7k
    JXL_ENSURE(use_full_image);
418
17.7k
    JXL_RETURN_IF_ERROR(
419
17.7k
        CopyImageTo(/*rect_from=*/Rect(0, 0, r.xsize(), r.ysize()),
420
17.7k
                    /*from=*/gi.channel[gic].plane,
421
17.7k
                    /*rect_to=*/r, /*to=*/&fc.plane));
422
17.7k
    gic++;
423
17.7k
  }
424
2.71k
  return true;
425
2.71k
}
426
427
Status ModularFrameDecoder::DecodeVarDCTDC(const FrameHeader& frame_header,
428
                                           size_t group_id, BitReader* reader,
429
7.33k
                                           PassesDecoderState* dec_state) {
430
7.33k
  JxlMemoryManager* memory_manager = dec_state->memory_manager();
431
7.33k
  const Rect r = dec_state->shared->frame_dim.DCGroupRect(group_id);
432
7.33k
  JXL_DEBUG_V(6, "Decoding VarDCT DC with rect %s", Description(r).c_str());
433
  // TODO(eustas): investigate if we could reduce the impact of
434
  //               EvalRationalPolynomial; generally speaking, the limit is
435
  //               2**(128/(3*magic)), where 128 comes from IEEE 754 exponent,
436
  //               3 comes from XybToRgb that cubes the values, and "magic" is
437
  //               the sum of all other contributions. 2**18 is known to lead
438
  //               to NaN on input found by fuzzing (see commit message).
439
7.33k
  JXL_ASSIGN_OR_RETURN(Image image,
440
7.33k
                       Image::Create(memory_manager, r.xsize(), r.ysize(),
441
7.33k
                                     full_image.bitdepth, 3));
442
7.33k
  size_t stream_id = ModularStreamId::VarDCTDC(group_id).ID(frame_dim);
443
7.33k
  reader->Refill();
444
7.33k
  size_t extra_precision = reader->ReadFixedBits<2>();
445
7.33k
  float mul = 1.0f / (1 << extra_precision);
446
7.33k
  ModularOptions options;
447
29.3k
  for (size_t c = 0; c < 3; c++) {
448
21.9k
    Channel& ch = image.channel[c < 2 ? c ^ 1 : c];
449
21.9k
    ch.w >>= frame_header.chroma_subsampling.HShift(c);
450
21.9k
    ch.h >>= frame_header.chroma_subsampling.VShift(c);
451
21.9k
    JXL_RETURN_IF_ERROR(ch.shrink());
452
21.9k
  }
453
7.33k
  if (!ModularGenericDecompress(
454
7.33k
          reader, image, /*header=*/nullptr, stream_id, &options,
455
7.33k
          /*undo_transforms=*/true, &tree, &code, &context_map)) {
456
30
    return JXL_FAILURE("Failed to decode VarDCT DC group (DC group id %d)",
457
30
                       static_cast<int>(group_id));
458
30
  }
459
7.30k
  DequantDC(r, &dec_state->shared_storage.dc_storage,
460
7.30k
            &dec_state->shared_storage.quant_dc, image,
461
7.30k
            dec_state->shared->quantizer.MulDC(), mul,
462
7.30k
            dec_state->shared->cmap.base().DCFactors(),
463
7.30k
            frame_header.chroma_subsampling, dec_state->shared->block_ctx_map);
464
7.30k
  return true;
465
7.33k
}
466
467
Status ModularFrameDecoder::DecodeAcMetadata(const FrameHeader& frame_header,
468
                                             size_t group_id, BitReader* reader,
469
7.30k
                                             PassesDecoderState* dec_state) {
470
7.30k
  JxlMemoryManager* memory_manager = dec_state->memory_manager();
471
7.30k
  const Rect r = dec_state->shared->frame_dim.DCGroupRect(group_id);
472
7.30k
  JXL_DEBUG_V(6, "Decoding AcMetadata with rect %s", Description(r).c_str());
473
7.30k
  size_t upper_bound = r.xsize() * r.ysize();
474
7.30k
  reader->Refill();
475
7.30k
  size_t count = reader->ReadBits(CeilLog2Nonzero(upper_bound)) + 1;
476
7.30k
  size_t stream_id = ModularStreamId::ACMetadata(group_id).ID(frame_dim);
477
  // YToX, YToB, ACS + QF, EPF
478
7.30k
  JXL_ASSIGN_OR_RETURN(Image image,
479
7.30k
                       Image::Create(memory_manager, r.xsize(), r.ysize(),
480
7.30k
                                     full_image.bitdepth, 4));
481
7.30k
  static_assert(kColorTileDimInBlocks == 8, "Color tile size changed");
482
7.30k
  Rect cr(r.x0() >> 3, r.y0() >> 3, (r.xsize() + 7) >> 3, (r.ysize() + 7) >> 3);
483
7.30k
  JXL_ASSIGN_OR_RETURN(
484
7.30k
      image.channel[0],
485
7.30k
      Channel::Create(memory_manager, cr.xsize(), cr.ysize(), 3, 3));
486
7.30k
  JXL_ASSIGN_OR_RETURN(
487
7.30k
      image.channel[1],
488
7.30k
      Channel::Create(memory_manager, cr.xsize(), cr.ysize(), 3, 3));
489
7.30k
  JXL_ASSIGN_OR_RETURN(image.channel[2],
490
7.30k
                       Channel::Create(memory_manager, count, 2, 0, 0));
491
7.30k
  ModularOptions options;
492
7.30k
  if (!ModularGenericDecompress(
493
7.30k
          reader, image, /*header=*/nullptr, stream_id, &options,
494
7.30k
          /*undo_transforms=*/true, &tree, &code, &context_map)) {
495
9
    return JXL_FAILURE("Failed to decode AC metadata");
496
9
  }
497
7.29k
  JXL_RETURN_IF_ERROR(
498
7.29k
      ConvertPlaneAndClamp(Rect(image.channel[0].plane), image.channel[0].plane,
499
7.29k
                           cr, &dec_state->shared_storage.cmap.ytox_map));
500
7.29k
  JXL_RETURN_IF_ERROR(
501
7.29k
      ConvertPlaneAndClamp(Rect(image.channel[1].plane), image.channel[1].plane,
502
7.29k
                           cr, &dec_state->shared_storage.cmap.ytob_map));
503
7.29k
  size_t num = 0;
504
7.29k
  bool is444 = frame_header.chroma_subsampling.Is444();
505
7.29k
  auto& ac_strategy = dec_state->shared_storage.ac_strategy;
506
7.29k
  size_t xlim = std::min(ac_strategy.xsize(), r.x0() + r.xsize());
507
7.29k
  size_t ylim = std::min(ac_strategy.ysize(), r.y0() + r.ysize());
508
7.29k
  uint32_t local_used_acs = 0;
509
92.1k
  for (size_t iy = 0; iy < r.ysize(); iy++) {
510
84.9k
    size_t y = r.y0() + iy;
511
84.9k
    int32_t* row_qf = r.Row(&dec_state->shared_storage.raw_quant_field, iy);
512
84.9k
    uint8_t* row_epf = r.Row(&dec_state->shared_storage.epf_sharpness, iy);
513
84.9k
    int32_t* row_in_1 = image.channel[2].plane.Row(0);
514
84.9k
    int32_t* row_in_2 = image.channel[2].plane.Row(1);
515
84.9k
    int32_t* row_in_3 = image.channel[3].plane.Row(iy);
516
1.75M
    for (size_t ix = 0; ix < r.xsize(); ix++) {
517
1.67M
      size_t x = r.x0() + ix;
518
1.67M
      int sharpness = row_in_3[ix];
519
1.67M
      if (sharpness < 0 || sharpness >= LoopFilter::kEpfSharpEntries) {
520
4
        return JXL_FAILURE("Corrupted sharpness field");
521
4
      }
522
1.67M
      row_epf[ix] = sharpness;
523
1.67M
      if (ac_strategy.IsValid(x, y)) {
524
781k
        continue;
525
781k
      }
526
527
889k
      if (num >= count) return JXL_FAILURE("Corrupted stream");
528
529
889k
      if (!AcStrategy::IsRawStrategyValid(row_in_1[num])) {
530
2
        return JXL_FAILURE("Invalid AC strategy");
531
2
      }
532
889k
      local_used_acs |= 1u << row_in_1[num];
533
889k
      AcStrategy acs = AcStrategy::FromRawStrategy(row_in_1[num]);
534
889k
      if ((acs.covered_blocks_x() > 1 || acs.covered_blocks_y() > 1) &&
535
639k
          !is444) {
536
0
        return JXL_FAILURE(
537
0
            "AC strategy not compatible with chroma subsampling");
538
0
      }
539
      // Ensure that blocks do not overflow *AC* groups.
540
889k
      size_t next_x_ac_block = (x / kGroupDimInBlocks + 1) * kGroupDimInBlocks;
541
889k
      size_t next_y_ac_block = (y / kGroupDimInBlocks + 1) * kGroupDimInBlocks;
542
889k
      size_t next_x_dct_block = x + acs.covered_blocks_x();
543
889k
      size_t next_y_dct_block = y + acs.covered_blocks_y();
544
890k
      if (next_x_dct_block > next_x_ac_block || next_x_dct_block > xlim) {
545
0
        return JXL_FAILURE("Invalid AC strategy, x overflow");
546
0
      }
547
890k
      if (next_y_dct_block > next_y_ac_block || next_y_dct_block > ylim) {
548
0
        return JXL_FAILURE("Invalid AC strategy, y overflow");
549
0
      }
550
889k
      JXL_RETURN_IF_ERROR(
551
889k
          ac_strategy.SetNoBoundsCheck(x, y, AcStrategyType(row_in_1[num])));
552
889k
      row_qf[ix] = 1 + std::max<int32_t>(0, std::min(Quantizer::kQuantMax - 1,
553
889k
                                                     row_in_2[num]));
554
889k
      num++;
555
889k
    }
556
84.9k
  }
557
7.28k
  dec_state->used_acs |= local_used_acs;
558
7.28k
  if (frame_header.loop_filter.epf_iters > 0) {
559
5.16k
    JXL_RETURN_IF_ERROR(ComputeSigma(frame_header.loop_filter, r, dec_state));
560
5.16k
  }
561
7.28k
  return true;
562
7.28k
}
563
564
Status ModularFrameDecoder::ModularImageToDecodedRect(
565
    const FrameHeader& frame_header, Image& gi, PassesDecoderState* dec_state,
566
    jxl::ThreadPool* pool, RenderPipelineInput& render_pipeline_input,
567
16.1k
    Rect modular_rect) const {
568
16.1k
  const auto* metadata = frame_header.nonserialized_metadata;
569
16.1k
  JXL_ENSURE(gi.transform.empty());
570
571
3.15M
  auto get_row = [&](size_t c, size_t y) {
572
3.15M
    const auto& buffer = render_pipeline_input.GetBuffer(c);
573
3.15M
    return buffer.second.Row(buffer.first, y);
574
3.15M
  };
575
576
16.1k
  size_t c = 0;
577
16.1k
  if (do_color) {
578
15.4k
    const bool rgb_from_gray =
579
15.4k
        metadata->m.color_encoding.IsGray() &&
580
798
        frame_header.color_transform == ColorTransform::kNone;
581
15.4k
    const bool fp = metadata->m.bit_depth.floating_point_sample &&
582
2.43k
                    frame_header.color_transform != ColorTransform::kXYB;
583
60.3k
    for (; c < 3; c++) {
584
45.3k
      double factor = full_image.bitdepth < 32
585
45.3k
                          ? 1.0 / ((1u << full_image.bitdepth) - 1)
586
45.3k
                          : 0;
587
45.3k
      size_t c_in = c;
588
45.3k
      if (frame_header.color_transform == ColorTransform::kXYB) {
589
22.2k
        factor = dec_state->shared->matrices.DCQuants()[c];
590
        // XYB is encoded as YX(B-Y)
591
22.2k
        if (c < 2) c_in = 1 - c;
592
23.0k
      } else if (rgb_from_gray) {
593
442
        c_in = 0;
594
442
      }
595
45.3k
      JXL_ENSURE(c_in < gi.channel.size());
596
45.3k
      Channel& ch_in = gi.channel[c_in];
597
      // TODO(eustas): could we detect it on earlier stage?
598
45.3k
      if (ch_in.w == 0 || ch_in.h == 0) {
599
0
        return JXL_FAILURE("Empty image");
600
0
      }
601
45.3k
      JXL_ENSURE(ch_in.hshift <= 3 && ch_in.vshift <= 3);
602
45.3k
      Rect r = render_pipeline_input.GetBuffer(c).second;
603
45.3k
      Rect mr(modular_rect.x0() >> ch_in.hshift,
604
45.3k
              modular_rect.y0() >> ch_in.vshift,
605
45.3k
              DivCeil(modular_rect.xsize(), 1 << ch_in.hshift),
606
45.3k
              DivCeil(modular_rect.ysize(), 1 << ch_in.vshift));
607
45.3k
      mr = mr.Crop(ch_in.plane);
608
45.3k
      size_t xsize_shifted = r.xsize();
609
45.3k
      size_t ysize_shifted = r.ysize();
610
45.3k
      if (r.ysize() != mr.ysize() || r.xsize() != mr.xsize()) {
611
0
        return JXL_FAILURE("Dimension mismatch: trying to fit a %" PRIuS
612
0
                           "x%" PRIuS
613
0
                           " modular channel into "
614
0
                           "a %" PRIuS "x%" PRIuS " rect",
615
0
                           mr.xsize(), mr.ysize(), r.xsize(), r.ysize());
616
0
      }
617
45.3k
      if (frame_header.color_transform == ColorTransform::kXYB && c == 2) {
618
7.43k
        JXL_ENSURE(!fp);
619
7.43k
        const auto process_row = [&](const uint32_t task,
620
613k
                                     size_t /* thread */) -> Status {
621
613k
          const size_t y = task;
622
613k
          const pixel_type* const JXL_RESTRICT row_in = mr.Row(&ch_in.plane, y);
623
613k
          const pixel_type* const JXL_RESTRICT row_in_Y =
624
613k
              mr.Row(&gi.channel[0].plane, y);
625
613k
          float* const JXL_RESTRICT row_out = get_row(c, y);
626
613k
          HWY_DYNAMIC_DISPATCH(MultiplySum)
627
613k
          (xsize_shifted, row_in, row_in_Y, factor, row_out);
628
613k
          return true;
629
613k
        };
630
7.43k
        JXL_RETURN_IF_ERROR(RunOnPool(pool, 0, ysize_shifted,
631
7.43k
                                      ThreadPool::NoInit, process_row,
632
7.43k
                                      "ModularIntToFloat"));
633
37.9k
      } else if (fp) {
634
5.24k
        int bits = metadata->m.bit_depth.bits_per_sample;
635
5.24k
        int exp_bits = metadata->m.bit_depth.exponent_bits_per_sample;
636
5.24k
        const auto process_row = [&](const uint32_t task,
637
132k
                                     size_t /* thread */) -> Status {
638
132k
          const size_t y = task;
639
132k
          const pixel_type* const JXL_RESTRICT row_in = mr.Row(&ch_in.plane, y);
640
132k
          if (rgb_from_gray) {
641
256
            for (size_t cc = 0; cc < 3; cc++) {
642
192
              float* const JXL_RESTRICT row_out = get_row(cc, y);
643
192
              JXL_RETURN_IF_ERROR(
644
192
                  int_to_float(row_in, row_out, xsize_shifted, bits, exp_bits));
645
192
            }
646
131k
          } else {
647
131k
            float* const JXL_RESTRICT row_out = get_row(c, y);
648
131k
            JXL_RETURN_IF_ERROR(
649
131k
                int_to_float(row_in, row_out, xsize_shifted, bits, exp_bits));
650
131k
          }
651
132k
          return true;
652
132k
        };
653
5.24k
        JXL_RETURN_IF_ERROR(RunOnPool(pool, 0, ysize_shifted,
654
5.24k
                                      ThreadPool::NoInit, process_row,
655
5.24k
                                      "ModularIntToFloat_losslessfloat"));
656
32.6k
      } else {
657
32.6k
        const auto process_row = [&](const uint32_t task,
658
2.39M
                                     size_t /* thread */) -> Status {
659
2.39M
          const size_t y = task;
660
2.39M
          const pixel_type* const JXL_RESTRICT row_in = mr.Row(&ch_in.plane, y);
661
2.39M
          if (rgb_from_gray) {
662
3.90k
            if (full_image.bitdepth < 23) {
663
3.90k
              HWY_DYNAMIC_DISPATCH(RgbFromSingle)
664
3.90k
              (xsize_shifted, row_in, factor, get_row(0, y), get_row(1, y),
665
3.90k
               get_row(2, y));
666
3.90k
            } else {
667
0
              SingleFromSingleAccurate(xsize_shifted, row_in, factor,
668
0
                                       get_row(0, y));
669
0
              SingleFromSingleAccurate(xsize_shifted, row_in, factor,
670
0
                                       get_row(1, y));
671
0
              SingleFromSingleAccurate(xsize_shifted, row_in, factor,
672
0
                                       get_row(2, y));
673
0
            }
674
2.38M
          } else {
675
2.38M
            float* const JXL_RESTRICT row_out = get_row(c, y);
676
2.38M
            if (full_image.bitdepth < 23) {
677
2.33M
              HWY_DYNAMIC_DISPATCH(SingleFromSingle)
678
2.33M
              (xsize_shifted, row_in, factor, row_out);
679
2.33M
            } else {
680
53.5k
              SingleFromSingleAccurate(xsize_shifted, row_in, factor, row_out);
681
53.5k
            }
682
2.38M
          }
683
2.39M
          return true;
684
2.39M
        };
685
32.6k
        JXL_RETURN_IF_ERROR(RunOnPool(pool, 0, ysize_shifted,
686
32.6k
                                      ThreadPool::NoInit, process_row,
687
32.6k
                                      "ModularIntToFloat"));
688
32.6k
      }
689
45.3k
      if (rgb_from_gray) {
690
442
        break;
691
442
      }
692
45.3k
    }
693
15.4k
    if (rgb_from_gray) {
694
442
      c = 1;
695
442
    }
696
15.4k
  }
697
16.1k
  size_t num_extra_channels = metadata->m.num_extra_channels;
698
22.4k
  for (size_t ec = 0; ec < num_extra_channels; ec++, c++) {
699
6.35k
    const ExtraChannelInfo& eci = metadata->m.extra_channel_info[ec];
700
6.35k
    int bits = eci.bit_depth.bits_per_sample;
701
6.35k
    int exp_bits = eci.bit_depth.exponent_bits_per_sample;
702
6.35k
    bool fp = eci.bit_depth.floating_point_sample;
703
6.35k
    JXL_ENSURE(fp || bits < 32);
704
6.35k
    const double factor = fp ? 0 : (1.0 / ((1u << bits) - 1));
705
6.35k
    JXL_ENSURE(c < gi.channel.size());
706
6.35k
    Channel& ch_in = gi.channel[c];
707
6.35k
    const auto& buffer = render_pipeline_input.GetBuffer(3 + ec);
708
6.35k
    Rect r = buffer.second;
709
6.35k
    Rect mr(modular_rect.x0() >> ch_in.hshift,
710
6.35k
            modular_rect.y0() >> ch_in.vshift,
711
6.35k
            DivCeil(modular_rect.xsize(), 1 << ch_in.hshift),
712
6.35k
            DivCeil(modular_rect.ysize(), 1 << ch_in.vshift));
713
6.35k
    mr = mr.Crop(ch_in.plane);
714
6.35k
    if (r.ysize() != mr.ysize() || r.xsize() != mr.xsize()) {
715
0
      return JXL_FAILURE("Dimension mismatch: trying to fit a %" PRIuS
716
0
                         "x%" PRIuS
717
0
                         " modular channel into "
718
0
                         "a %" PRIuS "x%" PRIuS " rect",
719
0
                         mr.xsize(), mr.ysize(), r.xsize(), r.ysize());
720
0
    }
721
496k
    for (size_t y = 0; y < r.ysize(); ++y) {
722
490k
      float* const JXL_RESTRICT row_out = r.Row(buffer.first, y);
723
490k
      const pixel_type* const JXL_RESTRICT row_in = mr.Row(&ch_in.plane, y);
724
490k
      if (fp) {
725
5.42k
        JXL_RETURN_IF_ERROR(
726
5.42k
            int_to_float(row_in, row_out, r.xsize(), bits, exp_bits));
727
484k
      } else {
728
484k
        if (full_image.bitdepth < 23) {
729
476k
          HWY_DYNAMIC_DISPATCH(SingleFromSingle)
730
476k
          (r.xsize(), row_in, factor, row_out);
731
476k
        } else {
732
8.45k
          SingleFromSingleAccurate(r.xsize(), row_in, factor, row_out);
733
8.45k
        }
734
484k
      }
735
490k
    }
736
6.35k
  }
737
16.1k
  return true;
738
16.1k
}
739
740
Status ModularFrameDecoder::FinalizeDecoding(const FrameHeader& frame_header,
741
                                             PassesDecoderState* dec_state,
742
                                             jxl::ThreadPool* pool,
743
17.1k
                                             bool inplace) {
744
17.1k
  if (!use_full_image) return true;
745
9.97k
  JxlMemoryManager* memory_manager = dec_state->memory_manager();
746
9.97k
  Image gi{memory_manager};
747
9.97k
  if (inplace) {
748
9.97k
    gi = std::move(full_image);
749
9.97k
  } else {
750
0
    JXL_ASSIGN_OR_RETURN(gi, Image::Clone(full_image));
751
0
  }
752
9.97k
  size_t xsize = gi.w;
753
9.97k
  size_t ysize = gi.h;
754
755
9.97k
  JXL_DEBUG_V(3, "Finalizing decoding for modular image: %s",
756
9.97k
              gi.DebugString().c_str());
757
758
  // Don't use threads if total image size is smaller than a group
759
9.97k
  if (xsize * ysize < frame_dim.group_dim * frame_dim.group_dim) pool = nullptr;
760
761
  // Undo the global transforms
762
9.97k
  gi.undo_transforms(global_header.wp_header, pool);
763
9.97k
  JXL_ENSURE(global_transform.empty());
764
9.97k
  if (gi.error) return JXL_FAILURE("Undoing transforms failed");
765
766
21.0k
  for (size_t i = 0; i < dec_state->shared->frame_dim.num_groups; i++) {
767
11.0k
    dec_state->render_pipeline->ClearDone(i);
768
11.0k
  }
769
770
9.97k
  const auto init = [&](size_t num_threads) -> Status {
771
9.97k
    bool use_group_ids = (frame_header.encoding == FrameEncoding::kVarDCT ||
772
9.97k
                          (frame_header.flags & FrameHeader::kNoise));
773
9.97k
    JXL_RETURN_IF_ERROR(dec_state->render_pipeline->PrepareForThreads(
774
9.97k
        num_threads, use_group_ids));
775
9.97k
    return true;
776
9.97k
  };
777
9.97k
  const auto process_group = [&](const uint32_t group,
778
11.0k
                                 size_t thread_id) -> Status {
779
11.0k
    RenderPipelineInput input =
780
11.0k
        dec_state->render_pipeline->GetInputBuffers(group, thread_id);
781
11.0k
    JXL_RETURN_IF_ERROR(ModularImageToDecodedRect(
782
11.0k
        frame_header, gi, dec_state, nullptr, input,
783
11.0k
        dec_state->shared->frame_dim.GroupRect(group)));
784
11.0k
    JXL_RETURN_IF_ERROR(input.Done());
785
11.0k
    return true;
786
11.0k
  };
787
9.97k
  JXL_RETURN_IF_ERROR(RunOnPool(pool, 0,
788
9.97k
                                dec_state->shared->frame_dim.num_groups, init,
789
9.97k
                                process_group, "ModularToRect"));
790
9.97k
  return true;
791
9.97k
}
792
793
static constexpr const float kAlmostZero = 1e-8f;
794
795
Status ModularFrameDecoder::DecodeQuantTable(
796
    JxlMemoryManager* memory_manager, size_t required_size_x,
797
    size_t required_size_y, BitReader* br, QuantEncoding* encoding, size_t idx,
798
1
    ModularFrameDecoder* modular_frame_decoder) {
799
1
  JXL_RETURN_IF_ERROR(F16Coder::Read(br, &encoding->qraw.qtable_den));
800
1
  if (encoding->qraw.qtable_den < kAlmostZero) {
801
    // qtable[] values are already checked for <= 0 so the denominator may not
802
    // be negative.
803
0
    return JXL_FAILURE("Invalid qtable_den: value too small");
804
0
  }
805
2
  JXL_ASSIGN_OR_RETURN(
806
2
      Image image,
807
2
      Image::Create(memory_manager, required_size_x, required_size_y, 8, 3));
808
2
  ModularOptions options;
809
2
  if (modular_frame_decoder) {
810
1
    JXL_ASSIGN_OR_RETURN(ModularStreamId qt, ModularStreamId::QuantTable(idx));
811
1
    JXL_RETURN_IF_ERROR(ModularGenericDecompress(
812
1
        br, image, /*header=*/nullptr, qt.ID(modular_frame_decoder->frame_dim),
813
1
        &options, /*undo_transforms=*/true, &modular_frame_decoder->tree,
814
1
        &modular_frame_decoder->code, &modular_frame_decoder->context_map));
815
1
  } else {
816
0
    JXL_RETURN_IF_ERROR(ModularGenericDecompress(br, image, /*header=*/nullptr,
817
0
                                                 0, &options,
818
0
                                                 /*undo_transforms=*/true));
819
0
  }
820
1
  if (!encoding->qraw.qtable) {
821
1
    encoding->qraw.qtable =
822
1
        new std::vector<int>(required_size_x * required_size_y * 3);
823
1
  } else {
824
0
    JXL_ENSURE(encoding->qraw.qtable->size() ==
825
0
               required_size_x * required_size_y * 3);
826
0
  }
827
1
  int* qtable = encoding->qraw.qtable->data();
828
2
  for (size_t c = 0; c < 3; c++) {
829
11
    for (size_t y = 0; y < required_size_y; y++) {
830
10
      int32_t* JXL_RESTRICT row = image.channel[c].Row(y);
831
85
      for (size_t x = 0; x < required_size_x; x++) {
832
76
        qtable[c * required_size_x * required_size_y + y * required_size_x +
833
76
               x] = row[x];
834
76
        if (row[x] <= 0) {
835
1
          return JXL_FAILURE("Invalid raw quantization table");
836
1
        }
837
76
      }
838
10
    }
839
2
  }
840
0
  return true;
841
1
}
842
843
}  // namespace jxl
844
#endif  // HWY_ONCE