Coverage Report

Created: 2025-12-03 07:28

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libjxl/lib/jxl/enc_context_map.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
// Library to encode the context map.
7
8
#include "lib/jxl/enc_context_map.h"
9
10
#include <jxl/memory_manager.h>
11
#include <jxl/types.h>
12
13
#include <algorithm>
14
#include <cstddef>
15
#include <cstdint>
16
#include <vector>
17
18
#include "lib/jxl/ac_context.h"
19
#include "lib/jxl/base/bits.h"
20
#include "lib/jxl/base/status.h"
21
#include "lib/jxl/enc_ans.h"
22
#include "lib/jxl/enc_ans_params.h"
23
#include "lib/jxl/enc_aux_out.h"
24
#include "lib/jxl/entropy_coder.h"
25
#include "lib/jxl/fields.h"
26
#include "lib/jxl/pack_signed.h"
27
28
namespace jxl {
29
30
namespace {
31
32
14.4M
size_t IndexOf(const std::vector<uint8_t>& v, uint8_t value) {
33
14.4M
  size_t i = 0;
34
34.8M
  for (; i < v.size(); ++i) {
35
34.8M
    if (v[i] == value) return i;
36
34.8M
  }
37
0
  return i;
38
14.4M
}
39
40
14.4M
void MoveToFront(std::vector<uint8_t>* v, size_t index) {
41
14.4M
  uint8_t value = (*v)[index];
42
34.8M
  for (size_t i = index; i != 0; --i) {
43
20.3M
    (*v)[i] = (*v)[i - 1];
44
20.3M
  }
45
14.4M
  (*v)[0] = value;
46
14.4M
}
47
48
16.9k
std::vector<uint8_t> MoveToFrontTransform(const std::vector<uint8_t>& v) {
49
16.9k
  if (v.empty()) return v;
50
16.9k
  uint8_t max_value = *std::max_element(v.begin(), v.end());
51
16.9k
  std::vector<uint8_t> mtf(max_value + 1);
52
218k
  for (size_t i = 0; i <= max_value; ++i) mtf[i] = i;
53
16.9k
  std::vector<uint8_t> result(v.size());
54
14.5M
  for (size_t i = 0; i < v.size(); ++i) {
55
14.4M
    size_t index = IndexOf(mtf, v[i]);
56
14.4M
    JXL_DASSERT(index < mtf.size());
57
14.4M
    result[i] = static_cast<uint8_t>(index);
58
14.4M
    MoveToFront(&mtf, index);
59
14.4M
  }
60
16.9k
  return result;
61
16.9k
}
62
63
}  // namespace
64
65
Status EncodeContextMap(const std::vector<uint8_t>& context_map,
66
                        size_t num_histograms, BitWriter* writer,
67
24.3k
                        LayerType layer, AuxOut* aux_out) {
68
24.3k
  if (num_histograms == 1) {
69
    // Simple code
70
7.43k
    writer->Write(1, 1);
71
    // 0 bits per entry.
72
7.43k
    writer->Write(2, 0);
73
7.43k
    return true;
74
7.43k
  }
75
76
16.9k
  JxlMemoryManager* memory_manager = writer->memory_manager();
77
16.9k
  std::vector<uint8_t> transformed_symbols = MoveToFrontTransform(context_map);
78
16.9k
  std::vector<std::vector<Token>> tokens(1);
79
16.9k
  std::vector<std::vector<Token>> mtf_tokens(1);
80
14.4M
  for (const uint8_t& ctx : context_map) {
81
14.4M
    tokens[0].emplace_back(0, ctx);
82
14.4M
  }
83
14.4M
  for (const uint8_t& sym : transformed_symbols) {
84
14.4M
    mtf_tokens[0].emplace_back(0, sym);
85
14.4M
  }
86
16.9k
  HistogramParams params;
87
16.9k
  params.uint_method = HistogramParams::HybridUintMethod::kContextMap;
88
16.9k
  size_t ans_cost;
89
16.9k
  size_t mtf_cost;
90
16.9k
  {
91
16.9k
    EntropyEncodingData codes;
92
16.9k
    JXL_ASSIGN_OR_RETURN(
93
16.9k
        ans_cost, BuildAndEncodeHistograms(memory_manager, params, 1, tokens,
94
16.9k
                                           &codes, nullptr, LayerType::Header,
95
16.9k
                                           /*aux_out*/ nullptr));
96
16.9k
  }
97
0
  {
98
16.9k
    EntropyEncodingData codes;
99
16.9k
    JXL_ASSIGN_OR_RETURN(
100
16.9k
        mtf_cost, BuildAndEncodeHistograms(
101
16.9k
                      memory_manager, params, 1, mtf_tokens, &codes, nullptr,
102
16.9k
                      LayerType::Header, /*aux_out*/ nullptr));
103
16.9k
  }
104
0
  bool use_mtf = mtf_cost < ans_cost;
105
  // Rebuild token list.
106
16.9k
  tokens[0].clear();
107
14.5M
  for (size_t i = 0; i < transformed_symbols.size(); i++) {
108
14.4M
    tokens[0].emplace_back(0,
109
14.4M
                           use_mtf ? transformed_symbols[i] : context_map[i]);
110
14.4M
  }
111
16.9k
  size_t entry_bits = CeilLog2Nonzero(num_histograms);
112
16.9k
  size_t simple_cost = entry_bits * context_map.size();
113
16.9k
  if (entry_bits < 4 && simple_cost < ans_cost && simple_cost < mtf_cost) {
114
8.42k
    JXL_RETURN_IF_ERROR(writer->WithMaxBits(
115
8.42k
        3 + entry_bits * context_map.size(), layer, aux_out, [&] {
116
8.42k
          writer->Write(1, 1);
117
8.42k
          writer->Write(2, entry_bits);
118
8.42k
          for (uint8_t entry : context_map) {
119
8.42k
            writer->Write(entry_bits, entry);
120
8.42k
          }
121
8.42k
          return true;
122
8.42k
        }));
123
8.51k
  } else {
124
8.51k
    JXL_RETURN_IF_ERROR(writer->WithMaxBits(
125
8.51k
        2 + tokens[0].size() * 24, layer, aux_out, [&]() -> Status {
126
8.51k
          writer->Write(1, 0);
127
8.51k
          writer->Write(1, TO_JXL_BOOL(use_mtf));  // Use/don't use MTF.
128
8.51k
          EntropyEncodingData codes;
129
8.51k
          JXL_ASSIGN_OR_RETURN(
130
8.51k
              size_t cost,
131
8.51k
              BuildAndEncodeHistograms(memory_manager, params, 1, tokens,
132
8.51k
                                       &codes, writer, layer, aux_out));
133
8.51k
          (void)cost;
134
8.51k
          WriteTokens(tokens[0], codes, 0, writer);
135
8.51k
          return true;
136
8.51k
        }));
137
8.51k
  }
138
16.9k
  return true;
139
16.9k
}
140
141
Status EncodeBlockCtxMap(const BlockCtxMap& block_ctx_map, BitWriter* writer,
142
3.69k
                         AuxOut* aux_out) {
143
3.69k
  const auto& dct = block_ctx_map.dc_thresholds;
144
3.69k
  const auto& qft = block_ctx_map.qf_thresholds;
145
3.69k
  const auto& ctx_map = block_ctx_map.ctx_map;
146
3.69k
  return writer->WithMaxBits(
147
3.69k
      (dct[0].size() + dct[1].size() + dct[2].size() + qft.size()) * 34 + 1 +
148
3.69k
          4 + 4 + ctx_map.size() * 10 + 1024,
149
3.69k
      LayerType::Ac, aux_out, [&]() -> Status {
150
3.69k
        if (dct[0].empty() && dct[1].empty() && dct[2].empty() && qft.empty() &&
151
3.69k
            ctx_map.size() == 21 &&
152
0
            std::equal(ctx_map.begin(), ctx_map.end(),
153
0
                       BlockCtxMap::kDefaultCtxMap)) {
154
0
          writer->Write(1, 1);  // default
155
0
          return true;
156
0
        }
157
3.69k
        writer->Write(1, 0);
158
11.0k
        for (int j : {0, 1, 2}) {
159
11.0k
          writer->Write(4, dct[j].size());
160
11.0k
          for (int i : dct[j]) {
161
0
            JXL_RETURN_IF_ERROR(
162
0
                U32Coder::Write(kDCThresholdDist, PackSigned(i), writer));
163
0
          }
164
11.0k
        }
165
3.69k
        writer->Write(4, qft.size());
166
3.69k
        for (uint32_t i : qft) {
167
0
          JXL_RETURN_IF_ERROR(U32Coder::Write(kQFThresholdDist, i - 1, writer));
168
0
        }
169
3.69k
        JXL_RETURN_IF_ERROR(EncodeContextMap(ctx_map, block_ctx_map.num_ctxs,
170
3.69k
                                             writer, LayerType::Ac, aux_out));
171
3.69k
        return true;
172
3.69k
      });
173
3.69k
}
174
175
}  // namespace jxl