Go to the documentation of this file.
26 #include "config_components.h"
45 #define IS_H264(codec_id) (CONFIG_H264_SEI && CONFIG_HEVC_SEI ? codec_id == AV_CODEC_ID_H264 : CONFIG_H264_SEI)
46 #define IS_HEVC(codec_id) (CONFIG_H264_SEI && CONFIG_HEVC_SEI ? codec_id == AV_CODEC_ID_HEVC : CONFIG_HEVC_SEI)
109 flag = !!(bytestream2_get_byteu(gb) & 0x40);
114 h->active_format_description = bytestream2_get_byteu(gb) & 0xF;
131 int country_code, provider_code;
136 country_code = bytestream2_get_byteu(gb);
137 if (country_code == 0xFF) {
147 "Unsupported User Data Registered ITU-T T35 SEI message (country_code = %d)\n",
153 provider_code = bytestream2_get_be16u(gb);
155 switch (provider_code) {
157 uint32_t user_identifier;
162 user_identifier = bytestream2_get_be32u(gb);
163 switch (user_identifier) {
164 case MKBETAG(
'D',
'T',
'G',
'1'):
166 case MKBETAG(
'G',
'A',
'9',
'4'):
170 "Unsupported User Data Registered ITU-T T35 SEI message (atsc user_identifier = 0x%04x)\n",
178 const uint16_t cuva_provider_oriented_code = 0x0005;
179 uint16_t provider_oriented_code;
182 goto unsupported_provider_code;
187 provider_oriented_code = bytestream2_get_be16u(gb);
188 if (provider_oriented_code == cuva_provider_oriented_code) {
189 return decode_registered_user_data_dynamic_hdr_vivid(&
h->dynamic_hdr_vivid, gb);
195 const uint16_t smpte2094_40_provider_oriented_code = 0x0001;
196 const uint8_t smpte2094_40_application_identifier = 0x04;
197 uint16_t provider_oriented_code;
198 uint8_t application_identifier;
201 goto unsupported_provider_code;
206 provider_oriented_code = bytestream2_get_be16u(gb);
207 application_identifier = bytestream2_get_byteu(gb);
208 if (provider_oriented_code == smpte2094_40_provider_oriented_code &&
209 application_identifier == smpte2094_40_application_identifier) {
210 return decode_registered_user_data_dynamic_hdr_plus(&
h->dynamic_hdr_plus, gb);
215 const uint16_t aom_grain_provider_oriented_code = 0x0001;
216 uint16_t provider_oriented_code;
219 goto unsupported_provider_code;
224 provider_oriented_code = bytestream2_get_byteu(gb);
225 if (provider_oriented_code == aom_grain_provider_oriented_code) {
232 unsupported_provider_code:
236 "Unsupported User Data Registered ITU-T T35 SEI message (provider_code = %d)\n",
252 if (size < 16 || size >= INT_MAX - 1)
268 h->buf_ref[
h->nb_buf_ref++] = buf_ref;
272 e = sscanf(
user_data + 16,
"x264 - core %d", &build);
273 if (e == 1 && build > 0)
274 h->x264_build = build;
275 if (e == 1 && build == 1 && !strncmp(
user_data+16,
"x264 - core 0000", 16))
291 h->anticlockwise_rotation =
get_bits(gb, 16);
306 h->present = !
h->arrangement_cancel_flag;
311 h->content_interpretation_type =
get_bits(gb, 6);
315 h->current_frame_is_frame0_flag =
get_bits1(gb);
319 if (!
h->quincunx_sampling_flag &&
h->arrangement_type != 5)
341 s->preferred_transfer_characteristics = bytestream2_get_byteu(gb);
349 static const uint16_t max_ambient_light_value = 50000;
354 s->ambient_illuminance = bytestream2_get_be32u(gb);
355 if (!
s->ambient_illuminance)
358 s->ambient_light_x = bytestream2_get_be16u(gb);
359 if (
s->ambient_light_x > max_ambient_light_value)
362 s->ambient_light_y = bytestream2_get_be16u(gb);
363 if (
s->ambient_light_y > max_ambient_light_value)
377 memset(
h, 0,
sizeof(*
h));
379 h->separate_colour_description_present_flag =
get_bits1(gb);
380 if (
h->separate_colour_description_present_flag) {
382 h->bit_depth_chroma =
get_bits(gb, 3) + 8;
385 h->transfer_characteristics =
get_bits(gb, 8);
390 for (
int c = 0;
c < 3;
c++)
392 for (
int c = 0;
c < 3;
c++) {
393 if (
h->comp_model_present_flag[
c]) {
394 h->num_intensity_intervals[
c] =
get_bits(gb, 8) + 1;
396 if (
h->num_model_values[
c] > 6)
398 for (
int i = 0;
i <
h->num_intensity_intervals[
c];
i++) {
399 h->intensity_interval_lower_bound[
c][
i] =
get_bits(gb, 8);
400 h->intensity_interval_upper_bound[
c][
i] =
get_bits(gb, 8);
401 for (
int j = 0; j <
h->num_model_values[
c]; j++)
426 for (
i = 0;
i < 3;
i++) {
427 s->display_primaries[
i][0] = bytestream2_get_be16u(gb);
428 s->display_primaries[
i][1] = bytestream2_get_be16u(gb);
431 s->white_point[0] = bytestream2_get_be16u(gb);
432 s->white_point[1] = bytestream2_get_be16u(gb);
435 s->max_luminance = bytestream2_get_be32u(gb);
436 s->min_luminance = bytestream2_get_be32u(gb);
453 s->max_content_light_level = bytestream2_get_be16u(gb);
454 s->max_pic_average_light_level = bytestream2_get_be16u(gb);
496 src->a53_caption.buf_ref);
504 if (
src->unregistered.nb_buf_ref) {
506 src->unregistered.nb_buf_ref,
511 for (
unsigned i = 0;
i <
src->unregistered.nb_buf_ref;
i++) {
535 unsigned bit_depth_luma,
unsigned bit_depth_chroma,
543 fp->content_interpretation_type > 0 &&
544 fp->content_interpretation_type < 3) {
550 switch (
fp->arrangement_type) {
563 if (
fp->quincunx_sampling_flag)
581 if (
fp->content_interpretation_type == 2)
585 if (
fp->current_frame_is_frame0_flag)
592 if (
sei->display_orientation.present &&
593 (
sei->display_orientation.anticlockwise_rotation ||
594 sei->display_orientation.hflip ||
595 sei->display_orientation.vflip)) {
612 angle = -angle * (1 - 2 * !!o->
hflip) * (1 - 2 * !!o->
vflip);
618 if (
sei->a53_caption.buf_ref) {
627 for (
unsigned i = 0;
i <
sei->unregistered.nb_buf_ref;
i++) {
639 sei->unregistered.nb_buf_ref = 0;
641 if (
sei->afd.present) {
646 *sd->
data =
sei->afd.active_format_description;
647 sei->afd.present = 0;
651 if (
sei->film_grain_characteristics.present) {
691 #if FF_API_H274_FILM_GRAIN_VCS
729 if (
sei->ambient_viewing_environment.present) {
731 &
sei->ambient_viewing_environment;
743 if (
sei->mastering_display.present) {
745 const int mapping[3] = {2, 0, 1};
746 const int chroma_den = 50000;
747 const int luma_den = 10000;
756 for (
i = 0;
i < 3;
i++) {
757 const int j = mapping[
i];
777 "r(%5.4f,%5.4f) g(%5.4f,%5.4f) b(%5.4f %5.4f) wp(%5.4f, %5.4f)\n",
786 "min_luminance=%f, max_luminance=%f\n",
791 if (
sei->content_light.present) {
799 metadata->
MaxCLL =
sei->content_light.max_content_light_level;
800 metadata->
MaxFALL =
sei->content_light.max_pic_average_light_level;
815 for (
unsigned i = 0;
i <
s->unregistered.nb_buf_ref;
i++)
817 s->unregistered.nb_buf_ref = 0;
822 s->ambient_viewing_environment.present = 0;
823 s->mastering_display.present = 0;
824 s->content_light.present = 0;
825 s->aom_film_grain.enable = 0;
#define FF_ENABLE_DEPRECATION_WARNINGS
static int decode_film_grain_characteristics(H2645SEIFilmGrainCharacteristics *h, enum AVCodecID codec_id, GetBitContext *gb)
@ AV_STEREO3D_VIEW_LEFT
Frame contains only the left view.
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
@ AV_STEREO3D_SIDEBYSIDE_QUINCUNX
Views are next to each other, but when upscaling apply a checkerboard pattern.
@ SEI_FPA_H264_TYPE_CHECKERBOARD
@ SEI_FPA_TYPE_INTERLEAVE_TEMPORAL
int bit_depth_luma
Intended bit depth, or 0 for unknown/unspecified.
AVFrameSideData * av_frame_new_side_data(AVFrame *frame, enum AVFrameSideDataType type, size_t size)
Add a new side data to a frame.
attribute_deprecated enum AVColorRange color_range
Specifies the video signal characteristics.
Ambient viewing environment metadata as defined by H.274.
static int get_se_golomb_long(GetBitContext *gb)
uint8_t * data
The data buffer.
@ AV_FRAME_DATA_A53_CC
ATSC A53 Part 4 Closed Captions.
int ff_h2645_sei_to_frame(AVFrame *frame, H2645SEI *sei, enum AVCodecID codec_id, AVCodecContext *avctx, const H2645VUI *vui, unsigned bit_depth_luma, unsigned bit_depth_chroma, int seed)
static av_always_inline void bytestream2_skipu(GetByteContext *g, unsigned int size)
enum AVColorSpace matrix_coeffs
int blending_mode_id
Specifies the blending mode used to blend the simulated film grain with the decoded images.
unsigned MaxCLL
Max content light level (cd/m^2).
This structure describes decoded (raw) audio or video data.
#define IS_H264(codec_id)
void av_display_matrix_flip(int32_t matrix[9], int hflip, int vflip)
Flip the input matrix horizontally and/or vertically.
AVRational ambient_light_x
Normalized x chromaticity coordinate of the environmental ambient light in the nominal viewing enviro...
enum AVColorSpace color_space
#define AV_LOG_VERBOSE
Detailed information.
void av_display_rotation_set(int32_t matrix[9], double angle)
Initialize a transformation matrix describing a pure clockwise rotation by the specified angle (in de...
@ AV_FRAME_DATA_DISPLAYMATRIX
This side data contains a 3x3 transformation matrix describing an affine transformation that needs to...
@ SEI_FPA_TYPE_TOP_BOTTOM
enum AVColorPrimaries colour_primaries
AVBufferRef * av_buffer_ref(const AVBufferRef *buf)
Create a new reference to an AVBuffer.
@ AV_STEREO3D_VIEW_RIGHT
Frame contains only the right view.
enum AVColorTransferCharacteristic color_trc
int video_full_range_flag
uint64_t seed
Seed to use for the synthesis process, if the codec allows for it.
int video_signal_type_present_flag
int ff_h2645_sei_message_decode(H2645SEI *h, enum SEIType type, enum AVCodecID codec_id, GetBitContext *gb, GetByteContext *gbyte, void *logctx)
Decode a single SEI message.
Content light level needed by to transmit HDR over HDMI (CTA-861.3).
static void skip_bits(GetBitContext *s, int n)
@ AV_STEREO3D_SIDEBYSIDE
Views are next to each other.
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
@ SEI_FPA_H264_TYPE_INTERLEAVE_COLUMN
#define ITU_T_T35_COUNTRY_CODE_CN
H2645SEIA53Caption a53_caption
@ AV_STEREO3D_2D
Video is not stereoscopic (and metadata has to be there).
uint8_t intensity_interval_upper_bound[3][256]
attribute_deprecated int bit_depth_chroma
Specifies the bit depth used for the chroma components.
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
@ SEI_TYPE_AMBIENT_VIEWING_ENVIRONMENT
AVRational ambient_illuminance
Environmental illuminance of the ambient viewing environment in lux.
#define ITU_T_T35_PROVIDER_CODE_ATSC
uint8_t intensity_interval_upper_bound[3][256]
Specifies the upper bound of each intensity interval for which the set of model values applies for th...
static int is_frame_packing_type_valid(SEIFpaType type, enum AVCodecID codec_id)
@ AV_STEREO3D_FRAMESEQUENCE
Views are alternated temporally.
uint8_t intensity_interval_lower_bound[3][256]
int width
Intended display resolution.
int anticlockwise_rotation
@ AV_STEREO3D_LINES
Views are packed per line, as if interlaced.
@ SEI_TYPE_FRAME_PACKING_ARRANGEMENT
void * av_realloc_array(void *ptr, size_t nmemb, size_t size)
@ SEI_FPA_H264_TYPE_INTERLEAVE_ROW
static int decode_registered_user_data_closed_caption(H2645SEIA53Caption *h, GetByteContext *gb)
static double av_q2d(AVRational a)
Convert an AVRational to a double.
static int decode_nal_sei_content_light_info(H2645SEIContentLight *s, GetByteContext *gb)
AVFilmGrainParams * av_film_grain_params_create_side_data(AVFrame *frame)
Allocate a complete AVFilmGrainParams and add it to the frame.
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
@ SEI_TYPE_USER_DATA_REGISTERED_ITU_T_T35
static int decode_unregistered_user_data(H2645SEIUnregistered *h, GetByteContext *gb, enum AVCodecID codec_id)
int16_t comp_model_value[3][256][6]
Specifies the model values for the component for each intensity interval.
int ff_decode_mastering_display_new(const AVCodecContext *avctx, AVFrame *frame, AVMasteringDisplayMetadata **mdm)
Wrapper around av_mastering_display_metadata_create_side_data(), which rejects side data overridden b...
#define FF_CODEC_PROPERTY_FILM_GRAIN
int flags
Additional information about the frame packing.
int model_id
Specifies the film grain simulation mode.
int ff_parse_a53_cc(AVBufferRef **pbuf, const uint8_t *data, int size)
Parse a data array for ATSC A53 Part 4 Closed Captions and store them in an AVBufferRef.
static int decode_registered_user_data(H2645SEI *h, GetByteContext *gb, enum AVCodecID codec_id, void *logctx)
int colour_description_present_flag
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it.
static int decode_frame_packing_arrangement(H2645SEIFramePacking *h, GetBitContext *gb, enum AVCodecID codec_id)
int comp_model_present_flag[3]
attribute_deprecated enum AVColorTransferCharacteristic color_trc
static unsigned int get_bits1(GetBitContext *s)
This struct represents dynamic metadata for color volume transform - CUVA 005.1:2021 standard.
AVFrameSideData * av_frame_new_side_data_from_buf(AVFrame *frame, enum AVFrameSideDataType type, AVBufferRef *buf)
Add a new side data to a frame from an existing AVBufferRef.
uint16_t num_intensity_intervals[3]
int subsampling_x
Intended subsampling ratio, or 0 for luma-only streams.
@ AV_FRAME_DATA_AFD
Active Format Description data consisting of a single byte as specified in ETSI TS 101 154 using AVAc...
static int FUNC() sei(CodedBitstreamContext *ctx, RWContext *rw, H264RawSEI *current)
#define IS_HEVC(codec_id)
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
int ff_aom_attach_film_grain_sets(const AVFilmGrainAFGS1Params *s, AVFrame *frame)
@ AV_FRAME_DATA_SEI_UNREGISTERED
User data unregistered metadata associated with a video frame.
static int decode_alternative_transfer(H2645SEIAlternativeTransfer *s, GetByteContext *gb)
AVBufferRef * av_buffer_create(uint8_t *data, size_t size, void(*free)(void *opaque, uint8_t *data), void *opaque, int flags)
Create an AVBuffer from an existing array.
static av_always_inline int bytestream2_get_bytes_left(GetByteContext *g)
AVCodecID
Identify the syntax and semantics of the bitstream.
uint8_t num_model_values[3]
@ AV_STEREO3D_CHECKERBOARD
Views are packed in a checkerboard-like structure per pixel.
enum AVColorTransferCharacteristic transfer_characteristics
attribute_deprecated enum AVColorPrimaries color_primaries
int component_model_present[3]
Indicates if the modelling of film grain for a given component is present.
static AVRational av_make_q(int num, int den)
Create an AVRational.
#define MKBETAG(a, b, c, d)
This structure describes how to handle film grain synthesis in video for specific codecs.
static int FUNC() user_data(CodedBitstreamContext *ctx, RWContext *rw, MPEG2RawUserData *current)
union AVFilmGrainParams::@357 codec
Additional fields may be added both here and in any structure included.
static int decode_nal_sei_mastering_display_info(H2645SEIMasteringDisplay *s, GetByteContext *gb)
int av_reallocp_array(void *ptr, size_t nmemb, size_t size)
Allocate, reallocate an array through a pointer to a pointer.
@ SEI_TYPE_MASTERING_DISPLAY_COLOUR_VOLUME
@ FF_H2645_SEI_MESSAGE_UNHANDLED
@ SEI_FPA_TYPE_SIDE_BY_SIDE
void ff_h2645_sei_reset(H2645SEI *s)
@ SEI_TYPE_ALTERNATIVE_TRANSFER_CHARACTERISTICS
static void skip_bits1(GetBitContext *s)
AVBufferRef * av_buffer_alloc(size_t size)
Allocate an AVBuffer of the given size using av_malloc().
AVFilmGrainH274Params h274
static int decode_registered_user_data_afd(H2645SEIAFD *h, GetByteContext *gb)
int ff_aom_parse_film_grain_sets(AVFilmGrainAFGS1Params *s, const uint8_t *payload, int payload_size)
#define AV_STEREO3D_FLAG_INVERT
Inverted views, Right/Bottom represents the left view.
int ff_parse_itu_t_t35_to_dynamic_hdr_vivid(AVDynamicHDRVivid *s, const uint8_t *data, int size)
Parse the user data registered ITU-T T.35 to AVbuffer (AVDynamicHDRVivid).
size_t size
Size of data in bytes.
int transfer_characteristics
enum AVColorPrimaries color_primaries
#define i(width, name, range_min, range_max)
unsigned properties
Properties of the stream that gets decoded.
AVAmbientViewingEnvironment * av_ambient_viewing_environment_create_side_data(AVFrame *frame)
Allocate and add an AVAmbientViewingEnvironment structure to an existing AVFrame as side data.
This structure describes how to handle film grain synthesis for codecs using the ITU-T H....
uint16_t num_intensity_intervals[3]
Specifies the number of intensity intervals for which a specific set of model values has been estimat...
@ AV_STEREO3D_TOPBOTTOM
Views are on top of each other.
@ SEI_TYPE_DISPLAY_ORIENTATION
int av_buffer_replace(AVBufferRef **pdst, const AVBufferRef *src)
Ensure dst refers to the same data as src.
uint8_t intensity_interval_lower_bound[3][256]
Specifies the lower ounds of each intensity interval for whichthe set of model values applies for the...
int separate_colour_description_present_flag
This struct represents dynamic metadata for color volume transform - application 4 of SMPTE 2094-40:2...
@ AV_STEREO3D_COLUMNS
Views are packed per column.
enum AVStereo3DType type
How views are packed within the video.
int ff_decode_content_light_new(const AVCodecContext *avctx, AVFrame *frame, AVContentLightMetadata **clm)
Wrapper around av_content_light_metadata_create_side_data(), which rejects side data overridden by th...
SEIFpaType
frame_packing_arrangement types.
H2645SEIUnregistered unregistered
main external API structure.
attribute_deprecated enum AVColorSpace color_space
@ AV_FILM_GRAIN_PARAMS_H274
The union is valid when interpreted as AVFilmGrainH274Params (codec.h274)
@ SEI_TYPE_USER_DATA_UNREGISTERED
static int decode_ambient_viewing_environment(H2645SEIAmbientViewingEnvironment *s, GetByteContext *gb)
int log2_scale_factor
Specifies a scale factor used in the film grain characterization equations.
attribute_deprecated int bit_depth_luma
TODO: On this ABI bump, please also re-order the fields in AVFilmGrainParams (see below)
#define FF_CODEC_PROPERTY_CLOSED_CAPTIONS
uint32_t ambient_illuminance
uint8_t num_model_values[3]
Specifies the number of model values present for each intensity interval in which the film grain has ...
enum AVColorRange color_range
Intended video signal characteristics.
#define FF_DISABLE_DEPRECATION_WARNINGS
#define ITU_T_T35_PROVIDER_CODE_CUVA
A reference to a data buffer.
static av_always_inline unsigned int bytestream2_get_bufferu(GetByteContext *g, uint8_t *dst, unsigned int size)
static unsigned get_ue_golomb_long(GetBitContext *gb)
Read an unsigned Exp-Golomb code in the range 0 to UINT32_MAX-1.
#define ITU_T_T35_COUNTRY_CODE_US
int ff_h2645_sei_ctx_replace(H2645SEI *dst, const H2645SEI *src)
AVStereo3D * av_stereo3d_create_side_data(AVFrame *frame)
Allocate a complete AVFrameSideData and add it to the frame.
Structure to hold side data for an AVFrame.
enum AVStereo3DView view
Determines which views are packed.
#define ITU_T_T35_PROVIDER_CODE_SMTPE
unsigned MaxFALL
Max average light level per frame (cd/m^2).
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
@ SEI_TYPE_CONTENT_LIGHT_LEVEL_INFO
Stereo 3D type: this structure describes how two videos are packed within a single video surface,...
AVRational ambient_light_y
Normalized y chromaticity coordinate of the environmental ambient light in the nominal viewing enviro...
int16_t comp_model_value[3][256][6]
@ SEI_TYPE_FILM_GRAIN_CHARACTERISTICS
enum AVFilmGrainParamsType type
Specifies the codec for which this structure is valid.
static int decode_display_orientation(H2645SEIDisplayOrientation *h, GetBitContext *gb)