annotate doc/NEW_FORMATS @ 4869:f07844bdc43f

Acknowledge contribution by Edward Sheldrake in bug #12.
author Tony Vroon <chainsaw@gentoo.org>
date Fri, 24 Apr 2009 09:43:41 +0100
parents 8ce4e7f5b827
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4243
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
1 Since 38449056c293 input plugins can open audio output in their's native format,
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
2 without worrying of output plugin's capabilities. Audio stream will be converted to format specified
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
3 in prefs win (currently FMT_S16_NE and FMT_S24_NE). Dithering will be applied automatically if
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
4 precision loss expected (except FMT_*32_*, on which dithering can cause clipping).
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
5
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
6 For full list of available formats see plugin.h
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
7
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
8 Known issues:
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
9
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
10 1. postproc_flow can deal only with S16_NE streams, so it will be bypassed in 24bit mode, i.e.: no vis, no equalizer, no softvolume.
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
11 2. Currently none of output plugins supports 24bit output :)
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
12
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
13 Possible solution:
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
14
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
15 1. It's easy to produce S16_NE stream directly from decoder's output special for vis_flow, as far as the latter has no output.
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
16 2. Switch equalizer and softvolume (and, in perspective, DSP PAPI) to floating-point. Another solution can cause precision
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
17 loss and avoid dithering. Why floating-point, not fixed? Because:
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
18 1. libsamplerate requires it.
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
19 2. Floating-point is standard for inter-component and inter-process audio exchange (LADSPA, JACK etc.).
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
20
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
21 Have a look at proposed_pipeline.dia
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
22
ec266557f845 Please read README.new_fmts
Eugene Zagidullin <e.asphyx@gmail.com>
parents:
diff changeset
23 -- asphyx