Index: third_party/libwebp/dec/decode_vp8.h |
diff --git a/third_party/libwebp/dec/decode_vp8.h b/third_party/libwebp/dec/decode_vp8.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..b9337bbec0e1c0dbf9c19be35f36dbf711796aa7 |
--- /dev/null |
+++ b/third_party/libwebp/dec/decode_vp8.h |
@@ -0,0 +1,185 @@ |
+// Copyright 2010 Google Inc. All Rights Reserved. |
+// |
+// Use of this source code is governed by a BSD-style license |
+// that can be found in the COPYING file in the root of the source |
+// tree. An additional intellectual property rights grant can be found |
+// in the file PATENTS. All contributing project authors may |
+// be found in the AUTHORS file in the root of the source tree. |
+// ----------------------------------------------------------------------------- |
+// |
+// Low-level API for VP8 decoder |
+// |
+// Author: Skal (pascal.massimino@gmail.com) |
+ |
+#ifndef WEBP_WEBP_DECODE_VP8_H_ |
+#define WEBP_WEBP_DECODE_VP8_H_ |
+ |
+#include "../webp/decode.h" |
+ |
+#ifdef __cplusplus |
+extern "C" { |
+#endif |
+ |
+//------------------------------------------------------------------------------ |
+// Lower-level API |
+// |
+// These functions provide fine-grained control of the decoding process. |
+// The call flow should resemble: |
+// |
+// VP8Io io; |
+// VP8InitIo(&io); |
+// io.data = data; |
+// io.data_size = size; |
+// /* customize io's functions (setup()/put()/teardown()) if needed. */ |
+// |
+// VP8Decoder* dec = VP8New(); |
+// bool ok = VP8Decode(dec); |
+// if (!ok) printf("Error: %s\n", VP8StatusMessage(dec)); |
+// VP8Delete(dec); |
+// return ok; |
+ |
+// Input / Output |
+typedef struct VP8Io VP8Io; |
+typedef int (*VP8IoPutHook)(const VP8Io* io); |
+typedef int (*VP8IoSetupHook)(VP8Io* io); |
+typedef void (*VP8IoTeardownHook)(const VP8Io* io); |
+ |
+struct VP8Io { |
+ // set by VP8GetHeaders() |
+ int width, height; // picture dimensions, in pixels (invariable). |
+ // These are the original, uncropped dimensions. |
+ // The actual area passed to put() is stored |
+ // in mb_w / mb_h fields. |
+ |
+ // set before calling put() |
+ int mb_y; // position of the current rows (in pixels) |
+ int mb_w; // number of columns in the sample |
+ int mb_h; // number of rows in the sample |
+ const uint8_t* y, *u, *v; // rows to copy (in yuv420 format) |
+ int y_stride; // row stride for luma |
+ int uv_stride; // row stride for chroma |
+ |
+ void* opaque; // user data |
+ |
+ // called when fresh samples are available. Currently, samples are in |
+ // YUV420 format, and can be up to width x 24 in size (depending on the |
+ // in-loop filtering level, e.g.). Should return false in case of error |
+ // or abort request. The actual size of the area to update is mb_w x mb_h |
+ // in size, taking cropping into account. |
+ VP8IoPutHook put; |
+ |
+ // called just before starting to decode the blocks. |
+ // Must return false in case of setup error, true otherwise. If false is |
+ // returned, teardown() will NOT be called. But if the setup succeeded |
+ // and true is returned, then teardown() will always be called afterward. |
+ VP8IoSetupHook setup; |
+ |
+ // Called just after block decoding is finished (or when an error occurred |
+ // during put()). Is NOT called if setup() failed. |
+ VP8IoTeardownHook teardown; |
+ |
+ // this is a recommendation for the user-side yuv->rgb converter. This flag |
+ // is set when calling setup() hook and can be overwritten by it. It then |
+ // can be taken into consideration during the put() method. |
+ int fancy_upsampling; |
+ |
+ // Input buffer. |
+ size_t data_size; |
+ const uint8_t* data; |
+ |
+ // If true, in-loop filtering will not be performed even if present in the |
+ // bitstream. Switching off filtering may speed up decoding at the expense |
+ // of more visible blocking. Note that output will also be non-compliant |
+ // with the VP8 specifications. |
+ int bypass_filtering; |
+ |
+ // Cropping parameters. |
+ int use_cropping; |
+ int crop_left, crop_right, crop_top, crop_bottom; |
+ |
+ // Scaling parameters. |
+ int use_scaling; |
+ int scaled_width, scaled_height; |
+ |
+ // If non NULL, pointer to the alpha data (if present) corresponding to the |
+ // start of the current row (That is: it is pre-offset by mb_y and takes |
+ // cropping into account). |
+ const uint8_t* a; |
+}; |
+ |
+// Internal, version-checked, entry point |
+int VP8InitIoInternal(VP8Io* const, int); |
+ |
+// Set the custom IO function pointers and user-data. The setter for IO hooks |
+// should be called before initiating incremental decoding. Returns true if |
+// WebPIDecoder object is successfully modified, false otherwise. |
+int WebPISetIOHooks(WebPIDecoder* const idec, |
+ VP8IoPutHook put, |
+ VP8IoSetupHook setup, |
+ VP8IoTeardownHook teardown, |
+ void* user_data); |
+ |
+// Main decoding object. This is an opaque structure. |
+typedef struct VP8Decoder VP8Decoder; |
+ |
+// Create a new decoder object. |
+VP8Decoder* VP8New(void); |
+ |
+// Must be called to make sure 'io' is initialized properly. |
+// Returns false in case of version mismatch. Upon such failure, no other |
+// decoding function should be called (VP8Decode, VP8GetHeaders, ...) |
+static WEBP_INLINE int VP8InitIo(VP8Io* const io) { |
+ return VP8InitIoInternal(io, WEBP_DECODER_ABI_VERSION); |
+} |
+ |
+// Decode the VP8 frame header. Returns true if ok. |
+// Note: 'io->data' must be pointing to the start of the VP8 frame header. |
+int VP8GetHeaders(VP8Decoder* const dec, VP8Io* const io); |
+ |
+// Decode a picture. Will call VP8GetHeaders() if it wasn't done already. |
+// Returns false in case of error. |
+int VP8Decode(VP8Decoder* const dec, VP8Io* const io); |
+ |
+// Return current status of the decoder: |
+VP8StatusCode VP8Status(VP8Decoder* const dec); |
+ |
+// return readable string corresponding to the last status. |
+const char* VP8StatusMessage(VP8Decoder* const dec); |
+ |
+// Resets the decoder in its initial state, reclaiming memory. |
+// Not a mandatory call between calls to VP8Decode(). |
+void VP8Clear(VP8Decoder* const dec); |
+ |
+// Destroy the decoder object. |
+void VP8Delete(VP8Decoder* const dec); |
+ |
+//------------------------------------------------------------------------------ |
+// Miscellaneous VP8/VP8L bitstream probing functions. |
+ |
+// Returns true if the next 3 bytes in data contain the VP8 signature. |
+WEBP_EXTERN(int) VP8CheckSignature(const uint8_t* const data, size_t data_size); |
+ |
+// Validates the VP8 data-header and retrieves basic header information viz |
+// width and height. Returns 0 in case of formatting error. *width/*height |
+// can be passed NULL. |
+WEBP_EXTERN(int) VP8GetInfo( |
+ const uint8_t* data, |
+ size_t data_size, // data available so far |
+ size_t chunk_size, // total data size expected in the chunk |
+ int* const width, int* const height); |
+ |
+// Returns true if the next byte(s) in data is a VP8L signature. |
+WEBP_EXTERN(int) VP8LCheckSignature(const uint8_t* const data, size_t size); |
+ |
+// Validates the VP8L data-header and retrieves basic header information viz |
+// width, height and alpha. Returns 0 in case of formatting error. |
+// width/height/has_alpha can be passed NULL. |
+WEBP_EXTERN(int) VP8LGetInfo( |
+ const uint8_t* data, size_t data_size, // data available so far |
+ int* const width, int* const height, int* const has_alpha); |
+ |
+#ifdef __cplusplus |
+} // extern "C" |
+#endif |
+ |
+#endif /* WEBP_WEBP_DECODE_VP8_H_ */ |