Coverage Report

Created: 2026-07-20 07:19

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libjxl/lib/jxl/modular/encoding/dec_ma.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/modular/encoding/dec_ma.h"
7
8
#include <jxl/memory_manager.h>
9
10
#include <algorithm>
11
#include <cstddef>
12
#include <cstdint>
13
#include <limits>
14
#include <utility>
15
#include <vector>
16
17
#include "lib/jxl/base/printf_macros.h"
18
#include "lib/jxl/base/status.h"
19
#include "lib/jxl/dec_ans.h"
20
#include "lib/jxl/dec_bit_reader.h"
21
#include "lib/jxl/modular/encoding/ma_common.h"
22
#include "lib/jxl/modular/modular_image.h"
23
#include "lib/jxl/modular/options.h"
24
#include "lib/jxl/pack_signed.h"
25
26
namespace jxl {
27
28
namespace {
29
30
enum class NextAction { CHECK_AND_GO_LEFT, GO_RIGHT, POP };
31
32
struct WorkItem {
33
  size_t node_index;
34
  pixel_type orig_l;
35
  pixel_type orig_u;
36
  NextAction action;
37
};
38
39
36.6k
Status ValidateTree(const Tree& tree) {
40
36.6k
  if (tree.empty()) return true;
41
  // TODO(eustas): or invalid?
42
43
36.6k
  int num_properties = 0;
44
179k
  for (auto node : tree) {
45
179k
    if (node.property >= num_properties) {
46
3.71k
      num_properties = node.property + 1;
47
3.71k
    }
48
179k
  }
49
50
36.6k
  std::vector<std::pair<pixel_type, pixel_type>> property_ranges(
51
36.6k
      num_properties);
52
65.3k
  for (int i = 0; i < num_properties; i++) {
53
28.6k
    property_ranges[i].first = std::numeric_limits<pixel_type>::min();
54
28.6k
    property_ranges[i].second = std::numeric_limits<pixel_type>::max();
55
28.6k
  }
56
57
36.6k
  constexpr size_t kHeightLimit = 2048;
58
59
36.6k
  std::vector<WorkItem> stack;
60
36.6k
  stack.push_back({/*node_index=*/0, /*orig_l=*/0, /*orig_u=*/0,
61
36.6k
                   NextAction::CHECK_AND_GO_LEFT});
62
63
264k
  while (!stack.empty()) {
64
228k
    if (stack.size() >= kHeightLimit) return JXL_FAILURE("Tree too tall");
65
228k
    WorkItem& item = stack.back();
66
228k
    const auto& node = tree[item.node_index];
67
228k
    switch (item.action) {
68
132k
      case NextAction::CHECK_AND_GO_LEFT: {
69
132k
        int16_t p = node.property;
70
132k
        if (p == -1) {
71
84.5k
          stack.pop_back();
72
84.5k
          continue;
73
84.5k
        }
74
47.8k
        PropertyVal v = node.splitval;
75
47.8k
        pixel_type l = property_ranges[p].first;
76
47.8k
        pixel_type u = property_ranges[p].second;
77
47.8k
        if (l > v || u <= v) {
78
10
          return JXL_FAILURE("Invalid tree");
79
10
        }
80
47.8k
        item.orig_l = l;
81
47.8k
        item.orig_u = u;
82
47.8k
        item.action = NextAction::GO_RIGHT;
83
47.8k
        property_ranges[node.property].first = node.splitval + 1;
84
47.8k
        stack.push_back({/*node_index=*/node.lchild,
85
47.8k
                         /*orig_l=*/0, /*orig_u=*/0,
86
47.8k
                         NextAction::CHECK_AND_GO_LEFT});
87
47.8k
        continue;
88
47.8k
      }
89
90
47.8k
      case NextAction::GO_RIGHT:
91
47.8k
        item.action = NextAction::POP;
92
47.8k
        property_ranges[node.property].first = item.orig_l;
93
47.8k
        property_ranges[node.property].second = node.splitval;
94
47.8k
        stack.push_back({/*node_index=*/node.rchild,
95
47.8k
                         /*orig_l=*/0, /*orig_u=*/0,
96
47.8k
                         NextAction::CHECK_AND_GO_LEFT});
97
47.8k
        continue;
98
99
47.8k
      case NextAction::POP:
100
47.8k
        property_ranges[node.property].second = item.orig_u;
101
47.8k
        stack.pop_back();
102
47.8k
        continue;
103
228k
    }
104
228k
  }
105
106
36.6k
  return true;
107
36.6k
}
108
109
Status DecodeTree(BitReader* br, ANSSymbolReader* reader,
110
                  const std::vector<uint8_t>& context_map, Tree* tree,
111
36.7k
                  size_t tree_size_limit) {
112
36.7k
  size_t leaf_id = 0;
113
36.7k
  size_t to_decode = 1;
114
36.7k
  tree->clear();
115
553k
  while (to_decode > 0) {
116
516k
    JXL_RETURN_IF_ERROR(br->AllReadsWithinBounds());
117
516k
    if (tree->size() > tree_size_limit) {
118
9
      return JXL_FAILURE("Tree is too large: %" PRIuS " nodes vs %" PRIuS
119
9
                         " max nodes",
120
9
                         tree->size(), tree_size_limit);
121
9
    }
122
516k
    to_decode--;
123
516k
    uint32_t prop1 = reader->ReadHybridUint(kPropertyContext, br, context_map);
124
516k
    if (prop1 > 256) return JXL_FAILURE("Invalid tree property value");
125
516k
    int property = prop1 - 1;
126
516k
    if (property == -1) {
127
170k
      size_t predictor =
128
170k
          reader->ReadHybridUint(kPredictorContext, br, context_map);
129
170k
      if (predictor >= kNumModularPredictors) {
130
5
        return JXL_FAILURE("Invalid predictor");
131
5
      }
132
170k
      int64_t predictor_offset =
133
170k
          UnpackSigned(reader->ReadHybridUint(kOffsetContext, br, context_map));
134
170k
      uint32_t mul_log =
135
170k
          reader->ReadHybridUint(kMultiplierLogContext, br, context_map);
136
170k
      if (mul_log >= 31) {
137
3
        return JXL_FAILURE("Invalid multiplier logarithm");
138
3
      }
139
170k
      uint32_t mul_bits =
140
170k
          reader->ReadHybridUint(kMultiplierBitsContext, br, context_map);
141
170k
      if (mul_bits >= (1u << (31u - mul_log)) - 1u) {
142
1
        return JXL_FAILURE("Invalid multiplier");
143
1
      }
144
170k
      uint32_t multiplier = (mul_bits + 1U) << mul_log;
145
170k
      Predictor p = static_cast<Predictor>(static_cast<uint32_t>(predictor));
146
170k
      tree->emplace_back(-1, 0, static_cast<int>(leaf_id), 0, p,
147
170k
                         predictor_offset, multiplier);
148
170k
      leaf_id++;
149
170k
      continue;
150
170k
    }
151
346k
    int splitval =
152
346k
        UnpackSigned(reader->ReadHybridUint(kSplitValContext, br, context_map));
153
346k
    tree->emplace_back(
154
346k
        property, splitval, static_cast<int>(tree->size() + to_decode + 1),
155
346k
        static_cast<int>(tree->size() + to_decode + 2), Predictor::Zero, 0, 1);
156
346k
    to_decode += 2;
157
346k
  }
158
36.6k
  return ValidateTree(*tree);
159
36.7k
}
160
}  // namespace
161
162
Status DecodeTree(JxlMemoryManager* memory_manager, BitReader* br, Tree* tree,
163
37.0k
                  size_t tree_size_limit) {
164
37.0k
  std::vector<uint8_t> tree_context_map;
165
37.0k
  ANSCode tree_code;
166
37.0k
  JXL_RETURN_IF_ERROR(DecodeHistograms(memory_manager, br, kNumTreeContexts,
167
37.0k
                                       &tree_code, &tree_context_map));
168
  // TODO(eustas): investigate more infinite tree cases.
169
36.7k
  if (tree_code.degenerate_symbols[tree_context_map[kPropertyContext]] > 0) {
170
6
    return JXL_FAILURE("Infinite tree");
171
6
  }
172
73.5k
  JXL_ASSIGN_OR_RETURN(ANSSymbolReader reader,
173
73.5k
                       ANSSymbolReader::Create(&tree_code, br));
174
73.5k
  JXL_RETURN_IF_ERROR(DecodeTree(br, &reader, tree_context_map, tree,
175
73.5k
                                 std::min(tree_size_limit, kMaxTreeSize)));
176
36.6k
  if (!reader.CheckANSFinalState()) {
177
0
    return JXL_FAILURE("ANS decode final state failed");
178
0
  }
179
36.6k
  return true;
180
36.6k
}
181
182
}  // namespace jxl