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 */
135 int ff_amf_receive_packet(AVCodecContext *avctx, AVPacket *avpkt);
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::header_spacing
int header_spacing
Definition: amfenc.h:102
hwconfig.h
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
AmfContext::factory
AMFFactory * factory
pointer to AMF factory
Definition: amfenc.h:51
AmfContext::hwsurfaces_in_queue_max
int hwsurfaces_in_queue_max
Definition: amfenc.h:67
AmfContext::trace
AMFTrace * trace
pointer to AMF trace interface
Definition: amfenc.h:53
AmfContext::profile
int profile
Definition: amfenc.h:84
AmfContext::qp_i
int qp_i
Definition: amfenc.h:98
ff_amf_receive_packet
int ff_amf_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
Ecoding one frame - common function for all AMF encoders.
Definition: amfenc.c:592
AmfContext::ref_b_frame_delta_qp
int ref_b_frame_delta_qp
Definition: amfenc.h:89
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:317
AmfContext::quality
int quality
Definition: amfenc.h:87
AmfTraceWriter::vtbl
AMFTraceWriterVtbl * vtbl
Definition: amfenc.h:39
AmfContext::library
amf_handle library
handle to DLL library
Definition: amfenc.h:50
AmfContext::qp_b
int qp_b
Definition: amfenc.h:100
AmfContext::enable_vbaq
int enable_vbaq
Definition: amfenc.h:96
AmfContext::level
int level
Definition: amfenc.h:85
AmfContext::skip_frame
int skip_frame
Definition: amfenc.h:97
AVFifoBuffer
Definition: fifo.h:31
AmfContext::delayed_frame
AVFrame * delayed_frame
Definition: amfenc.h:72
fifo.h
AmfContext::enforce_hrd
int enforce_hrd
Definition: amfenc.h:94
ff_amfenc_hw_configs
const AVCodecHWConfigInternal *const ff_amfenc_hw_configs[]
Definition: amfenc.c:786
AmfContext::delayed_surface
AMFSurface * delayed_surface
Definition: amfenc.h:71
AmfContext::rate_control_mode
int rate_control_mode
Definition: amfenc.h:93
AmfContext::preanalysis
int preanalysis
Definition: amfenc.h:86
AmfContext::filler_data
int filler_data
Definition: amfenc.h:95
AmfContext::avclass
AVClass * avclass
Definition: amfenc.h:48
AmfContext::debug
AMFDebug * debug
pointer to AMF debug interface
Definition: amfenc.h:52
AmfContext::min_qp_i
int min_qp_i
Definition: amfenc.h:114
AmfContext::min_qp_p
int min_qp_p
Definition: amfenc.h:116
AmfTraceWriter::avctx
AVCodecContext * avctx
Definition: amfenc.h:40
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
AmfContext::hw_frames_ctx
AVBufferRef * hw_frames_ctx
pointer to HW accelerator (frame allocator)
Definition: amfenc.h:64
AmfContext::timestamp_list
AVFifoBuffer * timestamp_list
Definition: amfenc.h:75
AmfContext::max_au_size
int max_au_size
Definition: amfenc.h:101
AmfContext::hwsurfaces_in_queue
int hwsurfaces_in_queue
Definition: amfenc.h:66
AmfContext::me_half_pel
int me_half_pel
Definition: amfenc.h:106
AmfTraceWriter
AMF trace writer callback class Used to capture all AMF logging.
Definition: amfenc.h:38
AmfContext::format
AMF_SURFACE_FORMAT format
AMF surface format.
Definition: amfenc.h:61
AVCodecHWConfigInternal
Definition: hwconfig.h:29
AmfContext::dts_delay
int64_t dts_delay
Definition: amfenc.h:76
ff_amf_pix_fmts
enum AVPixelFormat ff_amf_pix_fmts[]
Supported formats.
Definition: amfenc.c:53
AmfContext::usage
int usage
Definition: amfenc.h:83
AmfContext::encoder
AMFComponent * encoder
AMF encoder object.
Definition: amfenc.h:59
AmfContext::coding_mode
int coding_mode
Definition: amfenc.h:105
AmfContext::gops_per_idr
int gops_per_idr
Definition: amfenc.h:112
AmfContext::b_frame_delta_qp
int b_frame_delta_qp
Definition: amfenc.h:88
AmfContext::intra_refresh_mb
int intra_refresh_mb
Definition: amfenc.h:104
AmfContext::max_qp_i
int max_qp_i
Definition: amfenc.h:115
ff_amf_encode_close
int ff_amf_encode_close(AVCodecContext *avctx)
Common encoder termination function.
Definition: amfenc.c:370
avcodec.h
AmfContext::tier
int tier
Definition: amfenc.h:118
AmfContext::me_quarter_pel
int me_quarter_pel
Definition: amfenc.h:107
AmfContext::max_qp_p
int max_qp_p
Definition: amfenc.h:117
AVCodecContext
main external API structure.
Definition: avcodec.h:383
AmfContext::header_insertion_mode
int header_insertion_mode
Definition: amfenc.h:113
AmfContext::version
amf_uint64 version
version of AMF runtime
Definition: amfenc.h:55
AmfContext::qp_p
int qp_p
Definition: amfenc.h:99
ff_amf_encode_init
int ff_amf_encode_init(AVCodecContext *avctx)
Common encoder initization function.
Definition: amfenc.c:507
AmfContext::log_to_dbg
int log_to_dbg
Definition: amfenc.h:80
AmfContext::aud
int aud
Definition: amfenc.h:108
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
AmfContext::eof
amf_bool eof
flag indicating EOF happened
Definition: amfenc.h:60
AVPacket
This structure stores compressed data.
Definition: packet.h:350
AmfContext::hw_device_ctx
AVBufferRef * hw_device_ctx
pointer to HW accelerator (decoder)
Definition: amfenc.h:63
AmfContext::b_frame_ref
int b_frame_ref
Definition: amfenc.h:103
AmfContext
AMF encoder context.
Definition: amfenc.h:47
AmfContext::tracer
AmfTraceWriter tracer
AMF writer registered with AMF.
Definition: amfenc.h:56
AmfContext::context
AMFContext * context
AMF context.
Definition: amfenc.h:57
AmfContext::delayed_drain
int delayed_drain
Definition: amfenc.h:70