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

User Control: cAudioCDRipper

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

ConvertTo [Let] - Public


Set the format of the destination audio file:
MP3 - Rip to MP3 audio file.
ACM - Rip to ACM WAV audio file.
WMA - Rip to WMA audio file.
WAV - Rip to PCM WAV audio file.
OGG - Rip to OGG audio file.
APE - Rip to APE audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	eConvertTo

DestinationFileName [Let] - Public


Set the destination path and the file name.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

DeviceIndex [Let] - Public


Set the CD device index to rip from.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	Long

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


Get the CD device index to rip from.
No Parameters

Tag_Album [Let] - Public


Set the Albume tag for the destination audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

Tag_Artist [Let] - Public


Set the Artist tag for the destination audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

Tag_Comment [Let] - Public


Set the Comment tag for the destination audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

Tag_Genre [Let] - Public


Set the Genere tag for the destination audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

Tag_SongYear [Let] - Public


Set the SongYear tag for the destination audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

Tag_Title [Let] - Public


Set the Title tag for the destination audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

Tag_TrackNumber [Let] - Public


Set the TrackNumer tag for the destination audio file.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	String

TrackNumber [Let] - Public


Set the track number to rip.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	Value	Long

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


Get the track number to rip.
No Parameters

Subroutines

About - Public


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

DisplayRegistration - Public


Description: Display registration window.
No Parameters

Rip - Public


Description: Start to rip the selected audio cd to the choosen audio format.
Return: Nothing, if an error apears, the Error event will be raise.
No Parameters

SetACM - Public


Description: Set the properties of the ACM WAV format.

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

SetAPE - Public


Description: Set the properties of the APE format.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lCompressionLevel	Long

SetMP3 - Public


Description: Set the properties of the MP3 format.

Optional	ByVal/ByRef	Variable	Datatype
		MP3Properties	MP3_Properties

SetMP3Vals - Public


Set the new MP3 properties for C++.
Description: Set the MP3 target without using the MP3_Properties type (for C++, etc..).

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	ABRBitrate	Long
	ByVal	Bitrate	Long
	ByVal	CopyrightBit	Boolean
	ByVal	ErrorProtection	Boolean
	ByVal	Mode	MPEGMode
	ByVal	OriginalBit	Boolean
	ByVal	SampleRate	Long
	ByVal	Quality	Long
	ByVal	StrictISO	Boolean
	ByVal	VBR	VBRMode
	ByVal	VBRForceMinBitrate	Boolean
	ByVal	VBRMinBitrate	Long
	ByVal	VBRMaxBitrate	Long
	ByVal	VBRQuality	Long
	ByVal	WriteVBRTag	Boolean

SetOGG - Public


Description: Set the properties of the OGG format.

Optional	ByVal/ByRef	Variable	Datatype
		OGGProperties	OGG_Properties

SetOGGVals - Public


Description: Set the OGG target without using the OGG_Properties type (for C++, etc..).
Quality_Mode = 1
Bitrate_Mode = 2

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lMode	Long
	ByVal	lBitrateNominal	Long
	ByVal	lQuality	Long

SetWAV - Public


Description: Set the properties of the WAV format.

Optional	ByVal/ByRef	Variable	Datatype
		WAVProperties	WAV_Properties

SetWAVVals - Public


Description: Set the WAV target without using the WAV_Properties type (for C++, etc..).

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lSampleRate	Long
	ByVal	nChannels	Integer
	ByVal	nBitsPerSample	Integer

ShowAboutBox - Public

No Parameters

Functions

Cancel - Public (Return Datatype: Cancel())


Cancel the ripping progress.
No Parameters

CloseDrive - Public (Return Datatype: Boolean)


Description: Close the CD Drive.
Return: True if success, Flase if fail.
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

GetDevices - Public (Return Datatype: Collection)


Get the CDs devices listed on local system to the cDevices collection.
CheckLicense
No Parameters

GetDevicesX - Public (Return Datatype: Long)


Description: Get the CDs devices listed on local system.
Return: The number of the devices installed on the local machine.
No Parameters

GetDevicesXVal - Public (Return Datatype: String)


Description: Get the name and the description about the device by the lIndex
Return: A string with the device name and the description .

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lDeviceIndex	Long

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

IsAudioCD - Public (Return Datatype: Boolean)


Description: Check if the CD media is an audio CD.
Return: True if it is audio CD, Flase if not.
No Parameters

OpenDrive - Public (Return Datatype: Boolean)


Description: Open the CD Drive.
Return: True if success, Flase if fail.
No Parameters

SelectDevice - Public (Return Datatype: Boolean)


Description: Select the CD device to rip from.
Return: True if seccess to select the device, False if fail.
CheckLicense

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	DeviceIndex	Long

SetWMA - Public (Return Datatype: Boolean)


Description: Set the properties of the WMA format.

Optional	ByVal/ByRef	Variable	Datatype
		WMAProperties	WMA_Properties

SetWMAVals - Public (Return Datatype: Boolean)


Description: Set the WMAV target without using the WMAV_Properties type (for C++, etc..).

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lCodec	Long
	ByVal	lFormat	Long

TagCodecs - Public


Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sTagName	String

TagFormats - Public


Optional	ByVal/ByRef	Variable	Datatype
	ByVal	sTagFormat	String

TrackCount - Public (Return Datatype: Long)


Description: Get the number of tracks in the audio CD.
Return: The number of audio tracks in the audio CD.
No Parameters

TrackLength - Public (Return Datatype: String)


Description: Get the track time length for TrackIndex.
Return: The time length of the track in string.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	TrackIndex	Long

TrackLengthX - Public (Return Datatype: Long)


Description: Get the track time length for TrackIndex.
Return: The time length of the track in seconds.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	TrackIndex	Long

TrackType - Public (Return Datatype: Long)


Description: Get the track type.
Return: 1 for audio track, 2 for data track.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	TrackIndex	Long

WMACodecFormats - Public (Return Datatype: Collection)


Description: Get a list of WMA formats of the lCodecIndex.
Return: Collection type of list of WMA format.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lCodecIndex	Long

WMACodecFormatXVal - Public (Return Datatype: String)


Description: Get the WMA format name of the lCodecIndex by the lFormatIndex.
Return: A string with the codec name.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lCodecIndex	Long
	ByVal	lFormatIndex	Long

WMACodecs - Public (Return Datatype: Collection)


Description: Get a list of WMA codecs.
Return: Collection type of WMA codecs.
No Parameters

WMACodecsFormatsX - Public (Return Datatype: Long)


Description: Get a counter of the number of the formats by the lCodecIndex value.
Return: A long with a counter of the number of the codecs by the lCodecIndex.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lCodecIndex	Long

WMACodecsX - Public (Return Datatype: Long)


Description: Get a counter of the number of the WMA codecs that installed on the local machine.
Return: A long with a counter of the number of the WMA codecs.
No Parameters

WMACodecXVal - Public (Return Datatype: String)


Description: Get the WMA codec name by the lIndex.
Return: A string with the codec name.

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lIndex	Long

Event Declares

Aborted - Public


Raise when stop rip a track.
No Parameters

Done - Public


Raise when done rip a track.
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 rip(percent between 0 to 100).

Optional	ByVal/ByRef	Variable	Datatype
	ByVal	lPercent	Long