summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorTakashi Iwai <tiwai@suse.de>2007-02-20 12:43:58 +0100
committerTakashi Iwai <tiwai@suse.de>2007-02-20 12:43:58 +0100
commit9481014305ab8f8e1ba07749c0b7f68ec4b99e56 (patch)
treea9ce7eca089b691c329e6aa11baf05167f407bf2 /doc
parent25451b27d65d17a0d60b3c8e9bb7510e1ed68bd1 (diff)
Add livavcodec resampler plugin
Add a new pcm_rate plugin, "lavcrate", that uses the resampling filter from libavcodec. It should provide high performance and good output quality. Add a documentation file for lavcrate. Update autoconf and automake to build lavcrate. From: Nicholas Kain <njkain@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.am2
-rw-r--r--doc/lavcrate.txt33
2 files changed, 34 insertions, 1 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 17e5b99..5eda3bd 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,2 +1,2 @@
EXTRA_DIST = README-pcm-oss README-jack README-pulse README-maemo \
- upmix.txt vdownmix.txt samplerate.txt a52.txt
+ upmix.txt vdownmix.txt samplerate.txt a52.txt lavcrate.txt
diff --git a/doc/lavcrate.txt b/doc/lavcrate.txt
new file mode 100644
index 0000000..faf3e25
--- /dev/null
+++ b/doc/lavcrate.txt
@@ -0,0 +1,33 @@
+Rate Converter Plugin Using libavcodec
+======================================
+
+The plugin in rate-lavc subdirectory is an external rate converter using
+libavcodec's resampler. You can use this rate converter plugin by defining a
+rate PCM with "converter" parameter, such as:
+
+ pcm.my_rate {
+ type rate
+ slave.pcm "hw"
+ converter "lavcrate"
+ }
+
+The plug plugin has also a similar field, "rate_converter".
+
+Or, more easily, define a global variable "defaults.pcm.rate_converter",
+which is used as the default converter type by plug and rate plugins:
+
+ defaults.pcm.rate_converter "lavcrate"
+
+Write the above in your ~/.asoundrc or /etc/asound.conf.
+
+The following converter types are available:
+
+ - lavcrate_higher Use length=64
+ - lavcrate_high Use length=32
+ - lavcrate Use length=16
+ - lavcrate_fast Use length=8
+ - lavcrate_faster Use length=4
+
+Linear interpolation and cutoff values are automatically used depending on
+the supplied parameters and whether the plugin is used to upsample or
+downsample.