FFmpeg
hwcontext_internal.h
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 #ifndef AVUTIL_HWCONTEXT_INTERNAL_H
20 #define AVUTIL_HWCONTEXT_INTERNAL_H
21 
22 #include <stddef.h>
23 
24 #include "buffer.h"
25 #include "hwcontext.h"
26 #include "frame.h"
27 #include "pixfmt.h"
28 
29 typedef struct HWContextType {
30  enum AVHWDeviceType type;
31  const char *name;
32 
37  const enum AVPixelFormat *pix_fmts;
38 
49 
55 
66 
67  int (*device_create)(AVHWDeviceContext *ctx, const char *device,
68  AVDictionary *opts, int flags);
69  int (*device_derive)(AVHWDeviceContext *dst_ctx,
70  AVHWDeviceContext *src_ctx, int flags);
71 
72  int (*device_init)(AVHWDeviceContext *ctx);
73  void (*device_uninit)(AVHWDeviceContext *ctx);
74 
75  int (*frames_get_constraints)(AVHWDeviceContext *ctx,
76  const void *hwconfig,
77  AVHWFramesConstraints *constraints);
78 
79  int (*frames_init)(AVHWFramesContext *ctx);
80  void (*frames_uninit)(AVHWFramesContext *ctx);
81 
82  int (*frames_get_buffer)(AVHWFramesContext *ctx, AVFrame *frame);
83  int (*transfer_get_formats)(AVHWFramesContext *ctx,
84  enum AVHWFrameTransferDirection dir,
85  enum AVPixelFormat **formats);
86  int (*transfer_data_to)(AVHWFramesContext *ctx, AVFrame *dst,
87  const AVFrame *src);
88  int (*transfer_data_from)(AVHWFramesContext *ctx, AVFrame *dst,
89  const AVFrame *src);
90 
91  int (*map_to)(AVHWFramesContext *ctx, AVFrame *dst,
92  const AVFrame *src, int flags);
93  int (*map_from)(AVHWFramesContext *ctx, AVFrame *dst,
94  const AVFrame *src, int flags);
95 
96  int (*frames_derive_to)(AVHWFramesContext *dst_ctx,
97  AVHWFramesContext *src_ctx, int flags);
98  int (*frames_derive_from)(AVHWFramesContext *dst_ctx,
99  AVHWFramesContext *src_ctx, int flags);
100 } HWContextType;
101 
103  const HWContextType *hw_type;
104  void *priv;
105 
111 };
112 
114  const HWContextType *hw_type;
115  void *priv;
116 
117  AVBufferPool *pool_internal;
118 
129 };
130 
131 typedef struct HWMapDescriptor {
145  void (*unmap)(AVHWFramesContext *ctx,
146  struct HWMapDescriptor *hwmap);
150  void *priv;
152 
153 int ff_hwframe_map_create(AVBufferRef *hwframe_ref,
154  AVFrame *dst, const AVFrame *src,
155  void (*unmap)(AVHWFramesContext *ctx,
156  HWMapDescriptor *hwmap),
157  void *priv);
158 
159 
160 extern const HWContextType ff_hwcontext_type_cuda;
161 extern const HWContextType ff_hwcontext_type_d3d11va;
162 extern const HWContextType ff_hwcontext_type_drm;
163 extern const HWContextType ff_hwcontext_type_dxva2;
164 extern const HWContextType ff_hwcontext_type_opencl;
165 extern const HWContextType ff_hwcontext_type_qsv;
166 extern const HWContextType ff_hwcontext_type_vaapi;
167 extern const HWContextType ff_hwcontext_type_vdpau;
168 extern const HWContextType ff_hwcontext_type_videotoolbox;
169 extern const HWContextType ff_hwcontext_type_mediacodec;
170 
171 #endif /* AVUTIL_HWCONTEXT_INTERNAL_H */
This struct aggregates all the (hardware/vendor-specific) "high-level" state, i.e.
Definition: hwcontext.h:60
This structure describes decoded (raw) audio or video data.
Definition: frame.h:218
size_t device_priv_size
size of the private data, i.e.
Definition: hwcontext_internal.h:48
size_t frames_priv_size
size of the private data, i.e.
Definition: hwcontext_internal.h:65
size_t device_hwctx_size
size of the public hardware-specific context, i.e.
Definition: hwcontext_internal.h:43
void(* unmap)(AVHWFramesContext *ctx, struct HWMapDescriptor *hwmap)
Unmap function.
Definition: hwcontext_internal.h:145
size_t frames_hwctx_size
size of the public frame pool hardware-specific context, i.e.
Definition: hwcontext_internal.h:60
Definition: buffer_internal.h:76
Definition: dict.c:30
AVBufferRef * source_frames
For a derived context, a reference to the original frames context it was derived from.
Definition: hwcontext_internal.h:123
reference-counted frame API
AVFrame * source
A reference to the original source of the mapping.
Definition: hwcontext_internal.h:135
enum AVPixelFormat * pix_fmts
An array of pixel formats supported by the AVHWFramesContext instances Terminated by AV_PIX_FMT_NONE...
Definition: hwcontext_internal.h:37
size_t device_hwconfig_size
Size of the hardware-specific device configuration.
Definition: hwcontext_internal.h:54
Definition: hwcontext_internal.h:131
Definition: hwcontext_internal.h:102
void * priv
Hardware-specific private data associated with the mapping.
Definition: hwcontext_internal.h:150
This struct describes the constraints on hardware frames attached to a given device with a hardware-s...
Definition: hwcontext.h:432
int source_allocation_map_flags
Flags to apply to the mapping from the source to the derived frame context when trying to allocate in...
Definition: hwcontext_internal.h:128
This struct describes a set or pool of "hardware" frames (i.e.
Definition: hwcontext.h:123
Definition: hwcontext_internal.h:113
refcounted data buffer API
AVBufferRef * hw_frames_ctx
A reference to the hardware frames context in which this mapping was made.
Definition: hwcontext_internal.h:141
A reference to a data buffer.
Definition: buffer.h:81
pixel format definitions
AVBufferRef * source_device
For a derived device, a reference to the original device context it was derived from.
Definition: hwcontext_internal.h:110
AVPixelFormat
Pixel format.
Definition: pixfmt.h:60
Definition: hwcontext_internal.h:29