Coverage Report

Created: 2026-10-14 06:45

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.6k
               size_t width) {
36
10.6k
  size_t height = (size + width - 1) / width;  // amount of rows of output
37
10.6k
  PaddedBytes result(memory_manager);
38
10.6k
  JXL_ASSIGN_OR_RETURN(result,
39
10.6k
                       PaddedBytes::WithInitialSpace(memory_manager, size));
40
  // i = output index, j input index
41
10.6k
  size_t s = 0;
42
10.6k
  size_t j = 0;
43
1.34M
  for (size_t i = 0; i < size; i++) {
44
1.33M
    result[i] = data[j];
45
1.33M
    j += height;
46
1.33M
    if (j >= size) j = ++s;
47
1.33M
  }
48
49
1.34M
  for (size_t i = 0; i < size; i++) {
50
1.33M
    data[i] = result[i];
51
1.33M
  }
52
10.6k
  return true;
53
10.6k
}
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
79.9k
                    uint64_t* out) {
64
79.9k
  uint64_t ret = 0;
65
  // 9 bytes cover bits 0..62; the 10th byte may only contribute bit 63.
66
102k
  for (size_t i = 0; i < 9; ++i) {
67
102k
    if (*pos >= inputSize) {
68
0
      return JXL_FAILURE("DecodeVarInt: truncated input");
69
0
    }
70
102k
    const uint8_t byte = input[(*pos)++];
71
102k
    ret |= static_cast<uint64_t>(byte & 0x7F) << (7 * i);
72
102k
    if ((byte & 0x80) == 0) {
73
79.9k
      *out = ret;
74
79.9k
      return true;
75
79.9k
    }
76
102k
  }
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.48k
Status CheckPreamble(const PaddedBytes& data, size_t enc_size) {
97
4.48k
  const uint8_t* enc = data.data();
98
4.48k
  size_t size = data.size();
99
4.48k
  size_t pos = 0;
100
4.48k
  uint64_t osize;
101
4.48k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &osize));
102
4.48k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(osize));
103
4.48k
  uint64_t csize;
104
4.48k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &csize));
105
4.48k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(csize));
106
4.48k
  JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, csize, size));
107
  // We expect that UnpredictICC inflates input, not the other way round.
108
4.48k
  if (osize + 65536 < enc_size) return JXL_FAILURE("Malformed ICC");
109
110
  // NB(eustas): 64 MiB ICC should be enough for everything!?
111
4.48k
  const size_t output_limit = 1 << 28;
112
4.48k
  if (output_limit && osize > output_limit) {
113
0
    return JXL_FAILURE("Decoded ICC is too large");
114
0
  }
115
4.48k
  return true;
116
4.48k
}
117
118
// Decodes the result of PredictICC back to a valid ICC profile.
119
4.47k
Status UnpredictICC(const uint8_t* enc, size_t size, PaddedBytes* result) {
120
4.47k
  if (!result->empty()) return JXL_FAILURE("result must be empty initially");
121
4.47k
  JxlMemoryManager* memory_manager = result->memory_manager();
122
4.47k
  size_t pos = 0;
123
4.47k
  uint64_t osize;
124
4.47k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &osize));  // Output size
125
4.47k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(osize));
126
4.47k
  uint64_t csize;
127
4.47k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, size, &pos, &csize));  // Commands size
128
  // Every command is translated to at least one byte.
129
4.47k
  JXL_RETURN_IF_ERROR(CheckIs32Bit(csize));
130
4.47k
  size_t cpos = pos;  // pos in commands stream
131
4.47k
  JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, csize, size));
132
4.47k
  size_t commands_end = cpos + csize;
133
4.47k
  pos = commands_end;  // pos in data stream
134
135
  // Header
136
4.47k
  PaddedBytes header{memory_manager};
137
4.47k
  JXL_RETURN_IF_ERROR(header.append(ICCInitialHeaderPrediction(osize)));
138
575k
  for (size_t i = 0; i <= kICCHeaderSize; i++) {
139
575k
    if (result->size() == osize) {
140
7
      if (cpos != commands_end) return JXL_FAILURE("Not all commands used");
141
6
      if (pos != size) return JXL_FAILURE("Not all data used");
142
3
      return true;  // Valid end
143
6
    }
144
575k
    if (i == kICCHeaderSize) break;  // Done
145
571k
    ICCPredictHeader(result->data(), result->size(), header.data(), i);
146
571k
    if (pos >= size) return JXL_FAILURE("Out of bounds");
147
571k
    JXL_RETURN_IF_ERROR(result->push_back(enc[pos++] + header[i]));
148
571k
  }
