FFmpeg
Loading...
Searching...
No Matches
get_buffer.c
Go to the documentation of this file.
1/*
2 * The default get_buffer2() implementation
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 <stdint.h>
22
23#include "libavutil/avassert.h"
24#include "libavutil/avutil.h"
25#include "libavutil/buffer.h"
26#include "libavutil/frame.h"
27#include "libavutil/hwcontext.h"
28#include "libavutil/imgutils.h"
29#include "libavutil/mem.h"
30#include "libavutil/samplefmt.h"
31#include "libavutil/version.h"
32
33#include "avcodec.h"
34#include "internal.h"
35#include "libavutil/refstruct.h"
36
37typedef struct FramePool {
38 /**
39 * Pools for each data plane. For audio all the planes have the same size,
40 * so only pools[0] is used.
41 */
43
44 /*
45 * Pool parameters
46 */
47 int format;
50 int linesize[4];
51 int planes;
54} FramePool;
55
56static void frame_pool_free(AVRefStructOpaque unused, void *obj)
57{
58 FramePool *pool = obj;
59 int i;
60
61 for (i = 0; i < FF_ARRAY_ELEMS(pool->pools); i++)
63}
64
66{
67 FramePool *pool = avctx->internal->pool;
68 int i, ret;
69
70 if (pool && pool->format == frame->format) {
71 if (avctx->codec_type == AVMEDIA_TYPE_VIDEO &&
72 pool->width == frame->width && pool->height == frame->height)
73 return 0;
74 if (avctx->codec_type == AVMEDIA_TYPE_AUDIO &&
75 pool->channels == frame->ch_layout.nb_channels &&
76 frame->nb_samples == pool->samples)
77 return 0;
78 }
79
80 pool = av_refstruct_alloc_ext(sizeof(*pool), 0, NULL, frame_pool_free);
81 if (!pool)
82 return AVERROR(ENOMEM);
83
84 switch (avctx->codec_type) {
85 case AVMEDIA_TYPE_VIDEO: {
86 int linesize[4];
87 int w = frame->width;
88 int h = frame->height;
89 int unaligned;
90 ptrdiff_t linesize1[4];
91 size_t size[4];
92
93 avcodec_align_dimensions2(avctx, &w, &h, pool->stride_align);
94
95 do {
96 // NOTE: do not align linesizes individually, this breaks e.g. assumptions
97 // that linesize[0] == 2*linesize[1] in the MPEG-encoder for 4:2:2
98 ret = av_image_fill_linesizes(linesize, frame->format, w);
99 if (ret < 0)
100 goto fail;
101 // increase alignment of w for next try (rhs gives the lowest bit set in w)
102 w += w & ~(w - 1);
103
104 unaligned = 0;
105 for (i = 0; i < 4; i++)
106 unaligned |= linesize[i] % pool->stride_align[i];
107 } while (unaligned);
108
109 for (i = 0; i < 4; i++)
110 linesize1[i] = linesize[i];
111 ret = av_image_fill_plane_sizes(size, frame->format, h, linesize1);
112 if (ret < 0)
113 goto fail;
114
115 for (i = 0; i < 4; i++) {
116 pool->linesize[i] = linesize[i];
117 if (size[i]) {
118 if (size[i] > INT_MAX - (16 + STRIDE_ALIGN - 1)) {
119 ret = AVERROR(EINVAL);
120 goto fail;
121 }
122 pool->pools[i] = av_buffer_pool_init(size[i] + 16 + STRIDE_ALIGN - 1,
123 CONFIG_MEMORY_POISONING ?
124 NULL :
126 if (!pool->pools[i]) {
127 ret = AVERROR(ENOMEM);
128 goto fail;
129 }
130 }
131 }
132 pool->format = frame->format;
133 pool->width = frame->width;
134 pool->height = frame->height;
135
136 break;
137 }
138 case AVMEDIA_TYPE_AUDIO: {
139 ret = av_samples_get_buffer_size(&pool->linesize[0],
140 frame->ch_layout.nb_channels,
141 frame->nb_samples, frame->format, 0);
142 if (ret < 0)
143 goto fail;
144
145 pool->pools[0] = av_buffer_pool_init(pool->linesize[0],
146 CONFIG_MEMORY_POISONING ?
147 NULL :
149 if (!pool->pools[0]) {
150 ret = AVERROR(ENOMEM);
151 goto fail;
152 }
153
154 pool->format = frame->format;
155 pool->channels = frame->ch_layout.nb_channels;
156 pool->samples = frame->nb_samples;
157 pool->planes = av_sample_fmt_is_planar(pool->format) ? pool->channels : 1;
158 break;
159 }
160 default: av_assert0(0);
161 }
162
164 avctx->internal->pool = pool;
165
166 return 0;
167fail:
168 av_refstruct_unref(&pool);
169 return ret;
170}
171
173{
174 FramePool *pool = avctx->internal->pool;
175 int planes = pool->planes;
176 int i;
177
178 frame->linesize[0] = pool->linesize[0];
179
181 frame->extended_data = av_calloc(planes, sizeof(*frame->extended_data));
182 frame->nb_extended_buf = planes - AV_NUM_DATA_POINTERS;
183 frame->extended_buf = av_calloc(frame->nb_extended_buf,
184 sizeof(*frame->extended_buf));
185 if (!frame->extended_data || !frame->extended_buf) {
186 av_freep(&frame->extended_data);
187 av_freep(&frame->extended_buf);
188 return AVERROR(ENOMEM);
189 }
190 } else {
191 frame->extended_data = frame->data;
192 av_assert0(frame->nb_extended_buf == 0);
193 }
194
195 for (i = 0; i < FFMIN(planes, AV_NUM_DATA_POINTERS); i++) {
196 frame->buf[i] = av_buffer_pool_get(pool->pools[0]);
197 if (!frame->buf[i])
198 goto fail;
199 frame->extended_data[i] = frame->data[i] = frame->buf[i]->data;
200 }
201 for (i = 0; i < frame->nb_extended_buf; i++) {
202 frame->extended_buf[i] = av_buffer_pool_get(pool->pools[0]);
203 if (!frame->extended_buf[i])
204 goto fail;
205 frame->extended_data[i + AV_NUM_DATA_POINTERS] = frame->extended_buf[i]->data;
206 }
207
208 if (avctx->debug & FF_DEBUG_BUFFERS)
209 av_log(avctx, AV_LOG_DEBUG, "default_get_buffer called on frame %p", frame);
210
211 return 0;
212fail:
214 return AVERROR(ENOMEM);
215}
216
218{
219 FramePool *pool = s->internal->pool;
220 int i;
221
222 if (pic->data[0] || pic->data[1] || pic->data[2] || pic->data[3]) {
223 av_log(s, AV_LOG_ERROR, "pic->data[*]!=NULL in avcodec_default_get_buffer\n");
224 return -1;
225 }
226
227 memset(pic->data, 0, sizeof(pic->data));
228 pic->extended_data = pic->data;
229
230 for (i = 0; i < 4 && pool->pools[i]; i++) {
231 pic->linesize[i] = pool->linesize[i];
232
233 pic->buf[i] = av_buffer_pool_get(pool->pools[i]);
234 if (!pic->buf[i])
235 goto fail;
236
237 pic->data[i] = pic->buf[i]->data;
238 }
239 for (; i < AV_NUM_DATA_POINTERS; i++) {
240 pic->data[i] = NULL;
241 pic->linesize[i] = 0;
242 }
243
244 if (s->debug & FF_DEBUG_BUFFERS)
245 av_log(s, AV_LOG_DEBUG, "default_get_buffer called on pic %p\n", pic);
246
247 return 0;
248fail:
249 av_frame_unref(pic);
250 return AVERROR(ENOMEM);
251}
252
254{
255 int ret;
256
257 if (avctx->hw_frames_ctx) {
258 ret = av_hwframe_get_buffer(avctx->hw_frames_ctx, frame, 0);
259 if (ret == AVERROR(ENOMEM)) {
260 AVHWFramesContext *frames_ctx =
262 if (frames_ctx->initial_pool_size > 0 &&
264 av_log(avctx, AV_LOG_WARNING, "Failed to allocate a %s/%s "
265 "frame from a fixed pool of hardware frames.\n",
266 av_get_pix_fmt_name(frames_ctx->format),
267 av_get_pix_fmt_name(frames_ctx->sw_format));
268 av_log(avctx, AV_LOG_WARNING, "Consider setting "
269 "extra_hw_frames to a larger value "
270 "(currently set to %d, giving a pool size of %d).\n",
271 avctx->extra_hw_frames, frames_ctx->initial_pool_size);
273 }
274 }
275 frame->width = avctx->coded_width;
276 frame->height = avctx->coded_height;
277 return ret;
278 }
279
280 if ((ret = update_frame_pool(avctx, frame)) < 0)
281 return ret;
282
283 switch (avctx->codec_type) {
285 return video_get_buffer(avctx, frame);
287 return audio_get_buffer(avctx, frame);
288 default:
289 return -1;
290 }
291}
simple assert() macros that are a bit more flexible than ISO C assert().
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition avassert.h:42
Libavcodec external API header.
#define FF_DEBUG_BUFFERS
Definition avcodec.h:1404
Convenience header that includes libavutil's core.
refcounted data buffer API
#define flags(name, subs,...)
Definition cbs_h264.c:74
#define i(width, name, range_min, range_max)
Definition cbs_h264.c:63
#define s(width, name)
Definition cbs_vp9.c:198
#define NULL
Definition coverity.c:32
static AVFrame * frame
reference-counted frame API
#define AV_NUM_DATA_POINTERS
Definition frame.h:473
static int update_frame_pool(AVCodecContext *avctx, AVFrame *frame)
Definition get_buffer.c:65
static int video_get_buffer(AVCodecContext *s, AVFrame *pic)
Definition get_buffer.c:217
static int audio_get_buffer(AVCodecContext *avctx, AVFrame *frame)
Definition get_buffer.c:172
static void frame_pool_free(AVRefStructOpaque unused, void *obj)
Definition get_buffer.c:56
#define fail
Definition test.h:479
int avcodec_default_get_buffer2(AVCodecContext *avctx, AVFrame *frame, int flags)
The default callback for AVCodecContext.get_buffer2().
Definition get_buffer.c:253
void avcodec_align_dimensions2(AVCodecContext *s, int *width, int *height, int linesize_align[AV_NUM_DATA_POINTERS])
Modify width and height values so that they will result in a memory buffer that is acceptable for the...
Definition utils.c:141
AVBufferRef * av_buffer_allocz(size_t size)
Same as av_buffer_alloc(), except the returned buffer will be initialized to zero.
Definition buffer.c:93
void av_buffer_pool_uninit(AVBufferPool **ppool)
Mark the pool as being available for freeing.
Definition buffer.c:328
AVBufferPool * av_buffer_pool_init(size_t size, AVBufferRef *(*alloc)(size_t size))
Allocate and initialize a buffer pool.
Definition buffer.c:283
AVBufferRef * av_buffer_pool_get(AVBufferPool *pool)
Allocate a new AVBuffer, reusing an old buffer from the pool when available.
Definition buffer.c:390
#define AVERROR(e)
Definition error.h:45
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition frame.c:496
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition log.h:231
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition log.h:216
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition log.h:210
@ AVMEDIA_TYPE_AUDIO
Definition avutil.h:201
@ AVMEDIA_TYPE_VIDEO
Definition avutil.h:200
int av_image_fill_plane_sizes(size_t sizes[4], enum AVPixelFormat pix_fmt, int height, const ptrdiff_t linesizes[4])
Fill plane sizes for an image with pixel format pix_fmt and height height.
Definition imgutils.c:111
int av_image_fill_linesizes(int linesizes[4], enum AVPixelFormat pix_fmt, int width)
Fill plane linesizes for an image with pixel format pix_fmt and width width.
Definition imgutils.c:89
int av_sample_fmt_is_planar(enum AVSampleFormat sample_fmt)
Check if the sample format is planar.
Definition samplefmt.c:114
int av_samples_get_buffer_size(int *linesize, int nb_channels, int nb_samples, enum AVSampleFormat sample_fmt, int align)
Get the required buffer size for the given audio parameters.
Definition samplefmt.c:121
int av_hwframe_get_buffer(AVBufferRef *hwframe_ref, AVFrame *frame, int flags)
Allocate a new frame attached to the given AVHWFramesContext.
Definition hwcontext.c:506
misc image utilities
common internal api header.
#define STRIDE_ALIGN
Definition internal.h:46
Libavutil version macros.
static const struct @257111027162314367033347246032313251342043035002 planes[]
uint8_t w
Definition llvidencdsp.c:39
#define FFMIN(a, b)
Definition macros.h:49
void * av_calloc(size_t nmemb, size_t size)
Definition mem.c:264
Memory handling functions.
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
Definition pixdesc.c:3380
void av_refstruct_unref(void *objp)
Decrement the reference count of the underlying object and automatically free the object if there are...
Definition refstruct.c:120
static void * av_refstruct_alloc_ext(size_t size, unsigned flags, void *opaque, void(*free_cb)(AVRefStructOpaque opaque, void *obj))
A wrapper around av_refstruct_alloc_ext_c() for the common case of a non-const qualified opaque.
Definition refstruct.h:94
#define FF_ARRAY_ELEMS(a)
The buffer pool.
uint8_t * data
The data buffer.
Definition buffer.h:90
main external API structure.
Definition avcodec.h:443
int debug
debug
Definition avcodec.h:1392
AVBufferRef * hw_frames_ctx
A reference to the AVHWFramesContext describing the input (for encoding) or output (decoding) frames.
Definition avcodec.h:1471
enum AVMediaType codec_type
Definition avcodec.h:451
int extra_hw_frames
Video decoding only.
Definition avcodec.h:1516
int coded_width
Bitstream width / height, may be different from width/height e.g.
Definition avcodec.h:619
struct AVCodecInternal * internal
Private context used for internal data.
Definition avcodec.h:478
int warned_on_failed_allocation_from_fixed_pool
Set when the user has been warned about a failed allocation from a fixed frame pool.
Definition internal.h:156
struct FramePool * pool
Definition internal.h:69
This structure describes decoded (raw) audio or video data.
Definition frame.h:472
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition frame.h:493
AVBufferRef * buf[AV_NUM_DATA_POINTERS]
AVBuffer references backing the data for this frame.
Definition frame.h:649
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:517
uint8_t ** extended_data
pointers to the data planes/channels.
Definition frame.h:533
This struct describes a set or pool of "hardware" frames (i.e.
Definition hwcontext.h:118
enum AVPixelFormat format
The pixel format identifying the underlying HW surface type.
Definition hwcontext.h:200
enum AVPixelFormat sw_format
The pixel format identifying the actual data layout of the hardware frames.
Definition hwcontext.h:213
int initial_pool_size
Initial size of the frame pool.
Definition hwcontext.h:190
int channels
Definition get_buffer.c:52
int stride_align[AV_NUM_DATA_POINTERS]
Definition get_buffer.c:49
int linesize[4]
Definition get_buffer.c:50
AVBufferPool * pools[4]
Pools for each data plane.
Definition get_buffer.c:42
int samples
Definition get_buffer.c:53
#define av_freep(p)
#define av_log(a,...)
int size
RefStruct is an API for creating reference-counted objects with minimal overhead.
Definition refstruct.h:58