GetSequencePicture (DVR version only)

Description

Returns a Picture object representing a selected frame in the memory sequence.


Syntax

[VB]
Value=objActiveDcam.GetSequencePicture( Frame )

[C/C++]
HRESULT GetSequencePicture(long iFrame, IPictureDisp* *pPicture);


Data Types [VB]

Long: Frame
Return value: Picture


Parameters [C/C++]

iFrame

The zero-based index of the frame for which a Picture object will be created

pPicture

Pointer to the IPictureDisp interface object

Return Values

S_OK

Success

E_FAIL

Failure

E_INVALIDARG

Invalid frame index

Example


This VB example demonstrated how to display the 15th frame from the memory sequence in a picture box:
Picture1.Picture=ActiveDcam1.GetSequencePicture (15)

Remarks

The GetSequencePicture method provides allows you to display frames from the memory sequence in popular graphic controls such as PictureBox. Note that a Picture object contains only 8-bit pixel values, even if the current video mode is a 16- or 48-bit one. To access the actual pixel data, use the GetSequenceData or GetSequencePointer methods.