Merge pull request #211 from BlueSwordM/master

More documentation for aomenc-av1

docs/Encoders/aomenc.md

@@ -15,20 +15,35 @@ GIT: [AOM](https://aomedia.googlesource.com/aom/)
 | --cq-level=arg | Constant/Constrained Quality level, used in Q/CQ modes |
 | --target-bitrate=arg | Bitrate (kbps) |
 | --bit-depth=arg |  Bit depth (8, 10, 12) |
-| --lag-in-frames=arg | Amount of lag in frames (0..35) 19(default) | 
-| --tile-columns=arg | Number of tile columns to use, log2 (number to power of 2) |
-| --tile-rows=arg | Number of tile rows to use, log2  (number to power of 2)|
-| --threads=arg | Allowed number of threads to use|
+| --tile-columns=arg | Number of tile columns to use, log2 (number to power of 2). Therefore, if you set the number to 2, it'll do 2²= 4 tile columns. |
+| --tile-rows=arg | Number of tile rows to use, log2  (number to power of 2). Therefore, if you set the number to 1, it'll do 2¹= 2 tile rows. |
+| --threads=arg | Allowed number of threads to use. It is recommended to set to however many cores you have for chunked encoding, and how many threads you have for single instance encoding.|
+| --lag-in-frames=arg | Number of lagged frames used by the encoder for lookahead and alternate reference frame placement: more is better, but makes the encoder slower, up to a limit of 35 (default is 19). |
+| --aq-mode=arg | Adaptive quantization mode (0: Default. 1: Variance, in which the encoder lowers the quantizer value for flat low complexity blocks, like clouds or dark scenes. Not recommended unless you know what you are doing. 2: Complexity, in which the encoder lowers the quantizer for complex parts of the image. 3: Cyclic refresh. Ups the quantizer value as much as possible for static flat looking blocks, only doing block refreshes in cycles if needed. Not recommend unless when used for live-streaming or conferencing.) |
+| --tune-content=arg | Tune content type (default: tuned for most content. screen: tuned for screen recordings, low complexity animations, and most videos games. Not recommended for complex animation like anime as it disables some post-processing making it look worse.) |
+| --enable-fwd-kf=arg | Enable forward reference keyframes(default=0). Makes the encoder more efficient, but a bit slower. It's recommended to enable it by setting it to 1 . |
+| --kf-min-dist=arg | Minimum keyframe interval in frames(default=12). It is recommended to leave it to default values |
+| --kf-max-dist=arg | Maximum keyframe interval in frames(default=9999, or adaptive keyframe placement only). It is recommended to set it to a MAX of 10s worth of frames, or 240 for 24FPS, 300 for 30FPS, and 600 for 60FPS for easier seeking. For video game content or >=60FPS content, is is also possible to use a max of 5s worth of frames to help with seeking performance. Leave it to default if you want maximum efficiency. |
+| --enable-keyframe-filtering=arg | Apply temporal filtering on key frame(0: no filter, 1: filter without overlay (default), 2: filter with overlay - experimental, may break random access in players.). It is recommended to leave it at default unless you really know what you're doing. |
+| --arnr-maxframes=arg | Maximum number of alternate reference noise reduced frames used by the encoder(default=7). It is recommended to leave it at default unless you want to crank up the efficiency for low motion scenes. |
+| --arnr-strength=arg | ARNR frames filtering strength. It is recommended to leave it at default. |
+| --enable-qm=arg | Enable quantisation matrices (0: false (default), 1: true). It is recommended to turn the setting on by setting it to 1 for higher efficiency at a slight loss of speed. |
+| --quant-b-adapt=arg | Use adaptive quantize_b(default=0). This setting enables adaptive quanzation for reference frames. It is recommended to turn the setting on by setting it to 1 for higher efficiency at a slight loss of speed. |
+| --mv-cost-upd-freq=arg | Update freq for mv costs(motion vector estimation cost calculation) 0: SB(SuperBlock), 1: SB Row per Tile, 2: Tile, 3: Off. It is recommended to set it to 2 for higher efficiency at a slight loss of speed. |
+| --enable-chroma-deltaq=arg | Enable chroma delta quant (0: false (default), 1: true). It is recommened to turn the setting on by setting to 1 for higher efficiency at a slight loss of speed. It seems to be currently broken below CQ15, so use it at your own risk if you have a minimum Q(min_q) below 15.
+| --color-primaries=arg | Color primaries (CICP) of input content: bt709, unspecified, bt601, bt470m, bt470bg, smpte240, film, bt2020, xyz, smpte431, smpte432, ebu3213. Leave at default unless you have HDR content or your source's color-primaries information is different; in that case, set it to whatever your content is, usually BT2020.
+| --transfer-characteristics=arg | Transfer characteristics (CICP) of input content(unspecified, bt709, bt470m, bt470bg, bt601, smpte240, lin, log100, log100sq10, iec61966, bt1361, srgb, bt2020-10bit, bt2020-12bit, smpte2084, hlg, smpte428. Leave at default unless you have HDR content or your source's transfer characteristics are different; in that case, set it to whatever your content is.
+| --matrix-coefficients=arg | Matrix coefficients (CICP) of input content: identity, bt709, unspecified, fcc73, bt470bg, bt601, smpte240, ycgco, bt2020ncl, bt2020cl, smpte2085, chromncl, chromcl, ictcp. Leave at default unless you have HDR content or your source's matrix coefficients information is different; in that case, set it to whatever your content is.
 
 ### Examples of settings
 
 ##### Constant quality:
 
-` --end-usage=q --cq-level=30 --cpu-used=4 --threads=64 `
+` --end-usage=q --cq-level=30 --cpu-used=4 --threads=16 `
 
 ##### Target Bitrate:
 
-`` --end-usage=vbr --target-bitrate=1000 --cpu-used=4 --threads=64 ``
+`` --end-usage=vbr --target-bitrate=1000 --cpu-used=4 --threads=16 ``
 
 
 ##### Tiles: