Coverage Report

Created: 2026-10-27 06:57

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libjxl/lib/jxl/icc_codec.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/icc_codec.h"
7
8
#include <jxl/memory_manager.h>
9
10
#include <algorithm>
11
#include <cstddef>
12
#include <cstdint>
13
14
#include "lib/jxl/base/common.h"
15
#include "lib/jxl/base/status.h"
16
#include "lib/jxl/dec_ans.h"
17
#include "lib/jxl/dec_bit_reader.h"
18
#include "lib/jxl/fields.h"
19
#include "lib/jxl/icc_codec_common.h"
20
#include "lib/jxl/padded_bytes.h"
21
22
namespace jxl {
23
namespace {
24
25
// Shuffles or interleaves bytes, for example with width 2, turns "ABCDabcd"
26
// into "AaBbCcDd". Transposes a matrix of ceil(size / width) columns and
27
// width rows. There are size elements, size may be < width * height, if so the
28
// last elements of the rightmost column are missing, the missing spots are
29
// transposed along with the filled spots, and the result has the missing
30
// elements at the end of the bottom row. The input is the input matrix in
31
// scanline order but with missing elements skipped (which may occur in multiple
32
// locations), the output is the result matrix in scanline order (with
33
// no need to skip missing elements as they are past the end of the data).
34
Status Shuffle(JxlMemoryManager* memory_manager, uint8_t* data, size_t size,
35
10.9k
               size_t width) {
36
10.9k
  size_t height = (size + width - 1) / width;  // amount of rows of output
37
10.9k
  PaddedBytes result(memory_manager);
38
10.9k
  JXL_ASSIGN_OR_RETURN(result,
39
10.9k
                       PaddedBytes::WithInitialSpace(memory_manager, size));
40
  // i = output index, j input index
41
10.9k
  size_t s = 0;
42
10.9k
  size_t j = 0;
43
1.38M
  for (size_t i = 0; i < size; i++) {
44
1.36M
    result[i] = data[j];
45
1.36M
    j += height;
46
1.36M
    if (j >= size) j = ++s;
47
1.36M
  }
48
49
1.38M
  for (size_t i = 0; i < size; i++) {
50
1.36M
    data[i] = result[i];
51
1.36M
  }
52
10.9k
  return true;
53
10.9k
}
54
55
// Two base-128 varints at up to 10 bytes each.
56
constexpr size_t kPreambleSize = 20;
57
58
// Decodes a base-128 unsigned varint into *out, advancing *pos by the exact
59
// number of bytes consumed. Returns an error if the input is truncated, if
60
// the terminator (top-bit-clear byte) is not seen within 10 bytes, or if the
61
// 10th byte encodes a value that does not fit in a uint64_t.
62
Status DecodeVarInt(const uint8_t* input, size_t inputSize, size_t* pos,
63
84.0k
                    uint64_t* out) {
64
84.0k
  uint64_t ret = 0;
65
  // 9 bytes cover bits 0..62; the 10th byte may only contribute bit 63.
66
108k
  for (size_t i = 0; i < 9; ++i) {
67
108k
    if (*pos >= inputSize) {
68
0
      return JXL_FAILURE("DecodeVarInt: truncated input");
69
0
    }
70
108k
    const uint8_t byte = input[(*pos)++];
71
108k
    ret |= static_cast<uint64_t>(byte & 0x7F) << (7 * i);
72
108k
    if ((byte & 0x80) == 0) {
73
84.0k
      *out = ret;
74
84.0k
      return true;
75
84.0k
    }
76
108k
  }
77
0
  if (*pos >= inputSize) {
78
0
    return JXL_FAILURE("DecodeVarInt: truncated input (10th byte)");
79
0
  }
80
0
  const uint8_t byte = input[(*pos)++];
81
0
  if ((byte & 0x80) != 0) {
82
0
    return JXL_FAILURE("DecodeVarInt: varint exceeds 10 bytes");
83
0
  }
84
0
  if ((byte & 0x7E) != 0) {
85
0
    return JXL_FAILURE("DecodeVarInt: value exceeds 2^64 - 1");
86
0
  }
87
0
  ret |= static_cast<uint64_t>(byte & 0x01) << 63;
88
0
  *out = ret;
89
0
  return true;
90
0
}
91
92
}  // namespace
93
94
// Mimics the beginning of UnpredictICC for quick validity check.
95
// At least kPreambleSize bytes of data should be valid at invocation time.
96
4.70k
Status CheckPreamble(const PaddedBytes& data, size_t enc_size) {
97
4.70k
  const uint8_t* enc = data.data();
98
4.70k
  size_t size = data.size();
99
4.70k
  size_t pos = 0;
100
4.70k
  uint64_t osize;
101
4.70k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &osize));
102
4.70k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(osize));
103
4.70k
  uint64_t csize;
