System Requirements

• windows 95/98/Me/2000/XP/Vista

Installation

• Extract files into permanent directory.
• Run install.bat to register ActiveX control.

Removing Sound Converter ActiveX

• Run uninstall.bat to unregister ActiveX control.
• Remove the directory you created previously.

Distribution of Sound Converter ActiveX

When distributing your application, you need to:

• copy sndConverter.ocx to your application installation directory.
• register it with install.bat command.

No other files and actions are needed. We would appreciate if you mention us in your "About" window (not required).

License

See license.txt file included in the package.

Registration

Unregistered version of Sound Converter ActiveX stops functioning in 10 minutes after control was created in memory. You need to register the control in order to get rid of this restrinction. After registering, you will receive three numbers that you need to pass to the ActiveX control via Register() method. Below you will find more information.

It's better way to drop Sound Converter ActiveX on the form in design mode. Your IDE will do all needed job in order to support it.

You can freely create more than one instance of Sound Converter ActiveX.

BSTR SourceFile

Full path to source WAV file. File must exist and be available for reading.

BSTR DestinationFile

Full path to destination WAV file.

BSTR CodecName

Audio codec name. This is read-only value, do not attempt to change it directly. Use one of the following methods instead: ChooseCodec, LoadFormat, BrowseFormat, SetPCM, SuggestPCM, Properties.

LASTERR LastError

Last error occured during latest method call. It is one of LAST_ERROR_* contants.

VARIANT_BOOL Start()

Starts sound conversion process. Function returns True if converter created successfully. The funcion is asynchronous.

void Stop()

Breaks conversion and releases all system resources used by converter.

VARIANT_BOOL ChooseCodec()

Pops up standard Windows dialog box that allows to choose audio codec. Returns TRUE if user pushed OK button on the dialog box.

VARIANT_BOOL LoadFormat(BSTR FileName)

Loads codec format from external file.

VARIANT_BOOL BrowseFormat()

Pops up a file selection dialog box, and then loads codec format from external file.

VARIANT_BOOL SaveFormat(BSTR FileName)

Saves current file format to a file.

VARIANT_BOOL SaveFormatAs()

Pops up "Save As" dialog box, and saves current format into selected file.

VARIANT_BOOL SetPCM(long SampleRate, long NumBits, long NumChannels)

Specifies that the destination file format should be PCM.

VARIANT_BOOL SuggestPCM()

Sometimes direct conversion between two formats is not possible. You need to use three-step converstion (source -> PCM1 -> PCM2 -> destination). This methods suggests PCM1 format.

VARIANT_BOOL Properties()

Pops up a Sound Converter ActiveX tuning window. Returns True if user pressed Ok button on the dialog box.

VARIANT_BOOL Register(long Code1, long Code2, long Code3)

This function unlocks program to fully registered version without any restrinctions. Code1, Code2, Code2 are numbers you have got after filling in online order form. Returns True if specified numbers are correct, and program is registered.

void AboutBox()

Pops up About window with information about version, release date, and contact information about the control.

void OnBegin()

Container will receive it right after successful call to Start method.

void OnEnd()

Container will receive it either right after successful call to Stop method or after file conversion was successfully done.

void OnProgress(long PerCent)

Container will receive it periodically in order to learn about conversion process. PerCent is a per cent value in range 0....100.

Home · Online Help · Download · Order