149
4.46k
  if (cpos >= commands_end) return JXL_FAILURE("Out of bounds");
150
151
  // Tag list
152
4.46k
  uint64_t numtags;
153
4.46k
  JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &numtags));
154
155
4.46k
  if (numtags != 0) {
156
4.46k
    numtags--;
157
4.46k
    JXL_RETURN_IF_ERROR(CheckIs32Bit(numtags));
158
4.46k
    JXL_RETURN_IF_ERROR(AppendUint32(numtags, result));
159
4.46k
    uint64_t prevtagstart = kICCHeaderSize + numtags * 12;
160
4.46k
    uint64_t prevtagsize = 0;
161
35.1k
    for (;;) {
162
35.1k
      if (result->size() > osize) return JXL_FAILURE("Invalid result size");
163
35.1k
      if (cpos > commands_end) return JXL_FAILURE("Out of bounds");
164
35.1k
      if (cpos == commands_end) break;  // Valid end
165
35.1k
      uint8_t command = enc[cpos++];
166
35.1k
      uint8_t tagcode = command & 63;
167
35.1k
      Tag tag;
168
35.1k
      if (tagcode == 0) {
169
4.46k
        break;
170
30.7k
      } else if (tagcode == kCommandTagUnknown) {
171
640
        JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, 4, size));
172
640
        tag = DecodeKeyword(enc, size, pos);
173
640
        pos += 4;
174
30.0k
      } else if (tagcode == kCommandTagTRC) {
175
4.41k
        tag = kRtrcTag;
176
25.6k
      } else if (tagcode == kCommandTagXYZ) {
177
3.67k
        tag = kRxyzTag;
178
21.9k
      } else {
179
21.9k
        if (tagcode - kCommandTagStringFirst >= kNumTagStrings) {
180
0
          return JXL_FAILURE("Unknown tagcode");
181
0
        }
182
21.9k
        tag = *kTagStrings[tagcode - kCommandTagStringFirst];
183
21.9k
      }
184
30.7k
      JXL_RETURN_IF_ERROR(AppendKeyword(tag, result));
185
186
30.7k
      uint64_t tagstart;
187
30.7k
      uint64_t tagsize = prevtagsize;
188
30.7k
      if (tag == kRxyzTag || tag == kGxyzTag || tag == kBxyzTag ||
189
24.8k
          tag == kKxyzTag || tag == kWtptTag || tag == kBkptTag ||
190
20.3k
          tag == kLumiTag) {
191
10.3k
        tagsize = 20;
192
10.3k
      }
193
194
30.7k
      if (command & kFlagBitOffset) {
195
13.1k
        JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &tagstart));
196
17.5k
      } else {
197
17.5k
        JXL_RETURN_IF_ERROR(CheckIs32Bit(prevtagstart));
198
17.5k
        tagstart = prevtagstart + prevtagsize;
199
17.5k
      }
200
30.7k
      JXL_RETURN_IF_ERROR(CheckIs32Bit(tagstart));
201
30.7k
      JXL_RETURN_IF_ERROR(AppendUint32(tagstart, result));
202
30.7k
      if (command & kFlagBitSize) {
203
19.5k
        JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &tagsize));
204
19.5k
      }
205
30.7k
      JXL_RETURN_IF_ERROR(CheckIs32Bit(tagsize));
206
30.7k
      JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
207
30.7k
      prevtagstart = tagstart;
208
30.7k
      prevtagsize = tagsize;
209
210
30.7k
      if (tagcode == kCommandTagTRC) {
211
4.41k
        JXL_RETURN_IF_ERROR(AppendKeyword(kGtrcTag, result));
212
4.41k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart, result));
213
4.41k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
214
4.41k
        JXL_RETURN_IF_ERROR(AppendKeyword(kBtrcTag, result));
215
4.41k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart, result));
216
4.41k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
217
4.41k
      }
218
219
30.7k
      if (tagcode == kCommandTagXYZ) {
220
3.67k
        JXL_RETURN_IF_ERROR(CheckIs32Bit(tagstart + tagsize * 2));
221
3.67k
        JXL_RETURN_IF_ERROR(AppendKeyword(kGxyzTag, result));
222
3.67k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart + tagsize, result));
223
3.67k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
224
3.67k
        JXL_RETURN_IF_ERROR(AppendKeyword(kBxyzTag, result));
225
3.67k
        JXL_RETURN_IF_ERROR(AppendUint32(tagstart + tagsize * 2, result));