104
4.70k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &csize));
105
4.70k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(csize));
106
4.70k
  JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, csize, size));
107
  // We expect that UnpredictICC inflates input, not the other way round.
108
4.70k
  if (osize + 65536 < enc_size) return JXL_FAILURE("Malformed ICC");
109
110
  // NB(eustas): 64 MiB ICC should be enough for everything!?
111
4.70k
  const size_t output_limit = 1 << 28;
112
4.70k
  if (output_limit && osize > output_limit) {
113
0
    return JXL_FAILURE("Decoded ICC is too large");
114
0
  }
115
4.70k
  return true;
116
4.70k
}
117
118
// Decodes the result of PredictICC back to a valid ICC profile.
119
4.68k
Status UnpredictICC(const uint8_t* enc, size_t size, PaddedBytes* result) {
120
4.68k
  if (!result->empty()) return JXL_FAILURE("result must be empty initially");
121
4.68k
  JxlMemoryManager* memory_manager = result->memory_manager();
122
4.68k
  size_t pos = 0;
123
4.68k
  uint64_t osize;
124
4.68k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &osize));  // Output size
125
4.68k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(osize));
126
4.68k
  uint64_t csize;
127
4.68k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &csize));  // Commands size
128
  // Every command is translated to at least one byte.
129
4.68k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(csize));
130
4.68k
  size_t cpos = pos;  // pos in commands stream
131
4.68k
  JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, csize, size));
132
4.68k
  size_t commands_end = cpos + csize;
133
4.68k
  pos = commands_end;  // pos in data stream
134
135
  // Header
136
4.68k
  PaddedBytes header{memory_manager};
137
4.68k
  JXL_RETURN_IF_ERROR(header.append(ICCInitialHeaderPrediction(osize)));
138
603k
  for (size_t i = 0; i <= kICCHeaderSize; i++) {
139
603k
    if (result->size() == osize) {
140
3
      if (cpos != commands_end) return JXL_FAILURE("Not all commands used");
141
3
      if (pos != size) return JXL_FAILURE("Not all data used");
142
0
      return true;  // Valid end
143
3
    }
144
603k
    if (i == kICCHeaderSize) break;  // Done
145
599k
    ICCPredictHeader(result->data(), result->size(), header.data(), i);
146
599k
    if (pos >= size) return JXL_FAILURE("Out of bounds");
147
599k
    JXL_RETURN_IF_ERROR(result->push_back(enc[pos++] + header[i]));
148
599k
  }
149
4.68k
  if (cpos >= commands_end) return JXL_FAILURE("Out of bounds");
150
151
  // Tag list
152
4.68k
  uint64_t numtags;
153
4.68k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &numtags));
154
155
4.68k
  if (numtags != 0) {
156
4.68k
    numtags--;
157
4.68k
    JXL_RETURN_IF_ERROR(CheckIs32Bit(numtags));
158
4.68k
    JXL_RETURN_IF_ERROR(AppendUint32(numtags, result));
159
4.68k
    uint64_t prevtagstart = kICCHeaderSize + numtags * 12;
160
4.68k
    uint64_t prevtagsize = 0;
161
36.7k
    for (;;) {
162
36.7k
      if (result->size() > osize) return JXL_FAILURE("Invalid result size");
163
36.7k
      if (cpos > commands_end) return JXL_FAILURE("Out of bounds");
164
36.7k
      if (cpos == commands_end) break;  // Valid end
165
36.7k
      uint8_t command = enc[cpos++];
166
36.7k
      uint8_t tagcode = command & 63;
167
36.7k
      Tag tag;
168
36.7k
      if (tagcode == 0) {
169
4.68k
        break;
170
32.0k
      } else if (tagcode == kCommandTagUnknown) {
171
900
        JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, 4, size));
172
900
        tag = DecodeKeyword(enc, size, pos);
173
900
        pos += 4;
174
31.1k
      } else if (tagcode == kCommandTagTRC) {
175
4.60k
        tag = kRtrcTag;
176
26.5k
      } else if (tagcode == kCommandTagXYZ) {
177
3.89k
        tag = kRxyzTag;
178
22.6k
      } else {
179
22.6k
        if (tagcode - kCommandTagStringFirst >= kNumTagStrings) {
180
1
          return JXL_FAILURE("Unknown tagcode");
181
1
        }
182
22.6k
        tag = *kTagStrings[tagcode - kCommandTagStringFirst];
183
22.6k
      }
