Skip to content

Commit 7c02975

Browse files
sr55sr55
committed
Remove outdated option lists for the hardware encoders. While we support some of the libavcodec hardware encoder options, many have caveats or have changed over time. As such, this information is dated. If someone wants to test and re-work this, feel free.
1 parent c54bef6 commit 7c02975

File tree

3 files changed

+0
-184
lines changed

3 files changed

+0
-184
lines changed

‎source/docs/en/latest/technical/video-nvenc.markdown‎

Lines changed: 0 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -76,34 +76,3 @@ When using HandBrake’s graphical interface, set the options in the `Advanced O
7676
When using HandBrake’s command line interface, set the options using the `--encopts` parameter as follows:
7777

7878
--encopts="option1=value1:option2=value2"
79-
80-
### Option value types
81-
82-
The following value types are supported (each option only accepts one value type):
83-
84-
- integer
85-
A number that can be written without a fractional or decimal component.
86-
87-
- boolean
88-
0 means off (or disabled).
89-
1 means on (or enabled).
90-
91-
- string
92-
An alphanumeric string of characters. See the option’s comments for acceptable values.
93-
94-
### Options list
95-
96-
| Option | Type | H.264 | H.265 | Detail |
97-
|------------------|-------------|:-----:|:-----:|-----------------------------------------------------------------------------------------------------------|
98-
| coder | string | ✓ | | Coder selection. Values: `auto` (default), `cabac`, `cavlc`. |
99-
| temporal-aq | boolean | ✓ | | Set to `1` to enable Temporal Adaptive Quality, `0` to disable (default). Note the hyphen for H.264. |
100-
| temporal_aq | boolean | | ✓ | Set to `1` to enable Temporal Adaptive Quality, `0` to disable (default). Note the underscore for H.265. |
101-
| spatial-aq | boolean | ✓ | | Set to `1` to enable Spatial Adaptive Quality, `0` to disable (default). Note the hyphen for H.264. |
102-
| spatial_aq | boolean | | ✓ | Set to `1` to enable Spatial Adaptive Quality, `0` to disable (default). Note the underscore for H.265. |
103-
| aq-strength | int | ✓ | ✓ | When Spatial AQ is enabled, the values scale is `1` (low) – `15` (aggressive). Default: `8`. |
104-
| nonref_p | boolean | ✓ | ✓ | Set to `1` to enable automatic insertion of non-reference P-frames, `0` to disable (default). |
105-
| strict_gop | boolean | ✓ | ✓ | Set to `1` to minimize GOP-to-GOP rate fluctuations, `0` to disable (default). |
106-
| weighted_pred | boolean | ✓ | ✓ | Set to `1` to enable weighted prediction, `0` to disable (default). |
107-
| rc-lookahead | int | ✓ | ✓ | Number of frames to look ahead for rate control. Default: `0`. |
108-
| b_adapt | boolean | ✓ | | When lookahead is enabled, set this to `1` to enable adaptive B-frame decision (default), `0` to disable. |
109-
| no-scenecut | boolean | ✓ | ✓ | When lookahead is enabled, set this to `1` to disable adaptive I-frame insertion at scene cuts, `0` to enable (default). |

‎source/docs/en/latest/technical/video-qsv.markdown‎

Lines changed: 0 additions & 118 deletions
Original file line numberDiff line numberDiff line change
@@ -99,121 +99,3 @@ If using HandBrake’s graphical interface, you can set the options in the `Adva
9999
If using HandBrake’s command line interface, use the `--encopts` parameter as follows:
100100

