Mercurial > libavformat.hg
comparison avformat.h @ 5712:20877abd6b08 libavformat
Mention that metadata tags are (unvalidated) UTF-8.
Patch by Anton Khirnov <wyskas gmail com>.
author | rbultje |
---|---|
date | Wed, 24 Feb 2010 18:01:44 +0000 |
parents | c9466f118684 |
children | dbc61b2840eb |
comparison
equal
deleted
inserted
replaced
5711:1481fbffd30b | 5712:20877abd6b08 |
---|---|
61 | 61 |
62 | 62 |
63 /* | 63 /* |
64 * Public Metadata API. | 64 * Public Metadata API. |
65 * The metadata API allows libavformat to export metadata tags to a client | 65 * The metadata API allows libavformat to export metadata tags to a client |
66 * application using a sequence of key/value pairs. | 66 * application using a sequence of key/value pairs. Like all strings in FFmpeg, |
67 * metadata must be stored as UTF-8 encoded Unicode. Note that metadata | |
68 * exported by demuxers isn't checked to be valid UTF-8 in most cases. | |
67 * Important concepts to keep in mind: | 69 * Important concepts to keep in mind: |
68 * 1. Keys are unique; there can never be 2 tags with the same key. This is | 70 * 1. Keys are unique; there can never be 2 tags with the same key. This is |
69 * also meant semantically, i.e., a demuxer should not knowingly produce | 71 * also meant semantically, i.e., a demuxer should not knowingly produce |
70 * several keys that are literally different but semantically identical. | 72 * several keys that are literally different but semantically identical. |
71 * E.g., key=Author5, key=Author6. In this example, all authors must be | 73 * E.g., key=Author5, key=Author6. In this example, all authors must be |