FFmpeg
cbs_sei.h
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #ifndef AVCODEC_CBS_SEI_H
20 #define AVCODEC_CBS_SEI_H
21 
22 #include <stddef.h>
23 #include <stdint.h>
24 
25 #include "cbs.h"
26 #include "sei.h"
27 
28 
29 typedef struct SEIRawFillerPayload {
30  uint32_t payload_size;
32 
33 typedef struct SEIRawUserDataRegistered {
36  uint8_t *data; ///< RefStruct reference
37  size_t data_length;
39 
41  uint8_t uuid_iso_iec_11578[16];
42  uint8_t *data; ///< RefStruct reference
43  size_t data_length;
45 
47  uint16_t display_primaries_x[3];
48  uint16_t display_primaries_y[3];
49  uint16_t white_point_x;
50  uint16_t white_point_y;
54 
59 
63 
66  uint16_t ambient_light_x;
67  uint16_t ambient_light_y;
69 
70 typedef struct SEIRawMessage {
71  uint32_t payload_type;
72  uint32_t payload_size;
73  void *payload;
74  void *payload_ref; ///< RefStruct reference
75  uint8_t *extension_data; ///< RefStruct reference
78 
79 typedef struct SEIRawMessageList {
84 
85 
86 typedef struct SEIMessageState {
87  // The type of the payload being written.
88  uint32_t payload_type;
89  // When reading, contains the size of the payload to allow finding the
90  // end of variable-length fields (such as user_data_payload_byte[]).
91  // (When writing, the size will be derived from the total number of
92  // bytes actually written.)
93  uint32_t payload_size;
94  // When writing, indicates that payload extension data is present so
95  // all extended fields must be written. May be updated by the writer
96  // to indicate that extended fields have been written, so the extension
97  // end bits must be written too.
100 
101 struct GetBitContext;
102 struct PutBitContext;
103 
105  struct GetBitContext *rw,
106  void *current,
108 
110  struct PutBitContext *rw,
111  void *current,
113 
114 typedef struct SEIMessageTypeDescriptor {
115  // Payload type for the message. (-1 in this field ends a list.)
116  int type;
117  // Valid in a prefix SEI NAL unit (always for H.264).
118  uint8_t prefix;
119  // Valid in a suffix SEI NAL unit (never for H.264).
120  uint8_t suffix;
121  // Size of the decomposed structure.
122  size_t size;
123  // Read bitstream into SEI message.
125  // Write bitstream from SEI message.
128 
129 // End-of-list sentinel element.
130 #define SEI_MESSAGE_TYPE_END { .type = -1 }
131 
132 
133 /**
134  * Find the type descriptor for the given payload type.
135  *
136  * Returns NULL if the payload type is not known.
137  */
139  int payload_type);
140 
141 /**
142  * Allocate a new payload for the given SEI message.
143  */
146 
147 /**
148  * Allocate a new empty SEI message in a message list.
149  *
150  * The new message is in place nb_messages - 1.
151  */
153 
154 /**
155  * Free all SEI messages in a message list.
156  */
158 
159 /**
160  * Add an SEI message to an access unit.
161  *
162  * Will add to an existing SEI NAL unit, or create a new one for the
163  * message if there is no suitable existing one.
164  *
165  * If set, payload_ref must be a RefStruct reference backing payload_data.
166  * This function creates a new reference to payload_ref in this case.
167  * If payload_ref is NULL, the new message will not be reference counted.
168  */
171  int prefix,
172  uint32_t payload_type,
173  void *payload_data,
174  void *payload_ref);
175 
176 /**
177  * Iterate over messages with the given payload type in an access unit.
178  *
179  * Set message to NULL in the first call. Returns 0 while more messages
180  * are available, AVERROR(ENOENT) when all messages have been found.
181  */
184  uint32_t payload_type,
186 
187 /**
188  * Delete all messages with the given payload type from an access unit.
189  */
192  uint32_t payload_type);
193 
194 #endif /* AVCODEC_CBS_SEI_H */
SEIRawMasteringDisplayColourVolume::display_primaries_x
uint16_t display_primaries_x[3]
Definition: cbs_sei.h:47
SEIRawUserDataRegistered
Definition: cbs_sei.h:33
SEIMessageTypeDescriptor::size
size_t size
Definition: cbs_sei.h:122
ff_cbs_sei_find_message
int ff_cbs_sei_find_message(CodedBitstreamContext *ctx, CodedBitstreamFragment *au, uint32_t payload_type, SEIRawMessage **message)
Iterate over messages with the given payload type in an access unit.
Definition: cbs_sei.c:315
SEIRawAmbientViewingEnvironment
Definition: cbs_sei.h:64
message
Definition: api-threadmessage-test.c:46
SEIRawMessage::extension_bit_length
size_t extension_bit_length
Definition: cbs_sei.h:76
SEIRawMessage
Definition: cbs_sei.h:70
SEIRawAmbientViewingEnvironment::ambient_light_x
uint16_t ambient_light_x
Definition: cbs_sei.h:66
CodedBitstreamContext
Context structure for coded bitstream operations.
Definition: cbs.h:219
SEIRawAlternativeTransferCharacteristics
Definition: cbs_sei.h:60
SEIMessageState::payload_type
uint32_t payload_type
Definition: cbs_sei.h:88
cbs.h
SEIMessageTypeDescriptor::suffix
uint8_t suffix
Definition: cbs_sei.h:120
SEIMessageReadFunction
int(* SEIMessageReadFunction)(CodedBitstreamContext *ctx, struct GetBitContext *rw, void *current, SEIMessageState *sei)
Definition: cbs_sei.h:104
SEIRawMessage::payload_size
uint32_t payload_size
Definition: cbs_sei.h:72
SEIRawContentLightLevelInfo
Definition: cbs_sei.h:55
SEIRawUserDataUnregistered::data
uint8_t * data
RefStruct reference.
Definition: cbs_sei.h:42
GetBitContext
Definition: get_bits.h:108
SEIRawMasteringDisplayColourVolume::max_display_mastering_luminance
uint32_t max_display_mastering_luminance
Definition: cbs_sei.h:51
SEIRawMessage::extension_data
uint8_t * extension_data
RefStruct reference.
Definition: cbs_sei.h:75
SEIRawUserDataUnregistered
Definition: cbs_sei.h:40
ff_cbs_sei_list_add
int ff_cbs_sei_list_add(SEIRawMessageList *list)
Allocate a new empty SEI message in a message list.
Definition: cbs_sei.c:67
ff_cbs_sei_add_message
int ff_cbs_sei_add_message(CodedBitstreamContext *ctx, CodedBitstreamFragment *au, int prefix, uint32_t payload_type, void *payload_data, void *payload_ref)
Add an SEI message to an access unit.
Definition: cbs_sei.c:268
SEIRawUserDataRegistered::itu_t_t35_country_code
uint8_t itu_t_t35_country_code
Definition: cbs_sei.h:34
SEIMessageWriteFunction
int(* SEIMessageWriteFunction)(CodedBitstreamContext *ctx, struct PutBitContext *rw, void *current, SEIMessageState *sei)
Definition: cbs_sei.h:109
CodedBitstreamFragment
Coded bitstream fragment structure, combining one or more units.
Definition: cbs.h:122
SEIRawMessageList::nb_messages
int nb_messages
Definition: cbs_sei.h:81
SEIRawFillerPayload
Definition: cbs_sei.h:29
SEIRawMasteringDisplayColourVolume::white_point_y
uint16_t white_point_y
Definition: cbs_sei.h:50
SEIMessageState::payload_size
uint32_t payload_size
Definition: cbs_sei.h:93
SEIRawMessageList::nb_messages_allocated
int nb_messages_allocated
Definition: cbs_sei.h:82
SEIRawMessageList
Definition: cbs_sei.h:79
SEIRawUserDataUnregistered::data_length
size_t data_length
Definition: cbs_sei.h:43
ctx
AVFormatContext * ctx
Definition: movenc.c:48
PutBitContext
Definition: put_bits.h:50
SEIRawMessage::payload_type
uint32_t payload_type
Definition: cbs_sei.h:71
SEIRawMasteringDisplayColourVolume::min_display_mastering_luminance
uint32_t min_display_mastering_luminance
Definition: cbs_sei.h:52
SEIMessageTypeDescriptor
Definition: cbs_sei.h:114
SEIRawMasteringDisplayColourVolume
Definition: cbs_sei.h:46
sei.h
list
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 list
Definition: filter_design.txt:25
sei
static int FUNC() sei(CodedBitstreamContext *ctx, RWContext *rw, H264RawSEI *current)
Definition: cbs_h264_syntax_template.c:824
SEIRawMessage::payload_ref
void * payload_ref
RefStruct reference.
Definition: cbs_sei.h:74
ff_cbs_sei_alloc_message_payload
int ff_cbs_sei_alloc_message_payload(SEIRawMessage *message, const SEIMessageTypeDescriptor *desc)
Allocate a new payload for the given SEI message.
Definition: cbs_sei.c:39
SEIRawFillerPayload::payload_size
uint32_t payload_size
Definition: cbs_sei.h:30
SEIRawUserDataRegistered::data
uint8_t * data
RefStruct reference.
Definition: cbs_sei.h:36
SEIMessageTypeDescriptor::type
int type
Definition: cbs_sei.h:116
SEIMessageTypeDescriptor::write
SEIMessageWriteFunction write
Definition: cbs_sei.h:126
SEIRawUserDataRegistered::data_length
size_t data_length
Definition: cbs_sei.h:37
SEIRawAmbientViewingEnvironment::ambient_light_y
uint16_t ambient_light_y
Definition: cbs_sei.h:67
SEIRawUserDataRegistered::itu_t_t35_country_code_extension_byte
uint8_t itu_t_t35_country_code_extension_byte
Definition: cbs_sei.h:35
SEIRawMasteringDisplayColourVolume::white_point_x
uint16_t white_point_x
Definition: cbs_sei.h:49
SEIRawMessageList::messages
SEIRawMessage * messages
Definition: cbs_sei.h:80
SEIMessageTypeDescriptor::read
SEIMessageReadFunction read
Definition: cbs_sei.h:124
SEIRawMasteringDisplayColourVolume::display_primaries_y
uint16_t display_primaries_y[3]
Definition: cbs_sei.h:48
SEIRawContentLightLevelInfo::max_content_light_level
uint16_t max_content_light_level
Definition: cbs_sei.h:56
SEIRawAlternativeTransferCharacteristics::preferred_transfer_characteristics
uint8_t preferred_transfer_characteristics
Definition: cbs_sei.h:61
SEIRawMessage::payload
void * payload
Definition: cbs_sei.h:73
SEIMessageState
Definition: cbs_sei.h:86
ff_cbs_sei_find_type
const SEIMessageTypeDescriptor * ff_cbs_sei_find_type(CodedBitstreamContext *ctx, int payload_type)
Find the type descriptor for the given payload type.
Definition: cbs_h2645.c:2248
SEIRawAmbientViewingEnvironment::ambient_illuminance
uint32_t ambient_illuminance
Definition: cbs_sei.h:65
desc
const char * desc
Definition: libsvtav1.c:75
ff_cbs_sei_delete_message_type
void ff_cbs_sei_delete_message_type(CodedBitstreamContext *ctx, CodedBitstreamFragment *au, uint32_t payload_type)
Delete all messages with the given payload type from an access unit.
Definition: cbs_sei.c:368
SEIRawContentLightLevelInfo::max_pic_average_light_level
uint16_t max_pic_average_light_level
Definition: cbs_sei.h:57
ff_cbs_sei_free_message_list
void ff_cbs_sei_free_message_list(SEIRawMessageList *list)
Free all SEI messages in a message list.
Definition: cbs_sei.c:92
SEIRawUserDataUnregistered::uuid_iso_iec_11578
uint8_t uuid_iso_iec_11578[16]
Definition: cbs_sei.h:41
SEIMessageState::extension_present
uint8_t extension_present
Definition: cbs_sei.h:98
int
int
Definition: ffmpeg_filter.c:410
SEIMessageTypeDescriptor::prefix
uint8_t prefix
Definition: cbs_sei.h:118