har0ke/FFmpeg
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

avformat: extend documentation of event_flags

Browse Source 
Document how it is to be used for muxing (currently supported by
flvenc).
This commit is contained in:
Anton Khirnov 2020-10-25 15:22:44 +01:00
parent c515a35dde
commit 48f3ed96e9
1 changed files with 32 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
libavformat/avformat.h
View File

@ -977,12 +977,24 @@ typedef struct AVStream {
int nb_side_data; int nb_side_data;
/** /**
* Flags for the user to detect events happening on the stream. Flags must * Flags indicating events happening on the stream, a combination of
* be cleared by the user once the event has been handled. * AVSTREAM_EVENT_FLAG_*.
* A combination of AVSTREAM_EVENT_FLAG_*. *
* - demuxing: may be set by the demuxer in avformat_open_input(),
* avformat_find_stream_info() and av_read_frame(). Flags must be cleared
* by the user once the event has been handled.
* - muxing: may be set by the user after avformat_write_header(). to
* indicate a user-triggered event. The muxer will clear the flags for
* events it has handled in av_[interleaved]_write_frame().
*/ */
int event_flags; int event_flags;
#define AVSTREAM_EVENT_FLAG_METADATA_UPDATED 0x0001 ///< The call resulted in updated metadata. /**
* - demuxing: the demuxer read new metadata from the file and updated
* AVStream.metadata accordingly
* - muxing: the user updated AVStream.metadata and wishes the muxer to write
* it into the file
*/
#define AVSTREAM_EVENT_FLAG_METADATA_UPDATED 0x0001
/** /**
* Real base framerate of the stream. * Real base framerate of the stream.
@ -1649,12 +1661,24 @@ typedef struct AVFormatContext {
int strict_std_compliance; int strict_std_compliance;
/** /**
* Flags for the user to detect events happening on the file. Flags must * Flags indicating events happening on the file, a combination of
* be cleared by the user once the event has been handled. * AVFMT_EVENT_FLAG_*.
* A combination of AVFMT_EVENT_FLAG_*. *
* - demuxing: may be set by the demuxer in avformat_open_input(),
* avformat_find_stream_info() and av_read_frame(). Flags must be cleared
* by the user once the event has been handled.
* - muxing: may be set by the user after avformat_write_header() to
* indicate a user-triggered event. The muxer will clear the flags for
* events it has handled in av_[interleaved]_write_frame().
*/ */
int event_flags; int event_flags;
#define AVFMT_EVENT_FLAG_METADATA_UPDATED 0x0001 ///< The call resulted in updated metadata. /**
* - demuxing: the demuxer read new metadata from the file and updated
* AVFormatContext.metadata accordingly
* - muxing: the user updated AVFormatContext.metadata and wishes the muxer to
* write it into the file
*/
#define AVFMT_EVENT_FLAG_METADATA_UPDATED 0x0001
/** /**
* Maximum number of packets to read while waiting for the first timestamp. * Maximum number of packets to read while waiting for the first timestamp.