• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1  // Copyright 2011 Google Inc. All Rights Reserved.
2  //
3  // Use of this source code is governed by a BSD-style license
4  // that can be found in the COPYING file in the root of the source
5  // tree. An additional intellectual property rights grant can be found
6  // in the file PATENTS. All contributing project authors may
7  // be found in the AUTHORS file in the root of the source tree.
8  // -----------------------------------------------------------------------------
9  //
10  // Everything about WebPDecBuffer
11  //
12  // Author: Skal (pascal.massimino@gmail.com)
13  
14  #include <stdlib.h>
15  
16  #include "src/dec/vp8i_dec.h"
17  #include "src/dec/webpi_dec.h"
18  #include "src/utils/utils.h"
19  
20  //------------------------------------------------------------------------------
21  // WebPDecBuffer
22  
23  // Number of bytes per pixel for the different color-spaces.
24  static const uint8_t kModeBpp[MODE_LAST] = {
25    3, 4, 3, 4, 4, 2, 2,
26    4, 4, 4, 2,    // pre-multiplied modes
27    1, 1 };
28  
29  // Check that webp_csp_mode is within the bounds of WEBP_CSP_MODE.
30  // Convert to an integer to handle both the unsigned/signed enum cases
31  // without the need for casting to remove type limit warnings.
IsValidColorspace(int webp_csp_mode)32  static int IsValidColorspace(int webp_csp_mode) {
33    return (webp_csp_mode >= MODE_RGB && webp_csp_mode < MODE_LAST);
34  }
35  
36  // strictly speaking, the very last (or first, if flipped) row
37  // doesn't require padding.
38  #define MIN_BUFFER_SIZE(WIDTH, HEIGHT, STRIDE)       \
39      ((uint64_t)(STRIDE) * ((HEIGHT) - 1) + (WIDTH))
40  
CheckDecBuffer(const WebPDecBuffer * const buffer)41  static VP8StatusCode CheckDecBuffer(const WebPDecBuffer* const buffer) {
42    int ok = 1;
43    const WEBP_CSP_MODE mode = buffer->colorspace;
44    const int width = buffer->width;
45    const int height = buffer->height;
46    if (!IsValidColorspace(mode)) {
47      ok = 0;
48    } else if (!WebPIsRGBMode(mode)) {   // YUV checks
49      const WebPYUVABuffer* const buf = &buffer->u.YUVA;
50      const int uv_width  = (width  + 1) / 2;
51      const int uv_height = (height + 1) / 2;
52      const int y_stride = abs(buf->y_stride);
53      const int u_stride = abs(buf->u_stride);
54      const int v_stride = abs(buf->v_stride);
55      const int a_stride = abs(buf->a_stride);
56      const uint64_t y_size = MIN_BUFFER_SIZE(width, height, y_stride);
57      const uint64_t u_size = MIN_BUFFER_SIZE(uv_width, uv_height, u_stride);
58      const uint64_t v_size = MIN_BUFFER_SIZE(uv_width, uv_height, v_stride);
59      const uint64_t a_size = MIN_BUFFER_SIZE(width, height, a_stride);
60      ok &= (y_size <= buf->y_size);
61      ok &= (u_size <= buf->u_size);
62      ok &= (v_size <= buf->v_size);
63      ok &= (y_stride >= width);
64      ok &= (u_stride >= uv_width);
65      ok &= (v_stride >= uv_width);
66      ok &= (buf->y != NULL);
67      ok &= (buf->u != NULL);
68      ok &= (buf->v != NULL);
69      if (mode == MODE_YUVA) {
70        ok &= (a_stride >= width);
71        ok &= (a_size <= buf->a_size);
72        ok &= (buf->a != NULL);
73      }
74    } else {    // RGB checks
75      const WebPRGBABuffer* const buf = &buffer->u.RGBA;
76      const int stride = abs(buf->stride);
77      const uint64_t size = MIN_BUFFER_SIZE(width, height, stride);
78      ok &= (size <= buf->size);
79      ok &= (stride >= width * kModeBpp[mode]);
80      ok &= (buf->rgba != NULL);
81    }
82    return ok ? VP8_STATUS_OK : VP8_STATUS_INVALID_PARAM;
83  }
84  #undef MIN_BUFFER_SIZE
85  
AllocateBuffer(WebPDecBuffer * const buffer)86  static VP8StatusCode AllocateBuffer(WebPDecBuffer* const buffer) {
87    const int w = buffer->width;
88    const int h = buffer->height;
89    const WEBP_CSP_MODE mode = buffer->colorspace;
90  
91    if (w <= 0 || h <= 0 || !IsValidColorspace(mode)) {
92      return VP8_STATUS_INVALID_PARAM;
93    }
94  
95    if (buffer->is_external_memory <= 0 && buffer->private_memory == NULL) {
96      uint8_t* output;
97      int uv_stride = 0, a_stride = 0;
98      uint64_t uv_size = 0, a_size = 0, total_size;
99      // We need memory and it hasn't been allocated yet.
100      // => initialize output buffer, now that dimensions are known.
101      int stride;
102      uint64_t size;
103  
104      if ((uint64_t)w * kModeBpp[mode] >= (1ull << 32)) {
105        return VP8_STATUS_INVALID_PARAM;
106      }
107      stride = w * kModeBpp[mode];
108      size = (uint64_t)stride * h;
109      if (!WebPIsRGBMode(mode)) {
110        uv_stride = (w + 1) / 2;
111        uv_size = (uint64_t)uv_stride * ((h + 1) / 2);
112        if (mode == MODE_YUVA) {
113          a_stride = w;
114          a_size = (uint64_t)a_stride * h;
115        }
116      }
117      total_size = size + 2 * uv_size + a_size;
118  
119      // Security/sanity checks
120      output = (uint8_t*)WebPSafeMalloc(total_size, sizeof(*output));
121      if (output == NULL) {
122        return VP8_STATUS_OUT_OF_MEMORY;
123      }
124      buffer->private_memory = output;
125  
126      if (!WebPIsRGBMode(mode)) {   // YUVA initialization
127        WebPYUVABuffer* const buf = &buffer->u.YUVA;
128        buf->y = output;
129        buf->y_stride = stride;
130        buf->y_size = (size_t)size;
131        buf->u = output + size;
132        buf->u_stride = uv_stride;
133        buf->u_size = (size_t)uv_size;
134        buf->v = output + size + uv_size;
135        buf->v_stride = uv_stride;
136        buf->v_size = (size_t)uv_size;
137        if (mode == MODE_YUVA) {
138          buf->a = output + size + 2 * uv_size;
139        }
140        buf->a_size = (size_t)a_size;
141        buf->a_stride = a_stride;
142      } else {  // RGBA initialization
143        WebPRGBABuffer* const buf = &buffer->u.RGBA;
144        buf->rgba = output;
145        buf->stride = stride;
146        buf->size = (size_t)size;
147      }
148    }
149    return CheckDecBuffer(buffer);
150  }
151  
WebPFlipBuffer(WebPDecBuffer * const buffer)152  VP8StatusCode WebPFlipBuffer(WebPDecBuffer* const buffer) {
153    if (buffer == NULL) {
154      return VP8_STATUS_INVALID_PARAM;
155    }
156    if (WebPIsRGBMode(buffer->colorspace)) {
157      WebPRGBABuffer* const buf = &buffer->u.RGBA;
158      buf->rgba += (buffer->height - 1) * buf->stride;
159      buf->stride = -buf->stride;
160    } else {
161      WebPYUVABuffer* const buf = &buffer->u.YUVA;
162      const int H = buffer->height;
163      buf->y += (H - 1) * buf->y_stride;
164      buf->y_stride = -buf->y_stride;
165      buf->u += ((H - 1) >> 1) * buf->u_stride;
166      buf->u_stride = -buf->u_stride;
167      buf->v += ((H - 1) >> 1) * buf->v_stride;
168      buf->v_stride = -buf->v_stride;
169      if (buf->a != NULL) {
170        buf->a += (H - 1) * buf->a_stride;
171        buf->a_stride = -buf->a_stride;
172      }
173    }
174    return VP8_STATUS_OK;
175  }
176  
WebPAllocateDecBuffer(int width,int height,const WebPDecoderOptions * const options,WebPDecBuffer * const buffer)177  VP8StatusCode WebPAllocateDecBuffer(int width, int height,
178                                      const WebPDecoderOptions* const options,
179                                      WebPDecBuffer* const buffer) {
180    VP8StatusCode status;
181    if (buffer == NULL || width <= 0 || height <= 0) {
182      return VP8_STATUS_INVALID_PARAM;
183    }
184    if (options != NULL) {    // First, apply options if there is any.
185      if (options->use_cropping) {
186        const int cw = options->crop_width;
187        const int ch = options->crop_height;
188        const int x = options->crop_left & ~1;
189        const int y = options->crop_top & ~1;
190        if (x < 0 || y < 0 || cw <= 0 || ch <= 0 ||
191            x + cw > width || y + ch > height) {
192          return VP8_STATUS_INVALID_PARAM;   // out of frame boundary.
193        }
194        width = cw;
195        height = ch;
196      }
197  
198      if (options->use_scaling) {
199  #if !defined(WEBP_REDUCE_SIZE)
200        int scaled_width = options->scaled_width;
201        int scaled_height = options->scaled_height;
202        if (!WebPRescalerGetScaledDimensions(
203                width, height, &scaled_width, &scaled_height)) {
204          return VP8_STATUS_INVALID_PARAM;
205        }
206        width = scaled_width;
207        height = scaled_height;
208  #else
209        return VP8_STATUS_INVALID_PARAM;   // rescaling not supported
210  #endif
211      }
212    }
213    buffer->width = width;
214    buffer->height = height;
215  
216    // Then, allocate buffer for real.
217    status = AllocateBuffer(buffer);
218    if (status != VP8_STATUS_OK) return status;
219  
220    // Use the stride trick if vertical flip is needed.
221    if (options != NULL && options->flip) {
222      status = WebPFlipBuffer(buffer);
223    }
224    return status;
225  }
226  
227  //------------------------------------------------------------------------------
228  // constructors / destructors
229  
WebPInitDecBufferInternal(WebPDecBuffer * buffer,int version)230  int WebPInitDecBufferInternal(WebPDecBuffer* buffer, int version) {
231    if (WEBP_ABI_IS_INCOMPATIBLE(version, WEBP_DECODER_ABI_VERSION)) {
232      return 0;  // version mismatch
233    }
234    if (buffer == NULL) return 0;
235    memset(buffer, 0, sizeof(*buffer));
236    return 1;
237  }
238  
WebPFreeDecBuffer(WebPDecBuffer * buffer)239  void WebPFreeDecBuffer(WebPDecBuffer* buffer) {
240    if (buffer != NULL) {
241      if (buffer->is_external_memory <= 0) {
242        WebPSafeFree(buffer->private_memory);
243      }
244      buffer->private_memory = NULL;
245    }
246  }
247  
WebPCopyDecBuffer(const WebPDecBuffer * const src,WebPDecBuffer * const dst)248  void WebPCopyDecBuffer(const WebPDecBuffer* const src,
249                         WebPDecBuffer* const dst) {
250    if (src != NULL && dst != NULL) {
251      *dst = *src;
252      if (src->private_memory != NULL) {
253        dst->is_external_memory = 1;   // dst buffer doesn't own the memory.
254        dst->private_memory = NULL;
255      }
256    }
257  }
258  
259  // Copy and transfer ownership from src to dst (beware of parameter order!)
WebPGrabDecBuffer(WebPDecBuffer * const src,WebPDecBuffer * const dst)260  void WebPGrabDecBuffer(WebPDecBuffer* const src, WebPDecBuffer* const dst) {
261    if (src != NULL && dst != NULL) {
262      *dst = *src;
263      if (src->private_memory != NULL) {
264        src->is_external_memory = 1;   // src relinquishes ownership
265        src->private_memory = NULL;
266      }
267    }
268  }
269  
WebPCopyDecBufferPixels(const WebPDecBuffer * const src_buf,WebPDecBuffer * const dst_buf)270  VP8StatusCode WebPCopyDecBufferPixels(const WebPDecBuffer* const src_buf,
271                                        WebPDecBuffer* const dst_buf) {
272    assert(src_buf != NULL && dst_buf != NULL);
273    assert(src_buf->colorspace == dst_buf->colorspace);
274  
275    dst_buf->width = src_buf->width;
276    dst_buf->height = src_buf->height;
277    if (CheckDecBuffer(dst_buf) != VP8_STATUS_OK) {
278      return VP8_STATUS_INVALID_PARAM;
279    }
280    if (WebPIsRGBMode(src_buf->colorspace)) {
281      const WebPRGBABuffer* const src = &src_buf->u.RGBA;
282      const WebPRGBABuffer* const dst = &dst_buf->u.RGBA;
283      WebPCopyPlane(src->rgba, src->stride, dst->rgba, dst->stride,
284                    src_buf->width * kModeBpp[src_buf->colorspace],
285                    src_buf->height);
286    } else {
287      const WebPYUVABuffer* const src = &src_buf->u.YUVA;
288      const WebPYUVABuffer* const dst = &dst_buf->u.YUVA;
289      WebPCopyPlane(src->y, src->y_stride, dst->y, dst->y_stride,
290                    src_buf->width, src_buf->height);
291      WebPCopyPlane(src->u, src->u_stride, dst->u, dst->u_stride,
292                    (src_buf->width + 1) / 2, (src_buf->height + 1) / 2);
293      WebPCopyPlane(src->v, src->v_stride, dst->v, dst->v_stride,
294                    (src_buf->width + 1) / 2, (src_buf->height + 1) / 2);
295      if (WebPIsAlphaMode(src_buf->colorspace)) {
296        WebPCopyPlane(src->a, src->a_stride, dst->a, dst->a_stride,
297                      src_buf->width, src_buf->height);
298      }
299    }
300    return VP8_STATUS_OK;
301  }
302  
WebPAvoidSlowMemory(const WebPDecBuffer * const output,const WebPBitstreamFeatures * const features)303  int WebPAvoidSlowMemory(const WebPDecBuffer* const output,
304                          const WebPBitstreamFeatures* const features) {
305    assert(output != NULL);
306    return (output->is_external_memory >= 2) &&
307           WebPIsPremultipliedMode(output->colorspace) &&
308           (features != NULL && features->has_alpha);
309  }
310  
311  //------------------------------------------------------------------------------
312