101101
--encopts="option1=value1:option2=value2"
102-
103-
### Option value types
104-
105-
The following value types are supported (each option only accepts one value type):
106-
107-
- integer
108-
A number that can be written without a fractional or decimal component.
109-
110-
- boolean
111-
0 means off (or disabled).
112-
1 means on (or enabled).
113-
114-
- string
115-
An alphanumeric string of characters. See the option’s comments for acceptable values.
116-
117-
### Options list
118-
119-
- target-usage (or tu) <integer>
120-
- Sets the trade-off between quality and speed, from 1 (best quality) to 7 (fastest speed).
121-
- Default: 2
122-
123-
- num-ref-frame (or ref) <integer>
124-
- Number of reference frames, from 1 to 16.
125-
- 0 means unspecified (set at runtime by the implementation).
126-
- Default: 0 (unspecified)
127-
128-
- gop-ref-dist <integer>
129-
- Distance between I or P reference frames, from 1 to 16.
130-
- -1 means automatic (4 in constant QP mode, 3 otherwise).
131-
- 0 means unspecified (set at runtime by the implementation).
132-
- 1 means B-frames will not be used.
133-
- Default: -1 (automatic)
134-
- Note: may be sanitized to a lower value in some cases to avoid hangs.
135-
136-
- gop-pic-size (or keyint) <integer>
137-
- Number of pictures within the current GOP (aka "keyframe interval").
138-
- -1 means automatic (32 in constant QP mode, 1 second long otherwise).
139-
- 0 means unspecified (set at runtime by the implementation).
140-
- 1 means only I-frames will be used.
141-
- 2 means B-frames will not be used.
142-
- Default: -1 (automatic)
143-
144-
- cavlc <boolean>
145-
- Use CAVLC instead of CABAC entropy coding. Reduces compression efficiency.
146-
- It may improve encoding performance slightly, especially on older hardware.
147-
- Note: you can also use `cabac` (same as `cavlc` with reversed meaning).
148-
- Default: 0 (CAVLC off, CABAC on)
149-
150-
- b-pyramid <integer>
151-
- Enables or disables "Pyramidal B-frames" which can improve compression efficiency.
152-
- It may be incompatible with some playback devices (such as the first generation AppleTV).
153-
- Note that this options modifies other parameters (gop-ref-dist, num-ref-frame, gop-pic-size).
154-
- -1 means automatic (on in constant QP mode, off otherwise).
155-
- 0 means off (disabled).
156-
- 1 means on (enabled).
157-
- Default: -1 (automatic)
158-
- Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.6 of the Media SDK API.
159-
160-
- mbbrc <boolean>
161-
- Enables macroblock-level bitrate control that generally improves subjective visual quality.
162-
- It may have a negative impact on performance and objective visual quality metrics.
163-
- Default: 1 (on)
164-
- Note: not compatible with Constant QP or LookAhead rate control methods (ignored).
165-
- Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.6 of the Media SDK API.
166-
167-
- extbrc <boolean>
168-
- Use extended bitrate control algorithms.
169-
- It generally improves objective visual quality metrics and subjective visual quality,
170-
- but can also lead to violation of HRD conformance and may significantly reduce performance.
171-
- Default: 0 (off)
172-
- Note: not compatible with Constant QP or LookAhead rate control methods (ignored).
173-
- Caveats: requires driver support for version 1.6 of the Media SDK API.
174-
175-
- trellis <integer>
176-
- Enables trellis quantization.
177-
- 0 means trellis is disabled.
178-
- 1 means trellis is enabled for I-frames only.
179-
- 2 means trellis is enabled for I and P-frames.
180-
- 3 means trellis is enabled for all frames (I, P and B).
181-
- Default: 0 (disabled)
182-
- Note: ignored if the target-usage is too low (usually, only works in combination with tu=1).
183-
- Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.7 of the Media SDK API.
184-
185-
- lookahead (or la) <boolean>
186-
- Use the LookAhead (LA or LA_ICQ) bitrate control algorithm.
187-
- Default: 1 (on)
188-
- Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.7 (1.8 for LA_ICQ) of the Media SDK API.
189-
190-
- lookahead-depth (or la-depth) <integer>
191-
- If LookAhead bitrate control is enabled, number of frames that are analyzed before encoding, from 11 to 60.
192-
- Default: 40
193-
- Note: may be sanitized to a lower value in some cases to avoid hangs.
194-
- Caveats: requires hardware support (4th gen. Intel Core processor or equivalent), and driver support for version 1.7 of the Media SDK API.
195-
196-
- force-cqp <boolean>
197-
- In Constant Quality mode, use Constant QP rate control, even if Intelligent Constant Quality is available.
198-
- Default: 0 (ICQ enabled if available)
199-
200-
- cqp-offset-i <integer> | cqp-offset-p <integer> | cqp-offset-b <integer>
201-
- In constant QP (CQP) bitrate control mode, specify offset from the global quality/QP value for I, P and B-frames.
202-
- Defaults are 0, 2 and 4, respectively.
203-
204-
- vbv-maxrate <integer>
205-
- Sets the maximum rate the VBV buffer should be assumed to refill at, in kilobits per second (Kbps).
206-
- Default: 0 (set at runtime by the implementation)
207-
- Note: not compatible with Constant QP, Intelligent Constant Quality or LookAhead rate control methods (ignored).
208-
209-
- vbv-bufsize <integer>
210-
- Sets the size of the VBV buffer in kilobits (Kb).
211-
- Default: 0 (set at runtime by the implementation)
212-
- Note: not compatible with Constant QP, Intelligent Constant Quality or LookAhead rate control methods (ignored).
213-
214-
- vbv-init <float>
215-
- Sets how full the VBV Buffer must be before playback starts.
216-
- If it is less than 1, then the initial fill is: vbv-init * vbv-bufsize.
217-
- Otherwise it is interpreted as the initial fill in kilobits (Kb).
218-
- Default: 0 (set at runtime by the implementation)
219-
- Note: not compatible with Constant QP, Intelligent Constant Quality or LookAhead rate control methods (ignored).

