GstCodecParsers.AV1FilmGrainParams

Fields

Name

Type

Access

Description

apply_grain

bool

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

int

r/w

specifies the number of auto-regressive coefficients for luma and chroma.

ar_coeff_shift_minus_6

int

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

bytes

r/w

specifies auto-regressive coefficients used for the U plane.

ar_coeffs_cr_plus_128

bytes

r/w

specifies auto-regressive coefficients used for the V plane.

ar_coeffs_y_plus_128

bytes

r/w

specifies auto-regressive coefficients used for the Y plane.

cb_luma_mult

int

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

int

r/w

represents a multiplier for the cb component used in derivation of the input index to the cb component scaling function.

cb_offset

int

r/w

represents an offset used in derivation of the input index to the cb component scaling function.

chroma_scaling_from_luma

int

r/w

specifies that the chroma scaling is inferred from the luma scaling.

clip_to_restricted_range

bool

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

int

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

int

r/w

represents a multiplier for the cr component used in derivation of the input index to the cr component scaling function.

cr_offset

int

r/w

represents an offset used in derivation of the input index to the cr component scaling function.

film_grain_params_ref_idx

int

r/w

indicates which reference frame contains the film grain parameters to be used for this frame.

grain_scale_shift

int

r/w

specifies how much the Gaussian random numbers should be scaled down during the grain synthesis process.

grain_scaling_minus_8

int

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

int

r/w

specifies the starting value for the pseudo-random numbers used during film grain synthesis.

num_cb_points

int

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

int

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

int

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

bool

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

bytes

r/w

represents the scaling (output) value for the i-th point of the piecewise linear scaling function for cb component.

point_cb_value

bytes

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

bytes

r/w

represents the scaling (output) value for the i-th point of the piecewise linear scaling function for cr component.

point_cr_value

bytes

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

bytes

r/w

represents the scaling (output) value for the i-th point of the piecewise linear scaling function for luma component.

point_y_value

bytes

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

bool

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