1SVTAV1ENCAPP(1)                  User Commands                 SVTAV1ENCAPP(1)
2
3
4

NAME

6       SvtAv1EncApp - manual page for SvtAv1EncApp 0.8.7
7

SYNOPSIS

9       SvtAv1EncApp <options> -b dst_filename -i src_filename
10

OPTIONS

12       --help Show usage options and exit
13
14       -i, --input
15              Input filename
16
17       -b, --output
18              Output filename
19
20       --errlog
21              Error filename
22
23       -o, --recon
24              Recon filename
25
26       --stat-file
27              Stat filename
28
29       --preset
30              Encoder  mode/Preset  used  (-2 (debugging preset),-1 (debugging
31              preset),0 - 8 [default]) thehigher the preset,  the  higher  the
32              speed, the lower the preset, the lower the quality
33
34   Encoder Global Options:
35       -w, --width
36              Frame width
37
38       -h, --height
39              Frame height
40
41       -n, --frames
42              Stop encoding after n input frames
43
44       --nb   Buffer n input frames
45
46       --progress
47              Change  verbosity  of  the output (0: no progress is printed, 1:
48              default, 2: aomenc style machine parsable output)
49
50       --no-progress
51              Do not print out progress, if set  to  1  it  is  equivalent  to
52              `--progress 0`, else  `--progress 1`
53
54       --color-format
55              Set encoder color format(YUV400, YUV420, YUV422, YUV444 : YUV420
56              [default])
57
58       --profile
59              Bitstream profile number to  use(0:  main  profile[default],  1:
60              high profile, 2: professional profile)
61
62       --fps  Stream frame rate (rate/scale)
63
64       --fps-num
65              Stream frame rate numerator
66
67       --fps-denom
68              Stream frame rate denominator
69
70       --input-depth
71              Bit depth for codec(8 or 10)
72
73       --16bit-pipeline
74              Bit depth for enc-dec(0: lbd[default], 1: hbd)
75
76       --compressed-ten-bit-format
77              Offline packing of the 2bits: requires two bits packed input (0:
78              OFF[default], 1: ON)
79
80       --inj  Inject pictures at defined frame rate(0: OFF[default],1: ON)
81
82       --inj-frm-rt
83              Set injector frame rate
84
85       --hierarchical-levels
86              Set hierarchical levels (0 - 5 : 4 [default])
87
88       --pred-struct
89              Set prediction structure( 0: low delay P, 1:  low  delay  B,  2:
90              random access [default])
91
92       --enable-stat-report
93              outputs  psnr  ssim  metrics  at  the  end  of the encode    (0:
94              OFF[default], 1: ON)
95
96       --asm  Limit assembly instruction set [0 - 11] or [c, mmx,  sse,  sse2,
97              sse3, ssse3, sse4_1, sse4_2, avx, avx2, avx512, max], by default
98              highest level supported by CPU
99
100       --lp   target number of logical cores to be used (1-max number of cores
101              on machine[default])
102
103       --unpin
104              Allows  the execution to be pined/unpined to/from specific cores
105              set by --lp
106
107       The combinational use of --unpin with --lp results in memory  reduction
108       while  allowing  the  execution to work on any of the cores and not re‐
109       strict it to specific cores --unpin is overwritten to 0  when  --ss  is
110       set  to 0 or 1. ( 0: OFF ,1: ON [default]) Example: 72 core machine: 72
111       jobs x -- lp 1 -- unpin 1 36 jobs x -- lp 2 -- unpin 1 18 jobs x --  lp
112       4 -- unpin 1
113
114       --ss   Specify   which socket the encoder runs on--unpin is overwritten
115              to 0 when --ss is set to 0 or 1
116
117   Rate Control Options:
118       --rc   Rate control mode(0 = CQP if --enable-tpl-la is set to  0,  else
119              CRF , 1 = VBR)
120
121       --tbr  Target Bitrate (kbps)
122
123       --use-q-file
124              Overwrite QP assignment using qp values in QP file
125
126       --use-fixed-qindex-offsets
127              Use fixed QIndex offset
128
129       --key-frame-qindex-offset
130              Key Frame QIndex Offset
131
132       --key-frame-chroma-qindex-offset
133              Key Frame Chroma QIndex Offset
134
135       --qindex-offsets
136              QIndexOffsets
137
138       --chroma-qindex-offsets
139              ChromaQIndexOffsets
140
141       --qpfile
142              Path to Qp file
143
144       -q, --qp
145              Constant/Constrained Quality level
146
147       --crf  Constant Rate Factor, equal to --rc 0 --enable-tpl-la 1 --qp x
148
149       --max-qp
150              Maximum (worst) quantizer[0-63] only applicable  when --rc > 0
151
152       --min-qp
153              Minimum (best) quantizer[0-63] only applicable when --rc > 0
154
155       --adaptive-quantization
156              Set  adaptive  QP  level(0: OFF ,1: variance base using segments
157              ,2: Deltaq pred efficiency)
158
159       --vbv-bufsize
160              VBV buffer size
161
162       --undershoot-pct
163              Datarate undershoot (min) target (%)
164
165       --overshoot-pct
166              Datarate overshoot (max) target (%)
167
168       --recode-loop
169              Recode loop levels    (0 : OFF, 1: Allow recode for KF  and  ex‐
170              ceeding   maximum  frame  bandwidth,  2:Allow  recode  only  for
171              KF/ARF/GF frames, 3: Allow recode for all frames  based  on  bi‐
172              trate constraints, 4: preset based decision [Default])
173
174   Twopass Options:
175       --pass Multipass bitrate control (1: first pass, generates stats file ,
176              2: second pass, uses stats file)
177
178       --stats
179              Filename for 2 pass stats("svtav1_2pass.log" : [Default])
180
181       --passes
182              Number of passes (1: one pass encode, 2: two passes encode)  ap‐
183              plicable only for rc > 0
184
185       --bias-pct
186              CBR/VBR bias (0=CBR-like, 100=VBR-like)
187
188       --minsection-pct
189              GOP min bitrate (% of target)
190
191       --maxsection-pct
192              GOP max bitrate (% of target)
193
194   GOP size and type Options:
195       --keyint
196              Intra period interval(frames) (-2: default intra period , -1: No
197              intra update or [0 - 2^31-2]; [-2-255] if RateControlMode >= 1)
198
199       --irefresh-type
200              Intra refresh type (1:  FWD  Frame  (Open  GOP),  2:  KEY  Frame
201              (Closed GOP)[default])
202
203       --lookahead, -lad
204              The  lookahead  option is currently disabled (forced to 0) until
205              further work is done on rate control
206
207   AV1 Specific Options:
208       --tile-rows
209              Number of tile rows to use, log2[0-6]
210
211       --tile-columns
212              Number of tile columns to use, log2[0-4]
213
214       --disable-dlf
215              Disable loop filter(0: loop  filter  enabled[default]  ,1:  loop
216              filter disabled)
217
218       --cdef-level
219              CDEF  Level,  0:  OFF, 1-5: ON with 64,16,8,4,1 step refinement,
220              -1: DEFAULT
221
222       --enable-restoration-filtering
223              Enable the loop restoration filter(0: OFF ,1: ON ,-1:DEFAULT)
224
225       --sg-filter-mode
226              Self-guided filter mode (0:OFF, 1: step 0, 2: step 1, 3: step 4,
227              4: step 16, -1: DEFAULT)
228
229       --wn-filter-mode
230              Wiener filter mode (0:OFF, 1: 3-Tap luma/ 3-Tap chroma, 2: 5-Tap
231              luma/ 5-Tap chroma, 3: 7-Tap luma/ 7-Tap chroma, -1: DEFAULT)
232
233       --mrp-level
234              Multi reference frame levels( 0: OFF, 1: FULL, 2: Level1  ..  9:
235              Level8,  -1: DEFAULT)
236
237       --enable-tpl-la
238              RDO  based  on  frame  temporal  dependency (0: off, 1: backward
239              source based)
240
241       --enable-mfmv
242              Enable motion field motion vector( 0: OFF, 1: ON, -1: DEFAULT)
243
244       --enable-redundant-blk
245              Use the same md results(mode, residual , cost,etc..)as the  pre‐
246              viously processed identical block(0: OFF, 1: ON, -1: DEFAULT)
247
248       --enable-spatial-sse-full-loop-level
249              Enable spatial sse full loop(0: OFF, 1: ON, -1: DEFAULT)
250
251       --enable-over-bndry-blk
252              Enable over boundary block mode (0: OFF, 1: ON, -1: DEFAULT)
253
254       --enable-new-nrst-near-comb
255              Enable  new  nearest near comb injection (0: OFF, 1: ON, -1: DE‐
256              FAULT)
257
258       --enable-nsq-table-use
259              Enable nsq table (0: OFF, 1: ON, -1: DEFAULT)
260
261       --enable-framend-cdf-upd-mode
262              Enable frame end cdf update mode (0: OFF, 1: ON, -1: DEFAULT)
263
264       --chroma-mode
265              Select chroma mode([0-3], -1: DEFAULT)
266
267       --disable-cfl
268              Disable chroma from luma (CFL) flag (0: OFF (do not disable), 1:
269              ON (disable), -1: DEFAULT)
270
271       --enable-local-warp
272              Enable warped motion use , 0 = OFF, 1 = ON, -1 = DEFAULT
273
274       --enable-global-motion
275              Enable global motion (0: OFF, 1: ON [default])
276
277       --intra-angle-delta
278              Enable intra angle delta filtering filtering (0: OFF, 1: ON, -1:
279              DEFAULT)
280
281       --enable-interintra-comp
282              Enable interintra compound (0: OFF, 1: ON (default))
283
284       --enable-paeth
285              Enable paeth (0: OFF, 1: ON, -1: DEFAULT)
286
287       --enable-smooth
288              Enable smooth (0: OFF, 1: ON, -1: DEFAULT)
289
290       --obmc-level
291              OBMC Level(0: OFF, 1: Fully ON, 2 and 3 are faster  levels,  -1:
292              DEFAULT)
293
294       --rdoq-level
295              Enable RDOQ (0: OFF, 1: ON, -1: DEFAULT)
296
297       --filter-intra-level
298              Enable filter intra prediction mode (0: OFF, 1: ON [default])
299
300       --enable-intra-edge-filter
301              Enable intra edge filter (0: OFF, 1: ON, -1: DEFAULT)
302
303       --enable-pic-based-rate-est
304              Enable  picture  based  rate  estimation (0: OFF, 1: ON, -1: DE‐
305              FAULT)
306
307       --pred-me
308              Set predictive motion estimation level(-1: default, [0-5])
309
310       --bipred-3x3
311              Set bipred3x3 injection (0: OFF, 1: ON FULL, 2: Reduced set, -1:
312              DEFAULT)
313
314       --compound
315              Enable    compound    mode(0:   OFF,   1:ON[AVG/DIST/DIFF],   2:
316              ON[AVG/DIST/DIFF/WEDGE], -1: default)
317
318       --use-default-me-hme
319              Use default  motion  estimation/hierarchical  motion  estimation
320              settings(0: OFF, 1: ON[default])
321
322       --hme  Enable hierarchical motion estimation(0: OFF, 1: ON)
323
324       --hme-l0
325              Enable hierarchical motion estimation Level 0 (0: OFF, 1: ON)
326
327       --hme-l1
328              Enable hierarchical motion estimation Level 1 (0: OFF, 1: ON)
329
330       --hme-l2
331              Enable hierarchical motion estimation Level 2 (0: OFF, 1: ON)
332
333       --ext-block
334              Enable the rectangular and asymetric block (0: OFF, 1: ON)
335
336       --search-w
337              Set search area in width[1-256]
338
339       --search-h
340              Set search area in height[1-256]
341
342       --scm  Set screen content detection level([0-2], 2 Content adaptive de‐
343              cision: DEFAULT)
344
345       --intrabc-mode
346              Set intraBC mode (0: OFF, 1:  ON  slow,  2:  ON  faster,  3:  ON
347              fastest, -1: DEFAULT)
348
349       --hbd-md
350              Enable  high bit depth mode decision(0: OFF, 1: ON partially[de‐
351              fault],2: fully ON)
352
353       --palette-level
354              Set palette prediction mode(-1: default or [0-6])
355
356       --umv  Allow motion vectors to reach outside of the picture boundary(O:
357              OFF, 1: ON[default])
358
359       --film-grain
360              Enable  film grain(0: OFF[default], 1-50: ON, film-grain denois‐
361              ing strength)
362
363       --tf-level
364              Set altref level(-1: Default; 0: OFF; 1: ON)
365
366       --enable-overlays
367              Enable the insertion of an extra picture called  overlayer  pic‐
368              ture  which  will  be  used  as an extra reference frame for the
369              base-layer picture(0: OFF[default], 1: ON)
370
371       --enable-intra-angle-delta
372              Enable intra angle delta filtering filtering (0: OFF, 1: ON, -1:
373              DEFAULT)
374
375   Color Description Options:
376       --color-primaries
377              Color primaries (2: DEFAULT)
378
379       --transfer-characteristics
380              Transfer characteristics (2: DEFAULT)
381
382       --matrix-coefficients
383              Matrix coefficients (2: DEFAULT)
384
385       --color-range
386              Color range, 0: Studio (default), 1: Full
387

EXAMPLES

389   Two passes encode (VBR only):
390              SvtAv1EncApp <--stats svtav1_2pass.log> --rc 1 --tbr 1000 --pass
391              1 -b dst_filename  -i  src_filename  SvtAv1EncApp  <--stats  sv‐
392              tav1_2pass.log>  --rc  1  --tbr 1000 --pass 2 -b dst_filename -i
393              src_filename
394
395   Or a combined cli:
396              SvtAv1EncApp <--stats svtav1_2pass.log> --passes 2 --rc 1  --tbr
397              1000 -b dst_filename -i src_filename
398
399
400
401SvtAv1EncApp 0.8.7                August 2021                  SVTAV1ENCAPP(1)