text: // Copyright 2012 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.
  // -----------------------------------------------------------------------------
  //
  // Data-types common to the mux and demux libraries.
  //
  // Author: Urvang (urvang@google.com)
  
  #ifndef WEBP_WEBP_MUX_TYPES_H_
  #define WEBP_WEBP_MUX_TYPES_H_
  
  #include <string.h>  // memset()
  #import <webp/types.h>
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  // Note: forward declaring enumerations is not allowed in (strict) C and C++,
  // the types are left here for reference.
  // typedef enum WebPFeatureFlags WebPFeatureFlags;
  // typedef enum WebPMuxAnimDispose WebPMuxAnimDispose;
  // typedef enum WebPMuxAnimBlend WebPMuxAnimBlend;
  typedef struct WebPData WebPData;
  
  // VP8X Feature Flags.
  typedef enum WebPFeatureFlags {
    ANIMATION_FLAG  = 0x00000002,
    XMP_FLAG        = 0x00000004,
    EXIF_FLAG       = 0x00000008,
    ALPHA_FLAG      = 0x00000010,
    ICCP_FLAG       = 0x00000020,
  
    ALL_VALID_FLAGS = 0x0000003e
  } WebPFeatureFlags;
  
  // Dispose method (animation only). Indicates how the area used by the current
  // frame is to be treated before rendering the next frame on the canvas.
  typedef enum WebPMuxAnimDispose {
    WEBP_MUX_DISPOSE_NONE,       // Do not dispose.
    WEBP_MUX_DISPOSE_BACKGROUND  // Dispose to background color.
  } WebPMuxAnimDispose;
  
  // Blend operation (animation only). Indicates how transparent pixels of the
  // current frame are blended with those of the previous canvas.
  typedef enum WebPMuxAnimBlend {
    WEBP_MUX_BLEND,              // Blend.
    WEBP_MUX_NO_BLEND            // Do not blend.
  } WebPMuxAnimBlend;
  
  // Data type used to describe 'raw' data, e.g., chunk data
  // (ICC profile, metadata) and WebP compressed image data.
  // 'bytes' memory must be allocated using WebPMalloc() and such.
  struct WebPData {
    const uint8_t* bytes;
    size_t size;
  };
  
  // Initializes the contents of the 'webp_data' object with default values.
  static WEBP_INLINE void WebPDataInit(WebPData* webp_data) {
    if (webp_data != NULL) {
      memset(webp_data, 0, sizeof(*webp_data));
    }
  }
  
  // Clears the contents of the 'webp_data' object by calling WebPFree().
  // Does not deallocate the object itself.
  static WEBP_INLINE void WebPDataClear(WebPData* webp_data) {
    if (webp_data != NULL) {
      WebPFree((void*)webp_data->bytes);
      WebPDataInit(webp_data);
    }
  }
  
  // Allocates necessary storage for 'dst' and copies the contents of 'src'.
  // Returns true on success.
  static WEBP_INLINE int WebPDataCopy(const WebPData* src, WebPData* dst) {
    if (src == NULL || dst == NULL) return 0;
    WebPDataInit(dst);
    if (src->bytes != NULL && src->size != 0) {
      dst->bytes = (uint8_t*)WebPMalloc(src->size);
      if (dst->bytes == NULL) return 0;
      memcpy((void*)dst->bytes, src->bytes, src->size);
      dst->size = src->size;
    }
    return 1;
  }
  
  #ifdef __cplusplus
  }    // extern "C"
  #endif
  
  #endif  // WEBP_WEBP_MUX_TYPES_H_
  