Coverage Report

Created: 2026-09-13 07:02

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libjxl/lib/jxl/headers.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/headers.h"
7
8
#include <cstddef>
9
#include <cstdint>
10
#include <limits>
11
12
#include "lib/jxl/base/compiler_specific.h"
13
#include "lib/jxl/base/status.h"
14
#include "lib/jxl/dec_bit_reader.h"
15
#include "lib/jxl/field_encodings.h"
16
#include "lib/jxl/fields.h"
17
#include "lib/jxl/frame_dimensions.h"
18
19
namespace jxl {
20
namespace {
21
22
struct Rational {
23
  constexpr explicit Rational(uint32_t num, uint32_t den)
24
0
      : num(num), den(den) {}
25
26
  // Returns floor(multiplicand * rational).
27
162k
  constexpr uint32_t MulTruncate(uint32_t multiplicand) const {
28
162k
    return static_cast<uint64_t>(multiplicand) * num / den;
29
162k
  }
30
31
  uint32_t num;
32
  uint32_t den;
33
};
34
35
162k
Rational FixedAspectRatios(uint32_t ratio) {
36
162k
  JXL_DASSERT(0 != ratio && ratio < 8);
37
  // Other candidates: 5/4, 7/5, 14/9, 16/10, 5/3, 21/9, 12/5
38
162k
  constexpr Rational kRatios[7] = {Rational(1, 1),    // square
39
162k
                                   Rational(12, 10),  //
40
162k
                                   Rational(4, 3),    // camera
41
162k
                                   Rational(3, 2),    // mobile camera
42
162k
                                   Rational(16, 9),   // camera/display
43
162k
                                   Rational(5, 4),    //
44
162k
                                   Rational(2, 1)};   //
45
162k
  return kRatios[ratio - 1];
46
162k
}
47
48
2.95k
uint32_t FindAspectRatio(uint32_t xsize, uint32_t ysize) {
49
21.4k
  for (uint32_t r = 1; r < 8; ++r) {
50
18.9k
    if (xsize == FixedAspectRatios(r).MulTruncate(ysize)) {
51
461
      return r;
52
461
    }
53
18.9k
  }
54
2.49k
  return 0;  // Must send xsize instead
55
2.95k
}
56
57
}  // namespace
58
59
360k
size_t SizeHeader::xsize() const {
60
360k
  if (ratio_ != 0) {
61
143k
    return FixedAspectRatios(ratio_).MulTruncate(
62
143k
        static_cast<uint32_t>(ysize()));
63
143k
  }
64
217k
  return small_ ? ((xsize_div8_minus_1_ + 1) * 8) : xsize_;
65
360k
}
66
67
3.04k
Status SizeHeader::Set(size_t xsize64, size_t ysize64) {
68
3.04k
  constexpr size_t kDimensionCap = std::numeric_limits<uint32_t>::max();
69
3.04k
  if (xsize64 > kDimensionCap || ysize64 > kDimensionCap) {
70
0
    return JXL_FAILURE("Image too large");
71
0
  }
72
3.04k
  const uint32_t xsize32 = static_cast<uint32_t>(xsize64);
73
3.04k
  const uint32_t ysize32 = static_cast<uint32_t>(ysize64);
74
3.04k
  if (xsize64 == 0 || ysize64 == 0) return JXL_FAILURE("Empty image");
75
2.95k
  ratio_ = FindAspectRatio(xsize32, ysize32);
76
2.95k
  small_ = ysize64 <= 256 && (ysize64 % kBlockDim) == 0 &&
77
1.41k
           (ratio_ != 0 || (xsize64 <= 256 && (xsize64 % kBlockDim) == 0));
78
2.95k
  if (small_) {
79
1.37k
    ysize_div8_minus_1_ = ysize32 / 8 - 1;
80
1.57k
  } else {
81
1.57k
    ysize_ = ysize32;
82
1.57k
  }
83
84
2.95k
  if (ratio_ == 0) {
85
2.49k
    if (small_) {
86
1.13k
      xsize_div8_minus_1_ = xsize32 / 8 - 1;
87
1.35k
    } else {
88
1.35k
      xsize_ = xsize32;
89
1.35k
    }
90
2.49k
  }
91
2.95k
  JXL_ENSURE(xsize() == xsize64);
92
2.95k
  JXL_ENSURE(ysize() == ysize64);
93
2.95k
  return true;
94
2.95k
}
95
96
0
Status PreviewHeader::Set(size_t xsize64, size_t ysize64) {
97
0
  const uint32_t xsize32 = static_cast<uint32_t>(xsize64);
98
0
  const uint32_t ysize32 = static_cast<uint32_t>(ysize64);
99
0
  if (xsize64 == 0 || ysize64 == 0) return JXL_FAILURE("Empty preview");
100
0
  div8_ = (xsize64 % kBlockDim) == 0 && (ysize64 % kBlockDim) == 0;
101
0
  if (div8_) {
102
0
    ysize_div8_ = ysize32 / 8;
103
0
  } else {
104
0
    ysize_ = ysize32;
105
0
  }
106
107
0
  ratio_ = FindAspectRatio(xsize32, ysize32);
108
0
  if (ratio_ == 0) {
109
0
    if (div8_) {
110
0
      xsize_div8_ = xsize32 / 8;
111
0
    } else {
112
0
      xsize_ = xsize32;
113
0
    }
114
0
  }
115
0
  JXL_ENSURE(xsize() == xsize64);
116
0
  JXL_ENSURE(ysize() == ysize64);
117
0
  return true;
118
0
}
119
120
472
size_t PreviewHeader::xsize() const {
121
472
  if (ratio_ != 0) {
122
353
    return FixedAspectRatios(ratio_).MulTruncate(
123
353
        static_cast<uint32_t>(ysize()));
124
353
  }
125
119
  return div8_ ? (xsize_div8_ * 8) : xsize_;
126
472
}
127
128
105k
SizeHeader::SizeHeader() { Bundle::Init(this); }
129
157k
Status SizeHeader::VisitFields(Visitor* JXL_RESTRICT visitor) {
130
157k
  JXL_QUIET_RETURN_IF_ERROR(visitor->Bool(false, &small_));
131
132
157k
  if (visitor->Conditional(small_)) {
133
146k
    JXL_QUIET_RETURN_IF_ERROR(visitor->Bits(5, 0, &ysize_div8_minus_1_));
134
146k
  }
135
157k
  if (visitor->Conditional(!small_)) {
136
    // (Could still be small, but non-multiple of 8.)
137
130k
    JXL_QUIET_RETURN_IF_ERROR(visitor->U32(BitsOffset(9, 1), BitsOffset(13, 1),
138
130k
                                           BitsOffset(18, 1), BitsOffset(30, 1),
139
130k
                                           1, &ysize_));
140
130k
  }
141
142
157k
  JXL_QUIET_RETURN_IF_ERROR(visitor->Bits(3, 0, &ratio_));
143
157k
  if (visitor->Conditional(ratio_ == 0 && small_)) {
144
134k
    JXL_QUIET_RETURN_IF_ERROR(visitor->Bits(5, 0, &xsize_div8_minus_1_));
145
134k
  }
146
157k
  if (visitor->Conditional(ratio_ == 0 && !small_)) {
147
127k
    JXL_QUIET_RETURN_IF_ERROR(visitor->U32(BitsOffset(9, 1), BitsOffset(13, 1),
148
127k
                                           BitsOffset(18, 1), BitsOffset(30, 1),
149
127k
                                           1, &xsize_));
150
127k
  }
151
152
157k
  return true;
153
157k
}
154
155
60.5k
PreviewHeader::PreviewHeader() { Bundle::Init(this); }
156
75.0k
Status PreviewHeader::VisitFields(Visitor* JXL_RESTRICT visitor) {
157
75.0k
  JXL_QUIET_RETURN_IF_ERROR(visitor->Bool(false, &div8_));
158
159
75.0k
  if (visitor->Conditional(div8_)) {
160
74.8k
    JXL_QUIET_RETURN_IF_ERROR(visitor->U32(Val(16), Val(32), BitsOffset(5, 1),
161
74.8k
                                           BitsOffset(9, 33), 1, &ysize_div8_));
162
74.8k
  }
163
75.0k
  if (visitor->Conditional(!div8_)) {
164
74.7k
    JXL_QUIET_RETURN_IF_ERROR(visitor->U32(BitsOffset(6, 1), BitsOffset(8, 65),
165
74.7k
                                           BitsOffset(10, 321),
166
74.7k
                                           BitsOffset(12, 1345), 1, &ysize_));
167
74.7k
  }
168
169
75.0k
  JXL_QUIET_RETURN_IF_ERROR(visitor->Bits(3, 0, &ratio_));
170
75.0k
  if (visitor->Conditional(ratio_ == 0 && div8_)) {
171
74.6k
    JXL_QUIET_RETURN_IF_ERROR(visitor->U32(Val(16), Val(32), BitsOffset(5, 1),
172
74.6k
                                           BitsOffset(9, 33), 1, &xsize_div8_));
173
74.6k
  }
174
75.0k
  if (visitor->Conditional(ratio_ == 0 && !div8_)) {
175
74.6k
    JXL_QUIET_RETURN_IF_ERROR(visitor->U32(BitsOffset(6, 1), BitsOffset(8, 65),
176
74.6k
                                           BitsOffset(10, 321),
177
74.6k
                                           BitsOffset(12, 1345), 1, &xsize_));
178
74.6k
  }
179
180
75.0k
  return true;
181
75.0k
}
182
183
60.5k
AnimationHeader::AnimationHeader() { Bundle::Init(this); }
184
75.1k
Status AnimationHeader::VisitFields(Visitor* JXL_RESTRICT visitor) {
185
75.1k
  JXL_QUIET_RETURN_IF_ERROR(visitor->U32(Val(100), Val(1000), BitsOffset(10, 1),
186
75.1k
                                         BitsOffset(30, 1), 1, &tps_numerator));
187
75.1k
  JXL_QUIET_RETURN_IF_ERROR(visitor->U32(Val(1), Val(1001), BitsOffset(8, 1),
188
75.1k
                                         BitsOffset(10, 1), 1,
189
75.1k
                                         &tps_denominator));
190
191
75.1k
  JXL_QUIET_RETURN_IF_ERROR(
192
75.1k
      visitor->U32(Val(0), Bits(3), Bits(16), Bits(32), 0, &num_loops));
193
194
75.1k
  JXL_QUIET_RETURN_IF_ERROR(visitor->Bool(false, &have_timecodes));
195
75.1k
  return true;
196
75.1k
}
197
198
Status ReadSizeHeader(BitReader* JXL_RESTRICT reader,
199
0
                      SizeHeader* JXL_RESTRICT size) {
200
0
  return Bundle::Read(reader, size);
201
0
}
202
203
}  // namespace jxl