summaryrefslogtreecommitdiff
path: root/media/libjxl/src/lib/extras/dec/decode.h
blob: 32ec4c6368c2ea1c2ce19e36fb7cfaf833f9b58d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
// Copyright (c) the JPEG XL Project Authors. All rights reserved.
//
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

#ifndef LIB_EXTRAS_DEC_DECODE_H_
#define LIB_EXTRAS_DEC_DECODE_H_

// Facade for image decoders (PNG, PNM, ...).

#include <stddef.h>
#include <stdint.h>

#include <string>

#include "lib/extras/dec/color_hints.h"
#include "lib/jxl/base/compiler_specific.h"
#include "lib/jxl/base/data_parallel.h"
#include "lib/jxl/base/padded_bytes.h"
#include "lib/jxl/base/span.h"
#include "lib/jxl/base/status.h"
#include "lib/jxl/codec_in_out.h"
#include "lib/jxl/field_encodings.h"  // MakeBit

namespace jxl {
namespace extras {

// Codecs supported by CodecInOut::Encode.
enum class Codec : uint32_t {
  kUnknown,  // for CodecFromExtension
  kPNG,
  kPNM,
  kPGX,
  kJPG,
  kGIF,
  kEXR
};

static inline constexpr uint64_t EnumBits(Codec /*unused*/) {
  // Return only fully-supported codecs (kGIF is decode-only).
  return MakeBit(Codec::kPNM)
#if JPEGXL_ENABLE_APNG
         | MakeBit(Codec::kPNG)
#endif
#if JPEGXL_ENABLE_JPEG
         | MakeBit(Codec::kJPG)
#endif
#if JPEGXL_ENABLE_EXR
         | MakeBit(Codec::kEXR)
#endif
      ;
}

// If and only if extension is ".pfm", *bits_per_sample is updated to 32 so
// that Encode() would encode to PFM instead of PPM.
Codec CodecFromExtension(std::string extension,
                         size_t* JXL_RESTRICT bits_per_sample = nullptr);

// Decodes "bytes" and sets io->metadata.m.
// color_space_hint may specify the color space, otherwise, defaults to sRGB.
Status DecodeBytes(Span<const uint8_t> bytes, const ColorHints& color_hints,
                   const SizeConstraints& constraints,
                   extras::PackedPixelFile* ppf, Codec* orig_codec = nullptr);

}  // namespace extras
}  // namespace jxl

#endif  // LIB_EXTRAS_DEC_DECODE_H_