Methods > Editors > JoinFilesFromDisk method

Remarks

Joins two mono sound files into a single output stereo file keeping them separated inside left and right channel. The sound encoding format is defined inside the EncodeFormats.FormatToUse property.

A joining session can be stopped at any time through a call to the CancelJoinFilesFromDisk method.

If the EncodeFormats.FormatToUse property is set to ENCODING_FORMAT_WAV, the joining will only work if the EncodeFormats.WAV.EncodeMode property is set to a format supporting stereo meaning that, for example, it will not work for mono-only formats like WAV_ENCODE_GSM_610 or WAV_ENCODE_G721_ADPCM_32.

If the EncodeFormats.FormatToUse property is set to ENCODING_FORMAT_AIFF, the joining will only work if the EncodeFormats.AIFF.EncodeMode property is set to a format supporting stereo meaning that, for example, it will not work for mono-only formats like AIFF_ENCODE_GSM_610.

If the EncodeFormats.FormatToUse property is set to ENCODING_FORMAT_AU, the joining will only work if the EncodeFormats.AU.EncodeMode property is set to a format supporting stereo meaning that, for example, it will not work for mono-only formats like AU_ENCODE_G721_ADPCM_32 or AU_ENCODE_G723_ADPCM_24 or AU_ENCODE_G723_ADPCM_40.

If the EncodeFormats.FormatToUse property is set to ENCODING_FORMAT_ACM, the joining will only work if the selected codec supports stereo meaning that, for example, it will not work for mono-only codecs like GSM 6.10 or G721 ADPCM.

A successful call to this method will fire the SoundsJoinStarted event followed by a number of SoundsJoinPerc events and finally by the SoundsJoinDone event.

Syntax

[Visual Basic]

control.JoinFilesFromDisk (

nOutputFrequency as Long,

strPathnameLeft as String,

nOffsetLeftInMs as Long,

strPathnameRight as String,

nOffsetRightInMs as Long,

strPathnameOutput as String

) as enumErrorCodes

[C++]

short control.JoinFilesFromDisk (

long nOutputFrequency,

LPCTSTR strPathnameLeft,

long nOffsetLeftInMs,

LPCTSTR strPathnameRight,

long nOffsetRightInMs,

LPCTSTR strPathnameOutput

);

Parameter	Description

nOutputFrequency	Resampling frequency for the output file.
strPathnameLeft	String containing the absolute pathname of the first input mono file that will be stored inside the left channel of the output stereo file. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.
nOffsetLeftInMs	Offset expressed in milliseconds at which the first input mono file will be stored inside the output stereo file.
strPathnameRight	String containing the absolute pathname of the second input mono file that will be stored inside the right channel of the output stereo file. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.
nOffsetRightInMs	Offset expressed in milliseconds at which the second input mono file will be stored inside the output stereo file.
strPathnameOutput	String containing the absolute pathname of the output stereo file. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to see the error code meaning
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.