2 * IBM Ultimotion Video Decoder
3 * Copyright (C) 2004 Konstantin Shishkov
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 * IBM Ultimotion Video Decoder.
32 #include "bytestream.h"
36 typedef struct UltimotionDecodeContext {
37 AVCodecContext *avctx;
38 int width, height, blocks;
40 const uint8_t *ulti_codebook;
42 } UltimotionDecodeContext;
44 static av_cold int ulti_decode_init(AVCodecContext *avctx)
46 UltimotionDecodeContext *s = avctx->priv_data;
49 s->width = avctx->width;
50 s->height = avctx->height;
51 s->blocks = (s->width / 8) * (s->height / 8);
52 avctx->pix_fmt = AV_PIX_FMT_YUV410P;
53 avctx->coded_frame = &s->frame;
54 s->ulti_codebook = ulti_codebook;
59 static av_cold int ulti_decode_end(AVCodecContext *avctx){
60 UltimotionDecodeContext *s = avctx->priv_data;
61 AVFrame *pic = &s->frame;
64 avctx->release_buffer(avctx, pic);
69 static const int block_coords[8] = // 4x4 block coords in 8x8 superblock
70 { 0, 0, 0, 4, 4, 4, 4, 0};
72 static const int angle_by_index[4] = { 0, 2, 6, 12};
74 /* Lookup tables for luma and chroma - used by ulti_convert_yuv() */
75 static const uint8_t ulti_lumas[64] =
76 { 0x10, 0x13, 0x17, 0x1A, 0x1E, 0x21, 0x25, 0x28,
77 0x2C, 0x2F, 0x33, 0x36, 0x3A, 0x3D, 0x41, 0x44,
78 0x48, 0x4B, 0x4F, 0x52, 0x56, 0x59, 0x5C, 0x60,
79 0x63, 0x67, 0x6A, 0x6E, 0x71, 0x75, 0x78, 0x7C,
80 0x7F, 0x83, 0x86, 0x8A, 0x8D, 0x91, 0x94, 0x98,
81 0x9B, 0x9F, 0xA2, 0xA5, 0xA9, 0xAC, 0xB0, 0xB3,
82 0xB7, 0xBA, 0xBE, 0xC1, 0xC5, 0xC8, 0xCC, 0xCF,
83 0xD3, 0xD6, 0xDA, 0xDD, 0xE1, 0xE4, 0xE8, 0xEB};
85 static const uint8_t ulti_chromas[16] =
86 { 0x60, 0x67, 0x6D, 0x73, 0x7A, 0x80, 0x86, 0x8D,
87 0x93, 0x99, 0xA0, 0xA6, 0xAC, 0xB3, 0xB9, 0xC0};
89 /* convert Ultimotion YUV block (sixteen 6-bit Y samples and
90 two 4-bit chroma samples) into standard YUV and put it into frame */
91 static void ulti_convert_yuv(AVFrame *frame, int x, int y,
92 uint8_t *luma,int chroma)
94 uint8_t *y_plane, *cr_plane, *cb_plane;
97 y_plane = frame->data[0] + x + y * frame->linesize[0];
98 cr_plane = frame->data[1] + (x / 4) + (y / 4) * frame->linesize[1];
99 cb_plane = frame->data[2] + (x / 4) + (y / 4) * frame->linesize[2];
101 cr_plane[0] = ulti_chromas[chroma >> 4];
103 cb_plane[0] = ulti_chromas[chroma & 0xF];
106 for(i = 0; i < 16; i++){
107 y_plane[i & 3] = ulti_lumas[luma[i]];
108 if((i & 3) == 3) { //next row
109 y_plane += frame->linesize[0];
114 /* generate block like in MS Video1 */
115 static void ulti_pattern(AVFrame *frame, int x, int y,
116 int f0, int f1, int Y0, int Y1, int chroma)
120 for(mask = 0x80, i = 0; mask; mask >>= 1, i++) {
127 for(mask = 0x80, i = 8; mask; mask >>= 1, i++) {
134 ulti_convert_yuv(frame, x, y, Luma, chroma);
137 /* fill block with some gradient */
138 static void ulti_grad(AVFrame *frame, int x, int y, uint8_t *Y, int chroma, int angle)
141 if(angle & 8) { //reverse order
153 Luma[0] = Y[0]; Luma[1] = Y[1]; Luma[2] = Y[2]; Luma[3] = Y[3];
154 Luma[4] = Y[0]; Luma[5] = Y[1]; Luma[6] = Y[2]; Luma[7] = Y[3];
155 Luma[8] = Y[0]; Luma[9] = Y[1]; Luma[10] = Y[2]; Luma[11] = Y[3];
156 Luma[12] = Y[0]; Luma[13] = Y[1]; Luma[14] = Y[2]; Luma[15] = Y[3];
159 Luma[0] = Y[1]; Luma[1] = Y[2]; Luma[2] = Y[3]; Luma[3] = Y[3];
160 Luma[4] = Y[0]; Luma[5] = Y[1]; Luma[6] = Y[2]; Luma[7] = Y[3];
161 Luma[8] = Y[0]; Luma[9] = Y[1]; Luma[10] = Y[2]; Luma[11] = Y[3];
162 Luma[12] = Y[0]; Luma[13] = Y[0]; Luma[14] = Y[1]; Luma[15] = Y[2];
165 Luma[0] = Y[1]; Luma[1] = Y[2]; Luma[2] = Y[3]; Luma[3] = Y[3];
166 Luma[4] = Y[1]; Luma[5] = Y[2]; Luma[6] = Y[2]; Luma[7] = Y[3];
167 Luma[8] = Y[0]; Luma[9] = Y[1]; Luma[10] = Y[1]; Luma[11] = Y[2];
168 Luma[12] = Y[0]; Luma[13] = Y[0]; Luma[14] = Y[1]; Luma[15] = Y[2];
171 Luma[0] = Y[2]; Luma[1] = Y[3]; Luma[2] = Y[3]; Luma[3] = Y[3];
172 Luma[4] = Y[1]; Luma[5] = Y[2]; Luma[6] = Y[2]; Luma[7] = Y[3];
173 Luma[8] = Y[0]; Luma[9] = Y[1]; Luma[10] = Y[1]; Luma[11] = Y[2];
174 Luma[12] = Y[0]; Luma[13] = Y[0]; Luma[14] = Y[0]; Luma[15] = Y[1];
177 Luma[0] = Y[3]; Luma[1] = Y[3]; Luma[2] = Y[3]; Luma[3] = Y[3];
178 Luma[4] = Y[2]; Luma[5] = Y[2]; Luma[6] = Y[2]; Luma[7] = Y[2];
179 Luma[8] = Y[1]; Luma[9] = Y[1]; Luma[10] = Y[1]; Luma[11] = Y[1];
180 Luma[12] = Y[0]; Luma[13] = Y[0]; Luma[14] = Y[0]; Luma[15] = Y[0];
183 Luma[0] = Y[3]; Luma[1] = Y[3]; Luma[2] = Y[3]; Luma[3] = Y[2];
184 Luma[4] = Y[3]; Luma[5] = Y[2]; Luma[6] = Y[2]; Luma[7] = Y[1];
185 Luma[8] = Y[2]; Luma[9] = Y[1]; Luma[10] = Y[1]; Luma[11] = Y[0];
186 Luma[12] = Y[1]; Luma[13] = Y[0]; Luma[14] = Y[0]; Luma[15] = Y[0];
189 Luma[0] = Y[3]; Luma[1] = Y[3]; Luma[2] = Y[2]; Luma[3] = Y[2];
190 Luma[4] = Y[3]; Luma[5] = Y[2]; Luma[6] = Y[1]; Luma[7] = Y[1];
191 Luma[8] = Y[2]; Luma[9] = Y[2]; Luma[10] = Y[1]; Luma[11] = Y[0];
192 Luma[12] = Y[1]; Luma[13] = Y[1]; Luma[14] = Y[0]; Luma[15] = Y[0];
195 Luma[0] = Y[3]; Luma[1] = Y[3]; Luma[2] = Y[2]; Luma[3] = Y[1];
196 Luma[4] = Y[3]; Luma[5] = Y[2]; Luma[6] = Y[1]; Luma[7] = Y[0];
197 Luma[8] = Y[3]; Luma[9] = Y[2]; Luma[10] = Y[1]; Luma[11] = Y[0];
198 Luma[12] = Y[2]; Luma[13] = Y[1]; Luma[14] = Y[0]; Luma[15] = Y[0];
201 Luma[0] = Y[0]; Luma[1] = Y[0]; Luma[2] = Y[1]; Luma[3] = Y[1];
202 Luma[4] = Y[0]; Luma[5] = Y[0]; Luma[6] = Y[1]; Luma[7] = Y[1];
203 Luma[8] = Y[2]; Luma[9] = Y[2]; Luma[10] = Y[3]; Luma[11] = Y[3];
204 Luma[12] = Y[2]; Luma[13] = Y[2]; Luma[14] = Y[3]; Luma[15] = Y[3];
208 ulti_convert_yuv(frame, x, y, Luma, chroma);
211 static int ulti_decode_frame(AVCodecContext *avctx,
212 void *data, int *data_size,
215 const uint8_t *buf = avpkt->data;
216 int buf_size = avpkt->size;
217 UltimotionDecodeContext *s=avctx->priv_data;
228 s->frame.reference = 1;
229 s->frame.buffer_hints = FF_BUFFER_HINTS_VALID | FF_BUFFER_HINTS_PRESERVE | FF_BUFFER_HINTS_REUSABLE;
230 if (avctx->reget_buffer(avctx, &s->frame) < 0) {
231 av_log(avctx, AV_LOG_ERROR, "reget_buffer() failed\n");
235 bytestream2_init(&s->gb, buf, buf_size);
239 if(blocks >= s->blocks || y >= s->height)
240 break;//all blocks decoded
242 if (bytestream2_get_bytes_left(&s->gb) < 1)
244 idx = bytestream2_get_byteu(&s->gb);
245 if((idx & 0xF8) == 0x70) {
247 case 0x70: //change modifier
248 modifier = bytestream2_get_byte(&s->gb);
250 av_log(avctx, AV_LOG_INFO, "warning: modifier must be 0 or 1, got %i\n", modifier);
252 case 0x71: // set uniq flag
255 case 0x72: //toggle mode
258 case 0x73: //end-of-frame
261 case 0x74: //skip some blocks
262 skip = bytestream2_get_byte(&s->gb);
263 if ((blocks + skip) >= s->blocks)
267 while(x >= s->width) {
273 av_log(avctx, AV_LOG_INFO, "warning: unknown escape 0x%02X\n", idx);
275 } else { //handle one block
279 uint8_t Y[4]; // luma samples of block
280 int tx = 0, ty = 0; //coords of subblock
289 chroma = bytestream2_get_byte(&s->gb);
292 for (i = 0; i < 4; i++) { // for every subblock
293 code = (idx >> (6 - i*2)) & 3; //extract 2 bits
294 if(!code) //skip subblock
297 chroma = bytestream2_get_byte(&s->gb);
299 tx = x + block_coords[i * 2];
300 ty = y + block_coords[(i * 2) + 1];
303 tmp = bytestream2_get_byte(&s->gb);
305 angle = angle_by_index[(tmp >> 6) & 0x3];
322 if (modifier) { // unpack four luma samples
323 tmp = bytestream2_get_be24(&s->gb);
325 Y[0] = (tmp >> 18) & 0x3F;
326 Y[1] = (tmp >> 12) & 0x3F;
327 Y[2] = (tmp >> 6) & 0x3F;
330 } else { // retrieve luma samples from codebook
331 tmp = bytestream2_get_be16(&s->gb);
333 angle = (tmp >> 12) & 0xF;
336 Y[0] = s->ulti_codebook[tmp];
337 Y[1] = s->ulti_codebook[tmp + 1];
338 Y[2] = s->ulti_codebook[tmp + 2];
339 Y[3] = s->ulti_codebook[tmp + 3];
344 if (modifier) { // all 16 luma samples
347 if (bytestream2_get_bytes_left(&s->gb) < 12)
349 tmp = bytestream2_get_be24u(&s->gb);
350 Luma[0] = (tmp >> 18) & 0x3F;
351 Luma[1] = (tmp >> 12) & 0x3F;
352 Luma[2] = (tmp >> 6) & 0x3F;
353 Luma[3] = tmp & 0x3F;
355 tmp = bytestream2_get_be24u(&s->gb);
356 Luma[4] = (tmp >> 18) & 0x3F;
357 Luma[5] = (tmp >> 12) & 0x3F;
358 Luma[6] = (tmp >> 6) & 0x3F;
359 Luma[7] = tmp & 0x3F;
361 tmp = bytestream2_get_be24u(&s->gb);
362 Luma[8] = (tmp >> 18) & 0x3F;
363 Luma[9] = (tmp >> 12) & 0x3F;
364 Luma[10] = (tmp >> 6) & 0x3F;
365 Luma[11] = tmp & 0x3F;
367 tmp = bytestream2_get_be24u(&s->gb);
368 Luma[12] = (tmp >> 18) & 0x3F;
369 Luma[13] = (tmp >> 12) & 0x3F;
370 Luma[14] = (tmp >> 6) & 0x3F;
371 Luma[15] = tmp & 0x3F;
373 ulti_convert_yuv(&s->frame, tx, ty, Luma, chroma);
375 if (bytestream2_get_bytes_left(&s->gb) < 4)
377 tmp = bytestream2_get_byteu(&s->gb);
379 angle = (tmp >> 4) & 0x7;
380 tmp = (tmp << 8) + bytestream2_get_byteu(&s->gb);
381 Y[0] = (tmp >> 6) & 0x3F;
383 Y[2] = bytestream2_get_byteu(&s->gb) & 0x3F;
384 Y[3] = bytestream2_get_byteu(&s->gb) & 0x3F;
385 ulti_grad(&s->frame, tx, ty, Y, chroma, angle); //draw block
386 } else { // some patterns
388 f0 = bytestream2_get_byteu(&s->gb);
390 Y[0] = bytestream2_get_byteu(&s->gb) & 0x3F;
391 Y[1] = bytestream2_get_byteu(&s->gb) & 0x3F;
392 ulti_pattern(&s->frame, tx, ty, f1, f0, Y[0], Y[1], chroma);
398 ulti_grad(&s->frame, tx, ty, Y, chroma, angle); // draw block
409 *data_size=sizeof(AVFrame);
410 *(AVFrame*)data= s->frame;
415 av_log(avctx, AV_LOG_ERROR,
416 "Insufficient data\n");
417 return AVERROR_INVALIDDATA;
420 AVCodec ff_ulti_decoder = {
421 .name = "ultimotion",
422 .type = AVMEDIA_TYPE_VIDEO,
423 .id = AV_CODEC_ID_ULTI,
424 .priv_data_size = sizeof(UltimotionDecodeContext),
425 .init = ulti_decode_init,
426 .close = ulti_decode_end,
427 .decode = ulti_decode_frame,
428 .capabilities = CODEC_CAP_DR1,
429 .long_name = NULL_IF_CONFIG_SMALL("IBM UltiMotion"),