184
32.0k
      JXL_RETURN_IF_ERROR(AppendKeyword(tag, result));
185
186
32.0k
      uint64_t tagstart;
187
32.0k
      uint64_t tagsize = prevtagsize;
188
32.0k
      if (tag == kRxyzTag || tag == kGxyzTag || tag == kBxyzTag ||
189
26.0k
          tag == kKxyzTag || tag == kWtptTag || tag == kBkptTag ||
190
21.3k
          tag == kLumiTag) {
191
10.7k
        tagsize = 20;
192
10.7k
      }
193
194
32.0k
      if (command & kFlagBitOffset) {
195
14.0k
        JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &tagstart));
196
18.0k
      } else {
197
18.0k
        JXL_RETURN_IF_ERROR(CheckIs32Bit(prevtagstart));
198
18.0k
        tagstart = prevtagstart + prevtagsize;
199
18.0k
      }
200
32.0k
      JXL_RETURN_IF_ERROR(CheckIs32Bit(tagstart));
201
32.0k
      JXL_RETURN_IF_ERROR(AppendUint32(tagstart, result));
202
32.0k
      if (command & kFlagBitSize) {
203
20.6k
        JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &tagsize));
204
20.6k
      }
205
32.0k
      JXL_RETURN_IF_ERROR(CheckIs32Bit(tagsize));
206
32.0k
      JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
207
32.0k
      prevtagstart = tagstart;
208
32.0k
      prevtagsize = tagsize;
209
210
32.0k
      if (tagcode == kCommandTagTRC) {
211
4.60k
        JXL_RETURN_IF_ERROR(AppendKeyword(kGtrcTag, result));
212
4.60k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart, result));
213
4.60k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
214
4.60k
        JXL_RETURN_IF_ERROR(AppendKeyword(kBtrcTag, result));
215
4.60k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart, result));
216
4.60k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
217
4.60k
      }
218
219
32.0k
      if (tagcode == kCommandTagXYZ) {
220
3.89k
        JXL_RETURN_IF_ERROR(CheckIs32Bit(tagstart + tagsize * 2));
221
3.89k
        JXL_RETURN_IF_ERROR(AppendKeyword(kGxyzTag, result));
222
3.89k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart + tagsize, result));
223
3.89k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
224
3.89k
        JXL_RETURN_IF_ERROR(AppendKeyword(kBxyzTag, result));
225
3.89k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart + tagsize * 2, result));
226
3.89k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
227
3.89k
      }
228
32.0k
    }
229
4.68k
  }
230
231
  // Main Content
232
69.3k
  for (;;) {
233
69.3k
    if (result->size() > osize) return JXL_FAILURE("Invalid result size");
234
69.3k
    if (cpos > commands_end) return JXL_FAILURE("Out of bounds");
235
69.3k
    if (cpos == commands_end) break;  // Valid end
236
64.7k
    uint8_t command = enc[cpos++];
237
64.7k
    if (command == kCommandInsert) {
238
14.9k
      uint64_t num;
239
14.9k
      JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &num));
240
14.9k
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, num, size));
241
6.48M
      for (size_t i = 0; i < num; i++) {
242
6.47M
        JXL_RETURN_IF_ERROR(result->push_back(enc[pos++]));
243
6.47M
      }
244
49.7k
    } else if (command == kCommandShuffle2 || command == kCommandShuffle4) {
245
10.8k
      uint64_t num;
246
10.8k
      JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &num));
247
10.8k
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, num, size));
248
10.8k
      PaddedBytes shuffled(memory_manager);
249
10.8k
      JXL_ASSIGN_OR_RETURN(shuffled,
250
10.8k
                           PaddedBytes::WithInitialSpace(memory_manager, num));
251
409k
      for (size_t i = 0; i < num; i++) {
252
398k
        shuffled[i] = enc[pos + i];
253
398k
      }
254
10.8k
      if (command == kCommandShuffle2) {
255
10.7k
        JXL_RETURN_IF_ERROR(Shuffle(memory_manager, shuffled.data(), num, 2));
256
10.7k
      } else if (command == kCommandShuffle4) {
257
105
        JXL_RETURN_IF_ERROR(Shuffle(memory_manager, shuffled.data(), num, 4));
258
105
      }
259
409k
      for (size_t i = 0; i < num; i++) {
260
398k
        JXL_RETURN_IF_ERROR(result->push_back(shuffled[i]));
261
398k
        pos++;
262
398k
      }