‎source/docs/en/latest/technical/video-vcn.markdown‎

Lines changed: 0 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -96,38 +96,3 @@ If using HandBrake’s graphical interface, you can set the options in the `Adva
9696
If using HandBrake’s command line interface, use the `--encopts` parameter as follows:
9797

9898
--encopts="option1=value1:option2=value2"
99-
100-
101-
### Option value types
102-
103-
The following value types are supported (each option only accepts one value type):
104-
105-
- integer
106-
A number that can be written without a fractional or decimal component.
107-
108-
- boolean
109-
0 means off (or disabled).
110-
1 means on (or enabled).
111-
112-
- string
113-
An alphanumeric string of characters. See the option’s comments for acceptable values.
114-
115-
### Options list
116-
117-
| Option | Type | H.264 | H.265 | Detail |
118-
|-----------------------|-------------|:-----:|:-----:|--------------------------------------------------------------------------------------|
119-
| usage | string | ✓ | ✓ | Options: `transcoding`, `ultralowlatency`, `lowlatency`, `webcam` |
120-
| coder | string | ✓ | | Coder selection. Values: `auto` (default), `cabac`, `cavlc`. |
121-
| preanalysis | boolean | ✓ | ✓ | Set to `1` to enable preliminary analysis, `0` to disable (default). |
122-
| vbaq | boolean | ✓ | ✓ | Set to `1` to enable Variance Based Adaptive Quantization, `0` to disable (default). |
123-
| enforce_hrd | boolean | ✓ | ✓ | Set to `1` to enforce Hypothetical Reference Decoder, `0` to disable (default). |
124-
| max_au_size | int | ✓ | ✓ | Maximum Access Unit size for rate control, in bits. Default: `0` (automatic). |
125-
| me_half_pel | boolean | ✓ | ✓ | Set to `1` to enable half-pixel motion estimation (default), `0` to disable. |
126-
| me_quarter_pel | boolean | ✓ | ✓ | Set to `1` to enable quarter-pixel motion estimation (default), `0` to disable. |
127-
| bf_delta_qp | int | ✓ | | B-Picture Delta QP. The values scale is `-10`–`10`. Default: `4`. |
128-
| bf_ref | boolean | ✓ | | Set to `1` to enable Reference B-Frames (default), `0` to disable. |
129-
| bf_ref_delta_qp | int | ✓ | | Reference B-Picture Delta QP. The values scale is `-10`–`10`. Default: `4`. |
130-
| intra_refresh_mb | int | ✓ | | Number of Intra-Refresh Macroblocks per slot. Default: `0` (automatic). |
131-
| header_insertion_mode | string | | ✓ | Options: `none`, `gop`, `idr` |
132-
| gops_per_idr | int | | ✓ | GOPs per IDR 0-no IDR will be inserted |
133-

0 commit comments

Comments
 (0)