FFmpeg
|
ID3v2 header parser. More...
#include "config.h"
#include "libavutil/avstring.h"
#include "libavutil/dict.h"
#include "libavutil/intreadwrite.h"
#include "avio_internal.h"
#include "internal.h"
#include "id3v1.h"
#include "id3v2.h"
Go to the source code of this file.
Data Structures | |
struct | ID3v2EMFunc |
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. | |
static unsigned int | get_size (AVIOContext *s, int len) |
static void | free_geobtag (void *obj) |
Free GEOB type extra metadata. | |
static int | decode_str (AVFormatContext *s, AVIOContext *pb, int encoding, uint8_t **dst, int *maxread) |
Decode characters to UTF-8 according to encoding type. | |
static void | read_ttag (AVFormatContext *s, AVIOContext *pb, int taglen, AVDictionary **metadata, const char *key) |
Parse a text tag. | |
static void | read_geobtag (AVFormatContext *s, AVIOContext *pb, int taglen, char *tag, ID3v2ExtraMeta **extra_meta, int isv34) |
Parse GEOB tag into a ID3v2ExtraMetaGEOB struct. | |
static int | is_number (const char *str) |
static AVDictionaryEntry * | get_date_tag (AVDictionary *m, const char *tag) |
static void | merge_date (AVDictionary **m) |
static void | free_apic (void *obj) |
static void | read_apic (AVFormatContext *s, AVIOContext *pb, int taglen, char *tag, ID3v2ExtraMeta **extra_meta, int isv34) |
static void | read_chapter (AVFormatContext *s, AVIOContext *pb, int len, char *ttag, ID3v2ExtraMeta **extra_meta, int isv34) |
static void | free_priv (void *obj) |
static void | read_priv (AVFormatContext *s, AVIOContext *pb, int taglen, char *tag, ID3v2ExtraMeta **extra_meta, int isv34) |
static const ID3v2EMFunc * | get_extra_meta_func (const char *tag, int isv34) |
Get the corresponding ID3v2EMFunc struct for a tag. | |
static void | id3v2_parse (AVIOContext *pb, AVDictionary **metadata, AVFormatContext *s, int len, uint8_t version, uint8_t flags, ID3v2ExtraMeta **extra_meta) |
static void | id3v2_read_internal (AVIOContext *pb, AVDictionary **metadata, AVFormatContext *s, const char *magic, ID3v2ExtraMeta **extra_meta, int64_t max_search_size) |
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_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 [] |
static const AVMetadataConv | id3v2_2_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 char * | ff_id3v2_picture_types [21] |
const CodecMime | ff_id3v2_mime_tags [] |
static const ID3v2EMFunc | id3v2_extra_meta_funcs [] |
ID3v2 header parser.
Specifications available at: http://id3.org/Developer_Information
Definition in file id3v2.c.
int ff_id3v2_match | ( | const uint8_t * | buf, |
const char * | magic | ||
) |
Detect ID3v2 Header.
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 140 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.
buf | must be ID3v2_HEADER_SIZE bytes long and point to the start of an already detected ID3v2 tag |
Definition at line 153 of file id3v2.c.
Referenced by av_probe_input_format3(), intercept_id3(), mp3_read_probe(), and oma_read_probe().
|
static |
Definition at line 165 of file id3v2.c.
Referenced by id3v2_parse().
Free GEOB type extra metadata.
Definition at line 176 of file id3v2.c.
Referenced by read_geobtag().
|
static |
Decode characters to UTF-8 according to encoding type.
The decoded buffer is always null terminated. Stop reading when either *maxread bytes are read from pb or U+0000 character is found.
dst | Pointer where the address of the buffer with the decoded bytes is stored. Buffer must be freed by caller. |
maxread | Pointer to maximum number of characters to read from the AVIOContext. After execution the value is decremented by the number of bytes actually read. |
Definition at line 198 of file id3v2.c.
Referenced by read_apic(), read_chapter(), read_geobtag(), read_priv(), and read_ttag().
|
static |
Parse a text tag.
Definition at line 275 of file id3v2.c.
Referenced by id3v2_parse(), and read_chapter().
|
static |
Parse GEOB tag into a ID3v2ExtraMetaGEOB struct.
|
static |
Definition at line 393 of file id3v2.c.
Referenced by get_date_tag().
|
static |
Definition at line 400 of file id3v2.c.
Referenced by merge_date().
|
static |
Definition at line 409 of file id3v2.c.
Referenced by id3v2_read_internal().
Definition at line 441 of file id3v2.c.
Referenced by read_apic().
|
static |
|
static |
Definition at line 583 of file id3v2.c.
Referenced by read_priv().
|
static |
|
static |
Get the corresponding ID3v2EMFunc struct for a tag.
isv34 | Determines if v2.2 or v2.3/4 strings are used |
Definition at line 649 of file id3v2.c.
Referenced by ff_id3v2_free_extra_meta(), and id3v2_parse().
|
static |
Definition at line 663 of file id3v2.c.
Referenced by id3v2_read_internal().
|
static |
Definition at line 881 of file id3v2.c.
Referenced by ff_id3v2_read(), and ff_id3v2_read_dict().
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.
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 925 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.
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 931 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_free_extra_meta | ( | ID3v2ExtraMeta ** | extra_meta | ) |
Free memory allocated parsing special (non-text) metadata.
extra_meta | Pointer to a pointer to the head of a ID3v2ExtraMeta list, *extra_meta is set to NULL. |
Definition at line 937 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 953 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().
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 61 of file id3v2.c.
Referenced by write_metadata().
|
static |
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 85 of file id3v2.c.
Referenced by write_metadata().
const char ff_id3v2_4_tags[][4] |
ID3v2.4-only text information frames.
Definition at line 93 of file id3v2.c.
Referenced by write_metadata().
const char ff_id3v2_3_tags[][4] |
ID3v2.3-only text information frames.
Definition at line 99 of file id3v2.c.
Referenced by write_metadata().
const char* ff_id3v2_picture_types[21] |
Definition at line 104 of file id3v2.c.
Referenced by asf_read_picture(), ff_flac_parse_picture(), ff_id3v2_write_apic(), and read_apic().
const CodecMime ff_id3v2_mime_tags[] |
Definition at line 128 of file id3v2.c.
Referenced by asf_read_picture(), ff_flac_parse_picture(), ff_id3v2_write_apic(), query_codec(), and read_apic().
|
static |