| VPXENC(1) | General Commands Manual | VPXENC(1) |
NAME¶
vpxenc - VP8 and VP9 video codec encoding tool
SYNOPSIS¶
vpxenc <options> -o dst_filename src_filename
OPTIONS¶
- -D, --debug
- Debug mode (makes output deterministic)
- -o <arg>, --output=<arg>
- Output filename
- --codec=<arg>
- Codec to use
- -p <arg>, --passes=<arg>
- Number of passes (1/2)
- --pass=<arg>
- Pass to execute (1/2)
- --fpf=<arg>
- First pass statistics file name
- --limit=<arg>
- Stop encoding after n input frames
- --skip=<arg>
- Skip the first n input frames
- -d <arg>, --deadline=<arg>
- Deadline per frame (usec)
- --best
- Use Best Quality Deadline
- --good
- Use Good Quality Deadline
- --rt
- Use Realtime Quality Deadline
- -q, --quiet
- Do not print encode progress
- -v, --verbose
- Show encoder parameters
- --psnr
- Show PSNR in status line
- --webm
- Output WebM (default when WebM IO is enabled)
- --ivf
- Output IVF
- -P, --output-partitions
- Makes encoder output partitions. Requires IVF output!
- --q-hist=<arg>
- Show quantizer histogram (n-buckets)
- --rate-hist=<arg>
- Show rate histogram (n-buckets)
- --disable-warnings
- Disable warnings about potentially incorrect encode settings.
- -y, --disable-warning-prompt
- Display warnings, but do not prompt user to continue.
- --test-decode=<arg>
- Test encode/decode mismatch
- off, fatal, warn
Encoder Global Options:¶
- --yv12
- Input file is YV12
- --i420
- Input file is I420 (default)
- --i422
- Input file is I422
- --i444
- Input file is I444
- --i440
- Input file is I440
- -u <arg>, --usage=<arg>
- Usage profile number to use
- -t <arg>, --threads=<arg>
- Max number of threads to use
- --profile=<arg>
- Bitstream profile number to use
- -w <arg>, --width=<arg>
- Frame width
- -h <arg>, --height=<arg>
- Frame height
- --stereo-mode=<arg>
- Stereo 3D video format
- mono, left-right, bottom-top, top-bottom, right-left
- --timebase=<arg>
- Output timestamp precision (fractional seconds)
- --fps=<arg>
- Stream frame rate (rate/scale)
- --error-resilient=<arg>
- Enable error resiliency features
- --lag-in-frames=<arg>
- Max number of frames to lag
Rate Control Options:¶
- --drop-frame=<arg>
- Temporal resampling threshold (buf %)
- --resize-allowed=<arg>
- Spatial resampling enabled (bool)
- --resize-width=<arg>
- Width of encoded frame
- --resize-height=<arg>
- Height of encoded frame
- --resize-up=<arg>
- Upscale threshold (buf %)
- --resize-down=<arg>
- Downscale threshold (buf %)
- --end-usage=<arg>
- Rate control mode
- vbr, cbr, cq, q
- --target-bitrate=<arg>
- Bitrate (kbps)
- --min-q=<arg>
- Minimum (best) quantizer
- --max-q=<arg>
- Maximum (worst) quantizer
- --undershoot-pct=<arg>
- Datarate undershoot (min) target (%)
- --overshoot-pct=<arg>
- Datarate overshoot (max) target (%)
- --buf-sz=<arg>
- Client buffer size (ms)
- --buf-initial-sz=<arg>
- Client initial buffer size (ms)
- --buf-optimal-sz=<arg>
- Client optimal buffer size (ms)
Twopass Rate Control Options:¶
- --bias-pct=<arg>
- CBR/VBR bias (0=CBR, 100=VBR)
- --minsection-pct=<arg>
- GOP min bitrate (% of target)
- --maxsection-pct=<arg>
- GOP max bitrate (% of target)
Keyframe Placement Options:¶
- --kf-min-dist=<arg>
- Minimum keyframe interval (frames)
- --kf-max-dist=<arg>
- Maximum keyframe interval (frames)
- --disable-kf
- Disable keyframe placement
VP8 Specific Options:¶
- --cpu-used=<arg>
- CPU Used (-16..16)
- --auto-alt-ref=<arg>
- Enable automatic alt reference frames
- --noise-sensitivity=<arg>
- Noise sensitivity (frames to blur)
- Loop filter sharpness (0..7)
- --static-thresh=<arg>
- Motion detection threshold
- --token-parts=<arg>
- Number of token partitions to use, log2
- --arnr-maxframes=<arg>
- AltRef max frames (0..15)
- --arnr-strength=<arg>
- AltRef filter strength (0..6)
- --arnr-type=<arg>
- AltRef type
- --tune=<arg>
- Material to favor
- psnr, ssim
- --cq-level=<arg>
- Constant/Constrained Quality level
- --max-intra-rate=<arg>
- Max I-frame bitrate (pct)
- --screen-content-mode=<arg
- Screen content mode
VP9 Specific Options:¶
- --cpu-used=<arg>
- CPU Used (-8..8)
- --auto-alt-ref=<arg>
- Enable automatic alt reference frames
- Loop filter sharpness (0..7)
- --static-thresh=<arg>
- Motion detection threshold
- --tile-columns=<arg>
- Number of tile columns to use, log2
- --tile-rows=<arg>
- Number of tile rows to use, log2 (set to 0 while threads > 1)
- --arnr-maxframes=<arg>
- AltRef max frames (0..15)
- --arnr-strength=<arg>
- AltRef filter strength (0..6)
- --arnr-type=<arg>
- AltRef type
- --tune=<arg>
- Material to favor
- psnr, ssim
- --cq-level=<arg>
- Constant/Constrained Quality level
- --max-intra-rate=<arg>
- Max I-frame bitrate (pct)
- --max-inter-rate=<arg>
- Max P-frame bitrate (pct)
- --gf-cbr-boost=<arg>
- Boost for Golden Frame in CBR mode (pct)
- --lossless=<arg>
- Lossless mode (0: false (default), 1: true)
- --frame-parallel=<arg>
- Enable frame parallel decodability features
- --aq-mode=<arg>
- Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360)
- --frame-boost=<arg>
- Enable frame periodic boost (0: off (default), 1: on)
- --noise-sensitivity=<arg>
- Noise sensitivity (frames to blur)
- --tune-content=<arg>
- Tune content type
- default, screen
- --color-space=<arg>
- The color space of input content:
- unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB
- --min-gf-interval=<arg>
- min gf/arf frame interval (default 0, indicating in-built behavior)
- --max-gf-interval=<arg>
- max gf/arf frame interval (default 0, indicating in-built behavior)
- --target-level=<arg>
- Target level (255: off (default); 0: only keep level stats; 10: level 1.0; 11: level 1.1; ... 62: level 6.2)
Stream timebase (--timebase):¶
- The desired precision of timestamps in the output, expressed in fractional seconds. Default is 1/1000.
Included encoders:
- Use --codec to switch to a non-default encoder.
- -D, --debug
- Debug mode (makes output deterministic)
- -o <arg>, --output=<arg>
- Output filename
- --codec=<arg>
- Codec to use
- -p <arg>, --passes=<arg>
- Number of passes (1/2)
- --pass=<arg>
- Pass to execute (1/2)
- --fpf=<arg>
- First pass statistics file name
- --limit=<arg>
- Stop encoding after n input frames
- --skip=<arg>
- Skip the first n input frames
- -d <arg>, --deadline=<arg>
- Deadline per frame (usec)
- --best
- Use Best Quality Deadline
- --good
- Use Good Quality Deadline
- --rt
- Use Realtime Quality Deadline
- -q, --quiet
- Do not print encode progress
- -v, --verbose
- Show encoder parameters
- --psnr
- Show PSNR in status line
- --webm
- Output WebM (default when WebM IO is enabled)
- --ivf
- Output IVF
- -P, --output-partitions
- Makes encoder output partitions. Requires IVF output!
- --q-hist=<arg>
- Show quantizer histogram (n-buckets)
- --rate-hist=<arg>
- Show rate histogram (n-buckets)
- --disable-warnings
- Disable warnings about potentially incorrect encode settings.
- -y, --disable-warning-prompt
- Display warnings, but do not prompt user to continue.
- --test-decode=<arg>
- Test encode/decode mismatch
- off, fatal, warn
Encoder Global Options:¶
- --yv12
- Input file is YV12
- --i420
- Input file is I420 (default)
- --i422
- Input file is I422
- --i444
- Input file is I444
- --i440
- Input file is I440
- -u <arg>, --usage=<arg>
- Usage profile number to use
- -t <arg>, --threads=<arg>
- Max number of threads to use
- --profile=<arg>
- Bitstream profile number to use
- -w <arg>, --width=<arg>
- Frame width
- -h <arg>, --height=<arg>
- Frame height
- --stereo-mode=<arg>
- Stereo 3D video format
- mono, left-right, bottom-top, top-bottom, right-left
- --timebase=<arg>
- Output timestamp precision (fractional seconds)
- --fps=<arg>
- Stream frame rate (rate/scale)
- --error-resilient=<arg>
- Enable error resiliency features
- --lag-in-frames=<arg>
- Max number of frames to lag
Rate Control Options:¶
- --drop-frame=<arg>
- Temporal resampling threshold (buf %)
- --resize-allowed=<arg>
- Spatial resampling enabled (bool)
- --resize-width=<arg>
- Width of encoded frame
- --resize-height=<arg>
- Height of encoded frame
- --resize-up=<arg>
- Upscale threshold (buf %)
- --resize-down=<arg>
- Downscale threshold (buf %)
- --end-usage=<arg>
- Rate control mode
- vbr, cbr, cq, q
- --target-bitrate=<arg>
- Bitrate (kbps)
- --min-q=<arg>
- Minimum (best) quantizer
- --max-q=<arg>
- Maximum (worst) quantizer
- --undershoot-pct=<arg>
- Datarate undershoot (min) target (%)
- --overshoot-pct=<arg>
- Datarate overshoot (max) target (%)
- --buf-sz=<arg>
- Client buffer size (ms)
- --buf-initial-sz=<arg>
- Client initial buffer size (ms)
- --buf-optimal-sz=<arg>
- Client optimal buffer size (ms)
Twopass Rate Control Options:¶
- --bias-pct=<arg>
- CBR/VBR bias (0=CBR, 100=VBR)
- --minsection-pct=<arg>
- GOP min bitrate (% of target)
- --maxsection-pct=<arg>
- GOP max bitrate (% of target)
Keyframe Placement Options:¶
- --kf-min-dist=<arg>
- Minimum keyframe interval (frames)
- --kf-max-dist=<arg>
- Maximum keyframe interval (frames)
- --disable-kf
- Disable keyframe placement
VP8 Specific Options:¶
- --cpu-used=<arg>
- CPU Used (-16..16)
- --auto-alt-ref=<arg>
- Enable automatic alt reference frames
- --noise-sensitivity=<arg>
- Noise sensitivity (frames to blur)
- Loop filter sharpness (0..7)
- --static-thresh=<arg>
- Motion detection threshold
- --token-parts=<arg>
- Number of token partitions to use, log2
- --arnr-maxframes=<arg>
- AltRef max frames (0..15)
- --arnr-strength=<arg>
- AltRef filter strength (0..6)
- --arnr-type=<arg>
- AltRef type
- --tune=<arg>
- Material to favor
- psnr, ssim
- --cq-level=<arg>
- Constant/Constrained Quality level
- --max-intra-rate=<arg>
- Max I-frame bitrate (pct)
- --screen-content-mode=<arg
- Screen content mode
VP9 Specific Options:¶
- --cpu-used=<arg>
- CPU Used (-8..8)
- --auto-alt-ref=<arg>
- Enable automatic alt reference frames
- Loop filter sharpness (0..7)
- --static-thresh=<arg>
- Motion detection threshold
- --tile-columns=<arg>
- Number of tile columns to use, log2
- --tile-rows=<arg>
- Number of tile rows to use, log2 (set to 0 while threads > 1)
- --arnr-maxframes=<arg>
- AltRef max frames (0..15)
- --arnr-strength=<arg>
- AltRef filter strength (0..6)
- --arnr-type=<arg>
- AltRef type
- --tune=<arg>
- Material to favor
- psnr, ssim
- --cq-level=<arg>
- Constant/Constrained Quality level
- --max-intra-rate=<arg>
- Max I-frame bitrate (pct)
- --max-inter-rate=<arg>
- Max P-frame bitrate (pct)
- --gf-cbr-boost=<arg>
- Boost for Golden Frame in CBR mode (pct)
- --lossless=<arg>
- Lossless mode (0: false (default), 1: true)
- --frame-parallel=<arg>
- Enable frame parallel decodability features
- --aq-mode=<arg>
- Adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3: cyclic refresh, 4: equator360)
- --frame-boost=<arg>
- Enable frame periodic boost (0: off (default), 1: on)
- --noise-sensitivity=<arg>
- Noise sensitivity (frames to blur)
- --tune-content=<arg>
- Tune content type
- default, screen
- --color-space=<arg>
- The color space of input content:
- unknown, bt601, bt709, smpte170, smpte240, bt2020, reserved, sRGB
- --min-gf-interval=<arg>
- min gf/arf frame interval (default 0, indicating in-built behavior)
- --max-gf-interval=<arg>
- max gf/arf frame interval (default 0, indicating in-built behavior)
- --target-level=<arg>
- Target level (255: off (default); 0: only keep level stats; 10: level 1.0; 11: level 1.1; ... 62: level 6.2)
Stream timebase (--timebase):¶
- The desired precision of timestamps in the output, expressed in fractional seconds. Default is 1/1000.
Included encoders:¶
- Use --codec to switch to a non-default encoder.
| August 2016 |