libvpxdec.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2010, Google, Inc.
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 /**
22  * @file
23  * VP8 decoder support via libvpx
24  */
25 
26 #define VPX_CODEC_DISABLE_COMPAT 1
27 #include <vpx/vpx_decoder.h>
28 #include <vpx/vp8dx.h>
29 
30 #include "libavutil/common.h"
31 #include "libavutil/imgutils.h"
32 #include "avcodec.h"
33 #include "internal.h"
34 
35 typedef struct VP8DecoderContext {
36  struct vpx_codec_ctx decoder;
37 } VP8Context;
38 
39 static av_cold int vpx_init(AVCodecContext *avctx,
40  const struct vpx_codec_iface *iface)
41 {
42  VP8Context *ctx = avctx->priv_data;
43  struct vpx_codec_dec_cfg deccfg = {
44  /* token partitions+1 would be a decent choice */
45  .threads = FFMIN(avctx->thread_count, 16)
46  };
47 
48  av_log(avctx, AV_LOG_INFO, "%s\n", vpx_codec_version_str());
49  av_log(avctx, AV_LOG_VERBOSE, "%s\n", vpx_codec_build_config());
50 
51  if (vpx_codec_dec_init(&ctx->decoder, iface, &deccfg, 0) != VPX_CODEC_OK) {
52  const char *error = vpx_codec_error(&ctx->decoder);
53  av_log(avctx, AV_LOG_ERROR, "Failed to initialize decoder: %s\n",
54  error);
55  return AVERROR(EINVAL);
56  }
57 
58  avctx->pix_fmt = AV_PIX_FMT_YUV420P;
59  return 0;
60 }
61 
62 static int vp8_decode(AVCodecContext *avctx,
63  void *data, int *got_frame, AVPacket *avpkt)
64 {
65  VP8Context *ctx = avctx->priv_data;
66  AVFrame *picture = data;
67  const void *iter = NULL;
68  struct vpx_image *img;
69  int ret;
70 
71  if (vpx_codec_decode(&ctx->decoder, avpkt->data, avpkt->size, NULL, 0) !=
72  VPX_CODEC_OK) {
73  const char *error = vpx_codec_error(&ctx->decoder);
74  const char *detail = vpx_codec_error_detail(&ctx->decoder);
75 
76  av_log(avctx, AV_LOG_ERROR, "Failed to decode frame: %s\n", error);
77  if (detail)
78  av_log(avctx, AV_LOG_ERROR, " Additional information: %s\n",
79  detail);
80  return AVERROR_INVALIDDATA;
81  }
82 
83  if ((img = vpx_codec_get_frame(&ctx->decoder, &iter))) {
84  if (img->fmt != VPX_IMG_FMT_I420) {
85  av_log(avctx, AV_LOG_ERROR, "Unsupported output colorspace (%d)\n",
86  img->fmt);
87  return AVERROR_INVALIDDATA;
88  }
89 
90  if ((int) img->d_w != avctx->width || (int) img->d_h != avctx->height) {
91  av_log(avctx, AV_LOG_INFO, "dimension change! %dx%d -> %dx%d\n",
92  avctx->width, avctx->height, img->d_w, img->d_h);
93  if (av_image_check_size(img->d_w, img->d_h, 0, avctx))
94  return AVERROR_INVALIDDATA;
95  avcodec_set_dimensions(avctx, img->d_w, img->d_h);
96  }
97  if ((ret = ff_get_buffer(avctx, picture, 0)) < 0)
98  return ret;
99  av_image_copy(picture->data, picture->linesize, img->planes,
100  img->stride, avctx->pix_fmt, img->d_w, img->d_h);
101  *got_frame = 1;
102  }
103  return avpkt->size;
104 }
105 
106 static av_cold int vp8_free(AVCodecContext *avctx)
107 {
108  VP8Context *ctx = avctx->priv_data;
109  vpx_codec_destroy(&ctx->decoder);
110  return 0;
111 }
112 
113 #if CONFIG_LIBVPX_VP8_DECODER
114 static av_cold int vp8_init(AVCodecContext *avctx)
115 {
116  return vpx_init(avctx, &vpx_codec_vp8_dx_algo);
117 }
118 
119 AVCodec ff_libvpx_vp8_decoder = {
120  .name = "libvpx",
121  .type = AVMEDIA_TYPE_VIDEO,
122  .id = AV_CODEC_ID_VP8,
123  .priv_data_size = sizeof(VP8Context),
124  .init = vp8_init,
125  .close = vp8_free,
126  .decode = vp8_decode,
127  .capabilities = CODEC_CAP_AUTO_THREADS | CODEC_CAP_DR1,
128  .long_name = NULL_IF_CONFIG_SMALL("libvpx VP8"),
129 };
130 #endif /* CONFIG_LIBVPX_VP8_DECODER */
131 
132 #if CONFIG_LIBVPX_VP9_DECODER
133 static av_cold int vp9_init(AVCodecContext *avctx)
134 {
135  return vpx_init(avctx, &vpx_codec_vp9_dx_algo);
136 }
137 
138 AVCodec ff_libvpx_vp9_decoder = {
139  .name = "libvpx-vp9",
140  .type = AVMEDIA_TYPE_VIDEO,
141  .id = AV_CODEC_ID_VP9,
142  .priv_data_size = sizeof(VP8Context),
143  .init = vp9_init,
144  .close = vp8_free,
145  .decode = vp8_decode,
147  .long_name = NULL_IF_CONFIG_SMALL("libvpx VP9"),
148 };
149 #endif /* CONFIG_LIBVPX_VP9_DECODER */
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
This structure describes decoded (raw) audio or video data.
Definition: frame.h:76
misc image utilities
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
void avcodec_set_dimensions(AVCodecContext *s, int width, int height)
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
#define img
struct vpx_codec_ctx decoder
Definition: libvpxdec.c:36
struct VP8DecoderContext VP8Context
#define av_cold
Definition: attributes.h:78
#define CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
uint8_t * data
uint8_t * data[8]
pointer to the picture/channel planes.
Definition: frame.h:87
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Spectrum Plot time data
void av_log(void *avcl, int level, const char *fmt,...)
Send the specified message to the log if the level is less than or equal to the current av_log_level...
Definition: log.c:246
const char * name
Name of the codec implementation.
external API header
void av_image_copy(uint8_t *dst_data[4], int dst_linesizes[4], const uint8_t *src_data[4], const int src_linesizes[4], enum AVPixelFormat pix_fmt, int width, int height)
Copy image in src_data to dst_data.
Definition: imgutils.c:257
static av_cold int vp8_free(AVCodecContext *avctx)
Definition: libvpxdec.c:106
#define AV_LOG_VERBOSE
Definition: log.h:157
int av_image_check_size(unsigned int w, unsigned int h, int log_offset, void *log_ctx)
Check if the given dimension of an image is valid, meaning that all bytes of the image can be address...
Definition: imgutils.c:231
#define FFMIN(a, b)
Definition: common.h:58
ret
Definition: avfilter.c:821
int width
picture width / height.
static av_cold int vpx_init(AVCodecContext *avctx, const struct vpx_codec_iface *iface)
Definition: libvpxdec.c:39
#define CODEC_CAP_AUTO_THREADS
Codec supports avctx->thread_count == 0 (auto).
static int vp8_decode(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: libvpxdec.c:62
int thread_count
thread count is used to decide how many independent tasks should be passed to execute() ...
NULL
Definition: eval.c:55
main external API structure.
static void close(AVCodecParserContext *s)
Definition: h264_parser.c:375
int ff_get_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Get a buffer for a frame.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:148
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFilterBuffer 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.Buffer references ownership and permissions
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:68
common internal api header.
common internal and external API header
#define CODEC_CAP_EXPERIMENTAL
Codec is experimental and is thus avoided in favor of non experimental encoders.
int linesize[8]
For video, size in bytes of each picture line.
Definition: frame.h:101
#define AV_LOG_INFO
Definition: log.h:156
static int decode(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: crystalhd.c:868
This structure stores compressed data.