226
3.67k
        JXL_RETURN_IF_ERROR(AppendUint32(tagsize, result));
227
3.67k
      }
228
30.7k
    }
229
4.46k
  }
230
231
  // Main Content
232
66.4k
  for (;;) {
233
66.4k
    if (result->size() > osize) return JXL_FAILURE("Invalid result size");
234
66.4k
    if (cpos > commands_end) return JXL_FAILURE("Out of bounds");
235
66.4k
    if (cpos == commands_end) break;  // Valid end
236
61.9k
    uint8_t command = enc[cpos++];
237
61.9k
    if (command == kCommandInsert) {
238
14.2k
      uint64_t num;
239
14.2k
      JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &num));
240
14.2k
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, num, size));
241
3.33M
      for (size_t i = 0; i < num; i++) {
242
3.32M
        JXL_RETURN_IF_ERROR(result->push_back(enc[pos++]));
243
3.32M
      }
244
47.7k
    } else if (command == kCommandShuffle2 || command == kCommandShuffle4) {
245
10.5k
      uint64_t num;
246
10.5k
      JXL_RETURN_IF_ERROR(DecodeVarInt(enc, commands_end, &cpos, &num));
247
10.5k
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, num, size));
248
10.5k
      PaddedBytes shuffled(memory_manager);
249
10.5k
      JXL_ASSIGN_OR_RETURN(shuffled,
250
10.5k
                           PaddedBytes::WithInitialSpace(memory_manager, num));
251
378k
      for (size_t i = 0; i < num; i++) {
252
368k
        shuffled[i] = enc[pos + i];
253
368k
      }
254
10.5k
      if (command == kCommandShuffle2) {
255
10.4k
        JXL_RETURN_IF_ERROR(Shuffle(memory_manager, shuffled.data(), num, 2));
256
10.4k
      } else if (command == kCommandShuffle4) {
257
105
        JXL_RETURN_IF_ERROR(Shuffle(memory_manager, shuffled.data(), num, 4));
258
105
      }
259
378k
      for (size_t i = 0; i < num; i++) {
260
368k
        JXL_RETURN_IF_ERROR(result->push_back(shuffled[i]));
261
368k
        pos++;
262
368k
      }
263
37.2k
    } 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
37.1k
    } else if (command == kCommandXYZ) {
313
17.7k
      JXL_RETURN_IF_ERROR(AppendKeyword(kXyz_Tag, result));
314
88.7k
      for (int i = 0; i < 4; i++) {
315
70.9k
        JXL_RETURN_IF_ERROR(result->push_back(0));
316
70.9k
      }
317
17.7k
      JXL_RETURN_IF_ERROR(CheckOutOfBounds(pos, 12, size));
318
230k
      for (size_t i = 0; i < 12; i++) {
319
212k
        JXL_RETURN_IF_ERROR(result->push_back(enc[pos++]));
320
212k
      }
321
19.3k
    } else if (command >= kCommandTypeStartFirst &&
322
19.3k
               command < kCommandTypeStartFirst + kNumTypeStrings) {
323
19.3k
      JXL_RETURN_IF_ERROR(AppendKeyword(
324
19.3k
          *kTypeStrings[command - kCommandTypeStartFirst], result));
325
96.9k
      for (size_t i = 0; i < 4; i++) {
326
77.5k
        JXL_RETURN_IF_ERROR(result->push_back(0));
327
77.5k
      }
328
19.3k
    } else {
329
0
      return JXL_FAILURE("Unknown command");
330
0
    }
331
61.9k
  }
332
333
4.46k
  if (pos != size) return JXL_FAILURE("Not all data used");
334
4.46k
  if (result->size() != osize) return JXL_FAILURE("Invalid result size");
335
336
4.46k
  return true;
