InsertMovie

Description

Inserts a FlashBack movie into the currently open movie. The movie is inserted after the frame number passed to the method. So if you passed 100 as the frame number, the inserted movie would start at frame 101 in your current movie.

To insert a movie before frame zero (i.e. to add a movie to the start of your current movie), pass -1 as the frame number.

This method is accessible to the Pro and Advanced editions of the SDK only.
 

Syntax

[C#/C++]
public long InsertMovie (BSTR sFileName, long lFrameNum);

[VB.NET]
Public Function InsertMovie (ByVal sFileName As String, ByVal lFrameNum As Long) As Long

Parameters

sFileName : String containing filename of the FlashBack movie file to insert.

lFrameNum : the number of the frame at which to insert the movie.
 

Return Values

If the function fails, the return value is zero.

If the function succeeds, the return value is non-zero.
 

Remarks

Regardless of the dimensions of the inserted movie, the current movie maintains its dimensions. The inserted movie is centered within the current movie.

If the inserted movie is larger than the current movie, it is clipped. If the inserted movie is smaller than the current movie, black space is shown, filling the space between the edges of the inserted movie and the current movie.