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 (at) 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. 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 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 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 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 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 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 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 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!) 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 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 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