StartSequenceCapture (DVR version only)
Top  Previous  Next


Starts acquiring a sequence of frames into the memory. Use StopSequenceCapture to end the sequence capture process.


objActiveDcam.StartSequenceCapture Frames [, Timelapse = 0 ]

HRESULT StartSequenceCapture( bstr File, float Timelapse);

Data Types [VB]

Frames : String
Timelapse : Single (optional)


Frames [in]  
The maximum number of frames to capture.  
Frames>0 - sequence capture will stop automatically after the specified number of frames is reached, unless StopSequenceCapture is called before that.  
Frames<0 - loop recording mode; when the specified number of frames is reached, the capture will continue in a loop until StopSequenceCapture is called.  
Timelapse [in]  
The interval between consecutive frame acquisitions in seconds. If zero or not specified, the sequence will be captured at the current frame rate.  

Return Values

Invalid file name.  


This VB example demonstrates how to capture the video loop into the system memory at the current frame rate. The maximum sequence size is set to 1000 frames:

Private Sub
ActiveDcam1.StartSequenceCapture -1000

End Sub

Private Sub

End Sub


During the sequence capture the FrameRecorded event will be generated per each frame recorded into the memory.

In the loop recording mode (Frames < 0) after the frame limit is reached, ActiveDcam will maintain the specified number of recorded frames in the memory by removing a frame from the head of the sequence and adding the latest frame to its tail. Thus, in the example above, at any given moment the sequence will contain the most recent 1000 frames.

To reduce the memory consumption, ActiveDcam records frames in a sequence in the original raw image format. When the sequence is played back, its frames are converted to a regular monochrome or RGB format on the fly. See PlayVideo for more details.

If Timelapse is not specified, the sequence will be recorded at the maximum frame rate defined by the camera settings and system throughput.