xref: /aosp_15_r20/external/skia/include/codec/SkJpegDecoder.h (revision c8dee2aa9b3f27cf6c858bd81872bdeb2c07ed17)
1*c8dee2aaSAndroid Build Coastguard Worker /*
2*c8dee2aaSAndroid Build Coastguard Worker  * Copyright 2023 Google LLC
3*c8dee2aaSAndroid Build Coastguard Worker  *
4*c8dee2aaSAndroid Build Coastguard Worker  * Use of this source code is governed by a BSD-style license that can be
5*c8dee2aaSAndroid Build Coastguard Worker  * found in the LICENSE file.
6*c8dee2aaSAndroid Build Coastguard Worker  */
7*c8dee2aaSAndroid Build Coastguard Worker #ifndef SkJpegDecoder_DEFINED
8*c8dee2aaSAndroid Build Coastguard Worker #define SkJpegDecoder_DEFINED
9*c8dee2aaSAndroid Build Coastguard Worker 
10*c8dee2aaSAndroid Build Coastguard Worker #include "include/codec/SkCodec.h"
11*c8dee2aaSAndroid Build Coastguard Worker #include "include/core/SkRefCnt.h"
12*c8dee2aaSAndroid Build Coastguard Worker #include "include/private/base/SkAPI.h"
13*c8dee2aaSAndroid Build Coastguard Worker 
14*c8dee2aaSAndroid Build Coastguard Worker class SkData;
15*c8dee2aaSAndroid Build Coastguard Worker class SkStream;
16*c8dee2aaSAndroid Build Coastguard Worker 
17*c8dee2aaSAndroid Build Coastguard Worker #include <memory>
18*c8dee2aaSAndroid Build Coastguard Worker 
19*c8dee2aaSAndroid Build Coastguard Worker namespace SkJpegDecoder {
20*c8dee2aaSAndroid Build Coastguard Worker 
21*c8dee2aaSAndroid Build Coastguard Worker /** Returns true if this data claims to be a JPEG image. */
22*c8dee2aaSAndroid Build Coastguard Worker SK_API bool IsJpeg(const void*, size_t);
23*c8dee2aaSAndroid Build Coastguard Worker 
24*c8dee2aaSAndroid Build Coastguard Worker /**
25*c8dee2aaSAndroid Build Coastguard Worker  *  Attempts to decode the given bytes as a JPEG.
26*c8dee2aaSAndroid Build Coastguard Worker  *
27*c8dee2aaSAndroid Build Coastguard Worker  *  If the bytes are not a JPEG, returns nullptr.
28*c8dee2aaSAndroid Build Coastguard Worker  *
29*c8dee2aaSAndroid Build Coastguard Worker  *  DecodeContext is ignored
30*c8dee2aaSAndroid Build Coastguard Worker  */
31*c8dee2aaSAndroid Build Coastguard Worker SK_API std::unique_ptr<SkCodec> Decode(std::unique_ptr<SkStream>,
32*c8dee2aaSAndroid Build Coastguard Worker                                        SkCodec::Result*,
33*c8dee2aaSAndroid Build Coastguard Worker                                        SkCodecs::DecodeContext = nullptr);
34*c8dee2aaSAndroid Build Coastguard Worker SK_API std::unique_ptr<SkCodec> Decode(sk_sp<SkData>,
35*c8dee2aaSAndroid Build Coastguard Worker                                        SkCodec::Result*,
36*c8dee2aaSAndroid Build Coastguard Worker                                        SkCodecs::DecodeContext = nullptr);
37*c8dee2aaSAndroid Build Coastguard Worker 
Decoder()38*c8dee2aaSAndroid Build Coastguard Worker inline constexpr SkCodecs::Decoder Decoder() {
39*c8dee2aaSAndroid Build Coastguard Worker     return { "jpeg", IsJpeg, Decode };
40*c8dee2aaSAndroid Build Coastguard Worker }
41*c8dee2aaSAndroid Build Coastguard Worker 
42*c8dee2aaSAndroid Build Coastguard Worker }  // namespace SkJpegDecoder
43*c8dee2aaSAndroid Build Coastguard Worker 
44*c8dee2aaSAndroid Build Coastguard Worker #endif  // SkJpegDecoder_DEFINED
45