FFmpeg
c93.c
Go to the documentation of this file.
1 /*
2  * Interplay C93 video decoder
3  * Copyright (c) 2007 Anssi Hannula <anssi.hannula@gmail.com>
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg 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.
11  *
12  * FFmpeg 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.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 #include "avcodec.h"
23 #include "bytestream.h"
24 #include "codec_internal.h"
25 #include "decode.h"
26 #include "libavutil/attributes.h"
27 
28 typedef struct C93DecoderContext {
32 
33 typedef enum {
41  C93_NOOP = 0x0E,
42  C93_8X8_INTRA = 0x0F,
43 } C93BlockType;
44 
45 #define WIDTH 320
46 #define HEIGHT 192
47 
48 #define C93_HAS_PALETTE 0x01
49 #define C93_FIRST_FRAME 0x02
50 
51 static av_cold int decode_end(AVCodecContext *avctx)
52 {
53  C93DecoderContext * const c93 = avctx->priv_data;
54 
55  av_frame_free(&c93->pictures[0]);
56  av_frame_free(&c93->pictures[1]);
57 
58  return 0;
59 }
60 
62 {
63  C93DecoderContext *s = avctx->priv_data;
64  avctx->pix_fmt = AV_PIX_FMT_PAL8;
65 
66  s->pictures[0] = av_frame_alloc();
67  s->pictures[1] = av_frame_alloc();
68  if (!s->pictures[0] || !s->pictures[1])
69  return AVERROR(ENOMEM);
70 
71  return 0;
72 }
73 
74 static inline int copy_block(AVCodecContext *avctx, uint8_t *to,
75  uint8_t *from, int offset, int height, int stride)
76 {
77  int i;
78  int width = height;
79  int from_x = offset % WIDTH;
80  int from_y = offset / WIDTH;
81  int overflow = from_x + width - WIDTH;
82 
83  if (!from) {
84  /* silently ignoring predictive blocks in first frame */
85  return 0;
86  }
87 
88  if (from_y + height > HEIGHT) {
89  av_log(avctx, AV_LOG_ERROR, "invalid offset %d during C93 decoding\n",
90  offset);
91  return AVERROR_INVALIDDATA;
92  }
93 
94  if (overflow > 0) {
95  width -= overflow;
96  for (i = 0; i < height; i++) {
97  memcpy(&to[i*stride+width], &from[(from_y+i)*stride], overflow);
98  }
99  }
100 
101  for (i = 0; i < height; i++) {
102  memcpy(&to[i*stride], &from[(from_y+i)*stride+from_x], width);
103  }
104 
105  return 0;
106 }
107 
108 static inline void draw_n_color(uint8_t *out, int stride, int width,
109  int height, int bpp, uint8_t cols[4], uint8_t grps[4], uint32_t col)
110 {
111  int x, y;
112  for (y = 0; y < height; y++) {
113  if (grps)
114  cols[0] = grps[3 * (y >> 1)];
115  for (x = 0; x < width; x++) {
116  if (grps)
117  cols[1]= grps[(x >> 1) + 1];
118  out[x + y*stride] = cols[col & ((1 << bpp) - 1)];
119  col >>= bpp;
120  }
121  }
122 }
123 
124 static int decode_frame(AVCodecContext *avctx, AVFrame *rframe,
125  int *got_frame, AVPacket *avpkt)
126 {
127  const uint8_t *buf = avpkt->data;
128  int buf_size = avpkt->size;
129  C93DecoderContext * const c93 = avctx->priv_data;
130  AVFrame * const newpic = c93->pictures[c93->currentpic];
131  AVFrame * const oldpic = c93->pictures[c93->currentpic^1];
132  GetByteContext gb;
133  uint8_t *out;
134  int ret, i, x, y, b, bt = 0;
135  ptrdiff_t stride;
136 
137  if ((ret = ff_set_dimensions(avctx, WIDTH, HEIGHT)) < 0)
138  return ret;
139 
140  c93->currentpic ^= 1;
141 
142  if ((ret = ff_reget_buffer(avctx, newpic, 0)) < 0)
143  return ret;
144 
145  stride = newpic->linesize[0];
146 
147  bytestream2_init(&gb, buf, buf_size);
148  b = bytestream2_get_byte(&gb);
149  if (b & C93_FIRST_FRAME) {
150  newpic->pict_type = AV_PICTURE_TYPE_I;
151  newpic->flags |= AV_FRAME_FLAG_KEY;
152  } else {
153  newpic->pict_type = AV_PICTURE_TYPE_P;
154  newpic->flags &= ~AV_FRAME_FLAG_KEY;
155  }
156 
157  for (y = 0; y < HEIGHT; y += 8) {
158  out = newpic->data[0] + y * stride;
159  for (x = 0; x < WIDTH; x += 8) {
160  uint8_t *copy_from = oldpic->data[0];
161  uint8_t cols[4], grps[4];
162  C93BlockType block_type;
163 
164  if (!bt)
165  bt = bytestream2_get_byte(&gb);
166 
167  block_type= bt & 0x0F;
168  switch (block_type) {
169  case C93_8X8_FROM_PREV: {
170  int offset = bytestream2_get_le16(&gb);
171  if ((ret = copy_block(avctx, out, copy_from, offset, 8, stride)) < 0)
172  return ret;
173  break;
174  }
175 
176  case C93_4X4_FROM_CURR:
177  copy_from = newpic->data[0];
179  case C93_4X4_FROM_PREV:
180  for (int j = 0; j < 8; j += 4) {
181  for (i = 0; i < 8; i += 4) {
182  int offset = bytestream2_get_le16(&gb);
183  int from_x = offset % WIDTH;
184  int from_y = offset / WIDTH;
185  if (block_type == C93_4X4_FROM_CURR && from_y == y+j &&
186  (FFABS(from_x - x-i) < 4 || FFABS(from_x - x-i) > WIDTH-4)) {
187  avpriv_request_sample(avctx, "block overlap %d %d %d %d", from_x, x+i, from_y, y+j);
188  return AVERROR_INVALIDDATA;
189  }
190  if ((ret = copy_block(avctx, &out[j*stride+i],
191  copy_from, offset, 4, stride)) < 0)
192  return ret;
193  }
194  }
195  break;
196 
197  case C93_8X8_2COLOR:
198  bytestream2_get_buffer(&gb, cols, 2);
199  for (i = 0; i < 8; i++) {
200  draw_n_color(out + i*stride, stride, 8, 1, 1, cols,
201  NULL, bytestream2_get_byte(&gb));
202  }
203 
204  break;
205 
206  case C93_4X4_2COLOR:
207  case C93_4X4_4COLOR:
208  case C93_4X4_4COLOR_GRP:
209  for (int j = 0; j < 8; j += 4) {
210  for (i = 0; i < 8; i += 4) {
211  if (block_type == C93_4X4_2COLOR) {
212  bytestream2_get_buffer(&gb, cols, 2);
213  draw_n_color(out + i + j*stride, stride, 4, 4,
214  1, cols, NULL, bytestream2_get_le16(&gb));
215  } else if (block_type == C93_4X4_4COLOR) {
216  bytestream2_get_buffer(&gb, cols, 4);
217  draw_n_color(out + i + j*stride, stride, 4, 4,
218  2, cols, NULL, bytestream2_get_le32(&gb));
219  } else {
220  bytestream2_get_buffer(&gb, grps, 4);
221  draw_n_color(out + i + j*stride, stride, 4, 4,
222  1, cols, grps, bytestream2_get_le16(&gb));
223  }
224  }
225  }
226  break;
227 
228  case C93_NOOP:
229  break;
230 
231  case C93_8X8_INTRA:
232  for (int j = 0; j < 8; j++)
233  bytestream2_get_buffer(&gb, out + j*stride, 8);
234  break;
235 
236  default:
237  av_log(avctx, AV_LOG_ERROR, "unexpected type %x at %dx%d\n",
238  block_type, x, y);
239  return AVERROR_INVALIDDATA;
240  }
241  bt >>= 4;
242  out += 8;
243  }
244  }
245 
246  if (b & C93_HAS_PALETTE) {
247  uint32_t *palette = (uint32_t *) newpic->data[1];
248  for (i = 0; i < 256; i++) {
249  palette[i] = 0xFFU << 24 | bytestream2_get_be24(&gb);
250  }
251  } else {
252  if (oldpic->data[1])
253  memcpy(newpic->data[1], oldpic->data[1], 256 * 4);
254  }
255 
256  if ((ret = av_frame_ref(rframe, newpic)) < 0)
257  return ret;
258  *got_frame = 1;
259 
260  return buf_size;
261 }
262 
264  .p.name = "c93",
265  CODEC_LONG_NAME("Interplay C93"),
266  .p.type = AVMEDIA_TYPE_VIDEO,
267  .p.id = AV_CODEC_ID_C93,
268  .priv_data_size = sizeof(C93DecoderContext),
269  .init = decode_init,
270  .close = decode_end,
272  .p.capabilities = AV_CODEC_CAP_DR1,
273  .caps_internal = FF_CODEC_CAP_INIT_CLEANUP,
274 };
C93DecoderContext::currentpic
int currentpic
Definition: c93.c:30
C93_FIRST_FRAME
#define C93_FIRST_FRAME
Definition: c93.c:49
C93DecoderContext
Definition: c93.c:28
FF_CODEC_CAP_INIT_CLEANUP
#define FF_CODEC_CAP_INIT_CLEANUP
The codec allows calling the close function for deallocation even if the init function returned a fai...
Definition: codec_internal.h:43
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
out
static FILE * out
Definition: movenc.c:55
C93_8X8_2COLOR
@ C93_8X8_2COLOR
Definition: c93.c:37
GetByteContext
Definition: bytestream.h:33
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:64
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:435
AVPacket::data
uint8_t * data
Definition: packet.h:595
b
#define b
Definition: input.c:43
FFCodec
Definition: codec_internal.h:127
decode_frame
static int decode_frame(AVCodecContext *avctx, AVFrame *rframe, int *got_frame, AVPacket *avpkt)
Definition: c93.c:124
AVFrame::flags
int flags
Frame flags, a combination of AV_FRAME_FLAGS.
Definition: frame.h:679
ff_set_dimensions
int ff_set_dimensions(AVCodecContext *s, int width, int height)
Check that the provided frame dimensions are valid and set them on the codec context.
Definition: utils.c:91
AVFrame::data
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:456
close
static av_cold void close(AVCodecParserContext *s)
Definition: apv_parser.c:197
FFCodec::p
AVCodec p
The public AVCodec.
Definition: codec_internal.h:131
av_frame_alloc
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
Definition: frame.c:52
C93_NOOP
@ C93_NOOP
Definition: c93.c:41
C93_4X4_2COLOR
@ C93_4X4_2COLOR
Definition: c93.c:38
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:210
C93_HAS_PALETTE
#define C93_HAS_PALETTE
Definition: c93.c:48
av_cold
#define av_cold
Definition: attributes.h:119
AV_FRAME_FLAG_KEY
#define AV_FRAME_FLAG_KEY
A flag to mark frames that are keyframes.
Definition: frame.h:650
FF_CODEC_DECODE_CB
#define FF_CODEC_DECODE_CB(func)
Definition: codec_internal.h:347
s
#define s(width, name)
Definition: cbs_vp9.c:198
from
const char * from
Definition: jacosubdec.c:64
decode.h
decode_init
static av_cold int decode_init(AVCodecContext *avctx)
Definition: c93.c:61
C93BlockType
C93BlockType
Definition: c93.c:33
av_fallthrough
#define av_fallthrough
Definition: attributes.h:67
CODEC_LONG_NAME
#define CODEC_LONG_NAME(str)
Definition: codec_internal.h:332
decode_end
static av_cold int decode_end(AVCodecContext *avctx)
Definition: c93.c:51
FFABS
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Definition: common.h:74
NULL
#define NULL
Definition: coverity.c:32
AV_PICTURE_TYPE_I
@ AV_PICTURE_TYPE_I
Intra.
Definition: avutil.h:278
bytestream2_get_buffer
static av_always_inline unsigned int bytestream2_get_buffer(GetByteContext *g, uint8_t *dst, unsigned int size)
Definition: bytestream.h:267
C93_4X4_FROM_CURR
@ C93_4X4_FROM_CURR
Definition: c93.c:36
AVFrame::pict_type
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:527
init
int(* init)(AVBSFContext *ctx)
Definition: dts2pts.c:551
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
to
const char * to
Definition: webvttdec.c:35
AVPacket::size
int size
Definition: packet.h:596
height
#define height
Definition: dsp.h:89
av_frame_ref
int av_frame_ref(AVFrame *dst, const AVFrame *src)
Set up a new reference to the data described by the source frame.
Definition: frame.c:278
codec_internal.h
i
#define i(width, name, range_min, range_max)
Definition: cbs_h264.c:63
for
for(k=2;k<=8;++k)
Definition: h264pred_template.c:424
C93_8X8_FROM_PREV
@ C93_8X8_FROM_PREV
Definition: c93.c:34
WIDTH
#define WIDTH
Definition: c93.c:45
offset
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
Definition: writing_filters.txt:86
attributes.h
C93_4X4_4COLOR
@ C93_4X4_4COLOR
Definition: c93.c:40
C93_4X4_4COLOR_GRP
@ C93_4X4_4COLOR_GRP
Definition: c93.c:39
copy_from
static int copy_from(IpvideoContext *s, AVFrame *src, AVFrame *dst, int delta_x, int delta_y)
Definition: interplayvideo.c:78
HEIGHT
#define HEIGHT
Definition: c93.c:46
AV_CODEC_ID_C93
@ AV_CODEC_ID_C93
Definition: codec_id.h:154
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:179
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:639
avcodec.h
AV_PIX_FMT_PAL8
@ AV_PIX_FMT_PAL8
8 bits with AV_PIX_FMT_RGB32 palette
Definition: pixfmt.h:84
draw_n_color
static void draw_n_color(uint8_t *out, int stride, int width, int height, int bpp, uint8_t cols[4], uint8_t grps[4], uint32_t col)
Definition: c93.c:108
ff_reget_buffer
int ff_reget_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Identical in function to ff_get_buffer(), except it reuses the existing buffer if available.
Definition: decode.c:1894
ret
ret
Definition: filter_design.txt:187
C93_8X8_INTRA
@ C93_8X8_INTRA
Definition: c93.c:42
U
#define U(x)
Definition: vpx_arith.h:37
AVCodecContext
main external API structure.
Definition: avcodec.h:439
C93DecoderContext::pictures
AVFrame * pictures[2]
Definition: c93.c:29
C93_4X4_FROM_PREV
@ C93_4X4_FROM_PREV
Definition: c93.c:35
ff_c93_decoder
const FFCodec ff_c93_decoder
Definition: c93.c:263
AV_PICTURE_TYPE_P
@ AV_PICTURE_TYPE_P
Predicted.
Definition: avutil.h:279
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:200
overflow
Undefined Behavior In the C some operations are like signed integer overflow
Definition: undefined.txt:3
avpriv_request_sample
#define avpriv_request_sample(...)
Definition: tableprint_vlc.h:37
AVPacket
This structure stores compressed data.
Definition: packet.h:572
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:466
bytestream.h
bytestream2_init
static av_always_inline void bytestream2_init(GetByteContext *g, const uint8_t *buf, int buf_size)
Definition: bytestream.h:137
AVFrame::linesize
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
Definition: frame.h:480
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
stride
#define stride
Definition: h264pred_template.c:536
width
#define width
Definition: dsp.h:89
copy_block
static int copy_block(AVCodecContext *avctx, uint8_t *to, uint8_t *from, int offset, int height, int stride)
Definition: c93.c:74