FFmpeg
qoidec.c
Go to the documentation of this file.
1 /*
2  * QOI image format
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #include <stdlib.h>
22 
23 #include "libavutil/imgutils.h"
24 #include "avcodec.h"
25 #include "internal.h"
26 #include "bytestream.h"
27 #include "codec_internal.h"
28 #include "thread.h"
29 #include "qoi.h"
30 
31 static int qoi_decode_frame(AVCodecContext *avctx, AVFrame *p,
32  int *got_frame, AVPacket *avpkt)
33 {
34  const uint8_t *buf = avpkt->data;
35  int ret, buf_size = avpkt->size;
36  int width, height, channels, space, run = 0;
37  uint8_t index[64][4] = { 0 };
38  uint8_t px[4] = { 0, 0, 0, 255 };
39  GetByteContext gb;
40  uint8_t *dst;
41  uint64_t len;
42 
43  if (buf_size < 20)
44  return AVERROR_INVALIDDATA;
45 
46  bytestream2_init(&gb, buf, buf_size);
47  bytestream2_skip(&gb, 4);
48  width = bytestream2_get_be32(&gb);
49  height = bytestream2_get_be32(&gb);
50  channels = bytestream2_get_byte(&gb);
51  space = bytestream2_get_byte(&gb);
52  switch (space) {
53  case 0: break;
54  case 1: avctx->color_trc = AVCOL_TRC_LINEAR; break;
55  default: return AVERROR_INVALIDDATA;
56  }
57 
58  if ((ret = ff_set_dimensions(avctx, width, height)) < 0)
59  return ret;
60 
61  switch (channels) {
62  case 3: avctx->pix_fmt = AV_PIX_FMT_RGB24; break;
63  case 4: avctx->pix_fmt = AV_PIX_FMT_RGBA; break;
64  default: return AVERROR_INVALIDDATA;
65  }
66 
67  if ((ret = ff_thread_get_buffer(avctx, p, 0)) < 0)
68  return ret;
69 
70  dst = p->data[0];
71  len = width * height * channels;
72  for (int n = 0, off_x = 0; n < len; n += channels, off_x++) {
73  if (off_x >= width) {
74  off_x = 0;
75  dst += p->linesize[0];
76  }
77  if (run > 0) {
78  run--;
79  } else if (bytestream2_get_bytes_left(&gb) > 4) {
80  int chunk = bytestream2_get_byteu(&gb);
81 
82  if (chunk == QOI_OP_RGB) {
83  bytestream2_get_bufferu(&gb, px, 3);
84  } else if (chunk == QOI_OP_RGBA) {
85  bytestream2_get_bufferu(&gb, px, 4);
86  } else if ((chunk & QOI_MASK_2) == QOI_OP_INDEX) {
87  memcpy(px, index[chunk], 4);
88  } else if ((chunk & QOI_MASK_2) == QOI_OP_DIFF) {
89  px[0] += ((chunk >> 4) & 0x03) - 2;
90  px[1] += ((chunk >> 2) & 0x03) - 2;
91  px[2] += ( chunk & 0x03) - 2;
92  } else if ((chunk & QOI_MASK_2) == QOI_OP_LUMA) {
93  int b2 = bytestream2_get_byteu(&gb);
94  int vg = (chunk & 0x3f) - 32;
95  px[0] += vg - 8 + ((b2 >> 4) & 0x0f);
96  px[1] += vg;
97  px[2] += vg - 8 + (b2 & 0x0f);
98  } else if ((chunk & QOI_MASK_2) == QOI_OP_RUN) {
99  run = chunk & 0x3f;
100  }
101 
102  memcpy(index[QOI_COLOR_HASH(px) & 63], px, 4);
103  } else {
104  break;
105  }
106 
107  memcpy(&dst[off_x * channels], px, channels);
108  }
109 
110  p->key_frame = 1;
112 
113  *got_frame = 1;
114 
115  return buf_size;
116 }
117 
119  .p.name = "qoi",
120  .p.long_name = NULL_IF_CONFIG_SMALL("QOI (Quite OK Image format) image"),
121  .p.type = AVMEDIA_TYPE_VIDEO,
122  .p.id = AV_CODEC_ID_QOI,
123  .p.capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_FRAME_THREADS,
125 };
space
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated space
Definition: undefined.txt:4
QOI_OP_LUMA
#define QOI_OP_LUMA
Definition: qoi.h:26
GetByteContext
Definition: bytestream.h:33
AVCOL_TRC_LINEAR
@ AVCOL_TRC_LINEAR
"Linear transfer characteristics"
Definition: pixfmt.h:505
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:325
AVCodecContext::color_trc
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
Definition: avcodec.h:959
internal.h
AVPacket::data
uint8_t * data
Definition: packet.h:374
FFCodec
Definition: codec_internal.h:112
ff_qoi_decoder
const FFCodec ff_qoi_decoder
Definition: qoidec.c:118
thread.h
AVFrame::data
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:346
bytestream2_skip
static av_always_inline void bytestream2_skip(GetByteContext *g, unsigned int size)
Definition: bytestream.h:168
FFCodec::p
AVCodec p
The public AVCodec.
Definition: codec_internal.h:116
QOI_OP_RUN
#define QOI_OP_RUN
Definition: qoi.h:27
QOI_OP_INDEX
#define QOI_OP_INDEX
Definition: qoi.h:24
ff_thread_get_buffer
the pkt_dts and pkt_pts fields in AVFrame will work as usual Restrictions on codec whose streams don t reset across will not work because their bitstreams cannot be decoded in parallel *The contents of buffers must not be read before as well as code calling up to before the decode process starts Call have so the codec calls ff_thread_report set FF_CODEC_CAP_ALLOCATE_PROGRESS in AVCodec caps_internal and use ff_thread_get_buffer() to allocate frames. The frames must then be freed with ff_thread_release_buffer(). Otherwise decode directly into the user-supplied frames. Call ff_thread_report_progress() after some part of the current picture has decoded. A good place to put this is where draw_horiz_band() is called - add this if it isn 't called anywhere
AVFrame::key_frame
int key_frame
1 -> keyframe, 0-> not
Definition: frame.h:417
qoi_decode_frame
static int qoi_decode_frame(AVCodecContext *avctx, AVFrame *p, int *got_frame, AVPacket *avpkt)
Definition: qoidec.c:31
width
#define width
FF_CODEC_DECODE_CB
#define FF_CODEC_DECODE_CB(func)
Definition: codec_internal.h:254
channels
channels
Definition: aptx.h:32
AV_PIX_FMT_RGBA
@ AV_PIX_FMT_RGBA
packed RGBA 8:8:8:8, 32bpp, RGBARGBA...
Definition: pixfmt.h:93
QOI_MASK_2
#define QOI_MASK_2
Definition: qoi.h:31
AV_CODEC_CAP_FRAME_THREADS
#define AV_CODEC_CAP_FRAME_THREADS
Codec supports frame-level multithreading.
Definition: codec.h:113
run
uint8_t run
Definition: svq3.c:205
qoi.h
AV_PICTURE_TYPE_I
@ AV_PICTURE_TYPE_I
Intra.
Definition: avutil.h:274
index
int index
Definition: gxfenc.c:89
bytestream2_get_bytes_left
static av_always_inline int bytestream2_get_bytes_left(GetByteContext *g)
Definition: bytestream.h:158
AVFrame::pict_type
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:422
AV_PIX_FMT_RGB24
@ AV_PIX_FMT_RGB24
packed RGB 8:8:8, 24bpp, RGBRGB...
Definition: pixfmt.h:68
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
AVPacket::size
int size
Definition: packet.h:375
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:117
codec_internal.h
AV_CODEC_ID_QOI
@ AV_CODEC_ID_QOI
Definition: codec_id.h:313
height
#define height
b2
static double b2(void *priv, double x, double y)
Definition: vf_xfade.c:1772
QOI_OP_RGBA
#define QOI_OP_RGBA
Definition: qoi.h:29
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:203
len
int len
Definition: vorbis_enc_data.h:426
QOI_OP_RGB
#define QOI_OP_RGB
Definition: qoi.h:28
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:599
avcodec.h
ret
ret
Definition: filter_design.txt:187
QOI_COLOR_HASH
#define QOI_COLOR_HASH(px)
Definition: qoi.h:33
AVCodecContext
main external API structure.
Definition: avcodec.h:389
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
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:90
bytestream2_get_bufferu
static av_always_inline unsigned int bytestream2_get_bufferu(GetByteContext *g, uint8_t *dst, unsigned int size)
Definition: bytestream.h:277
QOI_OP_DIFF
#define QOI_OP_DIFF
Definition: qoi.h:25
AVPacket
This structure stores compressed data.
Definition: packet.h:351
bytestream.h
imgutils.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:370
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61