15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright 2010 Google Inc. All Rights Reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 3eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// Use of this source code is governed by a BSD-style license 4eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// that can be found in the COPYING file in the root of the source 5eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// tree. An additional intellectual property rights grant can be found 6eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// in the file PATENTS. All contributing project authors may 7eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// be found in the AUTHORS file in the root of the source tree. 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ----------------------------------------------------------------------------- 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Main decoding functions for WebP images. 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Author: Skal (pascal.massimino@gmail.com) 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef WEBP_WEBP_DECODE_H_ 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define WEBP_WEBP_DECODE_H_ 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "./types.h" 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 195d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#ifdef __cplusplus 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)extern "C" { 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 235d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#define WEBP_DECODER_ABI_VERSION 0x0203 // MAJOR(8b) + MINOR(8b) 242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 25eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// Note: forward declaring enumerations is not allowed in (strict) C and C++, 26eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// the types are left here for reference. 27eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// typedef enum VP8StatusCode VP8StatusCode; 28eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// typedef enum WEBP_CSP_MODE WEBP_CSP_MODE; 292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef struct WebPRGBABuffer WebPRGBABuffer; 302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef struct WebPYUVABuffer WebPYUVABuffer; 312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef struct WebPDecBuffer WebPDecBuffer; 322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef struct WebPIDecoder WebPIDecoder; 332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef struct WebPBitstreamFeatures WebPBitstreamFeatures; 342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef struct WebPDecoderOptions WebPDecoderOptions; 352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)typedef struct WebPDecoderConfig WebPDecoderConfig; 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Return the decoder's version number, packed in hexadecimal using 8bits for 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// each of major/minor/revision. E.g: v2.5.7 is 0x020507. 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(int) WebPGetDecoderVersion(void); 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Retrieve basic header information: width, height. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This function will also validate the header and return 0 in 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// case of formatting error. 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Pointers 'width' and 'height' can be passed NULL if deemed irrelevant. 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(int) WebPGetInfo(const uint8_t* data, size_t data_size, 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height); 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Decodes WebP images pointed to by 'data' and returns RGBA samples, along 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// with the dimensions in *width and *height. The ordering of samples in 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// memory is R, G, B, A, R, G, B, A... in scan order (endian-independent). 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The returned pointer should be deleted calling free(). 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns NULL in case of error. 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeRGBA(const uint8_t* data, size_t data_size, 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height); 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Same as WebPDecodeRGBA, but returning A, R, G, B, A, R, G, B... ordered data. 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeARGB(const uint8_t* data, size_t data_size, 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height); 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Same as WebPDecodeRGBA, but returning B, G, R, A, B, G, R, A... ordered data. 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeBGRA(const uint8_t* data, size_t data_size, 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height); 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Same as WebPDecodeRGBA, but returning R, G, B, R, G, B... ordered data. 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// If the bitstream contains transparency, it is ignored. 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeRGB(const uint8_t* data, size_t data_size, 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height); 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Same as WebPDecodeRGB, but returning B, G, R, B, G, R... ordered data. 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeBGR(const uint8_t* data, size_t data_size, 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height); 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Decode WebP images pointed to by 'data' to Y'UV format(*). The pointer 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// returned is the Y samples buffer. Upon return, *u and *v will point to 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the U and V chroma data. These U and V buffers need NOT be free()'d, 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// unlike the returned Y luma one. The dimension of the U and V planes 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// are both (*width + 1) / 2 and (*height + 1)/ 2. 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Upon return, the Y buffer has a stride returned as '*stride', while U and V 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// have a common stride returned as '*uv_stride'. 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Return NULL in case of error. 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// (*) Also named Y'CbCr. See: http://en.wikipedia.org/wiki/YCbCr 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeYUV(const uint8_t* data, size_t data_size, 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height, 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t** u, uint8_t** v, 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* stride, int* uv_stride); 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// These five functions are variants of the above ones, that decode the image 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// directly into a pre-allocated buffer 'output_buffer'. The maximum storage 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// available in this buffer is indicated by 'output_buffer_size'. If this 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// storage is not sufficient (or an error occurred), NULL is returned. 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Otherwise, output_buffer is returned, for convenience. 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The parameter 'output_stride' specifies the distance (in bytes) 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// between scanlines. Hence, output_buffer_size is expected to be at least 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// output_stride x picture-height. 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeRGBAInto( 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t* data, size_t data_size, 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* output_buffer, size_t output_buffer_size, int output_stride); 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeARGBInto( 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t* data, size_t data_size, 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* output_buffer, size_t output_buffer_size, int output_stride); 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeBGRAInto( 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t* data, size_t data_size, 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* output_buffer, size_t output_buffer_size, int output_stride); 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// RGB and BGR variants. Here too the transparency information, if present, 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// will be dropped and ignored. 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeRGBInto( 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t* data, size_t data_size, 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* output_buffer, size_t output_buffer_size, int output_stride); 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeBGRInto( 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t* data, size_t data_size, 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* output_buffer, size_t output_buffer_size, int output_stride); 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// WebPDecodeYUVInto() is a variant of WebPDecodeYUV() that operates directly 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// into pre-allocated luma/chroma plane buffers. This function requires the 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// strides to be passed: one for the luma plane and one for each of the 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// chroma ones. The size of each plane buffer is passed as 'luma_size', 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 'u_size' and 'v_size' respectively. 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Pointer to the luma plane ('*luma') is returned or NULL if an error occurred 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// during decoding (or because some buffers were found to be too small). 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPDecodeYUVInto( 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t* data, size_t data_size, 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* luma, size_t luma_size, int luma_stride, 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* u, size_t u_size, int u_stride, 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* v, size_t v_size, int v_stride); 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//------------------------------------------------------------------------------ 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Output colorspaces and buffer 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Colorspaces 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Note: the naming describes the byte-ordering of packed samples in memory. 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// For instance, MODE_BGRA relates to samples ordered as B,G,R,A,B,G,R,A,... 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Non-capital names (e.g.:MODE_Argb) relates to pre-multiplied RGB channels. 1352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// RGBA-4444 and RGB-565 colorspaces are represented by following byte-order: 1362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// RGBA-4444: [r3 r2 r1 r0 g3 g2 g1 g0], [b3 b2 b1 b0 a3 a2 a1 a0], ... 1372a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// RGB-565: [r4 r3 r2 r1 r0 g5 g4 g3], [g2 g1 g0 b4 b3 b2 b1 b0], ... 1382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// In the case WEBP_SWAP_16BITS_CSP is defined, the bytes are swapped for 1392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// these two modes: 1402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// RGBA-4444: [b3 b2 b1 b0 a3 a2 a1 a0], [r3 r2 r1 r0 g3 g2 g1 g0], ... 1412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// RGB-565: [g2 g1 g0 b4 b3 b2 b1 b0], [r4 r3 r2 r1 r0 g5 g4 g3], ... 1422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 143eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdochtypedef enum WEBP_CSP_MODE { 1442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_RGB = 0, MODE_RGBA = 1, 1452a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_BGR = 2, MODE_BGRA = 3, 1462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_ARGB = 4, MODE_RGBA_4444 = 5, 1472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_RGB_565 = 6, 1482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // RGB-premultiplied transparent modes (alpha value is preserved) 1492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_rgbA = 7, 1502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_bgrA = 8, 1512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_Argb = 9, 1522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_rgbA_4444 = 10, 1532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // YUV modes must come after RGB ones. 1542a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_YUV = 11, MODE_YUVA = 12, // yuv 4:2:0 1552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MODE_LAST = 13 156eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch} WEBP_CSP_MODE; 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Some useful macros: 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static WEBP_INLINE int WebPIsPremultipliedMode(WEBP_CSP_MODE mode) { 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return (mode == MODE_rgbA || mode == MODE_bgrA || mode == MODE_Argb || 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) mode == MODE_rgbA_4444); 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static WEBP_INLINE int WebPIsAlphaMode(WEBP_CSP_MODE mode) { 1655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return (mode == MODE_RGBA || mode == MODE_BGRA || mode == MODE_ARGB || 1665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) mode == MODE_RGBA_4444 || mode == MODE_YUVA || 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPIsPremultipliedMode(mode)); 1685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static WEBP_INLINE int WebPIsRGBMode(WEBP_CSP_MODE mode) { 1715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return (mode < MODE_YUV); 1725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//------------------------------------------------------------------------------ 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// WebPDecBuffer: Generic structure for describing the output sample buffer. 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct WebPRGBABuffer { // view as RGBA 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* rgba; // pointer to RGBA samples 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int stride; // stride in bytes from one scanline to the next. 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t size; // total size of the *rgba buffer. 1812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct WebPYUVABuffer { // view as YUVA 1845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* y, *u, *v, *a; // pointer to luma, chroma U/V, alpha samples 1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int y_stride; // luma stride 1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int u_stride, v_stride; // chroma strides 1875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int a_stride; // alpha stride 1885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t y_size; // luma plane size 1895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t u_size, v_size; // chroma planes size 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t a_size; // alpha-plane size 1912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Output buffer 1942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct WebPDecBuffer { 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WEBP_CSP_MODE colorspace; // Colorspace. 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int width, height; // Dimensions. 1975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int is_external_memory; // If true, 'internal_memory' pointer is not used. 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 1995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPRGBABuffer RGBA; 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPYUVABuffer YUVA; 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } u; // Nameless union of buffer parameters. 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t pad[4]; // padding for later use 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* private_memory; // Internally allocated memory (only when 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is_external_memory is false). Should not be used 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // externally, but accessed via the buffer union. 2072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 2085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Internal, version-checked, entry point 2105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(int) WebPInitDecBufferInternal(WebPDecBuffer*, int); 2115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Initialize the structure as empty. Must be called before any other use. 2135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns false in case of version mismatch 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static WEBP_INLINE int WebPInitDecBuffer(WebPDecBuffer* buffer) { 2155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return WebPInitDecBufferInternal(buffer, WEBP_DECODER_ABI_VERSION); 2165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Free any memory associated with the buffer. Must always be called last. 2195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Note: doesn't free the 'buffer' structure itself. 2205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(void) WebPFreeDecBuffer(WebPDecBuffer* buffer); 2215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//------------------------------------------------------------------------------ 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Enumeration of the status codes 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 225eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdochtypedef enum VP8StatusCode { 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_OK = 0, 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_OUT_OF_MEMORY, 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_INVALID_PARAM, 2295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_BITSTREAM_ERROR, 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_UNSUPPORTED_FEATURE, 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_SUSPENDED, 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_USER_ABORT, 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VP8_STATUS_NOT_ENOUGH_DATA 234eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch} VP8StatusCode; 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//------------------------------------------------------------------------------ 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Incremental decoding 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This API allows streamlined decoding of partial data. 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Picture can be incrementally decoded as data become available thanks to the 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// WebPIDecoder object. This object can be left in a SUSPENDED state if the 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// picture is only partially decoded, pending additional input. 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Code example: 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// WebPInitDecBuffer(&buffer); 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// buffer.colorspace = mode; 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ... 2485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// WebPIDecoder* idec = WebPINewDecoder(&buffer); 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// while (has_more_data) { 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// // ... (get additional data) 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// status = WebPIAppend(idec, new_data, new_data_size); 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// if (status != VP8_STATUS_SUSPENDED || 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// break; 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// } 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// // The above call decodes the current available buffer. 2575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// // Part of the image can now be refreshed by calling to 2585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// // WebPIDecGetRGB()/WebPIDecGetYUVA() etc. 2595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// } 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// WebPIDelete(idec); 2615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Creates a new incremental decoder with the supplied buffer parameter. 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This output_buffer can be passed NULL, in which case a default output buffer 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// is used (with MODE_RGB). Otherwise, an internal reference to 'output_buffer' 2655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// is kept, which means that the lifespan of 'output_buffer' must be larger than 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// that of the returned WebPIDecoder object. 267eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// The supplied 'output_buffer' content MUST NOT be changed between calls to 268eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// WebPIAppend() or WebPIUpdate() unless 'output_buffer.is_external_memory' is 269eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// set to 1. In such a case, it is allowed to modify the pointers, size and 270eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// stride of output_buffer.u.RGBA or output_buffer.u.YUVA, provided they remain 271eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// within valid bounds. 272eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// All other fields of WebPDecBuffer MUST remain constant between calls. 2735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns NULL if the allocation failed. 2745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(WebPIDecoder*) WebPINewDecoder(WebPDecBuffer* output_buffer); 2755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This function allocates and initializes an incremental-decoder object, which 2775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// will output the RGB/A samples specified by 'csp' into a preallocated 2785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// buffer 'output_buffer'. The size of this buffer is at least 2795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 'output_buffer_size' and the stride (distance in bytes between two scanlines) 2802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// is specified by 'output_stride'. 2812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Additionally, output_buffer can be passed NULL in which case the output 2822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// buffer will be allocated automatically when the decoding starts. The 2832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// colorspace 'csp' is taken into account for allocating this buffer. All other 2842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// parameters are ignored. 2852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Returns NULL if the allocation failed, or if some parameters are invalid. 2865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(WebPIDecoder*) WebPINewRGB( 2875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WEBP_CSP_MODE csp, 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* output_buffer, size_t output_buffer_size, int output_stride); 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This function allocates and initializes an incremental-decoder object, which 2912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// will output the raw luma/chroma samples into a preallocated planes if 2922a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// supplied. The luma plane is specified by its pointer 'luma', its size 2932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// 'luma_size' and its stride 'luma_stride'. Similarly, the chroma-u plane 2942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// is specified by the 'u', 'u_size' and 'u_stride' parameters, and the chroma-v 2952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// plane by 'v' and 'v_size'. And same for the alpha-plane. The 'a' pointer 2962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// can be pass NULL in case one is not interested in the transparency plane. 2972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Conversely, 'luma' can be passed NULL if no preallocated planes are supplied. 2982a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// In this case, the output buffer will be automatically allocated (using 2992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// MODE_YUVA) when decoding starts. All parameters are then ignored. 3002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Returns NULL if the allocation failed or if a parameter is invalid. 3015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(WebPIDecoder*) WebPINewYUVA( 3025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* luma, size_t luma_size, int luma_stride, 3035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* u, size_t u_size, int u_stride, 3045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* v, size_t v_size, int v_stride, 3055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* a, size_t a_size, int a_stride); 3065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Deprecated version of the above, without the alpha plane. 3085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Kept for backward compatibility. 3095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(WebPIDecoder*) WebPINewYUV( 3105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* luma, size_t luma_size, int luma_stride, 3115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* u, size_t u_size, int u_stride, 3125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t* v, size_t v_size, int v_stride); 3135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Deletes the WebPIDecoder object and associated memory. Must always be called 3155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// if WebPINewDecoder, WebPINewRGB or WebPINewYUV succeeded. 3165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(void) WebPIDelete(WebPIDecoder* idec); 3175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copies and decodes the next available data. Returns VP8_STATUS_OK when 3195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the image is successfully decoded. Returns VP8_STATUS_SUSPENDED when more 3205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// data is expected. Returns error in other cases. 3215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(VP8StatusCode) WebPIAppend( 3225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPIDecoder* idec, const uint8_t* data, size_t data_size); 3235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// A variant of the above function to be used when data buffer contains 3255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// partial data from the beginning. In this case data buffer is not copied 3265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// to the internal memory. 3275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Note that the value of the 'data' pointer can change between calls to 3285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// WebPIUpdate, for instance when the data buffer is resized to fit larger data. 3295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(VP8StatusCode) WebPIUpdate( 3305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPIDecoder* idec, const uint8_t* data, size_t data_size); 3315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns the RGB/A image decoded so far. Returns NULL if output params 3335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// are not initialized yet. The RGB/A output type corresponds to the colorspace 3345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// specified during call to WebPINewDecoder() or WebPINewRGB(). 3355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// *last_y is the index of last decoded row in raster scan order. Some pointers 3365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// (*last_y, *width etc.) can be NULL if corresponding information is not 3375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// needed. 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPIDecGetRGB( 3395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const WebPIDecoder* idec, int* last_y, 3405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height, int* stride); 3415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Same as above function to get a YUVA image. Returns pointer to the luma 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// plane or NULL in case of error. If there is no alpha information 3445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the alpha pointer '*a' will be returned NULL. 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(uint8_t*) WebPIDecGetYUVA( 3465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const WebPIDecoder* idec, int* last_y, 3475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8_t** u, uint8_t** v, uint8_t** a, 3485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height, int* stride, int* uv_stride, int* a_stride); 3495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Deprecated alpha-less version of WebPIDecGetYUVA(): it will ignore the 3515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// alpha information (if present). Kept for backward compatibility. 3525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static WEBP_INLINE uint8_t* WebPIDecGetYUV( 3535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const WebPIDecoder* idec, int* last_y, uint8_t** u, uint8_t** v, 3545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* width, int* height, int* stride, int* uv_stride) { 3555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return WebPIDecGetYUVA(idec, last_y, u, v, NULL, width, height, 3565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) stride, uv_stride, NULL); 3575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 3585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Generic call to retrieve information about the displayable area. 3605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// If non NULL, the left/right/width/height pointers are filled with the visible 3615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// rectangular area so far. 3625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns NULL in case the incremental decoder object is in an invalid state. 3635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Otherwise returns the pointer to the internal representation. This structure 3645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// is read-only, tied to WebPIDecoder's lifespan and should not be modified. 3655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(const WebPDecBuffer*) WebPIDecodedArea( 3665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const WebPIDecoder* idec, int* left, int* top, int* width, int* height); 3675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//------------------------------------------------------------------------------ 3695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Advanced decoding parametrization 3705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Code sample for using the advanced decoding API 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A) Init a configuration object 3745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPDecoderConfig config; 3755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CHECK(WebPInitDecoderConfig(&config)); 3765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // B) optional: retrieve the bitstream's features. 3785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CHECK(WebPGetFeatures(data, data_size, &config.input) == VP8_STATUS_OK); 3795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // C) Adjust 'config', if needed 3812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) config.no_fancy_upsampling = 1; 3825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) config.output.colorspace = MODE_BGRA; 3835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // etc. 3845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Note that you can also make config.output point to an externally 3865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // supplied memory buffer, provided it's big enough to store the decoded 3875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // picture. Otherwise, config.output will just be used to allocate memory 3885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and store the decoded picture. 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // D) Decode! 3915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CHECK(WebPDecode(data, data_size, &config) == VP8_STATUS_OK); 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // E) Decoded image is now in config.output (and config.output.u.RGBA) 3945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // F) Reclaim memory allocated in config's object. It's safe to call 3965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // this function even if the memory is external and wasn't allocated 3975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // by WebPDecode(). 3985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPFreeDecBuffer(&config.output); 3995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 4005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Features gathered from the bitstream 4022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct WebPBitstreamFeatures { 4032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int width; // Width in pixels, as read from the bitstream. 4042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int height; // Height in pixels, as read from the bitstream. 4052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int has_alpha; // True if the bitstream contains an alpha channel. 4062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int has_animation; // True if the bitstream is an animation. 4075d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) int format; // 0 = undefined (/mixed), 1 = lossy, 2 = lossless 4085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Unused for now: 4105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int no_incremental_decoding; // if true, using incremental decoding is not 4115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // recommended. 4125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int rotate; // TODO(later) 4135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int uv_sampling; // should be 0 for now. TODO(later) 4142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) uint32_t pad[2]; // padding for later use 4152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 4165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Internal, version-checked, entry point 4185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(VP8StatusCode) WebPGetFeaturesInternal( 4195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t*, size_t, WebPBitstreamFeatures*, int); 4205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Retrieve features from the bitstream. The *features structure is filled 4225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// with information gathered from the bitstream. 4232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// Returns VP8_STATUS_OK when the features are successfully retrieved. Returns 4242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// VP8_STATUS_NOT_ENOUGH_DATA when more data is needed to retrieve the 4252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// features from headers. Returns error in other cases. 4265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static WEBP_INLINE VP8StatusCode WebPGetFeatures( 4275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const uint8_t* data, size_t data_size, 4285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPBitstreamFeatures* features) { 4295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return WebPGetFeaturesInternal(data, data_size, features, 4305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WEBP_DECODER_ABI_VERSION); 4315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 4325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Decoding options 4342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct WebPDecoderOptions { 4355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int bypass_filtering; // if true, skip the in-loop filtering 4365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int no_fancy_upsampling; // if true, use faster pointwise upsampler 4375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int use_cropping; // if true, cropping is applied _first_ 4385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int crop_left, crop_top; // top-left position for cropping. 4395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Will be snapped to even values. 4405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int crop_width, crop_height; // dimension of the cropping area 4415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int use_scaling; // if true, scaling is applied _afterward_ 4425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int scaled_width, scaled_height; // final resolution 4435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int use_threads; // if true, use multi-threaded decoding 4445d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) int dithering_strength; // dithering strength (0=Off, 100=full) 4455f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles)#if WEBP_DECODER_ABI_VERSION > 0x0203 4465f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) int flip; // flip output vertically 4475f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) int alpha_dithering_strength; // alpha dithering strength in [0..100] 4485f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles)#endif 4495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Unused for now: 4515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int force_rotation; // forced rotation (to be applied _last_) 4525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int no_enhancement; // if true, discard enhancement layer 4535f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles)#if WEBP_DECODER_ABI_VERSION > 0x0203 4545f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) uint32_t pad[3]; // padding for later use 4555f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles)#else 4565d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) uint32_t pad[5]; // padding for later use 4575f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles)#endif 4582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 4595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Main object storing the configuration for advanced decoding. 4612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct WebPDecoderConfig { 4625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPBitstreamFeatures input; // Immutable bitstream features (optional) 4635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPDecBuffer output; // Output buffer (can point to external mem) 4645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPDecoderOptions options; // Decoding options 4652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}; 4665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Internal, version-checked, entry point 4685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(int) WebPInitDecoderConfigInternal(WebPDecoderConfig*, int); 4695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Initialize the configuration as empty. This function must always be 4715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// called first, unless WebPGetFeatures() is to be called. 4725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns false in case of mismatched version. 4735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)static WEBP_INLINE int WebPInitDecoderConfig(WebPDecoderConfig* config) { 4745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return WebPInitDecoderConfigInternal(config, WEBP_DECODER_ABI_VERSION); 4755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 4765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Instantiate a new incremental decoder object with the requested 4785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// configuration. The bitstream can be passed using 'data' and 'data_size' 4795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// parameter, in which case the features will be parsed and stored into 4805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// config->input. Otherwise, 'data' can be NULL and no parsing will occur. 4815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Note that 'config' can be NULL too, in which case a default configuration 4825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// is used. 4835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The return WebPIDecoder object must always be deleted calling WebPIDelete(). 4845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns NULL in case of error (and config->status will then reflect 4855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the error condition). 4865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(WebPIDecoder*) WebPIDecode(const uint8_t* data, size_t data_size, 4875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPDecoderConfig* config); 4885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Non-incremental version. This version decodes the full data at once, taking 4905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 'config' into account. Returns decoding status (which should be VP8_STATUS_OK 4915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// if the decoding was successful). 4925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)WEBP_EXTERN(VP8StatusCode) WebPDecode(const uint8_t* data, size_t data_size, 4935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) WebPDecoderConfig* config); 4945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4955d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#ifdef __cplusplus 4965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // extern "C" 4975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 4985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif /* WEBP_WEBP_DECODE_H_ */ 500