263
38.8k
    } else if (command == kCommandPredict) {
264
106
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(cpos, 2, commands_end));
265
106
      uint8_t flags = enc[cpos++];
266
267
106
      size_t width = (flags & 3) + 1;
268
106
      if (width == 3) return JXL_FAILURE("Invalid width");
269
270
106
      int order = (flags & 12) >> 2;
271
106
      if (order == 3) return JXL_FAILURE("Invalid order");
272
273
106
      uint64_t stride = width;
274
106
      if (flags & 16) {
275
0
        JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &stride));
276
0
        if (stride < width) {
277
0
          return JXL_FAILURE("Invalid stride");
278
0
        }
279
0
      }
280
      // If stride * 4 >= result->size(), return failure. The check
281
      // "size == 0 || ((size - 1) >> 2) < stride" corresponds to
282
      // "stride * 4 >= size", but does not suffer from integer overflow.
283
      // This check is more strict than necessary but follows the specification
284
      // and the encoder should ensure this is followed.
285
106
      if (result->empty() || ((result->size() - 1u) >> 2u) < stride) {
286
0
        return JXL_FAILURE("Invalid stride");
287
0
      }
288
289
106
      uint64_t num;
290
106
      JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &num));  // in bytes
291
106
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, num, size));
292
293
105
      PaddedBytes shuffled(memory_manager);
294
105
      JXL_ASSIGN_OR_RETURN(shuffled,
295
105
                           PaddedBytes::WithInitialSpace(memory_manager, num));
296
297
970k
      for (size_t i = 0; i < num; i++) {
298
970k
        shuffled[i] = enc[pos + i];
299
970k
      }
300
105
      if (width > 1) {
301
105
        JXL_RETURN_IF_ERROR(
302
105
            Shuffle(memory_manager, shuffled.data(), num, width));
303
105
      }
304
305
105
      size_t start = result->size();
306
970k
      for (size_t i = 0; i < num; i++) {
307
970k
        uint8_t predicted = LinearPredictICCValue(result->data(), start, i,
308
970k
                                                  stride, width, order);
309
970k
        JXL_RETURN_IF_ERROR(result->push_back(predicted + shuffled[i]));
310
970k
      }
311
105
      pos += num;
312
38.7k
    } else if (command == kCommandXYZ) {
313
18.5k
      JXL_RETURN_IF_ERROR(AppendKeyword(kXyz_Tag, result));
314
92.7k
      for (int i = 0; i < 4; i++) {
315
74.1k
        JXL_RETURN_IF_ERROR(result->push_back(0));
316
74.1k
      }
317
18.5k
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, 12, size));
318
241k
      for (size_t i = 0; i < 12; i++) {
319
222k
        JXL_RETURN_IF_ERROR(result->push_back(enc[pos++]));
320
222k
      }
321
20.2k
    } else if (command >= kCommandTypeStartFirst &&
322
20.2k
               command < kCommandTypeStartFirst + kNumTypeStrings) {
323
20.2k
      JXL_RETURN_IF_ERROR(AppendKeyword(
324
20.2k
          *kTypeStrings[command - kCommandTypeStartFirst], result));
325
101k
      for (size_t i = 0; i < 4; i++) {
326
80.9k
        JXL_RETURN_IF_ERROR(result->push_back(0));
327
80.9k
      }
328
20.2k
    } else {
329
3
      return JXL_FAILURE("Unknown command");
330
3
    }
331
64.7k
  }
332
333
4.67k
  if (pos != size) return JXL_FAILURE("Not all data used");
334
4.67k
  if (result->size() != osize) return JXL_FAILURE("Invalid result size");
335
336
4.67k
  return true;
