GetSequencePicture (DVR version only)
Top  Previous  Next

Description

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


Syntax


[VB]
Value=objActiveUSB.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 [out,retval]  
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=ActiveUSB1.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.