diff options
author | Mark Nauwelaerts <mark.nauwelaerts@collabora.co.uk> | 2009-09-05 21:35:19 +0200 |
---|---|---|
committer | Mark Nauwelaerts <mark.nauwelaerts@collabora.co.uk> | 2009-09-08 22:32:27 +0200 |
commit | ceb67924478d72dae10dd938e3bd9dc7b361de6b (patch) | |
tree | 0f1d4bdb8a09bddecf106e3fc08e993b939d602f | |
parent | f0f80f81d9351a77f2614cbccc22c266a41d87f9 (diff) |
faac: add some documentation
-rw-r--r-- | ext/faac/gstfaac.c | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/ext/faac/gstfaac.c b/ext/faac/gstfaac.c index 1e04ff435..7b81d6584 100644 --- a/ext/faac/gstfaac.c +++ b/ext/faac/gstfaac.c @@ -18,6 +18,32 @@ * Boston, MA 02111-1307, USA. */ +/** + * SECTION:element-faac + * @seealso: faad + * + * faac encodes raw audio to AAC (MPEG-4 part 10) streams. + * + * The #GstFaac:outputformat property determines whether or not the + * AAC data needs additional framing provided by a container + * (such as Matroska or Quicktime). + * This is required for raw data, whereas ADTS formatted AAC already provides + * framing and needs no container. + * + * The #GstFaac:profile property determines the AAC profile, where the default + * Main profile is fine for most players and settings, + * but in some cases (e.g. hardware platforms) + * a more restricted profile/level may be necessary. + * In particular, typical (iTunes) m4a expects LC profile AAC data. + * + * <refsect2> + * <title>Example launch line</title> + * <programlisting> + * gst-launch audiotestsrc wave=sine num-buffers=100 ! audioconvert ! faac ! matroskamux ! filesink location=sine.mkv + * </programlisting> + * </refsect2> + */ + #ifdef HAVE_CONFIG_H #include "config.h" #endif |