323 lines
10 KiB
C
323 lines
10 KiB
C
/*
|
|
* This file is part of FFmpeg.
|
|
*
|
|
* FFmpeg is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* FFmpeg is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with FFmpeg; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef AVUTIL_FILM_GRAIN_PARAMS_H
|
|
#define AVUTIL_FILM_GRAIN_PARAMS_H
|
|
|
|
#include "frame.h"
|
|
|
|
enum AVFilmGrainParamsType {
|
|
AV_FILM_GRAIN_PARAMS_NONE = 0,
|
|
|
|
/**
|
|
* The union is valid when interpreted as AVFilmGrainAOMParams (codec.aom)
|
|
*/
|
|
AV_FILM_GRAIN_PARAMS_AV1,
|
|
|
|
/**
|
|
* The union is valid when interpreted as AVFilmGrainH274Params (codec.h274)
|
|
*/
|
|
AV_FILM_GRAIN_PARAMS_H274,
|
|
};
|
|
|
|
/**
|
|
* This structure describes how to handle film grain synthesis for AOM codecs.
|
|
*
|
|
* @note The struct must be allocated as part of AVFilmGrainParams using
|
|
* av_film_grain_params_alloc(). Its size is not a part of the public ABI.
|
|
*/
|
|
typedef struct AVFilmGrainAOMParams {
|
|
/**
|
|
* Number of points, and the scale and value for each point of the
|
|
* piecewise linear scaling function for the uma plane.
|
|
*/
|
|
int num_y_points;
|
|
uint8_t y_points[14][2 /* value, scaling */];
|
|
|
|
/**
|
|
* Signals whether to derive the chroma scaling function from the luma.
|
|
* Not equivalent to copying the luma values and scales.
|
|
*/
|
|
int chroma_scaling_from_luma;
|
|
|
|
/**
|
|
* If chroma_scaling_from_luma is set to 0, signals the chroma scaling
|
|
* function parameters.
|
|
*/
|
|
int num_uv_points[2 /* cb, cr */];
|
|
uint8_t uv_points[2 /* cb, cr */][10][2 /* value, scaling */];
|
|
|
|
/**
|
|
* Specifies the shift applied to the chroma components. For AV1, its within
|
|
* [8; 11] and determines the range and quantization of the film grain.
|
|
*/
|
|
int scaling_shift;
|
|
|
|
/**
|
|
* Specifies the auto-regression lag.
|
|
*/
|
|
int ar_coeff_lag;
|
|
|
|
/**
|
|
* Luma auto-regression coefficients. The number of coefficients is given by
|
|
* 2 * ar_coeff_lag * (ar_coeff_lag + 1).
|
|
*/
|
|
int8_t ar_coeffs_y[24];
|
|
|
|
/**
|
|
* Chroma auto-regression coefficients. The number of coefficients is given by
|
|
* 2 * ar_coeff_lag * (ar_coeff_lag + 1) + !!num_y_points.
|
|
*/
|
|
int8_t ar_coeffs_uv[2 /* cb, cr */][25];
|
|
|
|
/**
|
|
* Specifies the range of the auto-regressive coefficients. Values of 6,
|
|
* 7, 8 and so on represent a range of [-2, 2), [-1, 1), [-0.5, 0.5) and
|
|
* so on. For AV1 must be between 6 and 9.
|
|
*/
|
|
int ar_coeff_shift;
|
|
|
|
/**
|
|
* Signals the down shift applied to the generated gaussian numbers during
|
|
* synthesis.
|
|
*/
|
|
int grain_scale_shift;
|
|
|
|
/**
|
|
* Specifies the luma/chroma multipliers for the index to the component
|
|
* scaling function.
|
|
*/
|
|
int uv_mult[2 /* cb, cr */];
|
|
int uv_mult_luma[2 /* cb, cr */];
|
|
|
|
/**
|
|
* Offset used for component scaling function. For AV1 its a 9-bit value
|
|
* with a range [-256, 255]
|
|
*/
|
|
int uv_offset[2 /* cb, cr */];
|
|
|
|
/**
|
|
* Signals whether to overlap film grain blocks.
|
|
*/
|
|
int overlap_flag;
|
|
|
|
/**
|
|
* Signals to clip to limited color levels after film grain application.
|
|
*/
|
|
int limit_output_range;
|
|
} AVFilmGrainAOMParams;
|
|
|
|
/**
|
|
* This structure describes how to handle film grain synthesis for codecs using
|
|
* the ITU-T H.274 Versatile suplemental enhancement information message.
|
|
*
|
|
* @note The struct must be allocated as part of AVFilmGrainParams using
|
|
* av_film_grain_params_alloc(). Its size is not a part of the public ABI.
|
|
*/
|
|
typedef struct AVFilmGrainH274Params {
|
|
/**
|
|
* Specifies the film grain simulation mode.
|
|
* 0 = Frequency filtering, 1 = Auto-regression
|
|
*/
|
|
int model_id;
|
|
|
|
#if FF_API_H274_FILM_GRAIN_VCS
|
|
/**
|
|
* TODO: On this ABI bump, please also re-order the fields in
|
|
* AVFilmGrainParams (see below)
|
|
*/
|
|
|
|
/**
|
|
* Specifies the bit depth used for the luma component.
|
|
*
|
|
* @deprecated use AVFilmGrainParams.bit_depth_luma.
|
|
*/
|
|
attribute_deprecated
|
|
int bit_depth_luma;
|
|
|
|
/**
|
|
* Specifies the bit depth used for the chroma components.
|
|
*
|
|
* @deprecated use AVFilmGrainParams.bit_depth_chroma.
|
|
*/
|
|
attribute_deprecated
|
|
int bit_depth_chroma;
|
|
|
|
/**
|
|
* Specifies the video signal characteristics.
|
|
*
|
|
* @deprecated use AVFilmGrainParams.color_{range,primaries,trc,space}.
|
|
*/
|
|
attribute_deprecated
|
|
enum AVColorRange color_range;
|
|
attribute_deprecated
|
|
enum AVColorPrimaries color_primaries;
|
|
attribute_deprecated
|
|
enum AVColorTransferCharacteristic color_trc;
|
|
attribute_deprecated
|
|
enum AVColorSpace color_space;
|
|
#endif
|
|
|
|
/**
|
|
* Specifies the blending mode used to blend the simulated film grain
|
|
* with the decoded images.
|
|
*
|
|
* 0 = Additive, 1 = Multiplicative
|
|
*/
|
|
int blending_mode_id;
|
|
|
|
/**
|
|
* Specifies a scale factor used in the film grain characterization equations.
|
|
*/
|
|
int log2_scale_factor;
|
|
|
|
/**
|
|
* Indicates if the modelling of film grain for a given component is present.
|
|
*/
|
|
int component_model_present[3 /* y, cb, cr */];
|
|
|
|
/**
|
|
* Specifies the number of intensity intervals for which a specific set of
|
|
* model values has been estimated, with a range of [1, 256].
|
|
*/
|
|
uint16_t num_intensity_intervals[3 /* y, cb, cr */];
|
|
|
|
/**
|
|
* Specifies the number of model values present for each intensity interval
|
|
* in which the film grain has been modelled, with a range of [1, 6].
|
|
*/
|
|
uint8_t num_model_values[3 /* y, cb, cr */];
|
|
|
|
/**
|
|
* Specifies the lower ounds of each intensity interval for whichthe set of
|
|
* model values applies for the component.
|
|
*/
|
|
uint8_t intensity_interval_lower_bound[3 /* y, cb, cr */][256 /* intensity interval */];
|
|
|
|
/**
|
|
* Specifies the upper bound of each intensity interval for which the set of
|
|
* model values applies for the component.
|
|
*/
|
|
uint8_t intensity_interval_upper_bound[3 /* y, cb, cr */][256 /* intensity interval */];
|
|
|
|
/**
|
|
* Specifies the model values for the component for each intensity interval.
|
|
* - When model_id == 0, the following applies:
|
|
* For comp_model_value[y], the range of values is [0, 2^bit_depth_luma - 1]
|
|
* For comp_model_value[cb..cr], the range of values is [0, 2^bit_depth_chroma - 1]
|
|
* - Otherwise, the following applies:
|
|
* For comp_model_value[y], the range of values is [-2^(bit_depth_luma - 1), 2^(bit_depth_luma - 1) - 1]
|
|
* For comp_model_value[cb..cr], the range of values is [-2^(bit_depth_chroma - 1), 2^(bit_depth_chroma - 1) - 1]
|
|
*/
|
|
int16_t comp_model_value[3 /* y, cb, cr */][256 /* intensity interval */][6 /* model value */];
|
|
} AVFilmGrainH274Params;
|
|
|
|
/**
|
|
* This structure describes how to handle film grain synthesis in video
|
|
* for specific codecs. Must be present on every frame where film grain is
|
|
* meant to be synthesised for correct presentation.
|
|
*
|
|
* @note The struct must be allocated with av_film_grain_params_alloc() and
|
|
* its size is not a part of the public ABI.
|
|
*/
|
|
typedef struct AVFilmGrainParams {
|
|
/**
|
|
* Specifies the codec for which this structure is valid.
|
|
*/
|
|
enum AVFilmGrainParamsType type;
|
|
|
|
/**
|
|
* Seed to use for the synthesis process, if the codec allows for it.
|
|
*
|
|
* @note For H.264, this refers to `pic_offset` as defined in
|
|
* SMPTE RDD 5-2006.
|
|
*/
|
|
uint64_t seed;
|
|
|
|
/**
|
|
* Additional fields may be added both here and in any structure included.
|
|
* If a codec's film grain structure differs slightly over another
|
|
* codec's, fields within may change meaning depending on the type.
|
|
*
|
|
* TODO: Move this to the end of the structure, at the next ABI bump.
|
|
*/
|
|
union {
|
|
AVFilmGrainAOMParams aom;
|
|
AVFilmGrainH274Params h274;
|
|
} codec;
|
|
|
|
/**
|
|
* Intended display resolution. May be 0 if the codec does not specify
|
|
* any restrictions.
|
|
*/
|
|
|
|
int width, height;
|
|
|
|
/**
|
|
* Intended subsampling ratio, or 0 for luma-only streams.
|
|
*/
|
|
int subsampling_x, subsampling_y;
|
|
|
|
/**
|
|
* Intended video signal characteristics.
|
|
*/
|
|
enum AVColorRange color_range;
|
|
enum AVColorPrimaries color_primaries;
|
|
enum AVColorTransferCharacteristic color_trc;
|
|
enum AVColorSpace color_space;
|
|
|
|
/**
|
|
* Intended bit depth, or 0 for unknown/unspecified.
|
|
*/
|
|
int bit_depth_luma;
|
|
int bit_depth_chroma;
|
|
|
|
} AVFilmGrainParams;
|
|
|
|
/**
|
|
* Allocate an AVFilmGrainParams structure and set its fields to
|
|
* default values. The resulting struct can be freed using av_freep().
|
|
* If size is not NULL it will be set to the number of bytes allocated.
|
|
*
|
|
* @return An AVFilmGrainParams filled with default values or NULL
|
|
* on failure.
|
|
*/
|
|
AVFilmGrainParams *av_film_grain_params_alloc(size_t *size);
|
|
|
|
/**
|
|
* Allocate a complete AVFilmGrainParams and add it to the frame.
|
|
*
|
|
* @param frame The frame which side data is added to.
|
|
*
|
|
* @return The AVFilmGrainParams structure to be filled by caller.
|
|
*/
|
|
AVFilmGrainParams *av_film_grain_params_create_side_data(AVFrame *frame);
|
|
|
|
/**
|
|
* Select the most appropriate film grain parameters set for the frame,
|
|
* taking into account the frame's format, resolution and video signal
|
|
* characteristics.
|
|
*
|
|
* @note, for H.274, this may select a film grain parameter set with
|
|
* greater chroma resolution than the frame. Users should take care to
|
|
* correctly adjust the chroma grain frequency to the frame.
|
|
*/
|
|
const AVFilmGrainParams *av_film_grain_params_select(const AVFrame *frame);
|
|
|
|
#endif /* AVUTIL_FILM_GRAIN_PARAMS_H */
|