337
4.67k
}
338
339
4.71k
Status ICCReader::Init(BitReader* reader) {
340
4.71k
  JXL_RETURN_IF_ERROR(CheckEOI(reader));
341
4.71k
  JxlMemoryManager* memory_manager = decompressed_.memory_manager();
342
4.71k
  used_bits_base_ = reader->TotalBitsConsumed();
343
4.71k
  if (bits_to_skip_ == 0) {
344
4.70k
    enc_size_ = U64Coder::Read(reader);
345
4.70k
    if (enc_size_ > 268435456) {
346
      // Avoid too large memory allocation for invalid file.
347
0
      return JXL_FAILURE("Too large encoded profile");
348
0
    }
349
4.70k
    JXL_RETURN_IF_ERROR(DecodeHistograms(
350
4.70k
        memory_manager, reader, kNumICCContexts, &code_, &context_map_));
351
9.41k
    JXL_ASSIGN_OR_RETURN(ans_reader_, ANSSymbolReader::Create(&code_, reader));
352
9.41k
    i_ = 0;
353
9.41k
    JXL_RETURN_IF_ERROR(
354
9.41k
        decompressed_.resize(std::min<size_t>(i_ + 0x400, enc_size_)));
355
14.1k
    for (; i_ < std::min<size_t>(2, enc_size_); i_++) {
356
9.41k
      decompressed_[i_] = ans_reader_.ReadHybridUint(
357
9.41k
          ICCANSContext(i_, i_ > 0 ? decompressed_[i_ - 1] : 0,
358
9.41k
                        i_ > 1 ? decompressed_[i_ - 2] : 0),
359
9.41k
          reader, context_map_);
360
9.41k
    }
361
4.70k
    if (enc_size_ > kPreambleSize) {
362
89.4k
      for (; i_ < kPreambleSize; i_++) {
363
84.7k
        decompressed_[i_] = ans_reader_.ReadHybridUint(
364
84.7k
            ICCANSContext(i_, decompressed_[i_ - 1], decompressed_[i_ - 2]),
365
84.7k
            reader, context_map_);
366
84.7k
      }
367
4.70k
      JXL_RETURN_IF_ERROR(CheckEOI(reader));
368
4.70k
      JXL_RETURN_IF_ERROR(CheckPreamble(decompressed_, enc_size_));
369
4.70k
    }
370
4.70k
    bits_to_skip_ = reader->TotalBitsConsumed() - used_bits_base_;
371
4.70k
  } else {
372
5
    reader->SkipBits(bits_to_skip_);
373
5
  }
374
4.71k
  return true;
375
4.71k
}
376
377
4.71k
Status ICCReader::Process(BitReader* reader, PaddedBytes* icc) {
378
4.71k
  auto checkpoint = jxl::make_unique<ANSSymbolReader::Checkpoint>();
379
4.71k
  size_t saved_i = 0;
380
267k
  auto save = [&]() {
381
267k
    ans_reader_.Save(checkpoint.get());
382
267k
    bits_to_skip_ = reader->TotalBitsConsumed() - used_bits_base_;
383
267k
    saved_i = i_;
384
267k
  };
385
4.71k
  save();
386
267k
  auto check_and_restore = [&]() -> Status {
387
267k
    Status status = CheckEOI(reader);
388
267k
    if (!status) {
389
      // not enough bytes.
390
27
      ans_reader_.Restore(*checkpoint);
391
27
      i_ = saved_i;
392
27
      return status;
393
27
    }
394
267k
    return true;
395
267k
  };
396
135M
  for (; i_ < enc_size_; i_++) {
397
135M
    if (i_ % ANSSymbolReader::kMaxCheckpointInterval == 0 && i_ > 0) {
398
262k
      JXL_RETURN_IF_ERROR(check_and_restore());
399
262k
      save();
400
262k
      if ((i_ > 0) && (((i_ & 0xFFFF) == 0))) {
401
1.99k
        float used_bytes =
402
1.99k
            (reader->TotalBitsConsumed() - used_bits_base_) / 8.0f;
403
1.99k
        if (i_ > used_bytes * 256) return JXL_FAILURE("Corrupted stream");
404
1.99k
      }
405
262k
      JXL_RETURN_IF_ERROR(
406
262k
          decompressed_.resize(std::min<size_t>(i_ + 0x400, enc_size_)));
407
262k
    }
408
135M
    JXL_ENSURE(i_ >= 2);
409
135M
    decompressed_[i_] = ans_reader_.ReadHybridUint(
410
135M
        ICCANSContext(i_, decompressed_[i_ - 1], decompressed_[i_ - 2]), reader,
411
135M
        context_map_);
412
135M
  }
413
4.69k
  JXL_RETURN_IF_ERROR(check_and_restore());
414
4.68k
  bits_to_skip_ = reader->TotalBitsConsumed() - used_bits_base_;
415
4.68k
  if (!ans_reader_.CheckANSFinalState()) {
416
0
    return JXL_FAILURE("Corrupted ICC profile");
417
0
  }
418
419
4.68k
  icc->clear();
420
4.68k
  return UnpredictICC(decompressed_.data(), decompressed_.size(), icc);
421
4.68k
}
422
423
277k
Status ICCReader::CheckEOI(BitReader* reader) {
424
277k
  if (reader->AllReadsWithinBounds()) return true;
425
27
  return JXL_NOT_ENOUGH_BYTES("Not enough bytes for reading ICC profile");
426
277k
}
427
428
}  // namespace jxl