// 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) #include #include "vp8i.h" #include "webpi.h" #if defined(__cplusplus) || defined(c_plusplus) extern "C" { #endif #define RIFF_HEADER_SIZE 12 //------------------------------------------------------------------------------ // RIFF layout is: // 0ffset tag // 0...3 "RIFF" 4-byte tag // 4...7 size of image data (including metadata) starting at offset 8 // 8...11 "WEBP" our form-type signature // The RIFF container (12 bytes) is followed by appropriate chunks: // 12..15 "VP8 ": 4-bytes tags, describing the raw video format used // 16..19 size of the raw VP8 image data, starting at offset 20 // 20.... the VP8 bytes // Or, // 12..15 "VP8X": 4-bytes tags, describing the extended-VP8 chunk. // 16..19 size of the VP8X chunk starting at offset 8. // 20..23 VP8X flags bit-map corresponding to the chunk-types present. // 24..27 Width of the Canvas Image. // 28..31 Height of the Canvas Image. // There can be extra chunks after the "VP8X" chunk (ICCP, TILE, FRM, VP8, // META ...) // All 32-bits sizes are in little-endian order. // Note: chunk data must be padded to multiple of 2 in size static inline uint32_t get_le32(const uint8_t* const data) { return data[0] | (data[1] << 8) | (data[2] << 16) | (data[3] << 24); } uint32_t WebPCheckAndSkipRIFFHeader(const uint8_t** data_ptr, uint32_t* data_size_ptr, uint32_t* riff_size) { if (*data_size_ptr >= RIFF_HEADER_SIZE && !memcmp(*data_ptr, "RIFF", 4)) { if (memcmp(*data_ptr + 8, "WEBP", 4)) { return 0; // Wrong image file signature. } else { *riff_size = get_le32(*data_ptr + 4); if (*riff_size < RIFF_HEADER_SIZE) { return 0; // We should have at least one chunk. } // We have a RIFF container. Skip it. *data_ptr += RIFF_HEADER_SIZE; *data_size_ptr -= RIFF_HEADER_SIZE; } } else { *riff_size = 0; // Did not get full RIFF Header. } return 1; } //------------------------------------------------------------------------------ // WebPDecParams void WebPResetDecParams(WebPDecParams* const params) { if (params) { memset(params, 0, sizeof(*params)); } } //------------------------------------------------------------------------------ // "Into" decoding variants // Main flow static VP8StatusCode DecodeInto(const uint8_t* data, uint32_t data_size, WebPDecParams* const params) { VP8Decoder* dec = VP8New(); VP8StatusCode status = VP8_STATUS_OK; VP8Io io; assert(params); if (dec == NULL) { return VP8_STATUS_INVALID_PARAM; } VP8InitIo(&io); io.data = data; io.data_size = data_size; WebPInitCustomIo(params, &io); // Plug the I/O functions. #ifdef WEBP_USE_THREAD dec->use_threads_ = params->options && (params->options->use_threads > 0); #else dec->use_threads_ = 0; #endif // Decode bitstream header, update io->width/io->height. if (!VP8GetHeaders(dec, &io)) { status = VP8_STATUS_BITSTREAM_ERROR; } else { // Allocate/check output buffers. status = WebPAllocateDecBuffer(io.width, io.height, params->options, params->output); if (status == VP8_STATUS_OK) { // Decode if (!VP8Decode(dec, &io)) { status = dec->status_; } } } VP8Delete(dec); if (status != VP8_STATUS_OK) { WebPFreeDecBuffer(params->output); } return status; } // Helpers static uint8_t* DecodeIntoRGBABuffer(WEBP_CSP_MODE colorspace, const uint8_t* data, uint32_t data_size, uint8_t* rgba, int stride, int size) { WebPDecParams params; WebPDecBuffer buf; if (rgba == NULL) { return NULL; } WebPInitDecBuffer(&buf); WebPResetDecParams(¶ms); params.output = &buf; buf.colorspace = colorspace; buf.u.RGBA.rgba = rgba; buf.u.RGBA.stride = stride; buf.u.RGBA.size = size; buf.is_external_memory = 1; if (DecodeInto(data, data_size, ¶ms) != VP8_STATUS_OK) { return NULL; } return rgba; } uint8_t* WebPDecodeRGBInto(const uint8_t* data, uint32_t data_size, uint8_t* output, int size, int stride) { return DecodeIntoRGBABuffer(MODE_RGB, data, data_size, output, stride, size); } uint8_t* WebPDecodeRGBAInto(const uint8_t* data, uint32_t data_size, uint8_t* output, int size, int stride) { return DecodeIntoRGBABuffer(MODE_RGBA, data, data_size, output, stride, size); } uint8_t* WebPDecodeARGBInto(const uint8_t* data, uint32_t data_size, uint8_t* output, int size, int stride) { return DecodeIntoRGBABuffer(MODE_ARGB, data, data_size, output, stride, size); } uint8_t* WebPDecodeBGRInto(const uint8_t* data, uint32_t data_size, uint8_t* output, int size, int stride) { return DecodeIntoRGBABuffer(MODE_BGR, data, data_size, output, stride, size); } uint8_t* WebPDecodeBGRAInto(const uint8_t* data, uint32_t data_size, uint8_t* output, int size, int stride) { return DecodeIntoRGBABuffer(MODE_BGRA, data, data_size, output, stride, size); } 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) { WebPDecParams params; WebPDecBuffer output; if (luma == NULL) return NULL; WebPInitDecBuffer(&output); WebPResetDecParams(¶ms); params.output = &output; output.colorspace = MODE_YUV; output.u.YUVA.y = luma; output.u.YUVA.y_stride = luma_stride; output.u.YUVA.y_size = luma_size; output.u.YUVA.u = u; output.u.YUVA.u_stride = u_stride; output.u.YUVA.u_size = u_size; output.u.YUVA.v = v; output.u.YUVA.v_stride = v_stride; output.u.YUVA.v_size = v_size; output.is_external_memory = 1; if (DecodeInto(data, data_size, ¶ms) != VP8_STATUS_OK) { return NULL; } return luma; } //------------------------------------------------------------------------------ static uint8_t* Decode(WEBP_CSP_MODE mode, const uint8_t* data, uint32_t data_size, int* width, int* height, WebPDecBuffer* keep_info) { WebPDecParams params; WebPDecBuffer output; WebPInitDecBuffer(&output); WebPResetDecParams(¶ms); params.output = &output; output.colorspace = mode; // Retrieve (and report back) the required dimensions from bitstream. if (!WebPGetInfo(data, data_size, &output.width, &output.height)) { return NULL; } if (width) *width = output.width; if (height) *height = output.height; // Decode if (DecodeInto(data, data_size, ¶ms) != VP8_STATUS_OK) { return NULL; } if (keep_info) { // keep track of the side-info WebPCopyDecBuffer(&output, keep_info); } // return decoded samples (don't clear 'output'!) return (mode >= MODE_YUV) ? output.u.YUVA.y : output.u.RGBA.rgba; } uint8_t* WebPDecodeRGB(const uint8_t* data, uint32_t data_size, int* width, int* height) { return Decode(MODE_RGB, data, data_size, width, height, NULL); } uint8_t* WebPDecodeRGBA(const uint8_t* data, uint32_t data_size, int* width, int* height) { return Decode(MODE_RGBA, data, data_size, width, height, NULL); } uint8_t* WebPDecodeARGB(const uint8_t* data, uint32_t data_size, int* width, int* height) { return Decode(MODE_ARGB, data, data_size, width, height, NULL); } uint8_t* WebPDecodeBGR(const uint8_t* data, uint32_t data_size, int* width, int* height) { return Decode(MODE_BGR, data, data_size, width, height, NULL); } uint8_t* WebPDecodeBGRA(const uint8_t* data, uint32_t data_size, int* width, int* height) { return Decode(MODE_BGRA, data, data_size, width, height, NULL); } 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) { WebPDecBuffer output; // only to preserve the side-infos uint8_t* const out = Decode(MODE_YUV, data, data_size, width, height, &output); if (out) { const WebPYUVABuffer* const buf = &output.u.YUVA; *u = buf->u; *v = buf->v; *stride = buf->y_stride; *uv_stride = buf->u_stride; assert(buf->u_stride == buf->v_stride); } return out; } static void DefaultFeatures(WebPBitstreamFeatures* const features) { assert(features); memset(features, 0, sizeof(*features)); features->bitstream_version = 0; } static VP8StatusCode GetFeatures(const uint8_t** data, uint32_t* data_size, WebPBitstreamFeatures* const features) { uint32_t chunk_size = 0; uint32_t riff_size = 0; uint32_t flags = 0; int is_vp8x_chunk = 0; int is_vp8_chunk = 0; if (features == NULL) { return VP8_STATUS_INVALID_PARAM; } DefaultFeatures(features); if (data == NULL || *data == NULL || data_size == 0) { return VP8_STATUS_INVALID_PARAM; } if (!WebPCheckAndSkipRIFFHeader(data, data_size, &riff_size)) { return VP8_STATUS_BITSTREAM_ERROR; // Wrong RIFF Header. } if (!VP8XGetInfo(data, data_size, &is_vp8x_chunk, &features->width, &features->height, &flags)) { return VP8_STATUS_BITSTREAM_ERROR; // Wrong VP8X Chunk-header. } if (is_vp8x_chunk > 0) { return VP8_STATUS_OK; } if (!VP8CheckAndSkipHeader(data, data_size, &is_vp8_chunk, &chunk_size, riff_size)) { return VP8_STATUS_BITSTREAM_ERROR; // Invalid VP8 header. } if (is_vp8_chunk == -1) { return VP8_STATUS_BITSTREAM_ERROR; // Insufficient data-bytes. } if (!is_vp8_chunk) { chunk_size = *data_size; // No VP8 chunk wrapper over raw VP8 data. } // Validates raw VP8 data. if (!VP8GetInfo(*data, *data_size, chunk_size, &features->width, &features->height, &features->has_alpha)) { return VP8_STATUS_BITSTREAM_ERROR; } return VP8_STATUS_OK; } //------------------------------------------------------------------------------ // WebPGetInfo() int WebPGetInfo(const uint8_t* data, uint32_t data_size, int* width, int* height) { WebPBitstreamFeatures features; if (GetFeatures(&data, &data_size, &features) != VP8_STATUS_OK) { return 0; } if (width) { *width = features.width; } if (height) { *height = features.height; } return 1; } //------------------------------------------------------------------------------ // Advance decoding API int WebPInitDecoderConfigInternal(WebPDecoderConfig* const config, int version) { if (version != WEBP_DECODER_ABI_VERSION) { return 0; // version mismatch } if (config == NULL) { return 0; } memset(config, 0, sizeof(*config)); DefaultFeatures(&config->input); WebPInitDecBuffer(&config->output); return 1; } VP8StatusCode WebPGetFeaturesInternal(const uint8_t* data, uint32_t data_size, WebPBitstreamFeatures* const features, int version) { if (version != WEBP_DECODER_ABI_VERSION) { return VP8_STATUS_INVALID_PARAM; // version mismatch } if (features == NULL) { return VP8_STATUS_INVALID_PARAM; } return GetFeatures(&data, &data_size, features); } VP8StatusCode WebPDecode(const uint8_t* data, uint32_t data_size, WebPDecoderConfig* const config) { WebPDecParams params; VP8StatusCode status; if (!config) { return VP8_STATUS_INVALID_PARAM; } status = GetFeatures(&data, &data_size, &config->input); if (status != VP8_STATUS_OK) { return status; } WebPResetDecParams(¶ms); params.output = &config->output; params.options = &config->options; status = DecodeInto(data, data_size, ¶ms); return status; } #if defined(__cplusplus) || defined(c_plusplus) } // extern "C" #endif