10#ifndef VPX_VPX_VPX_ENCODER_H_
11#define VPX_VPX_VPX_ENCODER_H_
38#define VPX_TS_MAX_PERIODICITY 16
41#define VPX_TS_MAX_LAYERS 5
44#define VPX_MAX_LAYERS 12
47#define VPX_SS_MAX_LAYERS 5
50#define VPX_SS_DEFAULT_LAYERS 1
65#define VPX_ENCODER_ABI_VERSION \
66 (18 + VPX_CODEC_ABI_VERSION + \
67 VPX_EXT_RATECTRL_ABI_VERSION)
78#define VPX_CODEC_CAP_PSNR 0x10000
85#define VPX_CODEC_CAP_OUTPUT_PARTITION 0x20000
94#define VPX_CODEC_USE_PSNR 0x10000
96#define VPX_CODEC_USE_OUTPUT_PARTITION 0x20000
97#define VPX_CODEC_USE_HIGHBITDEPTH 0x40000
123#define VPX_FRAME_IS_KEY 0x1u
126#define VPX_FRAME_IS_DROPPABLE 0x2u
128#define VPX_FRAME_IS_INVISIBLE 0x4u
130#define VPX_FRAME_IS_FRAGMENT 0x8u
140#define VPX_ERROR_RESILIENT_DEFAULT 0x1u
146#define VPX_ERROR_RESILIENT_PARTITIONS 0x2u
192 struct vpx_psnr_pkt {
268#define VPX_EFLAG_FORCE_KF (1 << 0)
900#define vpx_codec_enc_init(ctx, iface, cfg, flags) \
901 vpx_codec_enc_init_ver(ctx, iface, cfg, flags, VPX_ENCODER_ABI_VERSION)
931#define vpx_codec_enc_init_multi(ctx, iface, cfg, num_enc, flags, dsf) \
932 vpx_codec_enc_init_multi_ver(ctx, iface, cfg, num_enc, flags, dsf, \
933 VPX_ENCODER_ABI_VERSION)
1004#define VPX_DL_REALTIME 1ul
1006#define VPX_DL_GOOD_QUALITY 1000000ul
1008#define VPX_DL_BEST_QUALITY 0ul
1103 unsigned int pad_before,
1104 unsigned int pad_after);
long vpx_codec_flags_t
Initialization-time Feature Enabling.
Definition vpx_codec.h:170
struct vpx_codec_ctx vpx_codec_ctx_t
Codec context structure.
const void * vpx_codec_iter_t
Iterator.
Definition vpx_codec.h:190
enum vpx_bit_depth vpx_bit_depth_t
Bit depth for codecThis enumeration determines the bit depth of the codec.
vpx_codec_err_t
Algorithm return codes.
Definition vpx_codec.h:93
const struct vpx_codec_iface vpx_codec_iface_t
Codec interface structure.
Definition vpx_codec.h:177
vpx_codec_err_t vpx_codec_enc_init_ver(vpx_codec_ctx_t *ctx, vpx_codec_iface_t *iface, const vpx_codec_enc_cfg_t *cfg, vpx_codec_flags_t flags, int ver)
Initialize an encoder instance.
vpx_codec_err_t vpx_codec_enc_init_multi_ver(vpx_codec_ctx_t *ctx, vpx_codec_iface_t *iface, vpx_codec_enc_cfg_t *cfg, int num_enc, vpx_codec_flags_t flags, vpx_rational_t *dsf, int ver)
Initialize multi-encoder instance.
struct vpx_codec_enc_cfg vpx_codec_enc_cfg_t
Encoder configuration structure.
#define VPX_TS_MAX_LAYERS
Definition vpx_encoder.h:41
vpx_codec_cx_pkt_kind
Encoder output packet variants.
Definition vpx_encoder.h:154
void(* vpx_codec_enc_output_cx_pkt_cb_fn_t)(vpx_codec_cx_pkt_t *pkt, void *user_data)
Encoder return output buffer callback.
Definition vpx_encoder.h:213
vpx_enc_pass
Multi-pass Encoding Pass.
Definition vpx_encoder.h:232
const vpx_image_t * vpx_codec_get_preview_frame(vpx_codec_ctx_t *ctx)
Get Preview Frame.
struct vpx_svc_parameters vpx_svc_extra_cfg_t
vp9 svc extra configure parameters
struct vpx_fixed_buf vpx_fixed_buf_t
Generic fixed size buffer structure.
const vpx_codec_cx_pkt_t * vpx_codec_get_cx_data(vpx_codec_ctx_t *ctx, vpx_codec_iter_t *iter)
Encoded data iterator.
#define VPX_TS_MAX_PERIODICITY
Definition vpx_encoder.h:38
unsigned long vpx_enc_deadline_t
Encode Deadline.
Definition vpx_encoder.h:1002
struct vpx_codec_enc_output_cx_cb_pair vpx_codec_priv_output_cx_pkt_cb_pair_t
Callback function pointer / user data pair storage.
#define VPX_MAX_LAYERS
Definition vpx_encoder.h:44
uint32_t vpx_codec_er_flags_t
Error Resilient flags.
Definition vpx_encoder.h:138
int64_t vpx_codec_pts_t
Time Stamp Type.
Definition vpx_encoder.h:113
#define VPX_SS_MAX_LAYERS
Definition vpx_encoder.h:47
long vpx_enc_frame_flags_t
Encoded Frame Flags.
Definition vpx_encoder.h:267
vpx_codec_err_t vpx_codec_enc_config_default(vpx_codec_iface_t *iface, vpx_codec_enc_cfg_t *cfg, unsigned int usage)
Get a default configuration.
vpx_kf_mode
Keyframe placement mode.
Definition vpx_encoder.h:254
struct vpx_codec_cx_pkt vpx_codec_cx_pkt_t
Encoder output packet.
uint32_t vpx_codec_frame_flags_t
Compressed Frame Flags.
Definition vpx_encoder.h:122
vpx_codec_err_t vpx_codec_enc_config_set(vpx_codec_ctx_t *ctx, const vpx_codec_enc_cfg_t *cfg)
Set or change configuration.
vpx_fixed_buf_t * vpx_codec_get_global_headers(vpx_codec_ctx_t *ctx)
Get global stream headers.
struct vpx_rational vpx_rational_t
Rational Number.
vpx_codec_err_t vpx_codec_set_cx_data_buf(vpx_codec_ctx_t *ctx, const vpx_fixed_buf_t *buf, unsigned int pad_before, unsigned int pad_after)
Set compressed data output buffer.
vpx_codec_err_t vpx_codec_encode(vpx_codec_ctx_t *ctx, const vpx_image_t *img, vpx_codec_pts_t pts, unsigned long duration, vpx_enc_frame_flags_t flags, vpx_enc_deadline_t deadline)
Encode a frame.
vpx_rc_mode
Rate control mode.
Definition vpx_encoder.h:239
@ VPX_CODEC_PSNR_PKT
Definition vpx_encoder.h:158
@ VPX_CODEC_CX_FRAME_PKT
Definition vpx_encoder.h:155
@ VPX_CODEC_STATS_PKT
Definition vpx_encoder.h:156
@ VPX_CODEC_CUSTOM_PKT
Definition vpx_encoder.h:159
@ VPX_CODEC_FPMB_STATS_PKT
Definition vpx_encoder.h:157
@ VPX_RC_LAST_PASS
Definition vpx_encoder.h:235
@ VPX_RC_ONE_PASS
Definition vpx_encoder.h:233
@ VPX_RC_FIRST_PASS
Definition vpx_encoder.h:234
@ VPX_KF_DISABLED
Definition vpx_encoder.h:257
@ VPX_KF_FIXED
Definition vpx_encoder.h:255
@ VPX_KF_AUTO
Definition vpx_encoder.h:256
@ VPX_Q
Definition vpx_encoder.h:243
@ VPX_CQ
Definition vpx_encoder.h:242
@ VPX_CBR
Definition vpx_encoder.h:241
@ VPX_VBR
Definition vpx_encoder.h:240
Encoder output packet.
Definition vpx_encoder.h:167
union vpx_codec_cx_pkt::@105367030154200007005241002351245163342006201240 data
char pad[128 - sizeof(enum vpx_codec_cx_pkt_kind)]
Definition vpx_encoder.h:204
struct vpx_codec_cx_pkt::@105367030154200007005241002351245163342006201240::@337301343345304110063267327113124066016321050157 frame
vpx_codec_frame_flags_t flags
Definition vpx_encoder.h:177
vpx_fixed_buf_t twopass_stats
Definition vpx_encoder.h:190
enum vpx_codec_cx_pkt_kind kind
Definition vpx_encoder.h:168
unsigned int samples[4]
Definition vpx_encoder.h:193
double psnr[4]
Definition vpx_encoder.h:195
unsigned int width[5]
Width and height of frames in this packet. VP8 will only use the first one.
Definition vpx_encoder.h:184
uint8_t spatial_layer_encoded[5]
Flag to indicate if spatial layer frame in this packet is encoded or dropped. VP8 will always be set ...
Definition vpx_encoder.h:188
vpx_fixed_buf_t firstpass_mb_stats
Definition vpx_encoder.h:191
size_t sz
Definition vpx_encoder.h:172
void * buf
Definition vpx_encoder.h:171
vpx_codec_pts_t pts
time stamp to show frame (in timebase units)
Definition vpx_encoder.h:174
vpx_fixed_buf_t raw
Definition vpx_encoder.h:197
unsigned int height[5]
Definition vpx_encoder.h:185
int partition_id
the partition id defines the decoding order of the partitions. Only applicable when "output partition...
Definition vpx_encoder.h:181
uint64_t sse[4]
Definition vpx_encoder.h:194
unsigned long duration
duration to show frame (in timebase units)
Definition vpx_encoder.h:176
Encoder configuration structure.
Definition vpx_encoder.h:276
vpx_rational_t rd_mult_arf_qp_fac
Rate-distortion multiplier for alt-ref frames. The multiplier is a crucial parameter in the calculati...
Definition vpx_encoder.h:838
unsigned int rc_resize_allowed
Enable/disable spatial resampling, if supported by the codec.
Definition vpx_encoder.h:408
int temporal_layering_mode
Temporal layering mode indicating which temporal layering scheme to use.
Definition vpx_encoder.h:703
unsigned int kf_min_dist
Keyframe minimum interval.
Definition vpx_encoder.h:615
vpx_rational_t sr_default_decay_limit
Second reference default decay limit.
Definition vpx_encoder.h:736
unsigned int rc_min_quantizer
Minimum (Best Quality) Quantizer.
Definition vpx_encoder.h:483
unsigned int ts_number_layers
Number of temporal coding layers.
Definition vpx_encoder.h:654
vpx_rational_t kf_max_total_boost_factor
Keyframe maximum total boost adjustment factor.
Definition vpx_encoder.h:791
vpx_fixed_buf_t rc_twopass_stats_in
Two-pass stats buffer.
Definition vpx_encoder.h:455
unsigned int rc_resize_down_thresh
Spatial resampling down watermark.
Definition vpx_encoder.h:438
unsigned int ss_number_layers
Number of spatial coding layers.
Definition vpx_encoder.h:634
unsigned int rc_2pass_vbr_bias_pct
Two-pass mode CBR/VBR bias.
Definition vpx_encoder.h:573
unsigned int rc_2pass_vbr_minsection_pct
Two-pass mode per-GOP minimum bitrate.
Definition vpx_encoder.h:580
int ss_enable_auto_alt_ref[5]
Enable auto alt reference flags for each spatial layer.
Definition vpx_encoder.h:641
unsigned int rc_scaled_width
Internal coded frame width.
Definition vpx_encoder.h:415
vpx_rational_t rd_mult_key_qp_fac
Rate-distortion multiplier for key frames. The multiplier is a crucial parameter in the calculation o...
Definition vpx_encoder.h:848
unsigned int g_profile
Bitstream profile to use.
Definition vpx_encoder.h:303
unsigned int layer_target_bitrate[12]
Target bitrate for each spatial/temporal layer.
Definition vpx_encoder.h:694
unsigned int g_h
Height of the frame.
Definition vpx_encoder.h:321
enum vpx_kf_mode kf_mode
Keyframe placement mode.
Definition vpx_encoder.h:606
unsigned int ts_layer_id[16]
Template defining the membership of frames to temporal layers.
Definition vpx_encoder.h:686
vpx_codec_er_flags_t g_error_resilient
Enable error resilient modes.
Definition vpx_encoder.h:359
unsigned int ts_periodicity
Length of the sequence defining frame temporal layer membership.
Definition vpx_encoder.h:677
unsigned int rc_overshoot_pct
Rate control adaptation overshoot control.
Definition vpx_encoder.h:526
vpx_fixed_buf_t rc_firstpass_mb_stats_in
first pass mb stats buffer.
Definition vpx_encoder.h:462
unsigned int rc_scaled_height
Internal coded frame height.
Definition vpx_encoder.h:422
unsigned int g_usage
Deprecated: Algorithm specific "usage" value.
Definition vpx_encoder.h:285
unsigned int g_w
Width of the frame.
Definition vpx_encoder.h:312
unsigned int ss_target_bitrate[5]
Target bitrate for each spatial layer.
Definition vpx_encoder.h:648
unsigned int rc_buf_sz
Decoder Buffer Size.
Definition vpx_encoder.h:541
unsigned int rc_dropframe_thresh
Temporal resampling configuration, if supported by the codec.
Definition vpx_encoder.h:399
struct vpx_rational g_timebase
Stream timebase units.
Definition vpx_encoder.h:351
enum vpx_enc_pass g_pass
Multi-pass Encoding Mode.
Definition vpx_encoder.h:366
vpx_rational_t kf_frame_max_boost_first_factor
Keyframe maximum boost adjustment factor, for the first keyframe in a chunk.
Definition vpx_encoder.h:773
unsigned int rc_resize_up_thresh
Spatial resampling up watermark.
Definition vpx_encoder.h:430
unsigned int rc_max_quantizer
Maximum (Worst Quality) Quantizer.
Definition vpx_encoder.h:492
unsigned int rc_2pass_vbr_corpus_complexity
Two-pass corpus vbr mode complexity control Used only in VP9: A value representing the corpus midpoin...
Definition vpx_encoder.h:594
vpx_rational_t zm_factor
Zero motion power factor.
Definition vpx_encoder.h:818
unsigned int g_lag_in_frames
Allow lagged encoding.
Definition vpx_encoder.h:380
enum vpx_rc_mode rc_end_usage
Rate control algorithm to use.
Definition vpx_encoder.h:448
vpx_rational_t active_wq_factor
Active worst quality factor.
Definition vpx_encoder.h:718
vpx_rational_t gf_max_total_boost_factor
Golden frame maximum total boost adjustment factor.
Definition vpx_encoder.h:800
unsigned int rc_buf_initial_sz
Decoder Buffer Initial Size.
Definition vpx_encoder.h:550
vpx_bit_depth_t g_bit_depth
Bit-depth of the codec.
Definition vpx_encoder.h:329
vpx_rational_t gf_frame_max_boost_factor
Golden frame maximum boost adjustment factor.
Definition vpx_encoder.h:809
unsigned int rc_buf_optimal_sz
Decoder Buffer Optimal Size.
Definition vpx_encoder.h:559
int use_vizier_rc_params
A flag indicating whether to use external rate control parameters. By default is 0....
Definition vpx_encoder.h:709
unsigned int rc_2pass_vbr_maxsection_pct
Two-pass mode per-GOP maximum bitrate.
Definition vpx_encoder.h:587
unsigned int rc_target_bitrate
Target data rate.
Definition vpx_encoder.h:470
unsigned int ts_target_bitrate[5]
Target bitrate for each temporal layer.
Definition vpx_encoder.h:661
vpx_rational_t err_per_mb_factor
Error per macroblock adjustment factor.
Definition vpx_encoder.h:727
unsigned int g_input_bit_depth
Bit-depth of the input frames.
Definition vpx_encoder.h:337
vpx_rational_t kf_frame_min_boost_factor
Keyframe minimum boost adjustment factor.
Definition vpx_encoder.h:763
vpx_rational_t sr_diff_factor
Second reference difference factor.
Definition vpx_encoder.h:745
vpx_rational_t kf_err_per_mb_factor
Keyframe error per macroblock adjustment factor.
Definition vpx_encoder.h:754
unsigned int rc_undershoot_pct
Rate control adaptation undershoot control.
Definition vpx_encoder.h:511
unsigned int ts_rate_decimator[5]
Frame rate decimation factor for each temporal layer.
Definition vpx_encoder.h:668
unsigned int kf_max_dist
Keyframe maximum interval.
Definition vpx_encoder.h:624
vpx_rational_t rd_mult_inter_qp_fac
Rate-distortion multiplier for inter frames. The multiplier is a crucial parameter in the calculation...
Definition vpx_encoder.h:828
vpx_rational_t kf_frame_max_boost_subs_factor
Keyframe maximum boost adjustment factor, for subsequent keyframes.
Definition vpx_encoder.h:782
unsigned int g_threads
Maximum number of threads to use.
Definition vpx_encoder.h:293
Callback function pointer / user data pair storage.
Definition vpx_encoder.h:217
void * user_priv
Definition vpx_encoder.h:219
vpx_codec_enc_output_cx_pkt_cb_fn_t output_cx_pkt
Definition vpx_encoder.h:218
Generic fixed size buffer structure.
Definition vpx_encoder.h:103
size_t sz
Definition vpx_encoder.h:105
void * buf
Definition vpx_encoder.h:104
Rational Number.
Definition vpx_encoder.h:226
int den
Definition vpx_encoder.h:228
int num
Definition vpx_encoder.h:227
vp9 svc extra configure parameters
Definition vpx_encoder.h:856
int min_quantizers[12]
Definition vpx_encoder.h:858
int scaling_factor_num[12]
Definition vpx_encoder.h:859
int speed_per_layer[12]
Definition vpx_encoder.h:861
int max_quantizers[12]
Definition vpx_encoder.h:857
int scaling_factor_den[12]
Definition vpx_encoder.h:860
int loopfilter_ctrl[12]
Definition vpx_encoder.h:863
int temporal_layering_mode
Definition vpx_encoder.h:862
Describes the codec algorithm interface to applications.
Defines structs and callbacks needed for external rate control.
struct vpx_image vpx_image_t
Image Descriptor.