From: Olle Johansson <oej@edvina.net>
Date: Tue, 7 Nov 2006 13:16:05 +0000 (+0000)
Subject: Stealing Tilghman's explanation from the -dev list and producing documentation...
X-Git-Tag: 1.6.0-beta1~3^2~4101
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8e73644bb8edeba162f6316dca201b9e9e9443e1;p=thirdparty%2Fasterisk.git

Stealing Tilghman's explanation from the -dev list and producing documentation...


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@47251 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---

diff --git a/include/asterisk/frame.h b/include/asterisk/frame.h
index cc3aa5d832..5e02e670d1 100644
--- a/include/asterisk/frame.h
+++ b/include/asterisk/frame.h
@@ -450,6 +450,19 @@ int ast_getformatbyname(const char *name);
  */
 char *ast_codec2str(int codec);
 
+/*! \page ast_smooth
+The ast_smoother interface was designed specifically
+to take frames of variant sizes and produce frames of a single expected
+size, precisely what you want to do.
+
+The basic interface is:
+
+- Initialize with ast_smoother_new()
+- Queue input frames with ast_smoother_feed()
+- Get output frames with ast_smoother_read()
+- when you're done, free the structure with ast_smoother_free()
+- Also see ast_smoother_test_flag(), ast_smoother_set_flags(), ast_smoother_get_flags(), ast_smoother_reset()
+*/
 struct ast_smoother;
 
 struct ast_format_list *ast_get_format_list_index(int index);