Vibrant Communicator ActiveX library version 3.0

vcproWaveRiffX

Reads audio stream from WAV file, producing PCM stream, or creates and writes new WAV file.

Set FileName property to valid file name. Set IsInput to true if you wish to read from WAV file. Set IsInput to false if you wish to write (create) into WAV file. Set Active to true to start reading or writing. Set Active to false to stop reading, or close the produced WAV file. Set RealTime to true if you wish the stream read from WAV file will be available in real-time manner.

Implements

IvcproWaveRiffX	default
IvcproWaveRiffEvents	default	source
IvcproProvider
IvcproConsumer

IvcproWaveRiffEvents (IDispatch)
Can be implemeted by client to hook events

Methods
void OnDataAvailable()	This method is fired every time component has produced or received new chunk of data. Use this event to access the stream data
void OnStreamIsDone()	This method is fired when no more data can be read from stream (and Loop = False)

IvcproWaveRiffX (IDispatch)
Dispatch interface for vcproWaveRiffX component

Methods
void Flush()	Completes processing of the last available data. Recommended to call before component closing
bool FormatChoose(BSTR Title, long Handle)	Creates an ACM-defined dialog box that enables the user to select a waveform-audio format. Title parameter indicates dialog's title, Handle - parent handle of dialog window. If Handle is 0 then ActiveX component handle is used
VARIANT GetData()	Reads available data from output stream. Usually used when OnDataAvailable event fires
long GetVolume(long Channel)	Returns current volume value. CalcVolume must be set to True. Pass Channel = 0/1 (left/right) for stereo and 0 for mono. Result values range is 0...300 (logarithmic scale)
void SetData(VARIANT* data)	Writes data to input stream
Properties
bool Active	Set to true to activate (open) the component. All other properties should be set to proper values before activation. Set to false to deactivate (close) the component
bool AutoActivate	When true tells the component it must activate consumer (if any) before activating itself. Same applies for deactivation. When false the component does not change the consumer state
bool CalcVolume	When true tells the component to calculate the audio volume of a stream coming into or from the component
long DataSizeIn	Returns data written into but not yet processed by the pipe
long DataSizeOut	Returns data size available to read from the pipe
BSTR DumpInput	File name to dump the component input data to
BSTR DumpOutput	File name to dump the component output data to
BSTR FileName	Specifies file name with WAVe file for Riff wave device
long FileSize	Returns file size in bytes
long FormatTag	Specifies audio format tag for the wave device
bool IsFormatProvider	When true the component will assign stream format to the consumer (if any). This simplifies the process of distributing stream format among linked components. For example WaveRiff component can assign PCM format to linked WaveOutDevice component, so WAVe file will be played back correctly
bool IsInput	Specifies whether Riff wave device is used for reading or writing the audio
bool Loop	Specifies whether wave stream should be looped from end to beginning
long OverNum	Specifies how many chunks of data component can store in input or output buffer, if data cannot be processed immediately. Every chunk holds 1/10 sec. of audio. Set this property to 0 to disable the buffer overflow checking (NOTE: be carefully, since this could lead to uncontrolled memory usage grow)
long PcmBitsPerSample	Specifies number of bits per sample for wave device
long PcmNumChannels	Specifies number of channels per sample for wave device
long PcmSamplesPerSec	Specifies number of samples per second for wave device
bool RealTime	Specifies whether device is working as real-time device
unaSilenceDetectionMode SilenceDetectionMode	No silence detection - unasdm_none. Obsolete approach - unasdm_VC. New approach based on dynamic speech processing - unasdm_DSP.
bool SyncEvents	Specifies whether events calls synchronized through main thread