b0da9b399d
Add a new encoder control, VP8E_SET_TUNING, to allow the application to inform the encoder that the material will benefit from certain tuning. Expose this control as the --tune option to vpxenc. The args helper is expanded to support enumerated arguments by name or value. Two tunings are provided by this patch, PSNR (default) and SSIM. Activity masking is made dependent on setting --tune=ssim, as the current implementation hurts speed (10%) and PSNR (2.7% avg, 10% peak) too much for it to be a default yet. Change-Id: I110d969381c4805347ff5a0ffaf1a14ca1965257
227 lines
7.8 KiB
C
227 lines
7.8 KiB
C
/*
|
|
* Copyright (c) 2010 The WebM project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
|
|
#ifndef __INC_VP8_H
|
|
#define __INC_VP8_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
#include "vpx/internal/vpx_codec_internal.h"
|
|
#include "vpx/vp8cx.h"
|
|
#include "vpx_scale/yv12config.h"
|
|
#include "type_aliases.h"
|
|
#include "ppflags.h"
|
|
typedef int *VP8_PTR;
|
|
|
|
/* Create/destroy static data structures. */
|
|
|
|
typedef enum
|
|
{
|
|
NORMAL = 0,
|
|
FOURFIVE = 1,
|
|
THREEFIVE = 2,
|
|
ONETWO = 3
|
|
|
|
} VPX_SCALING;
|
|
|
|
typedef enum
|
|
{
|
|
VP8_LAST_FLAG = 1,
|
|
VP8_GOLD_FLAG = 2,
|
|
VP8_ALT_FLAG = 4
|
|
} VP8_REFFRAME;
|
|
|
|
|
|
typedef enum
|
|
{
|
|
USAGE_STREAM_FROM_SERVER = 0x0,
|
|
USAGE_LOCAL_FILE_PLAYBACK = 0x1
|
|
} END_USAGE;
|
|
|
|
|
|
typedef enum
|
|
{
|
|
MODE_REALTIME = 0x0,
|
|
MODE_GOODQUALITY = 0x1,
|
|
MODE_BESTQUALITY = 0x2,
|
|
MODE_FIRSTPASS = 0x3,
|
|
MODE_SECONDPASS = 0x4,
|
|
MODE_SECONDPASS_BEST = 0x5,
|
|
} MODE;
|
|
|
|
typedef enum
|
|
{
|
|
FRAMEFLAGS_KEY = 1,
|
|
FRAMEFLAGS_GOLDEN = 2,
|
|
FRAMEFLAGS_ALTREF = 4,
|
|
} FRAMETYPE_FLAGS;
|
|
|
|
|
|
#include <assert.h>
|
|
static __inline void Scale2Ratio(int mode, int *hr, int *hs)
|
|
{
|
|
switch (mode)
|
|
{
|
|
case NORMAL:
|
|
*hr = 1;
|
|
*hs = 1;
|
|
break;
|
|
case FOURFIVE:
|
|
*hr = 4;
|
|
*hs = 5;
|
|
break;
|
|
case THREEFIVE:
|
|
*hr = 3;
|
|
*hs = 5;
|
|
break;
|
|
case ONETWO:
|
|
*hr = 1;
|
|
*hs = 2;
|
|
break;
|
|
default:
|
|
*hr = 1;
|
|
*hs = 1;
|
|
assert(0);
|
|
break;
|
|
}
|
|
}
|
|
|
|
typedef struct
|
|
{
|
|
int Version; // 4 versions of bitstream defined 0 best quality/slowest decode, 3 lowest quality/fastest decode
|
|
int Width; // width of data passed to the compressor
|
|
int Height; // height of data passed to the compressor
|
|
double frame_rate; // set to passed in framerate
|
|
int target_bandwidth; // bandwidth to be used in kilobits per second
|
|
|
|
int noise_sensitivity; // parameter used for applying pre processing blur: recommendation 0
|
|
int Sharpness; // parameter used for sharpening output: recommendation 0:
|
|
int cpu_used;
|
|
|
|
// mode ->
|
|
//(0)=Realtime/Live Encoding. This mode is optimized for realtim encoding (for example, capturing
|
|
// a television signal or feed from a live camera). ( speed setting controls how fast )
|
|
//(1)=Good Quality Fast Encoding. The encoder balances quality with the amount of time it takes to
|
|
// encode the output. ( speed setting controls how fast )
|
|
//(2)=One Pass - Best Quality. The encoder places priority on the quality of the output over encoding
|
|
// speed. The output is compressed at the highest possible quality. This option takes the longest
|
|
// amount of time to encode. ( speed setting ignored )
|
|
//(3)=Two Pass - First Pass. The encoder generates a file of statistics for use in the second encoding
|
|
// pass. ( speed setting controls how fast )
|
|
//(4)=Two Pass - Second Pass. The encoder uses the statistics that were generated in the first encoding
|
|
// pass to create the compressed output. ( speed setting controls how fast )
|
|
//(5)=Two Pass - Second Pass Best. The encoder uses the statistics that were generated in the first
|
|
// encoding pass to create the compressed output using the highest possible quality, and taking a
|
|
// longer amount of time to encode.. ( speed setting ignored )
|
|
int Mode; //
|
|
|
|
// Key Framing Operations
|
|
int auto_key; // automatically detect cut scenes and set the keyframes
|
|
int key_freq; // maximum distance to key frame.
|
|
|
|
int allow_lag; // allow lagged compression (if 0 lagin frames is ignored)
|
|
int lag_in_frames; // how many frames lag before we start encoding
|
|
|
|
//----------------------------------------------------------------
|
|
// DATARATE CONTROL OPTIONS
|
|
|
|
int end_usage; // vbr or cbr
|
|
|
|
// shoot to keep buffer full at all times by undershooting a bit 95 recommended
|
|
int under_shoot_pct;
|
|
|
|
// buffering parameters
|
|
int starting_buffer_level; // in seconds
|
|
int optimal_buffer_level;
|
|
int maximum_buffer_size;
|
|
|
|
// controlling quality
|
|
int fixed_q;
|
|
int worst_allowed_q;
|
|
int best_allowed_q;
|
|
|
|
// allow internal resizing ( currently disabled in the build !!!!!)
|
|
int allow_spatial_resampling;
|
|
int resample_down_water_mark;
|
|
int resample_up_water_mark;
|
|
|
|
// allow internal frame rate alterations
|
|
int allow_df;
|
|
int drop_frames_water_mark;
|
|
|
|
// two pass datarate control
|
|
int two_pass_vbrbias; // two pass datarate control tweaks
|
|
int two_pass_vbrmin_section;
|
|
int two_pass_vbrmax_section;
|
|
// END DATARATE CONTROL OPTIONS
|
|
//----------------------------------------------------------------
|
|
|
|
|
|
// these parameters aren't to be used in final build don't use!!!
|
|
int play_alternate;
|
|
int alt_freq;
|
|
int alt_q;
|
|
int key_q;
|
|
int gold_q;
|
|
|
|
|
|
int multi_threaded; // how many threads to run the encoder on
|
|
int token_partitions; // how many token partitions to create for multi core decoding
|
|
int encode_breakout; // early breakout encode threshold : for video conf recommend 800
|
|
|
|
int error_resilient_mode; // if running over udp networks provides decodable frames after a
|
|
// dropped packet
|
|
|
|
int arnr_max_frames;
|
|
int arnr_strength ;
|
|
int arnr_type ;
|
|
|
|
|
|
struct vpx_fixed_buf two_pass_stats_in;
|
|
struct vpx_codec_pkt_list *output_pkt_list;
|
|
|
|
vp8e_tuning tuning;
|
|
} VP8_CONFIG;
|
|
|
|
|
|
void vp8_initialize();
|
|
|
|
VP8_PTR vp8_create_compressor(VP8_CONFIG *oxcf);
|
|
void vp8_remove_compressor(VP8_PTR *comp);
|
|
|
|
void vp8_init_config(VP8_PTR onyx, VP8_CONFIG *oxcf);
|
|
void vp8_change_config(VP8_PTR onyx, VP8_CONFIG *oxcf);
|
|
|
|
// receive a frames worth of data caller can assume that a copy of this frame is made
|
|
// and not just a copy of the pointer..
|
|
int vp8_receive_raw_frame(VP8_PTR comp, unsigned int frame_flags, YV12_BUFFER_CONFIG *sd, INT64 time_stamp, INT64 end_time_stamp);
|
|
int vp8_get_compressed_data(VP8_PTR comp, unsigned int *frame_flags, unsigned long *size, unsigned char *dest, INT64 *time_stamp, INT64 *time_end, int flush);
|
|
int vp8_get_preview_raw_frame(VP8_PTR comp, YV12_BUFFER_CONFIG *dest, vp8_ppflags_t *flags);
|
|
|
|
int vp8_use_as_reference(VP8_PTR comp, int ref_frame_flags);
|
|
int vp8_update_reference(VP8_PTR comp, int ref_frame_flags);
|
|
int vp8_get_reference(VP8_PTR comp, VP8_REFFRAME ref_frame_flag, YV12_BUFFER_CONFIG *sd);
|
|
int vp8_set_reference(VP8_PTR comp, VP8_REFFRAME ref_frame_flag, YV12_BUFFER_CONFIG *sd);
|
|
int vp8_update_entropy(VP8_PTR comp, int update);
|
|
int vp8_set_roimap(VP8_PTR comp, unsigned char *map, unsigned int rows, unsigned int cols, int delta_q[4], int delta_lf[4], unsigned int threshold[4]);
|
|
int vp8_set_active_map(VP8_PTR comp, unsigned char *map, unsigned int rows, unsigned int cols);
|
|
int vp8_set_internal_size(VP8_PTR comp, VPX_SCALING horiz_mode, VPX_SCALING vert_mode);
|
|
int vp8_get_quantizer(VP8_PTR c);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|