| Index: third_party/libwebp/webp/decode.h
|
| ===================================================================
|
| --- third_party/libwebp/webp/decode.h (revision 0)
|
| +++ third_party/libwebp/webp/decode.h (revision 0)
|
| @@ -0,0 +1,111 @@
|
| +// Copyright 2010 Google Inc.
|
| +//
|
| +// This code is licensed under the same terms as WebM:
|
| +// Software License Agreement: http://www.webmproject.org/license/software/
|
| +// Additional IP Rights Grant: http://www.webmproject.org/license/additional/
|
| +// -----------------------------------------------------------------------------
|
| +//
|
| +// Main decoding functions for WEBP images.
|
| +//
|
| +// Author: Skal (pascal.massimino@gmail.com)
|
| +
|
| +#ifndef WEBP_DECODE_WEBP_DECODE_H_
|
| +#define WEBP_DECODE_WEBP_DECODE_H_
|
| +
|
| +#ifndef _MSC_VER
|
| +#include <inttypes.h>
|
| +#else
|
| +typedef signed char int8_t;
|
| +typedef unsigned char uint8_t;
|
| +typedef signed short int16_t;
|
| +typedef unsigned short uint16_t;
|
| +typedef signed int int32_t;
|
| +typedef unsigned int uint32_t;
|
| +typedef unsigned long long int uint64_t;
|
| +#define inline __forceinline
|
| +#endif
|
| +
|
| +
|
| +#if defined(__cplusplus) || defined(c_plusplus)
|
| +extern "C" {
|
| +#endif
|
| +
|
| +// Retrieve basic header information: width, height.
|
| +// This function will also validate the header and return 0 in
|
| +// case of formatting error.
|
| +// Pointers *width/*height can be passed NULL if deemed irrelevant.
|
| +int WebPGetInfo(const uint8_t* data, uint32_t data_size,
|
| + int *width, int *height);
|
| +
|
| +// Decodes WEBP images pointed to by *data and returns RGB samples, along
|
| +// with the dimensions in *width and *height.
|
| +// The returned pointer should be deleted calling free().
|
| +// Returns NULL in case of error.
|
| +uint8_t* WebPDecodeRGB(const uint8_t* data, uint32_t data_size,
|
| + int *width, int *height);
|
| +
|
| +// Same as WebPDecodeRGB, but returning RGBA data.
|
| +uint8_t* WebPDecodeRGBA(const uint8_t* data, uint32_t data_size,
|
| + int *width, int *height);
|
| +
|
| +// This variant decode to BGR instead of RGB.
|
| +uint8_t* WebPDecodeBGR(const uint8_t* data, uint32_t data_size,
|
| + int *width, int *height);
|
| +// This variant decodes to BGRA instead of RGBA.
|
| +uint8_t* WebPDecodeBGRA(const uint8_t* data, uint32_t data_size,
|
| + int *width, int *height);
|
| +
|
| +// Decode WEBP images stored in *data in Y'UV format(*). The pointer returned is
|
| +// the Y samples buffer. Upon return, *u and *v will point to the U and V
|
| +// chroma data. These U and V buffers need NOT be free()'d, unlike the returned
|
| +// Y luma one. The dimension of the U and V planes are both (*width + 1) / 2
|
| +// and (*height + 1)/ 2.
|
| +// Upon return, the Y buffer has a stride returned as '*stride', while U and V
|
| +// have a common stride returned as '*uv_stride'.
|
| +// Return NULL in case of error.
|
| +// (*) Also named Y'CbCr. See: http://en.wikipedia.org/wiki/YCbCr
|
| +uint8_t* WebPDecodeYUV(const uint8_t* data, uint32_t data_size,
|
| + int *width, int *height, uint8_t** u, uint8_t** v,
|
| + int *stride, int* uv_stride);
|
| +
|
| +// These three functions are variants of the above ones, that decode the image
|
| +// directly into a pre-allocated buffer 'output_buffer'. The maximum storage
|
| +// available in this buffer is indicated by 'output_buffer_size'. If this
|
| +// storage is not sufficient (or an error occurred), NULL is returned.
|
| +// Otherwise, output_buffer is returned, for convenience.
|
| +// The parameter 'output_stride' specifies the distance (in bytes)
|
| +// between scanlines. Hence, output_buffer_size is expected to be at least
|
| +// output_stride x picture-height.
|
| +uint8_t* WebPDecodeRGBInto(const uint8_t* data, uint32_t data_size,
|
| + uint8_t* output_buffer, int output_buffer_size,
|
| + int output_stride);
|
| +uint8_t* WebPDecodeRGBAInto(const uint8_t* data, uint32_t data_size,
|
| + uint8_t* output_buffer, int output_buffer_size,
|
| + int output_stride);
|
| +// BGR variants
|
| +uint8_t* WebPDecodeBGRInto(const uint8_t* data, uint32_t data_size,
|
| + uint8_t* output_buffer, int output_buffer_size,
|
| + int output_stride);
|
| +uint8_t* WebPDecodeBGRAInto(const uint8_t* data, uint32_t data_size,
|
| + uint8_t* output_buffer, int output_buffer_size,
|
| + int output_stride);
|
| +
|
| +// WebPDecodeYUVInto() is a variant of WebPDecodeYUV() that operates directly
|
| +// into pre-allocated luma/chroma plane buffers. This function requires the
|
| +// strides to be passed: one for the luma plane and one for each of the
|
| +// chroma ones. The size of each plane buffer is passed as 'luma_size',
|
| +// 'u_size' and 'v_size' respectively.
|
| +// Pointer to the luma plane ('*luma') is returned or NULL if an error occurred
|
| +// during decoding (or because some buffers were found to be too small).
|
| +uint8_t* WebPDecodeYUVInto(const uint8_t* data, uint32_t data_size,
|
| + uint8_t* luma, int luma_size, int luma_stride,
|
| + uint8_t* u, int u_size, int u_stride,
|
| + uint8_t* v, int v_size, int v_stride);
|
| +
|
| +//-----------------------------------------------------------------------------
|
| +
|
| +#if defined(__cplusplus) || defined(c_plusplus)
|
| +} // extern "C"
|
| +#endif
|
| +
|
| +#endif // WEBP_DECODE_WEBP_DECODE_H_
|
|
|