FFmpeg: libavformat/id3v2.h File Reference

FFmpeg

libavformat

Data Structures | Macros | Enumerations | Functions | Variables

id3v2.h File Reference

#include <stdint.h>
#include "avformat.h"
#include "internal.h"
#include "metadata.h"

Go to the source code of this file.

Data Structures

struct ID3v2EncContext

struct ID3v2ExtraMeta

struct ID3v2ExtraMetaGEOB

struct ID3v2ExtraMetaAPIC

struct ID3v2ExtraMetaPRIV

Macros

#define ID3v2_HEADER_SIZE 10

#define ID3v2_DEFAULT_MAGIC "ID3"

Default magic bytes for ID3v2 header: "ID3".

#define ID3v2_FLAG_DATALEN 0x0001

#define ID3v2_FLAG_UNSYNCH 0x0002

#define ID3v2_FLAG_ENCRYPTION 0x0004

#define ID3v2_FLAG_COMPRESSION 0x0008

Enumerations

enum ID3v2Encoding { ID3v2_ENCODING_ISO8859 = 0, ID3v2_ENCODING_UTF16BOM = 1, ID3v2_ENCODING_UTF16BE = 2, ID3v2_ENCODING_UTF8 = 3 }

Functions

int ff_id3v2_match (const uint8_t *buf, const char *magic)

Detect ID3v2 Header.

int ff_id3v2_tag_len (const uint8_t *buf)

Get the length of an ID3v2 tag.

void ff_id3v2_read_dict (AVIOContext *pb, AVDictionary **metadata, const char *magic, ID3v2ExtraMeta **extra_meta)

Read an ID3v2 tag into specified dictionary and retrieve supported extra metadata.

void ff_id3v2_read (AVFormatContext *s, const char *magic, ID3v2ExtraMeta **extra_meta, unsigned int max_search_size)

Read an ID3v2 tag, including supported extra metadata and chapters.

void ff_id3v2_start (ID3v2EncContext *id3, AVIOContext *pb, int id3v2_version, const char *magic)

Initialize an ID3v2 tag.

int ff_id3v2_write_metadata (AVFormatContext *s, ID3v2EncContext *id3)

Convert and write all global metadata from s into an ID3v2 tag.

int ff_id3v2_write_apic (AVFormatContext *s, ID3v2EncContext *id3, AVPacket *pkt)

Write an attached picture from pkt into an ID3v2 tag.

void ff_id3v2_finish (ID3v2EncContext *id3, AVIOContext *pb, int padding_bytes)

Finalize an opened ID3v2 tag.

int ff_id3v2_write_simple (struct AVFormatContext *s, int id3v2_version, const char *magic)

Write an ID3v2 tag containing all global metadata from s.

void ff_id3v2_free_extra_meta (ID3v2ExtraMeta **extra_meta)

Free memory allocated parsing special (non-text) metadata.

int ff_id3v2_parse_apic (AVFormatContext *s, ID3v2ExtraMeta **extra_meta)

Create a stream for each APIC (attached picture) extracted from the ID3v2 header.

Variables

const AVMetadataConv ff_id3v2_34_metadata_conv []

const AVMetadataConv ff_id3v2_4_metadata_conv []

const char ff_id3v2_tags [][4]

A list of text information frames allowed in both ID3 v2.3 and v2.4 http://www.id3.org/id3v2.4.0-frames http://www.id3.org/id3v2.4.0-changes.

const char ff_id3v2_4_tags [][4]

ID3v2.4-only text information frames.

const char ff_id3v2_3_tags [][4]

ID3v2.3-only text information frames.

const CodecMime ff_id3v2_mime_tags []

const char * ff_id3v2_picture_types [21]

Macro Definition Documentation

#define ID3v2_HEADER_SIZE 10

Definition at line 30 of file id3v2.h.

Referenced by ff_id3v2_tag_len(), ff_id3v2_write_apic(), id3v2_put_ttag(), id3v2_read_internal(), intercept_id3(), oma_read_probe(), and write_chapter().

#define ID3v2_DEFAULT_MAGIC "ID3"

Default magic bytes for ID3v2 header: "ID3".

Definition at line 35 of file id3v2.h.

Referenced by adts_write_header(), aiff_read_header(), av_probe_input_format3(), avformat_open_input(), get_id3_tag(), intercept_id3(), mp3_read_probe(), parse_dsd_prop(), parse_id3(), put_id3v2_tags(), and read_id3().

#define ID3v2_FLAG_DATALEN 0x0001

Definition at line 37 of file id3v2.h.

Referenced by id3v2_parse().

#define ID3v2_FLAG_UNSYNCH 0x0002

Definition at line 38 of file id3v2.h.

Referenced by id3v2_parse().

#define ID3v2_FLAG_ENCRYPTION 0x0004

Definition at line 39 of file id3v2.h.

Referenced by id3v2_parse().

#define ID3v2_FLAG_COMPRESSION 0x0008

Definition at line 40 of file id3v2.h.

Referenced by id3v2_parse().

Enumeration Type Documentation

enum ID3v2Encoding

Enumerator:: ID3v2_ENCODING_ISO8859

ID3v2_ENCODING_UTF16BOM

ID3v2_ENCODING_UTF16BE

ID3v2_ENCODING_UTF8

Definition at line 42 of file id3v2.h.

Function Documentation

int ff_id3v2_match ( const uint8_t * buf,

const char * magic

)

Detect ID3v2 Header.

Parameters: buf must be ID3v2_HEADER_SIZE byte long

magic magic bytes to identify the header. If in doubt, use ID3v2_DEFAULT_MAGIC.

Definition at line 141 of file id3v2.c.

Referenced by av_probe_input_format3(), id3v2_read_internal(), intercept_id3(), mp3_read_probe(), and oma_read_probe().

