FFmpeg
amfenc.h
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 #ifndef AVCODEC_AMFENC_H
20 #define AVCODEC_AMFENC_H
21 
22 #include <AMF/core/Factory.h>
23 
24 #include <AMF/components/VideoEncoderVCE.h>
25 #include <AMF/components/VideoEncoderHEVC.h>
26 
27 #include "libavutil/fifo.h"
28 
29 #include "avcodec.h"
30 #include "hwconfig.h"
31 
32 
33 /**
34 * AMF trace writer callback class
35 * Used to capture all AMF logging
36 */
37 
38 typedef struct AmfTraceWriter {
39  AMFTraceWriterVtbl *vtbl;
42 
43 /**
44 * AMF encoder context
45 */
46 
47 typedef struct AmfContext {
49  // access to AMF runtime
50  amf_handle library; ///< handle to DLL library
51  AMFFactory *factory; ///< pointer to AMF factory
52  AMFDebug *debug; ///< pointer to AMF debug interface
53  AMFTrace *trace; ///< pointer to AMF trace interface
54 
55  amf_uint64 version; ///< version of AMF runtime
56  AmfTraceWriter tracer; ///< AMF writer registered with AMF
57  AMFContext *context; ///< AMF context
58  //encoder
59  AMFComponent *encoder; ///< AMF encoder object
60  amf_bool eof; ///< flag indicating EOF happened
61  AMF_SURFACE_FORMAT format; ///< AMF surface format
62 
63  AVBufferRef *hw_device_ctx; ///< pointer to HW accelerator (decoder)
64  AVBufferRef *hw_frames_ctx; ///< pointer to HW accelerator (frame allocator)
65 
68 
69  // helpers to handle async calls
71  AMFSurface *delayed_surface;
73 
74  // shift dts back by max_b_frames in timing
76  int64_t dts_delay;
77 
78  // common encoder option options
79 
81 
82  // Static options, have to be set before Init() call
83  int usage;
84  int profile;
85  int level;
87  int quality;
90 
91  // Dynamic options, can be set after Init() call
92 
98  int qp_i;
99  int qp_p;
100  int qp_b;
108  int aud;
109 
110  // HEVC - specific options
111 
114  int min_qp_i;
115  int max_qp_i;
116  int min_qp_p;
117  int max_qp_p;
118  int tier;
119 } AmfContext;
120 
121 extern const AVCodecHWConfigInternal *const ff_amfenc_hw_configs[];
122 
123 /**
124 * Common encoder initization function
125 */
127 /**
128 * Common encoder termination function
129 */
131 
132 /**
133 * Ecoding one frame - common function for all AMF encoders
134 */
136 
137 /**
138 * Supported formats
139 */
140 extern const enum AVPixelFormat ff_amf_pix_fmts[];
141 
142 /**
143 * Error handling helper
144 */
145 #define AMF_RETURN_IF_FALSE(avctx, exp, ret_value, /*message,*/ ...) \
146  if (!(exp)) { \
147  av_log(avctx, AV_LOG_ERROR, __VA_ARGS__); \
148  return ret_value; \
149  }
150 
151 #endif //AVCODEC_AMFENC_H
AMFContext * context
AMF context.
Definition: amfenc.h:57
int hwsurfaces_in_queue
Definition: amfenc.h:66
int usage
Definition: amfenc.h:83
This structure describes decoded (raw) audio or video data.
Definition: frame.h:318
int skip_frame
Definition: amfenc.h:97
int ff_amf_encode_init(AVCodecContext *avctx)
Common encoder initization function.
Definition: amfenc.c:507
AVBufferRef * hw_device_ctx
pointer to HW accelerator (decoder)
Definition: amfenc.h:63
int b_frame_ref
Definition: amfenc.h:103
int hwsurfaces_in_queue_max
Definition: amfenc.h:67
int me_half_pel
Definition: amfenc.h:106
int level
Definition: amfenc.h:85
int gops_per_idr
Definition: amfenc.h:112
int coding_mode
Definition: amfenc.h:105
AMF_SURFACE_FORMAT format
AMF surface format.
Definition: amfenc.h:61
int b_frame_delta_qp
Definition: amfenc.h:88
int enforce_hrd
Definition: amfenc.h:94
AVFrame * delayed_frame
Definition: amfenc.h:72
int me_quarter_pel
Definition: amfenc.h:107
int delayed_drain
Definition: amfenc.h:70
int ff_amf_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
Ecoding one frame - common function for all AMF encoders.
Definition: amfenc.c:592
int qp_b
Definition: amfenc.h:100
AMF trace writer callback class Used to capture all AMF logging.
Definition: amfenc.h:38
int max_au_size
Definition: amfenc.h:101
int rate_control_mode
Definition: amfenc.h:93
int quality
Definition: amfenc.h:87
int filler_data
Definition: amfenc.h:95
int qp_p
Definition: amfenc.h:99
enum AVPixelFormat ff_amf_pix_fmts[]
Supported formats.
Definition: amfenc.c:53
AVCodecContext * avctx
Definition: amfenc.h:40
int max_qp_i
Definition: amfenc.h:115
int tier
Definition: amfenc.h:118
AMFFactory * factory
pointer to AMF factory
Definition: amfenc.h:51
AVBufferRef * hw_frames_ctx
pointer to HW accelerator (frame allocator)
Definition: amfenc.h:64
int min_qp_i
Definition: amfenc.h:114
AMFTraceWriterVtbl * vtbl
Definition: amfenc.h:39
amf_handle library
handle to DLL library
Definition: amfenc.h:50
int preanalysis
Definition: amfenc.h:86
AMFComponent * encoder
AMF encoder object.
Definition: amfenc.h:59
int ref_b_frame_delta_qp
Definition: amfenc.h:89
Libavcodec external API header.
const AVCodecHWConfigInternal *const ff_amfenc_hw_configs[]
Definition: amfenc.c:786
int aud
Definition: amfenc.h:108
int intra_refresh_mb
Definition: amfenc.h:104
AMFDebug * debug
pointer to AMF debug interface
Definition: amfenc.h:52
int64_t dts_delay
Definition: amfenc.h:76
int enable_vbaq
Definition: amfenc.h:96
int qp_i
Definition: amfenc.h:98
AVFifoBuffer * timestamp_list
Definition: amfenc.h:75
main external API structure.
Definition: avcodec.h:536
int profile
Definition: amfenc.h:84
amf_bool eof
flag indicating EOF happened
Definition: amfenc.h:60
a very simple circular buffer FIFO implementation
Describe the class of an AVClass context structure.
Definition: log.h:67
int ff_amf_encode_close(AVCodecContext *avctx)
Common encoder termination function.
Definition: amfenc.c:370
amf_uint64 version
version of AMF runtime
Definition: amfenc.h:55
AMF encoder context.
Definition: amfenc.h:47
int header_insertion_mode
Definition: amfenc.h:113
A reference to a data buffer.
Definition: buffer.h:84
AmfTraceWriter tracer
AMF writer registered with AMF.
Definition: amfenc.h:56
AVClass * avclass
Definition: amfenc.h:48
int min_qp_p
Definition: amfenc.h:116
int max_qp_p
Definition: amfenc.h:117
int log_to_dbg
Definition: amfenc.h:80
AMFSurface * delayed_surface
Definition: amfenc.h:71
AMFTrace * trace
pointer to AMF trace interface
Definition: amfenc.h:53
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
This structure stores compressed data.
Definition: packet.h:346
int header_spacing
Definition: amfenc.h:102