337
4.46k
}
338
339
4.49k
Status ICCReader::Init(BitReader* reader) {
340
4.49k
  JXL_RETURN_IF_ERROR(CheckEOI(reader));
341
4.49k
  JxlMemoryManager* memory_manager = decompressed_.memory_manager();
342
4.49k
  used_bits_base_ = reader->TotalBitsConsumed();
343
4.49k
  if (bits_to_skip_ == 0) {
344
4.49k
    enc_size_ = U64Coder::Read(reader);
345
4.49k
    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.49k
    JXL_RETURN_IF_ERROR(DecodeHistograms(
350
4.49k
        memory_manager, reader, kNumICCContexts, &code_, &context_map_));
351
8.98k
    JXL_ASSIGN_OR_RETURN(ans_reader_, ANSSymbolReader::Create(&code_, reader));
352
8.98k
    i_ = 0;
353
8.98k
    JXL_RETURN_IF_ERROR(
354
8.98k
        decompressed_.resize(std::min<size_t>(i_ + 0x400, enc_size_)));
355
13.4k
    for (; i_ < std::min<size_t>(2, enc_size_); i_++) {
356
8.98k
      decompressed_[i_] = ans_reader_.ReadHybridUint(
357
8.98k
          ICCANSContext(i_, i_ > 0 ? decompressed_[i_ - 1] : 0,
358
8.98k
                        i_ > 1 ? decompressed_[i_ - 2] : 0),
359
8.98k
          reader, context_map_);
360
8.98k
    }
361
4.49k
    if (enc_size_ > kPreambleSize) {
362
85.2k
      for (; i_ < kPreambleSize; i_++) {
363
80.7k
        decompressed_[i_] = ans_reader_.ReadHybridUint(
364
80.7k
            ICCANSContext(i_, decompressed_[i_ - 1], decompressed_[i_ - 2]),
365
80.7k
            reader, context_map_);
366
80.7k
      }
367
4.48k
      JXL_RETURN_IF_ERROR(CheckEOI(reader));
368
4.48k
      JXL_RETURN_IF_ERROR(CheckPreamble(decompressed_, enc_size_));
369
4.48k
    }
370
4.49k
    bits_to_skip_ = reader->TotalBitsConsumed() - used_bits_base_;
371
4.49k
  } else {
372
5
    reader->SkipBits(bits_to_skip_);
373
5
  }
374
4.49k
  return true;
375
4.49k
}
376
377
4.49k
Status ICCReader::Process(BitReader* reader, PaddedBytes* icc) {
378
4.49k
  auto checkpoint = jxl::make_unique<ANSSymbolReader::Checkpoint>();
379
4.49k
  size_t saved_i = 0;
380
263k
  auto save = [&]() {
381
263k
    ans_reader_.Save(checkpoint.get());
382
263k
    bits_to_skip_ = reader->TotalBitsConsumed() - used_bits_base_;
383
263k
    saved_i = i_;
384
263k
  };
385
4.49k
  save();
386
263k
  auto check_and_restore = [&]() -> Status {
387
263k
    Status status = CheckEOI(reader);
388
263k
    if (!status) {
389
      // not enough bytes.
390
25
      ans_reader_.Restore(*checkpoint);
391
25
      i_ = saved_i;
392
25
      return status;
393
25
    }
394
263k
    return true;
395
263k
  };
396
133M
  for (; i_ < enc_size_; i_++) {
397
133M
    if (i_ % ANSSymbolReader::kMaxCheckpointInterval == 0 && i_ > 0) {
398
259k
      JXL_RETURN_IF_ERROR(check_and_restore());
399
259k
      save();
400
259k
      if ((i_ > 0) && (((i_ & 0xFFFF) == 0))) {
401
1.98k
        float used_bytes =
402
1.98k
            (reader->TotalBitsConsumed() - used_bits_base_) / 8.0f;
403
1.98k
        if (i_ > used_bytes * 256) return JXL_FAILURE("Corrupted stream");
404
1.98k
      }
405
259k
      JXL_RETURN_IF_ERROR(
406
259k
          decompressed_.resize(std::min<size_t>(i_ + 0x400, enc_size_)));
407
259k
    }
408
133M
    JXL_ENSURE(i_ >= 2);
409
133M
    decompressed_[i_] = ans_reader_.ReadHybridUint(
410
133M
        ICCANSContext(i_, decompressed_[i_ - 1], decompressed_[i_ - 2]), reader,
411
133M
        context_map_);
412
133M
  }
413
4.47k
  JXL_RETURN_IF_ERROR(check_and_restore());
414
4.47k
  bits_to_skip_ = reader->TotalBitsConsumed() - used_bits_base_;
415
4.47k
  if (!ans_reader_.CheckANSFinalState()) {
416
0
    return JXL_FAILURE("Corrupted ICC profile");
417
0
  }
418
419
4.47k
  icc->clear();
420
4.47k
  return UnpredictICC(decompressed_.data(), decompressed_.size(), icc);
421
4.47k
}
422
423
272k
Status ICCReader::CheckEOI(BitReader* reader) {
424
272k
  if (reader->AllReadsWithinBounds()) return true;
425
25
  return JXL_NOT_ENOUGH_BYTES("Not enough bytes for reading ICC profile");
426
272k
}
427
428
}  // namespace jxl