int ff_id3v2_tag_len ( const uint8_t * buf )

Get the length of an ID3v2 tag.

Parameters: buf must be ID3v2_HEADER_SIZE bytes long and point to the start of an already detected ID3v2 tag

Definition at line 154 of file id3v2.c.

Referenced by av_probe_input_format3(), intercept_id3(), mp3_read_probe(), and oma_read_probe().

void ff_id3v2_read_dict ( AVIOContext * pb,

AVDictionary ** metadata,

const char * magic,

ID3v2ExtraMeta ** extra_meta

)

Read an ID3v2 tag into specified dictionary and retrieve supported extra metadata.

Chapters are not currently read by this variant.

Parameters: metadata Parsed metadata is stored here

extra_meta If not NULL, extra metadata is parsed into a list of ID3v2ExtraMeta structs and *extra_meta points to the head of the list

Definition at line 1039 of file id3v2.c.

Referenced by parse_id3().

void ff_id3v2_read ( AVFormatContext * s,

const char * magic,

ID3v2ExtraMeta ** extra_meta,

unsigned int max_search_size

)

Read an ID3v2 tag, including supported extra metadata and chapters.

Data is read from and stored to AVFormatContext.

Parameters: extra_meta If not NULL, extra metadata is parsed into a list of ID3v2ExtraMeta structs and *extra_meta points to the head of the list

opt] max_search_search restrict ID3 magic number search (bytes from start)

Definition at line 1045 of file id3v2.c.

Referenced by aiff_read_header(), avformat_open_input(), get_id3_tag(), oma_read_header(), parse_dsd_prop(), and read_id3().

void ff_id3v2_start ( ID3v2EncContext * id3,

AVIOContext * pb,

int id3v2_version,

const char * magic

)

Initialize an ID3v2 tag.

Definition at line 152 of file id3v2enc.c.

Referenced by ff_id3v2_write_simple(), and put_id3v2_tags().

int ff_id3v2_write_metadata ( AVFormatContext * s,

ID3v2EncContext * id3

)

Convert and write all global metadata from s into an ID3v2 tag.

Definition at line 239 of file id3v2enc.c.

Referenced by ff_id3v2_write_simple(), and put_id3v2_tags().

int ff_id3v2_write_apic ( AVFormatContext * s,

ID3v2EncContext * id3,

AVPacket * pkt

)

Write an attached picture from pkt into an ID3v2 tag.

Definition at line 256 of file id3v2enc.c.

Referenced by put_id3v2_tags().

void ff_id3v2_finish ( ID3v2EncContext * id3,

AVIOContext * pb,

int padding_bytes

)

Finalize an opened ID3v2 tag.

Definition at line 325 of file id3v2enc.c.

Referenced by ff_id3v2_write_simple(), mp3_queue_flush(), and put_id3v2_tags().

int ff_id3v2_write_simple ( struct AVFormatContext * s,

int id3v2_version,

const char * magic

)

Write an ID3v2 tag containing all global metadata from s.

Parameters: id3v2_version Subversion of ID3v2; supported values are 3 and 4

magic magic bytes to identify the header If in doubt, use ID3v2_DEFAULT_MAGIC.

Definition at line 349 of file id3v2enc.c.

Referenced by adts_write_header(), and oma_write_header().

void ff_id3v2_free_extra_meta ( ID3v2ExtraMeta ** extra_meta )

Free memory allocated parsing special (non-text) metadata.

Parameters: extra_meta Pointer to a pointer to the head of a ID3v2ExtraMeta list, *extra_meta is set to NULL.

Definition at line 1051 of file id3v2.c.

Referenced by aiff_read_header(), avformat_open_input(), free_playlist_list(), get_id3_tag(), handle_id3(), hls_read_header(), oma_read_header(), parse_dsd_prop(), and read_id3().

int ff_id3v2_parse_apic ( AVFormatContext * s,

ID3v2ExtraMeta ** extra_meta

)

Create a stream for each APIC (attached picture) extracted from the ID3v2 header.

Definition at line 1067 of file id3v2.c.

Referenced by aiff_read_header(), avformat_open_input(), get_id3_tag(), handle_id3(), hls_read_header(), parse_dsd_prop(), and read_id3().

Variable Documentation

const AVMetadataConv ff_id3v2_34_metadata_conv[]

Definition at line 43 of file id3v2.c.

Referenced by write_metadata().

const AVMetadataConv ff_id3v2_4_metadata_conv[]

Definition at line 62 of file id3v2.c.

Referenced by write_metadata().

const char ff_id3v2_tags[][4]

A list of text information frames allowed in both ID3 v2.3 and v2.4 http://www.id3.org/id3v2.4.0-frames http://www.id3.org/id3v2.4.0-changes.

Definition at line 86 of file id3v2.c.

Referenced by write_metadata().

const char ff_id3v2_4_tags[][4]

ID3v2.4-only text information frames.

Definition at line 94 of file id3v2.c.

Referenced by write_metadata().

const char ff_id3v2_3_tags[][4]

ID3v2.3-only text information frames.

Definition at line 100 of file id3v2.c.

Referenced by write_metadata().

const CodecMime ff_id3v2_mime_tags[]

Definition at line 129 of file id3v2.c.

Referenced by asf_read_picture(), ff_flac_parse_picture(), ff_id3v2_write_apic(), query_codec(), and read_apic().

const char* ff_id3v2_picture_types[21]

Definition at line 105 of file id3v2.c.

Referenced by asf_read_picture(), ff_flac_parse_picture(), ff_id3v2_write_apic(), and read_apic().

Generated on Sun Mar 8 2015 02:35:29 for FFmpeg by doxygen 1.8.2