FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavcodec/hwaccel_internal.h
Date: 2024-10-04 17:46:48
Exec Total Coverage
Lines: 2 2 100.0%
Functions: 1 1 100.0%
Branches: 0 0 -%

Line Branch Exec Source
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 /**
20 * Header providing the internals of AVHWAccel.
21 */
22
23 #ifndef AVCODEC_HWACCEL_INTERNAL_H
24 #define AVCODEC_HWACCEL_INTERNAL_H
25
26 #include <stdint.h>
27
28 #include "avcodec.h"
29 #include "refstruct.h"
30
31 #define HWACCEL_CAP_ASYNC_SAFE (1 << 0)
32 #define HWACCEL_CAP_THREAD_SAFE (1 << 1)
33
34 typedef struct FFHWAccel {
35 /**
36 * The public AVHWAccel. See avcodec.h for it.
37 */
38 AVHWAccel p;
39
40 /**
41 * Allocate a custom buffer
42 */
43 int (*alloc_frame)(AVCodecContext *avctx, AVFrame *frame);
44
45 /**
46 * Called at the beginning of each frame or field picture.
47 *
48 * Meaningful frame information (codec specific) is guaranteed to
49 * be parsed at this point. This function is mandatory.
50 *
51 * Note that buf can be NULL along with buf_size set to 0.
52 * Otherwise, this means the whole frame is available at this point.
53 *
54 * @param avctx the codec context
55 * @param buf the frame data buffer base
56 * @param buf_size the size of the frame in bytes
57 * @return zero if successful, a negative value otherwise
58 */
59 int (*start_frame)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size);
60
61 /**
62 * Callback for parameter data (SPS/PPS/VPS etc).
63 *
64 * Useful for hardware decoders which keep persistent state about the
65 * video parameters, and need to receive any changes to update that state.
66 *
67 * @param avctx the codec context
68 * @param type the nal unit type
69 * @param buf the nal unit data buffer
70 * @param buf_size the size of the nal unit in bytes
71 * @return zero if successful, a negative value otherwise
72 */
73 int (*decode_params)(AVCodecContext *avctx, int type, const uint8_t *buf, uint32_t buf_size);
74
75 /**
76 * Callback for each slice.
77 *
78 * Meaningful slice information (codec specific) is guaranteed to
79 * be parsed at this point. This function is mandatory.
80 *
81 * @param avctx the codec context
82 * @param buf the slice data buffer base
83 * @param buf_size the size of the slice in bytes
84 * @return zero if successful, a negative value otherwise
85 */
86 int (*decode_slice)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size);
87
88 /**
89 * Called at the end of each frame or field picture.
90 *
91 * The whole picture is parsed at this point and can now be sent
92 * to the hardware accelerator. This function is mandatory.
93 *
94 * @param avctx the codec context
95 * @return zero if successful, a negative value otherwise
96 */
97 int (*end_frame)(AVCodecContext *avctx);
98
99 /**
100 * Size of per-frame hardware accelerator private data.
101 *
102 * Private data is allocated with av_mallocz() before
103 * AVCodecContext.get_buffer() and deallocated after
104 * AVCodecContext.release_buffer().
105 */
106 int frame_priv_data_size;
107
108 /**
109 * Size of the private data to allocate in
110 * AVCodecInternal.hwaccel_priv_data.
111 */
112 int priv_data_size;
113
114 /**
115 * Internal hwaccel capabilities.
116 */
117 int caps_internal;
118
119 /**
120 * Initialize the hwaccel private data.
121 *
122 * This will be called from ff_get_format(), after hwaccel and
123 * hwaccel_context are set and the hwaccel private data in AVCodecInternal
124 * is allocated.
125 */
126 int (*init)(AVCodecContext *avctx);
127
128 /**
129 * Uninitialize the hwaccel private data.
130 *
131 * This will be called from get_format() or ff_codec_close(), after hwaccel
132 * and hwaccel_context are already uninitialized.
133 */
134 int (*uninit)(AVCodecContext *avctx);
135
136 /**
137 * Fill the given hw_frames context with current codec parameters. Called
138 * from get_format. Refer to avcodec_get_hw_frames_parameters() for
139 * details.
140 *
141 * This CAN be called before AVHWAccel.init is called, and you must assume
142 * that avctx->hwaccel_priv_data is invalid.
143 */
144 int (*frame_params)(AVCodecContext *avctx, AVBufferRef *hw_frames_ctx);
145
146 /**
147 * Copy necessary context variables from a previous thread context to the current one.
148 * For thread-safe hwaccels only.
149 */
150 int (*update_thread_context)(AVCodecContext *dst, const AVCodecContext *src);
151
152 /**
153 * Callback to free the hwaccel-specific frame data.
154 *
155 * @param hwctx a pointer to an AVHWDeviceContext.
156 * @param data the per-frame hardware accelerator private data to be freed.
157 */
158 void (*free_frame_priv)(FFRefStructOpaque hwctx, void *data);
159
160 /**
161 * Callback to flush the hwaccel state.
162 */
163 void (*flush)(AVCodecContext *avctx);
164 } FFHWAccel;
165
166 428798 static inline const FFHWAccel *ffhwaccel(const AVHWAccel *codec)
167 {
168 428798 return (const FFHWAccel*)codec;
169 }
170
171 #define FF_HW_CALL(avctx, function, ...) \
172 (ffhwaccel((avctx)->hwaccel)->function((avctx), __VA_ARGS__))
173
174 #define FF_HW_SIMPLE_CALL(avctx, function) \
175 (ffhwaccel((avctx)->hwaccel)->function(avctx))
176
177 #define FF_HW_HAS_CB(avctx, function) \
178 ((avctx)->hwaccel && ffhwaccel((avctx)->hwaccel)->function)
179
180 #endif /* AVCODEC_HWACCEL_INTERNAL */
181