Coverage Report

Created: 2025-11-14 07:32

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libjxl/lib/jxl/dec_patch_dictionary.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_patch_dictionary.h"
7
8
#include <jxl/memory_manager.h>
9
10
#include <algorithm>
11
#include <cstdint>
12
#include <cstdlib>
13
#include <utility>
14
#include <vector>
15
16
#include "lib/jxl/base/printf_macros.h"
17
#include "lib/jxl/base/status.h"
18
#include "lib/jxl/blending.h"
19
#include "lib/jxl/common.h"  // kMaxNumReferenceFrames
20
#include "lib/jxl/dec_ans.h"
21
#include "lib/jxl/dec_bit_reader.h"
22
#include "lib/jxl/image.h"
23
#include "lib/jxl/image_bundle.h"
24
#include "lib/jxl/image_metadata.h"
25
#include "lib/jxl/pack_signed.h"
26
#include "lib/jxl/patch_dictionary_internal.h"
27
28
namespace jxl {
29
30
Status PatchDictionary::Decode(JxlMemoryManager* memory_manager, BitReader* br,
31
                               size_t xsize, size_t ysize,
32
                               size_t num_extra_channels,
33
1.11k
                               bool* uses_extra_channels) {
34
1.11k
  positions_.clear();
35
1.11k
  blendings_stride_ = num_extra_channels + 1;
36
1.11k
  std::vector<uint8_t> context_map;
37
1.11k
  ANSCode code;
38
1.11k
  JXL_RETURN_IF_ERROR(DecodeHistograms(
39
1.11k
      memory_manager, br, kNumPatchDictionaryContexts, &code, &context_map));
40
2.19k
  JXL_ASSIGN_OR_RETURN(ANSSymbolReader decoder,
41
2.19k
                       ANSSymbolReader::Create(&code, br));
42
43
4.11M
  auto read_num = [&](size_t context) -> size_t {
44
4.11M
    size_t r = decoder.ReadHybridUint(context, br, context_map);
45
4.11M
    return r;
46
4.11M
  };
47
48
2.19k
  size_t num_ref_patch = read_num(kNumRefPatchContext);
49
  // Limit max memory usage of patches to about 66 bytes per pixel (assuming 8
50
  // bytes per size_t)
51
2.19k
  const size_t num_pixels = xsize * ysize;
52
2.19k
  const size_t max_ref_patches = 1024 + num_pixels / 4;
53
2.19k
  const size_t max_patches = max_ref_patches * 4;
54
2.19k
  const size_t max_blending_infos = max_patches * 4;
55
2.19k
  if (num_ref_patch > max_ref_patches) {
56
1
    return JXL_FAILURE("Too many patches in dictionary");
57
1
  }
58
59
1.09k
  size_t total_patches = 0;
60
1.09k
  size_t next_size = 1;
61
62
30.3k
  for (size_t id = 0; id < num_ref_patch; id++) {
63
29.3k
    PatchReferencePosition ref_pos;
64
29.3k
    ref_pos.ref = read_num(kReferenceFrameContext);
65
29.3k
    if (ref_pos.ref >= kMaxNumReferenceFrames ||
66
29.3k
        reference_frames_->at(ref_pos.ref).frame->xsize() == 0) {
67
5
      return JXL_FAILURE("Invalid reference frame ID");
68
5
    }
69
29.3k
    if (!reference_frames_->at(ref_pos.ref).ib_is_in_xyb) {
70
2
      return JXL_FAILURE(
71
2
          "Patches cannot use frames saved post color transforms");
72
2
    }
73
29.3k
    const ImageBundle& ib = *reference_frames_->at(ref_pos.ref).frame;
74
29.3k
    ref_pos.x0 = read_num(kPatchReferencePositionContext);
75
29.3k
    ref_pos.y0 = read_num(kPatchReferencePositionContext);
76
29.3k
    ref_pos.xsize = read_num(kPatchSizeContext) + 1;
77
29.3k
    ref_pos.ysize = read_num(kPatchSizeContext) + 1;
78
29.3k
    if (ref_pos.x0 + ref_pos.xsize > ib.xsize()) {
79
3
      return JXL_FAILURE("Invalid position specified in reference frame");
80
3
    }
81
29.3k
    if (ref_pos.y0 + ref_pos.ysize > ib.ysize()) {
82
1
      return JXL_FAILURE("Invalid position specified in reference frame");
83
1
    }
84
29.3k
    size_t id_count = read_num(kPatchCountContext);
85
29.3k
    if (id_count > max_patches) {
86
1
      return JXL_FAILURE("Too many patches in dictionary");
87
1
    }
88
29.3k
    id_count++;
89
29.3k
    total_patches += id_count;
90
29.3k
    if (total_patches > max_patches) {
91
1
      return JXL_FAILURE("Too many patches in dictionary");
92
1
    }
93
29.3k
    if (next_size < total_patches) {
94
6.70k
      next_size *= 2;
95
6.70k
      next_size = std::min<size_t>(next_size, max_patches);
96
6.70k
    }
97
29.3k
    if (next_size * blendings_stride_ > max_blending_infos) {
98
0
      return JXL_FAILURE("Too many patches in dictionary");
99
0
    }
100
29.3k
    positions_.reserve(next_size);
101
29.3k
    blendings_.reserve(next_size * blendings_stride_);
102
29.3k
    bool choose_alpha = (num_extra_channels > 1);
103
1.33M
    for (size_t i = 0; i < id_count; i++) {
104
1.30M
      PatchPosition pos;
105
1.30M
      pos.ref_pos_idx = ref_positions_.size();
106
1.30M
      if (i == 0) {
107
29.3k
        pos.x = read_num(kPatchPositionContext);
108
29.3k
        pos.y = read_num(kPatchPositionContext);
109
1.27M
      } else {
110
1.27M
        ptrdiff_t deltax = UnpackSigned(read_num(kPatchOffsetContext));
111
1.27M
        if (deltax < 0 && static_cast<size_t>(-deltax) > positions_.back().x) {
112
5
          return JXL_FAILURE("Invalid patch: negative x coordinate (%" PRIuS
113
5
                             " base x %" PRIdS " delta x)",
114
5
                             positions_.back().x, deltax);
115
5
        }
116
1.27M
        pos.x = positions_.back().x + deltax;
117
1.27M
        ptrdiff_t deltay = UnpackSigned(read_num(kPatchOffsetContext));
118
1.27M
        if (deltay < 0 && static_cast<size_t>(-deltay) > positions_.back().y) {
119
8
          return JXL_FAILURE("Invalid patch: negative y coordinate (%" PRIuS
120
8
                             " base y %" PRIdS " delta y)",
121
8
                             positions_.back().y, deltay);
122
8
        }
123
1.27M
        pos.y = positions_.back().y + deltay;
124
1.27M
      }
125
1.30M
      if (pos.x + ref_pos.xsize > xsize) {
126
1
        return JXL_FAILURE("Invalid patch x: at %" PRIuS " + %" PRIuS
127
1
                           " > %" PRIuS,
128
1
                           pos.x, ref_pos.xsize, xsize);
129
1
      }
130
1.30M
      if (pos.y + ref_pos.ysize > ysize) {
131
3
        return JXL_FAILURE("Invalid patch y: at %" PRIuS " + %" PRIuS
132
3
                           " > %" PRIuS,
133
3
                           pos.y, ref_pos.ysize, ysize);
134
3
      }
135
2.61M
      for (size_t j = 0; j < blendings_stride_; j++) {
136
1.30M
        uint32_t blend_mode = read_num(kPatchBlendModeContext);
137
1.30M
        if (blend_mode >= kNumPatchBlendModes) {
138
7
          return JXL_FAILURE("Invalid patch blend mode: %u", blend_mode);
139
7
        }
140
1.30M
        PatchBlending info;
141
1.30M
        info.mode = static_cast<PatchBlendMode>(blend_mode);
142
1.30M
        if (UsesAlpha(info.mode)) {
143
14.8k
          *uses_extra_channels = true;
144
14.8k
        }
145
1.30M
        if (info.mode != PatchBlendMode::kNone && j > 0) {
146
1.26k
          *uses_extra_channels = true;
147
1.26k
        }
148
1.30M
        if (UsesAlpha(info.mode) && choose_alpha) {
149
1.01k
          info.alpha_channel = read_num(kPatchAlphaChannelContext);
150
1.01k
          if (info.alpha_channel >= num_extra_channels) {
151
6
            return JXL_FAILURE(
152
6
                "Invalid alpha channel for blending: %u out of %u\n",
153
6
                info.alpha_channel, static_cast<uint32_t>(num_extra_channels));
154
6
          }
155
1.30M
        } else {
156
1.30M
          info.alpha_channel = 0;
157
1.30M
        }
158
1.30M
        if (UsesClamp(info.mode)) {
159
19.9k
          info.clamp = static_cast<bool>(read_num(kPatchClampContext));
160
1.28M
        } else {
161
1.28M
          info.clamp = false;
162
1.28M
        }
163
1.30M
        blendings_.push_back(info);
164
1.30M
      }
165
1.30M
      positions_.emplace_back(pos);
166
1.30M
    }
167
29.2k
    ref_positions_.emplace_back(ref_pos);
168
29.2k
  }
169
1.05k
  positions_.shrink_to_fit();
170
171
1.05k
  if (!decoder.CheckANSFinalState()) {
172
0
    return JXL_FAILURE("ANS checksum failure.");
173
0
  }
174
175
1.05k
  ComputePatchTree();
176
1.05k
  return true;
177
1.05k
}
178
179
834
int PatchDictionary::GetReferences() const {
180
834
  int result = 0;
181
109k
  for (const auto& ref_pos : ref_positions_) {
182
109k
    result |= (1 << static_cast<int>(ref_pos.ref));
183
109k
  }
184
834
  return result;
185
834
}
186
187
namespace {
188
struct PatchInterval {
189
  size_t idx;
190
  size_t y0, y1;
191
};
192
}  // namespace
193
194
38.4k
void PatchDictionary::ComputePatchTree() {
195
38.4k
  patch_tree_.clear();
196
38.4k
  num_patches_.clear();
197
38.4k
  sorted_patches_y0_.clear();
198
38.4k
  sorted_patches_y1_.clear();
199
38.4k
  if (positions_.empty()) {
200
36.7k
    return;
201
36.7k
  }
202
  // Create a y-interval for each patch.
203
1.70k
  std::vector<PatchInterval> intervals(positions_.size());
204
2.89M
  for (size_t i = 0; i < positions_.size(); ++i) {
205
2.89M
    const auto& pos = positions_[i];
206
2.89M
    intervals[i].idx = i;
207
2.89M
    intervals[i].y0 = pos.y;
208
2.89M
    intervals[i].y1 = pos.y + ref_positions_[pos.ref_pos_idx].ysize;
209
2.89M
  }
210
345k
  auto sort_by_y0 = [&intervals](size_t start, size_t end) {
211
345k
    std::sort(intervals.data() + start, intervals.data() + end,
212
94.4M
              [](const PatchInterval& i0, const PatchInterval& i1) {
213
94.4M
                return i0.y0 < i1.y0;
214
94.4M
              });
215
345k
  };
216
174k
  auto sort_by_y1 = [&intervals](size_t start, size_t end) {
217
174k
    std::sort(intervals.data() + start, intervals.data() + end,
218
80.3M
              [](const PatchInterval& i0, const PatchInterval& i1) {
219
80.3M
                return i0.y1 < i1.y1;
220
80.3M
              });
221
174k
  };
222
  // Count the number of patches for each row.
223
1.70k
  sort_by_y1(0, intervals.size());
224
1.70k
  num_patches_.resize(intervals.back().y1);
225
2.89M
  for (auto iv : intervals) {
226
35.7M
    for (size_t y = iv.y0; y < iv.y1; ++y) num_patches_[y]++;
227
2.89M
  }
228
1.70k
  PatchTreeNode root;
229
1.70k
  root.start = 0;
230
1.70k
  root.num = intervals.size();
231
1.70k
  patch_tree_.push_back(root);
232
1.70k
  size_t next = 0;
233
174k
  while (next < patch_tree_.size()) {
234
172k
    auto& node = patch_tree_[next];
235
172k
    size_t start = node.start;
236
172k
    size_t end = node.start + node.num;
237
    // Choose the y_center for this node to be the median of interval starts.
238
172k
    sort_by_y0(start, end);
239
172k
    size_t middle_idx = start + node.num / 2;
240
172k
    node.y_center = intervals[middle_idx].y0;
241
    // Divide the intervals in [start, end) into three groups:
242
    //   * those completely to the right of y_center: [right_start, end)
243
    //   * those overlapping y_center: [left_end, right_start)
244
    //   * those completely to the left of y_center: [start, left_end)
245
172k
    size_t right_start = middle_idx;
246
1.22M
    while (right_start < end && intervals[right_start].y0 == node.y_center) {
247
1.05M
      ++right_start;
248
1.05M
    }
249
172k
    sort_by_y1(start, right_start);
250
172k
    size_t left_end = right_start;
251
3.07M
    while (left_end > start && intervals[left_end - 1].y1 > node.y_center) {
252
2.89M
      --left_end;
253
2.89M
    }
254
    // Fill in sorted_patches_y0_ and sorted_patches_y1_ for the current node.
255
172k
    node.num = right_start - left_end;
256
172k
    node.start = sorted_patches_y0_.size();
257
172k
    for (ptrdiff_t i = static_cast<ptrdiff_t>(right_start) - 1;
258
3.07M
         i >= static_cast<ptrdiff_t>(left_end); --i) {
259
2.89M
      sorted_patches_y1_.emplace_back(intervals[i].y1, intervals[i].idx);
260
2.89M
    }
261
172k
    sort_by_y0(left_end, right_start);
262
3.07M
    for (size_t i = left_end; i < right_start; ++i) {
263
2.89M
      sorted_patches_y0_.emplace_back(intervals[i].y0, intervals[i].idx);
264
2.89M
    }
265
    // Create the left and right nodes (if not empty).
266
172k
    node.left_child = node.right_child = -1;
267
172k
    if (left_end > start) {
268
83.5k
      PatchTreeNode left;
269
83.5k
      left.start = start;
270
83.5k
      left.num = left_end - left.start;
271
83.5k
      patch_tree_[next].left_child = patch_tree_.size();
272
83.5k
      patch_tree_.push_back(left);
273
83.5k
    }
274
172k
    if (right_start < end) {
275
87.3k
      PatchTreeNode right;
276
87.3k
      right.start = right_start;
277
87.3k
      right.num = end - right.start;
278
87.3k
      patch_tree_[next].right_child = patch_tree_.size();
279
87.3k
      patch_tree_.push_back(right);
280
87.3k
    }
281
172k
    ++next;
282
172k
  }
283
1.70k
}
284
285
3.27M
std::vector<size_t> PatchDictionary::GetPatchesForRow(size_t y) const {
286
3.27M
  std::vector<size_t> result;
287
3.27M
  if (y < num_patches_.size() && num_patches_[y] > 0) {
288
1.66M
    result.reserve(num_patches_[y]);
289
13.3M
    for (ptrdiff_t tree_idx = 0; tree_idx != -1;) {
290
11.7M
      JXL_DASSERT(tree_idx < static_cast<ptrdiff_t>(patch_tree_.size()));
291
11.7M
      const auto& node = patch_tree_[tree_idx];
292
11.7M
      if (y <= node.y_center) {
293
27.5M
        for (size_t i = 0; i < node.num; ++i) {
294
26.5M
          const auto& p = sorted_patches_y0_[node.start + i];
295
26.5M
          if (y < p.first) break;
296
21.4M
          result.push_back(p.second);
297
21.4M
        }
298
6.05M
        tree_idx = y < node.y_center ? node.left_child : -1;
299
6.05M
      } else {
300
27.2M
        for (size_t i = 0; i < node.num; ++i) {
301
26.9M
          const auto& p = sorted_patches_y1_[node.start + i];
302
26.9M
          if (y >= p.first) break;
303
21.6M
          result.push_back(p.second);
304
21.6M
        }
305
5.65M
        tree_idx = node.right_child;
306
5.65M
      }
307
11.7M
    }
308
    // Ensure that he relative order of patches that affect the same pixels is
309
    // preserved. This is important for patches that have a blend mode
310
    // different from kAdd.
311
1.66M
    std::sort(result.begin(), result.end());
312
1.66M
  }
313
3.27M
  return result;
314
3.27M
}
315
316
// Adds patches to a segment of `xsize` pixels, starting at `inout`, assumed
317
// to be located at position (x0, y) in the frame.
318
Status PatchDictionary::AddOneRow(
319
    float* const* inout, size_t y, size_t x0, size_t xsize,
320
2.41M
    const std::vector<ExtraChannelInfo>& extra_channel_info) const {
321
2.41M
  size_t num_ec = extra_channel_info.size();
322
2.41M
  JXL_ENSURE(num_ec + 1 <= blendings_stride_);
323
2.41M
  std::vector<const float*> fg_ptrs(3 + num_ec);
324
39.6M
  for (size_t pos_idx : GetPatchesForRow(y)) {
325
39.6M
    const size_t blending_idx = pos_idx * blendings_stride_;
326
39.6M
    const PatchPosition& pos = positions_[pos_idx];
327
39.6M
    const PatchReferencePosition& ref_pos = ref_positions_[pos.ref_pos_idx];
328
39.6M
    size_t by = pos.y;
329
39.6M
    size_t bx = pos.x;
330
39.6M
    size_t patch_xsize = ref_pos.xsize;
331
39.6M
    JXL_ENSURE(y >= by);
332
39.6M
    JXL_ENSURE(y < by + ref_pos.ysize);
333
39.6M
    size_t iy = y - by;
334
39.6M
    size_t ref = ref_pos.ref;
335
39.6M
    if (bx >= x0 + xsize) continue;
336
35.0M
    if (bx + patch_xsize < x0) continue;
337
29.5M
    size_t patch_x0 = std::max(bx, x0);
338
29.5M
    size_t patch_x1 = std::min(bx + patch_xsize, x0 + xsize);
339
118M
    for (size_t c = 0; c < 3; c++) {
340
88.7M
      fg_ptrs[c] = reference_frames_->at(ref).frame->color()->ConstPlaneRow(
341
88.7M
                       c, ref_pos.y0 + iy) +
342
88.7M
                   ref_pos.x0 + x0 - bx;
343
88.7M
    }
344
29.5M
    for (size_t i = 0; i < num_ec; i++) {
345
262
      fg_ptrs[3 + i] =
346
262
          reference_frames_->at(ref).frame->extra_channels()[i].ConstRow(
347
262
              ref_pos.y0 + iy) +
348
262
          ref_pos.x0 + x0 - bx;
349
262
    }
350
29.5M
    JXL_RETURN_IF_ERROR(PerformBlending(
351
29.5M
        memory_manager_, inout, fg_ptrs.data(), inout, patch_x0 - x0,
352
29.5M
        patch_x1 - patch_x0, blendings_[blending_idx],
353
29.5M
        blendings_.data() + blending_idx + 1, extra_channel_info));
354
29.5M
  }
355
2.41M
  return true;
356
2.41M
}
357
}  // namespace jxl