By: Yaron Goali (WISERBIT DOT COM) for Microncode.com

User Control: cACMConverter

VB6ACMConverter is an OCX component that can convert ACM WAV files from one format to another.
Supported formats are: AC3, CCITT A-Law, CCITT u-Law, DivX WMA Audio V1 or V2, DSP Group True Speech, GSM 6.10, IAC2, Lame MP3, Microsoft ADPCM, MSN Messenger Audio Codec, OGG Vorbis (All modes), PCM, and any other ACM format that installed on the local PC.
Also, this AX can change the bit rate, the channels, the sample rate and more of an existing WAV file, supports many events, runs fast and easy to use.

Home Page:
https://www.microncode.com


This CHM file contains the documentation and the description about all the functions/events/properties this component is using.

For more information about how to operate this component, please look inside the samples.

The samples of this component contains a clearly and easy to understand source code with a description for each line.

If you need more help, feel free to contact us via: https://www.microncode.com/support/

Properties

ConvertLengthSec [Let] - Public


Set the length to convert in seconds.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	RHS	Long

ConvertStartFromSec [Let] - Public


Set the second to start convert from.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	RHS	Long

Destination [Let] - Public


Set the destination of the file to convert.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	RHS	String

Info_Bitrate [Get] - Public (Return Datatype: Long)


Bitrate file info
No Parameters

Info_BitsPerSample [Get] - Public (Return Datatype: Long)


BitsPerSample file info
No Parameters

Info_Channels [Get] - Public (Return Datatype: Integer)


Channels file info
No Parameters

Info_Duration [Get] - Public (Return Datatype: Long)


Duration file info
No Parameters

Info_NameTag [Get] - Public (Return Datatype: String)


Format name of opened file
No Parameters

Info_Samplerate [Get] - Public (Return Datatype: Long)


Samplerate file info
No Parameters

Info_TagNumber [Get] - Public (Return Datatype: Long)


ACM tag file info
No Parameters

SourceFile [Let] - Public


Set the source file to convert.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	RHS	String

Subroutines

About - Public


Description: Display About message box with the license details.
No Parameters

Convert - Public


Description: Start the conversion.
Return: Nothing, if an error apear, the Error event will be fire.
No Parameters

DisplayRegistration - Public


Description: Display registration window.
No Parameters

SetFormat - Public


Description: Set the format of the destination by the Tag and the Format names.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sTag	String
	ByVal	sFormat	String

SetFormatDialog - Public


Description: Set the format of the destination by the default windows dialog.

Optional	ByVal/ByRef	Variable	Datatype
		sRetTag	String
		sRetFormat	String
	ByVal	lSampleRate	Long
	ByVal	lChannels	Integer
	ByVal	lBitsPerSample	Integer
	ByVal	lhwndOwner	Long
	ByVal	sTitle	String

ShowAboutBox - Public

No Parameters

Functions

Cancel - Public (Return Datatype: Cancel())


Description: Cancel the conversion proccess.
No Parameters

CloseFile - Public (Return Datatype: CloseFile())


Added : 18/10/2006
Calose the stram so the source file can be deleted
at the end of the proccess.
No Parameters

ConvertX - Public (Return Datatype: Long)


Description: Start the conversion, the next code line will operate when the conversion is done.
Return: Nothing, if an error apear, the Error event will be fire.
No Parameters

DeInit - Public (Return Datatype: Long)


Description: DeInit the component, must be call before closing the program.
Return: 0 if success, otherwise a number describe the error.
No Parameters

GetFormatsByTag - Public (Return Datatype: Long)


Description: Get the formats of the sTagsName.
Return: Formats collection of the ACM tag name.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sTagsName	String

GetTagInfo - Public (Return Datatype: String)


Description: Get information about sTagName.
Return: String that describe the information about tag name.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sTagName	String

GetTags - Public (Return Datatype: Long)


Description: Get all the ACM tags that installed on the local machine.
Return: Collection of ACM tags.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lFormatTag	Long
	ByVal	lSamplesPerSec	Long
	ByVal	lChannels	Long
	ByVal	lBitsPerSample	Long
	ByVal	eTagMode	eTagsMode

Init - Public (Return Datatype: Long)


Description: Init the component, must be call before using any functionality of the component.
Return: 0 if success, otherwise a number describe the error.

Optional	ByVal/ByRef	Variable	Datatype
Optional	ByVal	sKey	String

OpenFile - Public (Return Datatype: Long)


Change : 18/10/2006
Set the OpenFile function to public.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	strFile	String

SecondsAsTimeString - Public (Return Datatype: String)


Get time length in seconds and return somthing like 02:22.08

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lSeconds	Long

TagCodecs - Public


Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sTagName	String

TagFormats - Public


Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sTagFormat	String

Event Declares

Aborted - Public


Raise when the converting proccess has aborted.
No Parameters

Done - Public


Raise when the converting proccess has done.
No Parameters

Error - Public


Error handling: ErrNum - error number, ErrDescription - error description.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lErrNum	Long
	ByVal	sErrDescription	String

Progress - Public


The progress of the conversion (percent between 0 to 100).

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lPercent	Long