2 * Lagarith lossless decoder
3 * Copyright (c) 2009 Nathan Caldwell <saintdev (at) gmail.com>
5 * This file is part of Libav.
7 * Libav is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * Libav is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 * Lagarith lossless decoder
25 * @author Nathan Caldwell
32 #include "lagarithrac.h"
35 enum LagarithFrameType {
36 FRAME_RAW = 1, /**< uncompressed */
37 FRAME_U_RGB24 = 2, /**< unaligned RGB24 */
38 FRAME_ARITH_YUY2 = 3, /**< arithmetic coded YUY2 */
39 FRAME_ARITH_RGB24 = 4, /**< arithmetic coded RGB24 */
40 FRAME_SOLID_GRAY = 5, /**< solid grayscale color frame */
41 FRAME_SOLID_COLOR = 6, /**< solid non-grayscale color frame */
42 FRAME_OLD_ARITH_RGB = 7, /**< obsolete arithmetic coded RGB (no longer encoded by upstream since version 1.1.0) */
43 FRAME_ARITH_RGBA = 8, /**< arithmetic coded RGBA */
44 FRAME_SOLID_RGBA = 9, /**< solid RGBA color frame */
45 FRAME_ARITH_YV12 = 10, /**< arithmetic coded YV12 */
46 FRAME_REDUCED_RES = 11, /**< reduced resolution YV12 frame */
49 typedef struct LagarithContext {
50 AVCodecContext *avctx;
53 int zeros; /**< number of consecutive zero bytes encountered */
54 int zeros_rem; /**< number of zero bytes remaining to output */
60 * Compute the 52bit mantissa of 1/(double)denom.
61 * This crazy format uses floats in an entropy coder and we have to match x86
62 * rounding exactly, thus ordinary floats aren't portable enough.
63 * @param denom denominator
64 * @return 52bit mantissa
67 static uint64_t softfloat_reciprocal(uint32_t denom)
69 int shift = av_log2(denom - 1) + 1;
70 uint64_t ret = (1ULL << 52) / denom;
71 uint64_t err = (1ULL << 52) - ret * denom;
75 return ret + err / denom;
79 * (uint32_t)(x*f), where f has the given mantissa, and exponent 0
80 * Used in combination with softfloat_reciprocal computes x/(double)denom.
81 * @param x 32bit integer factor
82 * @param mantissa mantissa of f with exponent 0
83 * @return 32bit integer value (x*f)
84 * @see softfloat_reciprocal
86 static uint32_t softfloat_mul(uint32_t x, uint64_t mantissa)
88 uint64_t l = x * (mantissa & 0xffffffff);
89 uint64_t h = x * (mantissa >> 32);
92 l += 1 << av_log2(h >> 21);
97 static uint8_t lag_calc_zero_run(int8_t x)
99 return (x << 1) ^ (x >> 7);
102 static int lag_decode_prob(GetBitContext *gb, uint32_t *value)
104 static const uint8_t series[] = { 1, 2, 3, 5, 8, 13, 21 };
111 for (i = 0; i < 7; i++) {
120 if (bits < 0 || bits > 31) {
123 } else if (bits == 0) {
128 val = get_bits_long(gb, bits);
136 static int lag_read_prob_header(lag_rac *rac, GetBitContext *gb)
138 int i, j, scale_factor;
139 unsigned prob, cumulative_target;
140 unsigned cumul_prob = 0;
141 unsigned scaled_cumul_prob = 0;
144 rac->prob[257] = UINT_MAX;
145 /* Read probabilities from bitstream */
146 for (i = 1; i < 257; i++) {
147 if (lag_decode_prob(gb, &rac->prob[i]) < 0) {
148 av_log(rac->avctx, AV_LOG_ERROR, "Invalid probability encountered.\n");
151 if ((uint64_t)cumul_prob + rac->prob[i] > UINT_MAX) {
152 av_log(rac->avctx, AV_LOG_ERROR, "Integer overflow encountered in cumulative probability calculation.\n");
155 cumul_prob += rac->prob[i];
157 if (lag_decode_prob(gb, &prob)) {
158 av_log(rac->avctx, AV_LOG_ERROR, "Invalid probability run encountered.\n");
163 for (j = 0; j < prob; j++)
169 av_log(rac->avctx, AV_LOG_ERROR, "All probabilities are 0!\n");
173 /* Scale probabilities so cumulative probability is an even power of 2. */
174 scale_factor = av_log2(cumul_prob);
176 if (cumul_prob & (cumul_prob - 1)) {
177 uint64_t mul = softfloat_reciprocal(cumul_prob);
178 for (i = 1; i < 257; i++) {
179 rac->prob[i] = softfloat_mul(rac->prob[i], mul);
180 scaled_cumul_prob += rac->prob[i];
184 cumulative_target = 1 << scale_factor;
186 if (scaled_cumul_prob > cumulative_target) {
187 av_log(rac->avctx, AV_LOG_ERROR,
188 "Scaled probabilities are larger than target!\n");
192 scaled_cumul_prob = cumulative_target - scaled_cumul_prob;
194 for (i = 1; scaled_cumul_prob; i = (i & 0x7f) + 1) {
199 /* Comment from reference source:
200 * if (b & 0x80 == 0) { // order of operations is 'wrong'; it has been left this way
201 * // since the compression change is negligable and fixing it
202 * // breaks backwards compatibilty
203 * b =- (signed int)b;
213 rac->scale = scale_factor;
215 /* Fill probability array with cumulative probability for each symbol. */
216 for (i = 1; i < 257; i++)
217 rac->prob[i] += rac->prob[i - 1];
222 static void add_lag_median_prediction(uint8_t *dst, uint8_t *src1,
223 uint8_t *diff, int w, int *left,
226 /* This is almost identical to add_hfyu_median_prediction in dsputil.h.
227 * However the &0xFF on the gradient predictor yealds incorrect output
236 for (i = 0; i < w; i++) {
237 l = mid_pred(l, src1[i], l + src1[i] - lt) + diff[i];
246 static void lag_pred_line(LagarithContext *l, uint8_t *buf,
247 int width, int stride, int line)
252 /* Left prediction only for first line */
253 L = l->dsp.add_hfyu_left_prediction(buf + 1, buf + 1,
256 /* Left pixel is actually prev_row[width] */
257 L = buf[width - stride - 1];
260 /* Second line, left predict first pixel, the rest of the line is median predicted
261 * NOTE: In the case of RGB this pixel is top predicted */
262 TL = l->avctx->pix_fmt == AV_PIX_FMT_YUV420P ? buf[-stride] : L;
264 /* Top left is 2 rows back, last pixel */
265 TL = buf[width - (2 * stride) - 1];
268 add_lag_median_prediction(buf, buf - stride, buf,
273 static void lag_pred_line_yuy2(LagarithContext *l, uint8_t *buf,
274 int width, int stride, int line,
284 l->dsp.add_hfyu_left_prediction(buf + 1, buf + 1, width - 1, buf[0]);
288 const int HEAD = is_luma ? 4 : 2;
291 L = buf[width - stride - 1];
292 TL = buf[HEAD - stride - 1];
293 for (i = 0; i < HEAD; i++) {
300 TL = buf[width - (2 * stride) - 1];
301 L = buf[width - stride - 1];
303 l->dsp.add_hfyu_median_prediction(buf, buf - stride, buf, width,
307 static int lag_decode_line(LagarithContext *l, lag_rac *rac,
308 uint8_t *dst, int width, int stride,
317 /* Output any zeros remaining from the previous run */
320 int count = FFMIN(l->zeros_rem, width - i);
321 memset(dst + i, 0, count);
323 l->zeros_rem -= count;
327 dst[i] = lag_get_rac(rac);
336 if (l->zeros == esc_count) {
337 int index = lag_get_rac(rac);
342 l->zeros_rem = lag_calc_zero_run(index);
349 static int lag_decode_zero_run_line(LagarithContext *l, uint8_t *dst,
350 const uint8_t *src, const uint8_t *src_end,
351 int width, int esc_count)
355 uint8_t zero_run = 0;
356 const uint8_t *src_start = src;
357 uint8_t mask1 = -(esc_count < 2);
358 uint8_t mask2 = -(esc_count < 3);
359 uint8_t *end = dst + (width - 2);
363 count = FFMIN(l->zeros_rem, width - i);
364 if (end - dst < count) {
365 av_log(l->avctx, AV_LOG_ERROR, "Too many zeros remaining.\n");
366 return AVERROR_INVALIDDATA;
369 memset(dst, 0, count);
370 l->zeros_rem -= count;
376 while (!zero_run && dst + i < end) {
378 if (src + i >= src_end)
379 return AVERROR_INVALIDDATA;
381 !(src[i] | (src[i + 1] & mask1) | (src[i + 2] & mask2));
388 l->zeros_rem = lag_calc_zero_run(src[i]);
398 return src_start - src;
403 static int lag_decode_arith_plane(LagarithContext *l, uint8_t *dst,
404 int width, int height, int stride,
405 const uint8_t *src, int src_size)
411 int esc_count = src[0];
414 const uint8_t *src_end = src + src_size;
416 rac.avctx = l->avctx;
420 length = width * height;
421 if (esc_count && AV_RL32(src + 1) < length) {
422 length = AV_RL32(src + 1);
426 init_get_bits(&gb, src + offset, src_size * 8);
428 if (lag_read_prob_header(&rac, &gb) < 0)
431 ff_lag_rac_init(&rac, &gb, length - stride);
433 for (i = 0; i < height; i++)
434 read += lag_decode_line(l, &rac, dst + (i * stride), width,
438 av_log(l->avctx, AV_LOG_WARNING,
439 "Output more bytes than length (%d of %d)\n", read,
441 } else if (esc_count < 8) {
444 /* Zero run coding only, no range coding. */
445 for (i = 0; i < height; i++) {
446 int res = lag_decode_zero_run_line(l, dst + (i * stride), src,
447 src_end, width, esc_count);
453 if (src_size < width * height)
454 return AVERROR_INVALIDDATA; // buffer not big enough
455 /* Plane is stored uncompressed */
456 for (i = 0; i < height; i++) {
457 memcpy(dst + (i * stride), src, width);
461 } else if (esc_count == 0xff) {
462 /* Plane is a solid run of given value */
463 for (i = 0; i < height; i++)
464 memset(dst + i * stride, src[1], width);
465 /* Do not apply prediction.
466 Note: memset to 0 above, setting first value to src[1]
467 and applying prediction gives the same result. */
470 av_log(l->avctx, AV_LOG_ERROR,
471 "Invalid zero run escape code! (%#x)\n", esc_count);
475 if (l->avctx->pix_fmt != AV_PIX_FMT_YUV422P) {
476 for (i = 0; i < height; i++) {
477 lag_pred_line(l, dst, width, stride, i);
481 for (i = 0; i < height; i++) {
482 lag_pred_line_yuy2(l, dst, width, stride, i,
483 width == l->avctx->width);
493 * @param avctx codec context
494 * @param data output AVFrame
495 * @param data_size size of output data or 0 if no picture is returned
496 * @param avpkt input packet
497 * @return number of consumed bytes on success or negative if decode fails
499 static int lag_decode_frame(AVCodecContext *avctx,
500 void *data, int *data_size, AVPacket *avpkt)
502 const uint8_t *buf = avpkt->data;
503 int buf_size = avpkt->size;
504 LagarithContext *l = avctx->priv_data;
505 AVFrame *const p = &l->picture;
506 uint8_t frametype = 0;
507 uint32_t offset_gu = 0, offset_bv = 0, offset_ry = 9;
509 uint8_t *srcs[4], *dst;
510 int i, j, planes = 3;
512 AVFrame *picture = data;
515 ff_thread_release_buffer(avctx, p);
522 offset_gu = AV_RL32(buf + 1);
523 offset_bv = AV_RL32(buf + 5);
526 case FRAME_SOLID_RGBA:
527 avctx->pix_fmt = AV_PIX_FMT_RGB32;
529 if (ff_thread_get_buffer(avctx, p) < 0) {
530 av_log(avctx, AV_LOG_ERROR, "get_buffer() failed\n");
535 for (j = 0; j < avctx->height; j++) {
536 for (i = 0; i < avctx->width; i++)
537 AV_WN32(dst + i * 4, offset_gu);
538 dst += p->linesize[0];
541 case FRAME_ARITH_RGBA:
542 avctx->pix_fmt = AV_PIX_FMT_RGB32;
545 offs[3] = AV_RL32(buf + 9);
546 case FRAME_ARITH_RGB24:
548 if (frametype == FRAME_ARITH_RGB24 || frametype == FRAME_U_RGB24)
549 avctx->pix_fmt = AV_PIX_FMT_RGB24;
551 if (ff_thread_get_buffer(avctx, p) < 0) {
552 av_log(avctx, AV_LOG_ERROR, "get_buffer() failed\n");
560 if (!l->rgb_planes) {
561 l->rgb_stride = FFALIGN(avctx->width, 16);
562 l->rgb_planes = av_malloc(l->rgb_stride * avctx->height * planes + 1);
563 if (!l->rgb_planes) {
564 av_log(avctx, AV_LOG_ERROR, "cannot allocate temporary buffer\n");
565 return AVERROR(ENOMEM);
568 for (i = 0; i < planes; i++)
569 srcs[i] = l->rgb_planes + (i + 1) * l->rgb_stride * avctx->height - l->rgb_stride;
570 if (offset_ry >= buf_size ||
571 offset_gu >= buf_size ||
572 offset_bv >= buf_size ||
573 (planes == 4 && offs[3] >= buf_size)) {
574 av_log(avctx, AV_LOG_ERROR,
575 "Invalid frame offsets\n");
576 return AVERROR_INVALIDDATA;
578 for (i = 0; i < planes; i++)
579 lag_decode_arith_plane(l, srcs[i],
580 avctx->width, avctx->height,
581 -l->rgb_stride, buf + offs[i],
584 for (i = 0; i < planes; i++)
585 srcs[i] = l->rgb_planes + i * l->rgb_stride * avctx->height;
586 for (j = 0; j < avctx->height; j++) {
587 for (i = 0; i < avctx->width; i++) {
594 if (frametype == FRAME_ARITH_RGBA) {
596 AV_WN32(dst + i * 4, MKBETAG(a, r, g, b));
603 dst += p->linesize[0];
604 for (i = 0; i < planes; i++)
605 srcs[i] += l->rgb_stride;
608 case FRAME_ARITH_YUY2:
609 avctx->pix_fmt = AV_PIX_FMT_YUV422P;
611 if (ff_thread_get_buffer(avctx, p) < 0) {
612 av_log(avctx, AV_LOG_ERROR, "get_buffer() failed\n");
616 if (offset_ry >= buf_size ||
617 offset_gu >= buf_size ||
618 offset_bv >= buf_size) {
619 av_log(avctx, AV_LOG_ERROR,
620 "Invalid frame offsets\n");
621 return AVERROR_INVALIDDATA;
624 lag_decode_arith_plane(l, p->data[0], avctx->width, avctx->height,
625 p->linesize[0], buf + offset_ry,
626 buf_size - offset_ry);
627 lag_decode_arith_plane(l, p->data[1], avctx->width / 2,
628 avctx->height, p->linesize[1],
629 buf + offset_gu, buf_size - offset_gu);
630 lag_decode_arith_plane(l, p->data[2], avctx->width / 2,
631 avctx->height, p->linesize[2],
632 buf + offset_bv, buf_size - offset_bv);
634 case FRAME_ARITH_YV12:
635 avctx->pix_fmt = AV_PIX_FMT_YUV420P;
637 if (ff_thread_get_buffer(avctx, p) < 0) {
638 av_log(avctx, AV_LOG_ERROR, "get_buffer() failed\n");
642 if (offset_ry >= buf_size ||
643 offset_gu >= buf_size ||
644 offset_bv >= buf_size) {
645 av_log(avctx, AV_LOG_ERROR,
646 "Invalid frame offsets\n");
647 return AVERROR_INVALIDDATA;
650 lag_decode_arith_plane(l, p->data[0], avctx->width, avctx->height,
651 p->linesize[0], buf + offset_ry,
652 buf_size - offset_ry);
653 lag_decode_arith_plane(l, p->data[2], avctx->width / 2,
654 avctx->height / 2, p->linesize[2],
655 buf + offset_gu, buf_size - offset_gu);
656 lag_decode_arith_plane(l, p->data[1], avctx->width / 2,
657 avctx->height / 2, p->linesize[1],
658 buf + offset_bv, buf_size - offset_bv);
661 av_log(avctx, AV_LOG_ERROR,
662 "Unsupported Lagarith frame type: %#x\n", frametype);
667 *data_size = sizeof(AVFrame);
672 static av_cold int lag_decode_init(AVCodecContext *avctx)
674 LagarithContext *l = avctx->priv_data;
677 ff_dsputil_init(&l->dsp, avctx);
682 static av_cold int lag_decode_end(AVCodecContext *avctx)
684 LagarithContext *l = avctx->priv_data;
686 if (l->picture.data[0])
687 ff_thread_release_buffer(avctx, &l->picture);
688 av_freep(&l->rgb_planes);
693 AVCodec ff_lagarith_decoder = {
695 .type = AVMEDIA_TYPE_VIDEO,
696 .id = AV_CODEC_ID_LAGARITH,
697 .priv_data_size = sizeof(LagarithContext),
698 .init = lag_decode_init,
699 .close = lag_decode_end,
700 .decode = lag_decode_frame,
701 .capabilities = CODEC_CAP_DR1 | CODEC_CAP_FRAME_THREADS,
702 .long_name = NULL_IF_CONFIG_SMALL("Lagarith lossless"),