GstCodecParsers.AV1FilmGrainParams¶
Fields¶
Name |
Type |
Access |
Description |
|---|---|---|---|
apply_grain |
r/w |
equal to 1 specifies that film grain should be added to this frame. apply_grain equal to 0 specifies that film grain should not be added. |
|
ar_coeff_lag |
r/w |
specifies the number of auto-regressive coefficients for luma and chroma. |
|
ar_coeff_shift_minus_6 |
r/w |
specifies the range of the auto-regressive coefficients. Values of 0, 1, 2, and 3 correspond to the ranges for auto-regressive coefficients of [-2, 2), [-1, 1), [-0.5, 0.5) and [-0.25, 0.25) respectively. |
|
ar_coeffs_cb_plus_128 |
r/w |
specifies auto-regressive coefficients used for the U plane. |
|
ar_coeffs_cr_plus_128 |
r/w |
specifies auto-regressive coefficients used for the V plane. |
|
ar_coeffs_y_plus_128 |
r/w |
specifies auto-regressive coefficients used for the Y plane. |
|
cb_luma_mult |
r/w |
represents a multiplier for the average luma component used in derivation of the input index to the cb component scaling function. |
|
cb_mult |
r/w |
represents a multiplier for the cb component used in derivation of the input index to the cb component scaling function. |
|
cb_offset |
r/w |
represents an offset used in derivation of the input index to the cb component scaling function. |
|
chroma_scaling_from_luma |
r/w |
specifies that the chroma scaling is inferred from the luma scaling. |
|
clip_to_restricted_range |
r/w |
equal to 1 indicates that clipping to the restricted (studio) range shall be applied to the sample values after adding the film grain (see the semantics for color_range for an explanation of studio swing). clip_to_restricted_range equal to 0 indicates that clipping to the full range shall be applied to the sample values after adding the film grain. |
|
cr_luma_mult |
r/w |
represents a multiplier for the average luma component used in derivation of the input index to the cr component scaling function. |
|
cr_mult |
r/w |
represents a multiplier for the cr component used in derivation of the input index to the cr component scaling function. |
|
cr_offset |
r/w |
represents an offset used in derivation of the input index to the cr component scaling function. |
|
film_grain_params_ref_idx |
r/w |
indicates which reference frame contains the film grain parameters to be used for this frame. |
|
grain_scale_shift |
r/w |
specifies how much the Gaussian random numbers should be scaled down during the grain synthesis process. |
|
grain_scaling_minus_8 |
r/w |
represents the shift - 8 applied to the values of the chroma component. The grain_scaling_minus_8 can take values of 0..3 and determines the range and quantization step of the standard deviation of film grain. |
|
grain_seed |
r/w |
specifies the starting value for the pseudo-random numbers used during film grain synthesis. |
|
num_cb_points |
r/w |
specifies the number of points for the piece-wise linear scaling function of the cb component. It is a requirement of bitstream conformance that num_cb_points is less than or equal to 10. |
|
num_cr_points |
r/w |
specifies represents the number of points for the piece-wise linear scaling function of the cr component. It is a requirement of bitstream conformance that num_cr_points is less than or equal to 10. If subsampling_x is equal to 1 and subsampling_y is equal to 1 and num_cb_points is equal to 0, it is a requirement of bitstream conformance that num_cr_points is equal to 0. If subsampling_x is equal to 1 and subsampling_y is equal to 1 and num_cb_points is not equal to 0, it is a requirement of bitstream conformance that num_cr_points is not equal to 0. |
|
num_y_points |
r/w |
specifies the number of points for the piece-wise linear scaling function of the luma component. It is a requirement of bitstream conformance that num_y_points is less than or equal to 14. |
|
overlap_flag |
r/w |
equal to 1 indicates that the overlap between film grain blocks shall be applied. overlap_flag equal to 0 indicates that the overlap between film grain blocks shall not be applied. |
|
point_cb_scaling |
r/w |
represents the scaling (output) value for the i-th point of the piecewise linear scaling function for cb component. |
|
point_cb_value |
r/w |
represents the x coordinate for the i-th point of the piece-wise linear scaling function for cb component. The values are signaled on the scale of 0..255. If i is greater than 0, it is a requirement of bitstream conformance that point_cb_value[ i ] is greater than point_cb_value[ i - 1 ]. |
|
point_cr_scaling |
r/w |
represents the scaling (output) value for the i-th point of the piecewise linear scaling function for cr component. |
|
point_cr_value |
r/w |
represents the x coordinate for the i-th point of the piece-wise linear scaling function for cr component. The values are signaled on the scale of 0..255. If i is greater than 0, it is a requirement of bitstream conformance that point_cr_value[ i ] is greater than point_cr_value[ i - 1 ]. |
|
point_y_scaling |
r/w |
represents the scaling (output) value for the i-th point of the piecewise linear scaling function for luma component. |
|
point_y_value |
r/w |
represents the x (luma value) coordinate for the i-th point of the piecewise linear scaling function for luma component. The values are signaled on the scale of 0..255. (In case of 10 bit video, these values correspond to luma values divided by 4. In case of 12 bit video, these values correspond to luma values divided by 16.) If i is greater than 0, it is a r equirement of bitstream conformance that point_y_value[ i ] is greater than point_y_value[ i - 1 ] (this ensures the x coordinates are specified in increasing order). |
|
update_grain |
r/w |
equal to 1 means that a new set of parameters should be sent. update_grain equal to 0 means that the previous set of parameters should be used. |
Methods¶
None
Details¶
- class GstCodecParsers.AV1FilmGrainParams¶