Move metadata API from avcodec to avformat.

Originally committed as revision 16425 to svn://svn.ffmpeg.org/ffmpeg/trunk
pull/126/head
Michael Niedermayer 16 years ago
parent 47146dfbf6
commit a6d18a0e6a
  1. 1
      libavcodec/Makefile
  2. 44
      libavcodec/avcodec.h
  3. 2
      libavformat/Makefile
  4. 45
      libavformat/avformat.h
  5. 0
      libavformat/metadata.c
  6. 10
      libavformat/metadata.h

@ -14,7 +14,6 @@ OBJS = allcodecs.o \
faanidct.o \ faanidct.o \
imgconvert.o \ imgconvert.o \
jrevdct.o \ jrevdct.o \
metadata.o \
opt.o \ opt.o \
parser.o \ parser.o \
raw.o \ raw.o \

@ -401,50 +401,6 @@ enum SampleFormat {
#define FF_MIN_BUFFER_SIZE 16384 #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. * motion estimation type.
*/ */

@ -5,7 +5,7 @@ FFLIBS = avcodec avutil
HEADERS = avformat.h avio.h rtsp.h rtspcodes.h 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 # muxers/demuxers
OBJS-$(CONFIG_AAC_DEMUXER) += raw.o OBJS-$(CONFIG_AAC_DEMUXER) += raw.o

@ -46,6 +46,51 @@ unsigned avformat_version(void);
#include "avio.h" #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 */ /* packet functions */
typedef struct AVPacket { typedef struct AVPacket {

@ -18,21 +18,21 @@
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/ */
#ifndef AVCODEC_METADATA_H #ifndef AVFORMAT_METADATA_H
#define AVCODEC_METADATA_H #define AVFORMAT_METADATA_H
/** /**
* @file metadata.h * @file metadata.h
* internal metadata API header * 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{ struct AVMetaData{
int count; int count;
AVMetaDataTag *elems; AVMetaDataTag *elems;
}; };
#endif /* AVCODEC_METADATA_H */ #endif /* AVFORMAT_METADATA_H */
Loading…
Cancel
Save