xref: /aosp_15_r20/external/webp/imageio/image_dec.h (revision b2055c353e87c8814eb2b6b1b11112a1562253bd)
1*b2055c35SXin Li // Copyright 2016 Google Inc. All Rights Reserved.
2*b2055c35SXin Li //
3*b2055c35SXin Li // Use of this source code is governed by a BSD-style license
4*b2055c35SXin Li // that can be found in the COPYING file in the root of the source
5*b2055c35SXin Li // tree. An additional intellectual property rights grant can be found
6*b2055c35SXin Li // in the file PATENTS. All contributing project authors may
7*b2055c35SXin Li // be found in the AUTHORS file in the root of the source tree.
8*b2055c35SXin Li // -----------------------------------------------------------------------------
9*b2055c35SXin Li //
10*b2055c35SXin Li //  All-in-one library to decode PNG/JPEG/WebP/TIFF/WIC input images.
11*b2055c35SXin Li //
12*b2055c35SXin Li // Author: Skal ([email protected])
13*b2055c35SXin Li 
14*b2055c35SXin Li #ifndef WEBP_IMAGEIO_IMAGE_DEC_H_
15*b2055c35SXin Li #define WEBP_IMAGEIO_IMAGE_DEC_H_
16*b2055c35SXin Li 
17*b2055c35SXin Li #include "webp/types.h"
18*b2055c35SXin Li 
19*b2055c35SXin Li #ifdef HAVE_CONFIG_H
20*b2055c35SXin Li #include "webp/config.h"
21*b2055c35SXin Li #endif
22*b2055c35SXin Li 
23*b2055c35SXin Li #include "./metadata.h"
24*b2055c35SXin Li #include "./jpegdec.h"
25*b2055c35SXin Li #include "./pngdec.h"
26*b2055c35SXin Li #include "./pnmdec.h"
27*b2055c35SXin Li #include "./tiffdec.h"
28*b2055c35SXin Li #include "./webpdec.h"
29*b2055c35SXin Li #include "./wicdec.h"
30*b2055c35SXin Li 
31*b2055c35SXin Li #ifdef __cplusplus
32*b2055c35SXin Li extern "C" {
33*b2055c35SXin Li #endif
34*b2055c35SXin Li 
35*b2055c35SXin Li typedef enum {
36*b2055c35SXin Li   WEBP_PNG_FORMAT = 0,
37*b2055c35SXin Li   WEBP_JPEG_FORMAT,
38*b2055c35SXin Li   WEBP_TIFF_FORMAT,
39*b2055c35SXin Li   WEBP_WEBP_FORMAT,
40*b2055c35SXin Li   WEBP_PNM_FORMAT,
41*b2055c35SXin Li   WEBP_UNSUPPORTED_FORMAT
42*b2055c35SXin Li } WebPInputFileFormat;
43*b2055c35SXin Li 
44*b2055c35SXin Li // Returns a comma separated list of enabled input formats.
45*b2055c35SXin Li const char* WebPGetEnabledInputFileFormats(void);
46*b2055c35SXin Li 
47*b2055c35SXin Li // Try to infer the image format. 'data_size' should be larger than 12.
48*b2055c35SXin Li // Returns WEBP_UNSUPPORTED_FORMAT if format can't be guess safely.
49*b2055c35SXin Li WebPInputFileFormat WebPGuessImageType(const uint8_t* const data,
50*b2055c35SXin Li                                        size_t data_size);
51*b2055c35SXin Li 
52*b2055c35SXin Li // Signature for common image-reading functions (ReadPNG, ReadJPEG, ...)
53*b2055c35SXin Li typedef int (*WebPImageReader)(const uint8_t* const data, size_t data_size,
54*b2055c35SXin Li                                struct WebPPicture* const pic,
55*b2055c35SXin Li                                int keep_alpha, struct Metadata* const metadata);
56*b2055c35SXin Li 
57*b2055c35SXin Li // Return the reader associated to a given file format.
58*b2055c35SXin Li WebPImageReader WebPGetImageReader(WebPInputFileFormat format);
59*b2055c35SXin Li 
60*b2055c35SXin Li // This function is similar to WebPGuessImageType(), but returns a
61*b2055c35SXin Li // suitable reader function. The returned reader is never NULL, but
62*b2055c35SXin Li // unknown formats will return an always-failing valid reader.
63*b2055c35SXin Li WebPImageReader WebPGuessImageReader(const uint8_t* const data,
64*b2055c35SXin Li                                      size_t data_size);
65*b2055c35SXin Li 
66*b2055c35SXin Li #ifdef __cplusplus
67*b2055c35SXin Li }    // extern "C"
68*b2055c35SXin Li #endif
69*b2055c35SXin Li 
70*b2055c35SXin Li #endif  // WEBP_IMAGEIO_IMAGE_DEC_H_
71