ACS_Converters

Classes which convert bit depth, sample rates, and stereo/mono.

Summary

ACS_Converters	Classes which convert bit depth, sample rates, and stereo/mono.
TRateConverter	Descends from TAuConverter.
Properties
FilterWindow	Use this property to set the window type for the filter.
KernelWidth	Use this property to set the width of the sinc kernel in points.
OutSampleRate	Use this property to set the output sample rate.
TNormalizer	Descends from TAuConverter.
Properties
StoreMode	TNormalizer needs a preprocessing data stage.
TmpFileName	The name of the temporary file that stores intermediate data in the nsmFile mode.
Enabled	If this property is set to False the component passes data through without scaling.
TDitherer	Descends from TAuConverter.
Properties
DitheringDepth	Use this property to set the number of bits that will contain the dithering noise.
DitheringAlgorithm
TAudioConverter	Descends from TAuConverter.
Properties
Mode	Mode property affects the way the mono stream is converted into stereo.
OutBitsPerSample	Use this property to set the number of bits per sample in the resulting audio stream.
OutChannels	Use this property to set the number of channels in the resulting audio stream.
TACMConverter	Descends from TAuConverter, an ACM-based converter.
Properties
OutBitsPerSample	Use this property to set the number of bits per sample in the resulting audio stream.
OutChannels	Use this property to set the number of channels in the resulting audio stream.
OutSampleRate	Use this property to set thesample rate of the resulting audio stream.

TRateConverter

Descends from TAuConverter. TRateConverter is an audio resampler. It uses windowed sinc kernel for changing audio sample rate and supports only 16-bit input. This component is kept for backward compatibility. In new projects it is recommended to use other resampler components instead.

Summary

Properties
FilterWindow	Use this property to set the window type for the filter.
KernelWidth	Use this property to set the width of the sinc kernel in points.
OutSampleRate	Use this property to set the output sample rate.

Properties

FilterWindow

Use this property to set the window type for the filter.

KernelWidth

Use this property to set the width of the sinc kernel in points.

OutSampleRate

Use this property to set the output sample rate.

TNormalizer

Descends from TAuConverter. TNormalizer scales audio data so that the highest peak in data is mapped to the maximum sample value avaiable.

Summary

Properties
StoreMode	TNormalizer needs a preprocessing data stage.
TmpFileName	The name of the temporary file that stores intermediate data in the nsmFile mode.
Enabled	If this property is set to False the component passes data through without scaling.

Properties

StoreMode

TNormalizer needs a preprocessing data stage. Depending on the StoreMode value the component can work in several modes.

nsmFile - the intermediate data is stored in a disc file (see the <TmpFileName> property).
nsmMemory - the intermediate data is stored in RAM.
nsmNone - no intermediate data is stored. In this mode the component reads the data from its input twice. This mode works only for inputs that can reproduce its data (TSreamedIn descendants).

TmpFileName

The name of the temporary file that stores intermediate data in the nsmFile mode.

Enabled

If this property is set to False the component passes data through without scaling.

TDitherer

Descends from TAuConverter. TDitherer converter adds dithering noise to the audio data passing through it. Dithering is usefull when performing audio samples truncation (with TAudioConverter for example) and other DSP operatins that involve rounding off. TDitherer uses seeveral dithering algorithms but none of them is perfect. I will be grateful for any dithering algorithms additions. If you want to use TDitherer together with TAudioConverter you should place it before TAudioConverter in the audio-processing chain.

Summary

Properties
DitheringDepth	Use this property to set the number of bits that will contain the dithering noise.
DitheringAlgorithm

Properties

DitheringDepth

Use this property to set the number of bits that will contain the dithering noise. For example, if you want to truncate audio samples from 24 bits per sample to 16 bits, set this value to 8. If the DitheringDepth value is set to 0 (the default value), the component switches to pass-through mode in which audio data will be passed through unmodified.

DitheringAlgorithm

Use this property to set the dithering algorithm. Possible values are

dtaRectangular (rectangle noise)
dtaTriangular (triangle noise)
dtaShaped1
dtaShaped2

TAudioConverter

Descends from TAuConverter. TAudioConverter component may be used for changing the number of channels and number of bits per sample in an audio stream.

Summary

Properties
Mode	Mode property affects the way the mono stream is converted into stereo.
OutBitsPerSample	Use this property to set the number of bits per sample in the resulting audio stream.
OutChannels	Use this property to set the number of channels in the resulting audio stream.

Properties

Mode

Mode property affects the way the mono stream is converted into stereo. If mode is msmMonoToBoth (which is the default) the data from the mono channel is copied into both stereo channels. If the mode is msmMonoToLeft or msmMonoToRight the data from the mono channel is put to one of the stereo channels while the other channel plays silence.

OutBitsPerSample

Use this property to set the number of bits per sample in the resulting audio stream. The valid values are 0, 8, 16, 24, and 32. If the property is set to 0 (the default) the converter preserves the original stream’s number of bits per sample.

OutChannels

Use this property to set the number of channels in the resulting audio stream. The valid values are 0, 1 (mono), and 2 (stereo). If the property is set to 0 (the default value) the converter preserves the original stream’s number of channels. If the number of input channels is greater than 2 the component cannot change it. Only number of bits per sample can be changed in this case.

TACMConverter

Descends from TAuConverter, an ACM-based converter. It may be used for changing the number of channels and number of bits per sample in an audio stream and resampling audio (at low quality). Unlike TAudioConverter, TACMConverter doesn’t work with 24 bps audio streams.

Summary

Properties
OutBitsPerSample	Use this property to set the number of bits per sample in the resulting audio stream.
OutChannels	Use this property to set the number of channels in the resulting audio stream.
OutSampleRate	Use this property to set thesample rate of the resulting audio stream.

Properties

OutBitsPerSample

Use this property to set the number of bits per sample in the resulting audio stream. The valid values are 0, 8, 16. If the property is set to 0 (the default) the converter preserves the original stream’s number of bits per sample.

OutChannels

OutSampleRate

Use this property to set thesample rate of the resulting audio stream. The valid values are 0 and something between 2000-12000. If the property is set to 0 (the default value) the converter preserves the original stream’s sample rate.