FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
vf_hwupload.c
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #include "libavutil/buffer.h"
20 #include "libavutil/hwcontext.h"
22 #include "libavutil/log.h"
23 #include "libavutil/pixdesc.h"
24 #include "libavutil/opt.h"
25 
26 #include "avfilter.h"
27 #include "formats.h"
28 #include "internal.h"
29 #include "video.h"
30 
31 typedef struct HWUploadContext {
32  const AVClass *class;
33 
36 
40 
42 {
43  HWUploadContext *ctx = avctx->priv;
44  AVHWFramesConstraints *constraints = NULL;
45  const enum AVPixelFormat *input_pix_fmts, *output_pix_fmts;
46  AVFilterFormats *input_formats = NULL;
47  int err, i;
48 
49  if (!avctx->hw_device_ctx) {
50  av_log(ctx, AV_LOG_ERROR, "A hardware device reference is required "
51  "to upload frames to.\n");
52  return AVERROR(EINVAL);
53  }
54 
56  if (!ctx->hwdevice_ref)
57  return AVERROR(ENOMEM);
59 
61  if (!constraints) {
62  err = AVERROR(EINVAL);
63  goto fail;
64  }
65 
66  input_pix_fmts = constraints->valid_sw_formats;
67  output_pix_fmts = constraints->valid_hw_formats;
68 
69  input_formats = ff_make_format_list(output_pix_fmts);
70  if (!input_formats) {
71  err = AVERROR(ENOMEM);
72  goto fail;
73  }
74  if (input_pix_fmts) {
75  for (i = 0; input_pix_fmts[i] != AV_PIX_FMT_NONE; i++) {
76  err = ff_add_format(&input_formats, input_pix_fmts[i]);
77  if (err < 0)
78  goto fail;
79  }
80  }
81 
82  if ((err = ff_formats_ref(input_formats, &avctx->inputs[0]->out_formats)) < 0 ||
83  (err = ff_formats_ref(ff_make_format_list(output_pix_fmts),
84  &avctx->outputs[0]->in_formats)) < 0)
85  goto fail;
86 
87  av_hwframe_constraints_free(&constraints);
88  return 0;
89 
90 fail:
92  av_hwframe_constraints_free(&constraints);
93  return err;
94 }
95 
97 {
98  AVFilterContext *avctx = outlink->src;
99  AVFilterLink *inlink = avctx->inputs[0];
100  HWUploadContext *ctx = avctx->priv;
101  int err;
102 
104 
105  if (inlink->format == outlink->format) {
106  // The input is already a hardware format, so we just want to
107  // pass through the input frames in their own hardware context.
108  if (!inlink->hw_frames_ctx) {
109  av_log(ctx, AV_LOG_ERROR, "No input hwframe context.\n");
110  return AVERROR(EINVAL);
111  }
112 
113  outlink->hw_frames_ctx = av_buffer_ref(inlink->hw_frames_ctx);
114  if (!outlink->hw_frames_ctx)
115  return AVERROR(ENOMEM);
116 
117  return 0;
118  }
119 
121  if (!ctx->hwframes_ref)
122  return AVERROR(ENOMEM);
123 
125 
126  av_log(ctx, AV_LOG_DEBUG, "Surface format is %s.\n",
127  av_get_pix_fmt_name(inlink->format));
128 
129  ctx->hwframes->format = outlink->format;
130  ctx->hwframes->sw_format = inlink->format;
131  ctx->hwframes->width = inlink->w;
132  ctx->hwframes->height = inlink->h;
133 
134  err = av_hwframe_ctx_init(ctx->hwframes_ref);
135  if (err < 0)
136  goto fail;
137 
138  outlink->hw_frames_ctx = av_buffer_ref(ctx->hwframes_ref);
139  if (!outlink->hw_frames_ctx) {
140  err = AVERROR(ENOMEM);
141  goto fail;
142  }
143 
144  return 0;
145 
146 fail:
148  return err;
149 }
150 
151 static int hwupload_filter_frame(AVFilterLink *link, AVFrame *input)
152 {
153  AVFilterContext *avctx = link->dst;
154  AVFilterLink *outlink = avctx->outputs[0];
155  HWUploadContext *ctx = avctx->priv;
156  AVFrame *output = NULL;
157  int err;
158 
159  if (input->format == outlink->format)
160  return ff_filter_frame(outlink, input);
161 
162  output = ff_get_video_buffer(outlink, outlink->w, outlink->h);
163  if (!output) {
164  av_log(ctx, AV_LOG_ERROR, "Failed to allocate frame to upload to.\n");
165  err = AVERROR(ENOMEM);
166  goto fail;
167  }
168 
169  output->width = input->width;
170  output->height = input->height;
171 
172  err = av_hwframe_transfer_data(output, input, 0);
173  if (err < 0) {
174  av_log(ctx, AV_LOG_ERROR, "Failed to upload frame: %d.\n", err);
175  goto fail;
176  }
177 
178  err = av_frame_copy_props(output, input);
179  if (err < 0)
180  goto fail;
181 
182  av_frame_free(&input);
183 
184  return ff_filter_frame(outlink, output);
185 
186 fail:
187  av_frame_free(&input);
188  av_frame_free(&output);
189  return err;
190 }
191 
193 {
194  HWUploadContext *ctx = avctx->priv;
195 
198 }
199 
200 static const AVClass hwupload_class = {
201  .class_name = "hwupload",
202  .item_name = av_default_item_name,
203  .option = NULL,
204  .version = LIBAVUTIL_VERSION_INT,
205 };
206 
207 static const AVFilterPad hwupload_inputs[] = {
208  {
209  .name = "default",
210  .type = AVMEDIA_TYPE_VIDEO,
211  .filter_frame = hwupload_filter_frame,
212  },
213  { NULL }
214 };
215 
216 static const AVFilterPad hwupload_outputs[] = {
217  {
218  .name = "default",
219  .type = AVMEDIA_TYPE_VIDEO,
220  .config_props = hwupload_config_output,
221  },
222  { NULL }
223 };
224 
226  .name = "hwupload",
227  .description = NULL_IF_CONFIG_SMALL("Upload a normal frame to a hardware frame"),
228  .uninit = hwupload_uninit,
229  .query_formats = hwupload_query_formats,
230  .priv_size = sizeof(HWUploadContext),
231  .priv_class = &hwupload_class,
232  .inputs = hwupload_inputs,
233  .outputs = hwupload_outputs,
234  .flags_internal = FF_FILTER_FLAG_HWFRAME_AWARE,
235 };
This struct aggregates all the (hardware/vendor-specific) "high-level" state, i.e.
Definition: hwcontext.h:54
#define NULL
Definition: coverity.c:32
static int hwupload_query_formats(AVFilterContext *avctx)
Definition: vf_hwupload.c:41
#define FF_FILTER_FLAG_HWFRAME_AWARE
The filter is aware of hardware frames, and any hardware frame context should not be automatically pr...
Definition: internal.h:393
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it...
Definition: buffer.c:125
This structure describes decoded (raw) audio or video data.
Definition: frame.h:187
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
Main libavfilter public API header.
int width
The allocated dimensions of the frames in this pool.
Definition: hwcontext.h:222
AVBufferRef * hw_device_ctx
For filters which will create hardware frames, sets the device the filter should create them in...
Definition: avfilter.h:379
enum AVPixelFormat format
The pixel format identifying the underlying HW surface type.
Definition: hwcontext.h:202
AVFrame * ff_get_video_buffer(AVFilterLink *link, int w, int h)
Request a picture buffer with a specific set of permissions.
Definition: video.c:92
AVFilterFormats * ff_make_format_list(const int *fmts)
Create a list of supported formats.
Definition: formats.c:283
void av_hwframe_constraints_free(AVHWFramesConstraints **constraints)
Free an AVHWFrameConstraints structure.
Definition: hwcontext.c:493
const char * name
Pad name.
Definition: internal.h:60
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:331
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1125
#define av_cold
Definition: attributes.h:82
AVOptions.
AVHWFramesContext * hwframes
Definition: vf_hwupload.c:38
#define av_log(a,...)
AVBufferRef * hwframes_ref
Definition: vf_hwupload.c:37
A filter pad used for either input or output.
Definition: internal.h:54
static int hwupload_config_output(AVFilterLink *outlink)
Definition: vf_hwupload.c:96
int width
width and height of the video frame
Definition: frame.h:239
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
av_default_item_name
#define AVERROR(e)
Definition: error.h:43
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:163
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:179
void * priv
private data for use by the filter
Definition: avfilter.h:338
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:197
AVBufferRef * hwdevice_ref
Definition: vf_hwupload.c:34
int ff_add_format(AVFilterFormats **avff, int64_t fmt)
Add fmt to the list of media formats contained in *avff.
Definition: formats.c:337
int av_hwframe_ctx_init(AVBufferRef *ref)
Finalize the context before use.
Definition: hwcontext.c:268
#define fail()
Definition: checkasm.h:89
int av_hwframe_transfer_data(AVFrame *dst, const AVFrame *src, int flags)
Copy data to or from a hw surface.
Definition: hwcontext.c:378
int ff_formats_ref(AVFilterFormats *f, AVFilterFormats **ref)
Add *ref as a new reference to formats.
Definition: formats.c:440
AVFormatContext * ctx
Definition: movenc.c:48
static int hwupload_filter_frame(AVFilterLink *link, AVFrame *input)
Definition: vf_hwupload.c:151
static const AVFilterPad outputs[]
Definition: af_afftfilt.c:386
AVFilter ff_vf_hwupload
Definition: vf_hwupload.c:225
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
Definition: frame.h:251
static const AVFilterPad inputs[]
Definition: af_afftfilt.c:376
This struct describes the constraints on hardware frames attached to a given device with a hardware-s...
Definition: hwcontext.h:373
AVHWFramesConstraints * av_hwdevice_get_hwframe_constraints(AVBufferRef *ref, const void *hwconfig)
Get the constraints on HW frames given a device and the HW-specific configuration to be used with tha...
Definition: hwcontext.c:468
uint8_t * data
The data buffer.
Definition: buffer.h:89
Describe the class of an AVClass context structure.
Definition: log.h:67
Filter definition.
Definition: avfilter.h:144
This struct describes a set or pool of "hardware" frames (i.e.
Definition: hwcontext.h:117
refcounted data buffer API
enum AVPixelFormat * valid_hw_formats
A list of possible values for format in the hw_frames_ctx, terminated by AV_PIX_FMT_NONE.
Definition: hwcontext.h:378
const char * name
Filter name.
Definition: avfilter.h:148
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:335
AVHWDeviceContext * hwdevice
Definition: vf_hwupload.c:35
A reference to a data buffer.
Definition: buffer.h:81
static av_cold void hwupload_uninit(AVFilterContext *avctx)
Definition: vf_hwupload.c:192
AVBufferRef * av_hwframe_ctx_alloc(AVBufferRef *device_ref_in)
Allocate an AVHWFramesContext tied to a given device context.
Definition: hwcontext.c:182
AVBufferRef * av_buffer_ref(AVBufferRef *buf)
Create a new reference to an AVBuffer.
Definition: buffer.c:93
enum AVPixelFormat * valid_sw_formats
A list of possible values for sw_format in the hw_frames_ctx, terminated by AV_PIX_FMT_NONE.
Definition: hwcontext.h:385
static const AVFilterPad hwupload_outputs[]
Definition: vf_hwupload.c:216
A list of supported formats for one end of a filter link.
Definition: formats.h:64
An instance of a filter.
Definition: avfilter.h:323
int height
Definition: frame.h:239
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:2249
static const AVFilterPad hwupload_inputs[]
Definition: vf_hwupload.c:207
internal API functions
enum AVPixelFormat sw_format
The pixel format identifying the actual data layout of the hardware frames.
Definition: hwcontext.h:215
AVPixelFormat
Pixel format.
Definition: pixfmt.h:60
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:596
static const AVClass hwupload_class
Definition: vf_hwupload.c:200