xref: /aosp_15_r20/external/webp/imageio/image_enc.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 save PNG/JPEG/WebP/TIFF/WIC images.
11*b2055c35SXin Li //
12*b2055c35SXin Li // Author: Skal ([email protected])
13*b2055c35SXin Li 
14*b2055c35SXin Li #ifndef WEBP_IMAGEIO_IMAGE_ENC_H_
15*b2055c35SXin Li #define WEBP_IMAGEIO_IMAGE_ENC_H_
16*b2055c35SXin Li 
17*b2055c35SXin Li #include <stdio.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 "webp/types.h"
24*b2055c35SXin Li #include "webp/decode.h"
25*b2055c35SXin Li 
26*b2055c35SXin Li #ifdef __cplusplus
27*b2055c35SXin Li extern "C" {
28*b2055c35SXin Li #endif
29*b2055c35SXin Li 
30*b2055c35SXin Li // Output types
31*b2055c35SXin Li typedef enum {
32*b2055c35SXin Li   PNG = 0,
33*b2055c35SXin Li   PAM,
34*b2055c35SXin Li   PPM,
35*b2055c35SXin Li   PGM,
36*b2055c35SXin Li   BMP,
37*b2055c35SXin Li   TIFF,
38*b2055c35SXin Li   RAW_YUV,
39*b2055c35SXin Li   ALPHA_PLANE_ONLY,  // this is for experimenting only
40*b2055c35SXin Li   // forced colorspace output (for testing, mostly)
41*b2055c35SXin Li   RGB, RGBA, BGR, BGRA, ARGB,
42*b2055c35SXin Li   RGBA_4444, RGB_565,
43*b2055c35SXin Li   rgbA, bgrA, Argb, rgbA_4444,
44*b2055c35SXin Li   YUV, YUVA
45*b2055c35SXin Li } WebPOutputFileFormat;
46*b2055c35SXin Li 
47*b2055c35SXin Li // General all-purpose call.
48*b2055c35SXin Li // Most formats expect a 'buffer' containing RGBA-like samples, except
49*b2055c35SXin Li // RAW_YUV, YUV and YUVA formats.
50*b2055c35SXin Li // If 'out_file_name' is "-", data is saved to stdout.
51*b2055c35SXin Li // Returns false if an error occurred, true otherwise.
52*b2055c35SXin Li int WebPSaveImage(const WebPDecBuffer* const buffer,
53*b2055c35SXin Li                   WebPOutputFileFormat format, const char* const out_file_name);
54*b2055c35SXin Li 
55*b2055c35SXin Li // Save to PNG.
56*b2055c35SXin Li #ifdef HAVE_WINCODEC_H
57*b2055c35SXin Li int WebPWritePNG(const char* out_file_name, int use_stdout,
58*b2055c35SXin Li                  const struct WebPDecBuffer* const buffer);
59*b2055c35SXin Li #else
60*b2055c35SXin Li int WebPWritePNG(FILE* out_file, const WebPDecBuffer* const buffer);
61*b2055c35SXin Li #endif
62*b2055c35SXin Li 
63*b2055c35SXin Li // Save to PPM format (RGB, no alpha)
64*b2055c35SXin Li int WebPWritePPM(FILE* fout, const struct WebPDecBuffer* const buffer);
65*b2055c35SXin Li 
66*b2055c35SXin Li // Save to PAM format (= PPM + alpha)
67*b2055c35SXin Li int WebPWritePAM(FILE* fout, const struct WebPDecBuffer* const buffer);
68*b2055c35SXin Li 
69*b2055c35SXin Li // Save 16b mode (RGBA4444, RGB565, ...) for debugging purposes.
70*b2055c35SXin Li int WebPWrite16bAsPGM(FILE* fout, const struct WebPDecBuffer* const buffer);
71*b2055c35SXin Li 
72*b2055c35SXin Li // Save as BMP
73*b2055c35SXin Li int WebPWriteBMP(FILE* fout, const struct WebPDecBuffer* const buffer);
74*b2055c35SXin Li 
75*b2055c35SXin Li // Save as TIFF
76*b2055c35SXin Li int WebPWriteTIFF(FILE* fout, const struct WebPDecBuffer* const buffer);
77*b2055c35SXin Li 
78*b2055c35SXin Li // Save the ALPHA plane (only) as a PGM
79*b2055c35SXin Li int WebPWriteAlphaPlane(FILE* fout, const struct WebPDecBuffer* const buffer);
80*b2055c35SXin Li 
81*b2055c35SXin Li // Save as YUV samples as PGM format (using IMC4 layout).
82*b2055c35SXin Li // See: https://www.fourcc.org/yuv.php#IMC4.
83*b2055c35SXin Li // (very convenient format for viewing the samples, esp. for odd dimensions).
84*b2055c35SXin Li int WebPWritePGM(FILE* fout, const struct WebPDecBuffer* const buffer);
85*b2055c35SXin Li 
86*b2055c35SXin Li // Save YUV(A) planes sequentially (raw dump)
87*b2055c35SXin Li int WebPWriteYUV(FILE* fout, const struct WebPDecBuffer* const buffer);
88*b2055c35SXin Li 
89*b2055c35SXin Li // Save 16b mode (RGBA4444, RGB565, ...) as PGM format, for debugging purposes.
90*b2055c35SXin Li int WebPWrite16bAsPGM(FILE* fout, const struct WebPDecBuffer* const buffer);
91*b2055c35SXin Li 
92*b2055c35SXin Li #ifdef __cplusplus
93*b2055c35SXin Li }    // extern "C"
94*b2055c35SXin Li #endif
95*b2055c35SXin Li 
96*b2055c35SXin Li #endif  // WEBP_IMAGEIO_IMAGE_ENC_H_
97