Go to the documentation of this file.
26 #include "config_components.h"
43 #define IS_H264(codec_id) (CONFIG_H264_SEI && CONFIG_HEVC_SEI ? codec_id == AV_CODEC_ID_H264 : CONFIG_H264_SEI)
44 #define IS_HEVC(codec_id) (CONFIG_H264_SEI && CONFIG_HEVC_SEI ? codec_id == AV_CODEC_ID_HEVC : CONFIG_HEVC_SEI)
107 flag = !!(bytestream2_get_byteu(gb) & 0x40);
112 h->active_format_description = bytestream2_get_byteu(gb) & 0xF;
129 int country_code, provider_code;
134 country_code = bytestream2_get_byteu(gb);
135 if (country_code == 0xFF) {
142 if (country_code != 0xB5 && country_code != 0x26) {
144 "Unsupported User Data Registered ITU-T T35 SEI message (country_code = %d)\n",
150 provider_code = bytestream2_get_be16u(gb);
152 switch (provider_code) {
154 uint32_t user_identifier;
159 user_identifier = bytestream2_get_be32u(gb);
160 switch (user_identifier) {
161 case MKBETAG(
'D',
'T',
'G',
'1'):
163 case MKBETAG(
'G',
'A',
'9',
'4'):
167 "Unsupported User Data Registered ITU-T T35 SEI message (atsc user_identifier = 0x%04x)\n",
175 const uint16_t cuva_provider_oriented_code = 0x0005;
176 uint16_t provider_oriented_code;
179 goto unsupported_provider_code;
184 provider_oriented_code = bytestream2_get_be16u(gb);
185 if (provider_oriented_code == cuva_provider_oriented_code) {
186 return decode_registered_user_data_dynamic_hdr_vivid(&
h->dynamic_hdr_vivid, gb);
192 const uint16_t smpte2094_40_provider_oriented_code = 0x0001;
193 const uint8_t smpte2094_40_application_identifier = 0x04;
194 uint16_t provider_oriented_code;
195 uint8_t application_identifier;
198 goto unsupported_provider_code;
203 provider_oriented_code = bytestream2_get_be16u(gb);
204 application_identifier = bytestream2_get_byteu(gb);
205 if (provider_oriented_code == smpte2094_40_provider_oriented_code &&
206 application_identifier == smpte2094_40_application_identifier) {
207 return decode_registered_user_data_dynamic_hdr_plus(&
h->dynamic_hdr_plus, gb);
211 unsupported_provider_code:
215 "Unsupported User Data Registered ITU-T T35 SEI message (provider_code = %d)\n",
231 if (size < 16 || size >= INT_MAX - 1)
247 h->buf_ref[
h->nb_buf_ref++] = buf_ref;
251 e = sscanf(
user_data + 16,
"x264 - core %d", &build);
252 if (e == 1 && build > 0)
253 h->x264_build = build;
254 if (e == 1 && build == 1 && !strncmp(
user_data+16,
"x264 - core 0000", 16))
270 h->anticlockwise_rotation =
get_bits(gb, 16);
285 h->present = !
h->arrangement_cancel_flag;
290 h->content_interpretation_type =
get_bits(gb, 6);
294 h->current_frame_is_frame0_flag =
get_bits1(gb);
298 if (!
h->quincunx_sampling_flag &&
h->arrangement_type != 5)
320 s->preferred_transfer_characteristics = bytestream2_get_byteu(gb);
328 static const uint16_t max_ambient_light_value = 50000;
333 s->ambient_illuminance = bytestream2_get_be32u(gb);
334 if (!
s->ambient_illuminance)
337 s->ambient_light_x = bytestream2_get_be16u(gb);
338 if (
s->ambient_light_x > max_ambient_light_value)
341 s->ambient_light_y = bytestream2_get_be16u(gb);
342 if (
s->ambient_light_y > max_ambient_light_value)
356 memset(
h, 0,
sizeof(*
h));
358 h->separate_colour_description_present_flag =
get_bits1(gb);
359 if (
h->separate_colour_description_present_flag) {
361 h->bit_depth_chroma =
get_bits(gb, 3) + 8;
364 h->transfer_characteristics =
get_bits(gb, 8);
369 for (
int c = 0;
c < 3;
c++)
371 for (
int c = 0;
c < 3;
c++) {
372 if (
h->comp_model_present_flag[
c]) {
373 h->num_intensity_intervals[
c] =
get_bits(gb, 8) + 1;
375 if (
h->num_model_values[
c] > 6)
377 for (
int i = 0;
i <
h->num_intensity_intervals[
c];
i++) {
378 h->intensity_interval_lower_bound[
c][
i] =
get_bits(gb, 8);
379 h->intensity_interval_upper_bound[
c][
i] =
get_bits(gb, 8);
380 for (
int j = 0; j <
h->num_model_values[
c]; j++)
405 for (
i = 0;
i < 3;
i++) {
406 s->display_primaries[
i][0] = bytestream2_get_be16u(gb);
407 s->display_primaries[
i][1] = bytestream2_get_be16u(gb);
410 s->white_point[0] = bytestream2_get_be16u(gb);
411 s->white_point[1] = bytestream2_get_be16u(gb);
414 s->max_luminance = bytestream2_get_be32u(gb);
415 s->min_luminance = bytestream2_get_be32u(gb);
432 s->max_content_light_level = bytestream2_get_be16u(gb);
433 s->max_pic_average_light_level = bytestream2_get_be16u(gb);
475 src->a53_caption.buf_ref);
483 if (
src->unregistered.nb_buf_ref) {
485 src->unregistered.nb_buf_ref,
490 for (
unsigned i = 0;
i <
src->unregistered.nb_buf_ref;
i++) {
514 unsigned bit_depth_luma,
unsigned bit_depth_chroma,
521 fp->content_interpretation_type > 0 &&
522 fp->content_interpretation_type < 3) {
528 switch (
fp->arrangement_type) {
541 if (
fp->quincunx_sampling_flag)
559 if (
fp->content_interpretation_type == 2)
563 if (
fp->current_frame_is_frame0_flag)
570 if (
sei->display_orientation.present &&
571 (
sei->display_orientation.anticlockwise_rotation ||
572 sei->display_orientation.hflip ||
573 sei->display_orientation.vflip)) {
590 angle = -angle * (1 - 2 * !!o->
hflip) * (1 - 2 * !!o->
vflip);
596 if (
sei->a53_caption.buf_ref) {
606 for (
unsigned i = 0;
i <
sei->unregistered.nb_buf_ref;
i++) {
618 sei->unregistered.nb_buf_ref = 0;
620 if (
sei->afd.present) {
625 *sd->
data =
sei->afd.active_format_description;
626 sei->afd.present = 0;
630 if (
sei->film_grain_characteristics.present) {
693 if (
sei->ambient_viewing_environment.present) {
695 &
sei->ambient_viewing_environment;
707 if (
sei->mastering_display.present) {
709 const int mapping[3] = {2, 0, 1};
710 const int chroma_den = 50000;
711 const int luma_den = 10000;
718 for (
i = 0;
i < 3;
i++) {
719 const int j = mapping[
i];
739 "r(%5.4f,%5.4f) g(%5.4f,%5.4f) b(%5.4f %5.4f) wp(%5.4f, %5.4f)\n",
748 "min_luminance=%f, max_luminance=%f\n",
752 if (
sei->content_light.present) {
757 metadata->
MaxCLL =
sei->content_light.max_content_light_level;
758 metadata->
MaxFALL =
sei->content_light.max_pic_average_light_level;
772 for (
unsigned i = 0;
i <
s->unregistered.nb_buf_ref;
i++)
774 s->unregistered.nb_buf_ref = 0;
779 s->ambient_viewing_environment.present = 0;
780 s->mastering_display.present = 0;
781 s->content_light.present = 0;
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
AVFrameSideData * av_frame_new_side_data(AVFrame *frame, enum AVFrameSideDataType type, size_t size)
Add a new side data to a frame.
Ambient viewing environment metadata as defined by H.274.
enum AVColorSpace color_space
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...
union AVFilmGrainParams::@337 codec
Additional fields may be added both here and in any structure included.
#define AV_LOG_VERBOSE
Detailed information.
enum AVColorRange color_range
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.
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)
@ FF_H2645_SEI_MESSAGE_UNHANDLED
@ 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
H2645SEIA53Caption a53_caption
@ AV_STEREO3D_2D
Video is not stereoscopic (and metadata has to be there).
uint8_t intensity_interval_upper_bound[3][256]
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.
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...
int bit_depth_luma
Specifies the bit depth used for the luma component.
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 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.
#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]
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]
@ 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)
@ AVCOL_RANGE_UNSPECIFIED
#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
@ 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
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)
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
@ 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)
#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
#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.
enum AVColorPrimaries color_primaries
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.
SEIFpaType
frame_packing_arrangement types.
H2645SEIUnregistered unregistered
main external API structure.
@ 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.
#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 ...
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.
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.
enum AVColorTransferCharacteristic color_trc
Structure to hold side data for an AVFrame.
enum AVStereo3DView view
Determines which views are packed.
unsigned MaxFALL
Max average light level per frame (cd/m^2).
int bit_depth_chroma
Specifies the bit depth used for the chroma components.
#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)