Commit a6d18a0e authored by Michael Niedermayer's avatar Michael Niedermayer

Move metadata API from avcodec to avformat.

Originally committed as revision 16425 to svn://svn.ffmpeg.org/ffmpeg/trunk
parent 47146dfb
......@@ -14,7 +14,6 @@ OBJS = allcodecs.o \
faanidct.o \
imgconvert.o \
jrevdct.o \
metadata.o \
opt.o \
parser.o \
raw.o \
......
......@@ -401,50 +401,6 @@ enum SampleFormat {
#define FF_MIN_BUFFER_SIZE 16384
/*
* public Metadata API.
* Important concepts, to keep in mind
* 1. keys are unique, there are never 2 tags with equal keys, this is also
* meant semantically that is a demuxer should not knowingly produce
* several keys that are litterally different but semantically identical,
* like key=Author5, key=Author6.
* All authors have to be placed in the same tag for the case of Authors.
* 2. Metadata is flat, there are no subtags, if you for whatever obscene
* reason want to store the email address of the child of producer alice
* and actor bob, that could have key=alice_and_bobs_childs_email_address.
* 3. A tag whichs value is translated has the ISO 639 3-letter language code
* with a '-' between appended. So for example Author-ger=Michael, Author-eng=Mike
* the original/default language is in the unqualified "Author"
* A demuxer should set a default if it sets any translated tag.
*/
#define AV_METADATA_IGNORE_CASE 1
#define AV_METADATA_IGNORE_SUFFIX 2
typedef struct {
char *key;
char *value;
}AVMetaDataTag;
struct AVMetaData;
/**
* gets a metadata element with matching key.
* @param prev set to the previous matching element to find the next.
* @param flags allows case as well as suffix insensitive comparissions.
* @return found tag or NULL, changing key or value leads to undefined behavior.
*/
AVMetaDataTag *
av_metadata_get(struct AVMetaData *m, const char *key, const AVMetaDataTag *prev, int flags);
/**
* sets the given tag in m, overwriting an existing tag.
* @param tag tag to add to m, key and value will be av_strduped.
* @return >= 0 if success otherwise error code that is <0.
*/
int av_metadata_set(struct AVMetaData **m, AVMetaDataTag tag);
/**
* motion estimation type.
*/
......
......@@ -5,7 +5,7 @@ FFLIBS = avcodec avutil
HEADERS = avformat.h avio.h rtsp.h rtspcodes.h
OBJS = allformats.o cutils.o os_support.o sdp.o utils.o
OBJS = allformats.o cutils.o metadata.o os_support.o sdp.o utils.o
# muxers/demuxers
OBJS-$(CONFIG_AAC_DEMUXER) += raw.o
......
......@@ -46,6 +46,51 @@ unsigned avformat_version(void);
#include "avio.h"
/*
* public Metadata API.
* Important concepts, to keep in mind
* 1. keys are unique, there are never 2 tags with equal keys, this is also
* meant semantically that is a demuxer should not knowingly produce
* several keys that are litterally different but semantically identical,
* like key=Author5, key=Author6.
* All authors have to be placed in the same tag for the case of Authors.
* 2. Metadata is flat, there are no subtags, if you for whatever obscene
* reason want to store the email address of the child of producer alice
* and actor bob, that could have key=alice_and_bobs_childs_email_address.
* 3. A tag whichs value is translated has the ISO 639 3-letter language code
* with a '-' between appended. So for example Author-ger=Michael, Author-eng=Mike
* the original/default language is in the unqualified "Author"
* A demuxer should set a default if it sets any translated tag.
*/
#define AV_METADATA_IGNORE_CASE 1
#define AV_METADATA_IGNORE_SUFFIX 2
typedef struct {
char *key;
char *value;
}AVMetaDataTag;
struct AVMetaData;
/**
* gets a metadata element with matching key.
* @param prev set to the previous matching element to find the next.
* @param flags allows case as well as suffix insensitive comparissions.
* @return found tag or NULL, changing key or value leads to undefined behavior.
*/
AVMetaDataTag *
av_metadata_get(struct AVMetaData *m, const char *key, const AVMetaDataTag *prev, int flags);
/**
* sets the given tag in m, overwriting an existing tag.
* @param tag tag to add to m, key and value will be av_strduped.
* @return >= 0 if success otherwise error code that is <0.
*/
int av_metadata_set(struct AVMetaData **m, AVMetaDataTag tag);
/* packet functions */
typedef struct AVPacket {
......
......@@ -18,21 +18,21 @@
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef AVCODEC_METADATA_H
#define AVCODEC_METADATA_H
#ifndef AVFORMAT_METADATA_H
#define AVFORMAT_METADATA_H
/**
* @file metadata.h
* internal metadata API header
* see avcodec.h or the public API!
* see avformat.h or the public API!
*/
#include "avcodec.h"
#include "avformat.h"
struct AVMetaData{
int count;
AVMetaDataTag *elems;
};
#endif /* AVCODEC_METADATA_H */
#endif /* AVFORMAT_METADATA_H */
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment