Coverage Report

Created: 2025-06-16 07:00

/src/libjxl/lib/jxl/decode_to_jpeg.h
Line
Count
Source (jump to first uncovered line)
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
#ifndef LIB_JXL_DECODE_TO_JPEG_H_
7
#define LIB_JXL_DECODE_TO_JPEG_H_
8
9
// JPEG XL to JPEG bytes decoder logic. The JxlToJpegDecoder class keeps track
10
// of the decoder state needed to parse the JPEG reconstruction box and provide
11
// the reconstructed JPEG to the output buffer.
12
13
#include <jxl/decode.h>
14
#include <stdint.h>
15
#include <stdlib.h>
16
17
#include <algorithm>
18
#include <cstring>
19
#include <memory>
20
#include <utility>
21
#include <vector>
22
23
#include "lib/jxl/base/status.h"
24
#include "lib/jxl/common.h"  // JPEGXL_ENABLE_TRANSCODE_JPEG
25
#include "lib/jxl/image_bundle.h"
26
#include "lib/jxl/jpeg/jpeg_data.h"
27
#if JPEGXL_ENABLE_TRANSCODE_JPEG
28
#include "lib/jxl/jpeg/dec_jpeg_data_writer.h"
29
#endif  // JPEGXL_ENABLE_TRANSCODE_JPEG
30
31
namespace jxl {
32
33
#if JPEGXL_ENABLE_TRANSCODE_JPEG
34
35
class JxlToJpegDecoder {
36
 public:
37
  // Returns whether an output buffer is set.
38
92.1k
  bool IsOutputSet() const { return next_out_ != nullptr; }
39
40
  // Returns whether the decoder is parsing a boxa JPEG box was parsed.
41
0
  bool IsParsingBox() const { return inside_box_; }
42
43
  // Sets the output buffer used when producing JPEG output.
44
0
  JxlDecoderStatus SetOutputBuffer(uint8_t* data, size_t size) {
45
0
    if (next_out_) return JXL_DEC_ERROR;
46
0
    next_out_ = data;
47
0
    avail_size_ = size;
48
0
    return JXL_DEC_SUCCESS;
49
0
  }
50
51
  // Releases the buffer set with SetOutputBuffer().
52
0
  size_t ReleaseOutputBuffer() {
53
0
    size_t result = avail_size_;
54
0
    next_out_ = nullptr;
55
0
    avail_size_ = 0;
56
0
    return result;
57
0
  }
58
59
0
  void StartBox(bool box_until_eof, size_t contents_size) {
60
    // A new box implies that we clear the buffer.
61
0
    buffer_.clear();
62
0
    inside_box_ = true;
63
0
    if (box_until_eof) {
64
0
      box_until_eof_ = true;
65
0
    } else {
66
0
      box_size_ = contents_size;
67
0
    }
68
0
  }
69
70
  // Consumes data from next_in/avail_in to reconstruct JPEG data.
71
  // Uses box_size_, inside_box_ and box_until_eof_ to calculate how much to
72
  // consume. Potentially stores unparsed data in buffer_.
73
  // Potentially populates jpeg_data_. Potentially updates inside_box_.
74
  // Returns JXL_DEC_JPEG_RECONSTRUCTION when finished, JXL_DEC_NEED_MORE_INPUT
75
  // if more input is needed, JXL_DEC_ERROR on parsing error.
76
  JxlDecoderStatus Process(const uint8_t** next_in, size_t* avail_in);
77
78
  // Returns non-owned copy of the JPEGData, only after Process finished and
79
  // the JPEGData was not yet moved to an image bundle with
80
  // SetImageBundleJpegData.
81
0
  jpeg::JPEGData* GetJpegData() { return jpeg_data_.get(); }
82
83
  // Returns how many exif or xmp app markers are present in the JPEG data. A
84
  // return value higher than 1 would require multiple exif boxes or multiple
85
  // xmp boxes in the container format, and this is not supported by the API and
86
  // considered an error. May only be called after Process returned success.
87
  static size_t NumExifMarkers(const jpeg::JPEGData& jpeg_data);
88
  static size_t NumXmpMarkers(const jpeg::JPEGData& jpeg_data);
89
90
  // Returns box content size for metadata, using the known data from the app
91
  // markers.
92
  static JxlDecoderStatus ExifBoxContentSize(const jpeg::JPEGData& jpeg_data,
93
                                             size_t* size);
94
  static JxlDecoderStatus XmlBoxContentSize(const jpeg::JPEGData& jpeg_data,
95
                                            size_t* size);
96
97
  // Returns JXL_DEC_ERROR if there is no exif/XMP marker or the data size
98
  // does not match, or this function is called before Process returned
99
  // success, JXL_DEC_SUCCESS otherwise. As input, provide the full box contents
100
  // but not the box header. In case of exif, this includes the 4-byte TIFF
101
  // header, even though it won't be copied into the JPEG.
102
  static JxlDecoderStatus SetExif(const uint8_t* data, size_t size,
103
                                  jpeg::JPEGData* jpeg_data);
104
  static JxlDecoderStatus SetXmp(const uint8_t* data, size_t size,
105
                                 jpeg::JPEGData* jpeg_data);
106
107
  // Sets the JpegData of the ImageBundle passed if there is anything to set.
108
  // Releases the JpegData from this decoder if set.
109
45.2k
  Status SetImageBundleJpegData(ImageBundle* ib) {
110
45.2k
    if (IsOutputSet() && jpeg_data_ != nullptr) {
111
0
      if (!jpeg::SetJPEGDataFromICC(ib->metadata()->color_encoding.ICC(),
112
0
                                    jpeg_data_.get())) {
113
0
        return false;
114
0
      }
115
0
      ib->jpeg_data = std::move(jpeg_data_);
116
0
    }
117
45.2k
    return true;
118
45.2k
  }
119
120
0
  JxlDecoderStatus WriteOutput(const jpeg::JPEGData& jpeg_data) {
121
    // Copy JPEG bytestream if desired.
122
0
    uint8_t* tmp_next_out = next_out_;
123
0
    size_t tmp_avail_size = avail_size_;
124
0
    auto write = [&tmp_next_out, &tmp_avail_size](const uint8_t* buf,
125
0
                                                  size_t len) {
126
0
      size_t to_write = std::min<size_t>(tmp_avail_size, len);
127
0
      if (to_write != 0) memcpy(tmp_next_out, buf, to_write);
128
0
      tmp_next_out += to_write;
129
0
      tmp_avail_size -= to_write;
130
0
      return to_write;
131
0
    };
132
0
    Status write_result = jpeg::WriteJpeg(jpeg_data, write);
133
0
    if (!write_result) {
134
0
      if (tmp_avail_size == 0) {
135
0
        return JXL_DEC_JPEG_NEED_MORE_OUTPUT;
136
0
      }
137
0
      return JXL_DEC_ERROR;
138
0
    }
139
0
    next_out_ = tmp_next_out;
140
0
    avail_size_ = tmp_avail_size;
141
0
    return JXL_DEC_SUCCESS;
142
0
  }
143
144
 private:
145
  // Content of the most recently parsed JPEG reconstruction box if any.
146
  std::vector<uint8_t> buffer_;
147
148
  // Decoded content of the most recently parsed JPEG reconstruction box is
149
  // stored here.
150
  std::unique_ptr<jpeg::JPEGData> jpeg_data_;
151
152
  // True if the decoder is currently reading bytes inside a JPEG reconstruction
153
  // box.
154
  bool inside_box_ = false;
155
156
  // True if the JPEG reconstruction box had undefined size (all remaining
157
  // bytes).
158
  bool box_until_eof_ = false;
159
  // Size of most recently parsed JPEG reconstruction box contents.
160
  size_t box_size_ = 0;
161
162
  // Next bytes to write JPEG reconstruction to.
163
  uint8_t* next_out_ = nullptr;
164
  // Available bytes to write JPEG reconstruction to.
165
  size_t avail_size_ = 0;
166
};
167
168
#else
169
170
// Fake class that disables support for decoding JPEG XL to JPEG.
171
class JxlToJpegDecoder {
172
 public:
173
  bool IsOutputSet() const { return false; }
174
  bool IsParsingBox() const { return false; }
175
176
  JxlDecoderStatus SetOutputBuffer(uint8_t* /* data */, size_t /* size */) {
177
    return JXL_DEC_ERROR;
178
  }
179
  size_t ReleaseOutputBuffer() { return 0; }
180
181
  void StartBox(bool /* box_until_eof */, size_t /* contents_size */) {}
182
183
  JxlDecoderStatus Process(const uint8_t** next_in, size_t* avail_in) {
184
    return JXL_DEC_ERROR;
185
  }
186
  jpeg::JPEGData* GetJpegData() { return nullptr; }
187
188
  Status SetImageBundleJpegData(ImageBundle* /* ib */) { return true; }
189
190
  static size_t NumExifMarkers(const jpeg::JPEGData& /*jpeg_data*/) {
191
    return 0;
192
  }
193
  static size_t NumXmpMarkers(const jpeg::JPEGData& /*jpeg_data*/) { return 0; }
194
  static size_t ExifBoxContentSize(const jpeg::JPEGData& /*jpeg_data*/,
195
                                   size_t* /*size*/) {
196
    return JXL_DEC_ERROR;
197
  }
198
  static size_t XmlBoxContentSize(const jpeg::JPEGData& /*jpeg_data*/,
199
                                  size_t* /*size*/) {
200
    return JXL_DEC_ERROR;
201
  }
202
  static JxlDecoderStatus SetExif(const uint8_t* /*data*/, size_t /*size*/,
203
                                  jpeg::JPEGData* /*jpeg_data*/) {
204
    return JXL_DEC_ERROR;
205
  }
206
  static JxlDecoderStatus SetXmp(const uint8_t* /*data*/, size_t /*size*/,
207
                                 jpeg::JPEGData* /*jpeg_data*/) {
208
    return JXL_DEC_ERROR;
209
  }
210
211
  JxlDecoderStatus WriteOutput(const jpeg::JPEGData& /* jpeg_data */) {
212
    return JXL_DEC_SUCCESS;
213
  }
214
};
215
216
#endif  // JPEGXL_ENABLE_TRANSCODE_JPEG
217
218
}  // namespace jxl
219
220
#endif  // LIB_JXL_DECODE_TO_JPEG_H_