Copyright © 2011-2018 MultiMedia Soft

MixAutomationItemAddFromEditor method

Previous pageReturn to chapter overviewNext page

Remarks

 

Adds contents of an editing session belonging to another instance of Audio Sound Editor to the mixing automation list.

 

For further information about management of append automation sessions refer to the How to mix or append several sounds in one single shot tutorial.

 

 

Syntax

 

[Visual Basic]

Public Function MixAutomationItemAddFromEditor (

hWndEditorCtrl as IntPtr,

nStartPosition as Int32,

nEndPosition as Int32,

fVolume as Single,

nMixPosition as Int32

) as enumErrorCodes


 

[C#]

public enumErrorCodes MixAutomationItemAddFromEditor (

IntPtr hWndEditorCtrl,

Int32 nStartPosition,

Int32 nEndPosition,

float fVolume,

Int32 nMixPosition

);


 

[C++]

public: enumErrorCodes MixAutomationItemAddFromEditor (

IntPtr hWndEditorCtrl,

Int32 nStartPosition,

Int32 nEndPosition,

float fVolume,

Int32 nMixPosition

);


 

 

Parameter

Description

 

 

hWndEditorCtrl

The value to pass to this parameter depends upon the nature of the editor control that will provide the sound:

- If the editor is an instance created through Audio Sound Editor for .NET, use the Windows handle (Handle property) of the instance

- If the editor is another instance of Audio Sound Editor API for .NET, use the identifier of the instance returned by its GetEditorInstanceId method

nStartPosition

Start position, expressed in milliseconds, of the range to load from the added editing session

nEndPosition

End position, expressed in milliseconds, of the range to load from the added editing session

fVolume

Volume level applied to the added song when it will be appended.

Supported values are expressed with a linear volume in the range from 0 to 100. In case you should need to set a volume expressed in dB, before setting this parameter you could convert the value in dB into a linear value through the following formula (C syntax):

VolumeLinear = 100 * pow (10, VolumeInDB/20);

nMixPosition

Position, expressed in milliseconds, inside the destination sound where the added editing session will be mixed

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred. Check the LastError property value in order to see the last error.

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.