SaveSequence (DVR version only)
Top  Previous  Next

Description

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


Syntax


[VB]
objActiveDcam.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()
ActiveDcam1.StartSequenceCapture 1000

End Sub

 
Private Sub
 ActiveDcam1_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.