SaveSequence (DVR version only)

Description

Saves the current memory sequence or its fragment in the specified AVI or TIFF file.


Syntax

[VB]
objActiveGige.SaveSequence File [, Start, End, FPS ])  

[C/C++]
HRESULT SaveSequence( bstr File, long Start, long End, float FPS );


Data Types [VB]

File: String
Start: Long
End: Long
FPS: Single

Parameters [C/C++]

File [in]

The string containing the file name and path. The extension of the file must be "avi" or "tif".

Start [in]

The zero-based index of the first frame of the fragment of the sequence to be saved. If omitted, frame 0 will be used.

End [in]

The zero-based index of the fragment of the sequence to be saved. If omitted, the last frame will be used.

FPS [in]

The frame rate to be assigned to the saved video. If zero or omitted, the recorded frame rate will be used.

   

Return Values

S_OK

Success

E_FAIL

Failure.

E_INVALIDARG

Invalid file name.

Example

This VB example records 1000 frames into the memory sequence and uses the CaptureCompleted event to save it in an AVI file.

Private Sub StartButton_Click()
ActiveGige1.StartSequenceCapture 1000
End Sub
Private Sub ActiveGige1_CaptureCompleted(ByVal Frames As Long)
SaveSequence "C:\\video.avi"
End Sub

Remarks

If the sequence is saved in the AVI format, the currently selected compression codec will be used.

If the external device (typically, a hard drive or memory card) doesn't have enough space to store the whole sequence, it will be truncated to accommodate the remaining space.