ScenesAdd Method (IMScenes)

Adds a new scene.

Syntax

VB.Net
C#
Delphi
C++

Sub ScenesAdd( _
   ByVal _bsXMLDescOrPathName As String, _
   ByRef _pbsSceneID As String, _
   ByRef _ppScene As IMElements _
)

void ScenesAdd( 
   string _bsXMLDescOrPathName,
   out string _pbsSceneID,
   out IMElements _ppScene
)

procedure ScenesAdd( 
    _bsXMLDescOrPathName: String;
   Out  _pbsSceneID: String;
   Out  _ppScene: IMElements
);

void ScenesAdd( 
   BSTR* _bsXMLDescOrPathName,
   [PARAMFLAG::Out] BSTR* _pbsSceneID,
   [PARAMFLAG::Out] IMElements* _ppScene
)

Parameters

_bsXMLDescOrPathName: description of the scene as XML string or path to file with the description
_pbsSceneID: ID of the scene
_ppScene: scene object

Example

Here is example of how to add a scene and set this scene as active in your mixer:

Visual Basic
C#
Delphi

'initialize mixer
Dim myMixer As MMixeerClass = New MMixerClass()
myMixer.ObjectStart(Nothing)
Dim pScene As IMElements
myMixer.ScenesAdd("copy_active='true'", mySceneID, pScene)
myMixer.ScenesActiveSet(mySceneID, "")

//initialize mixer
MMixeerClass myMixer = new MMixerClass();
myMixer.ObjectStart(null);
IMElements pScene;
myMixer.ScenesAdd("copy_active='true'", out mySceneID, out pScene);
myMixer.ScenesActiveSet(mySceneID, "");

var
myMixer: MMixer;
myScenes: IMScenes;
myObject: IMObject;
myScene: IMElements;
mySceneID: string;
begin
myMixer:= CreateComObject(CLASS_MMixer) as MMixer;
myObject:= myMixer as IMObject;
myObject.ObjectStart();
myScenes := myMixer as IMScenes;
myScenes.ScenesAdd('copy_active=true', mySceneID, myScene);
myScenes.ScenesActiveSet(mySceneID, '');
end;

Reference

IMScenes Interface
IMScenes Members