GetStillDIB Method

Summary

Gets a device independent bitmap during a CaptureMode.Still capture.

Syntax
C#
VB
C++
public virtual IntPtr GetStillDIB( 
   int timeOut 
) 
Public Overridable Function GetStillDIB( _ 
   ByVal timeOut As Integer _ 
) As IntPtr 
public: 
virtual IntPtr GetStillDIB(  
   int timeOut 
)  

Parameters

timeOut
A value containing the maximum time, in milliseconds, to wait for the image.

Return Value

System.IntPtr

Remarks

If the method succeeds, the caller must free the returned HDIB by calling the GlobalFree method. If TimeOut is -1, the method's time-out interval never elapses. If the method fails, an error is raised. For more information, refer to the Error Codes.

Example
C#
VB
using Leadtools; 
using Leadtools.MediaFoundation; 
using LeadtoolsMediaFoundationExamples.Fixtures; 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
public void GetStillDIBExample() 
{ 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   try 
   { 
      // set the video capture device, use your capture device name here 
      if (capturectrl.VideoDevices["Logitech"] == null) 
         throw new Exception("No Logitech video device available"); 
 
      capturectrl.VideoDevices["Logitech"].Selected = true; 
 
      // set the capture mode to still and start 
      capturectrl.StartCapture(CaptureMode.Still); 
 
      // capture device independent bitmap 
      IntPtr dib = capturectrl.GetStillDIB(-1); 
 
      // stop the capture 
      capturectrl.StopCapture(); 
 
      _result = (dib != null); 
 
      //free allocated global memory 
      Marshal.FreeHGlobal(dib); 
   } 
   catch (COMException) 
   { 
      _result = false; 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
Imports Leadtools 
Imports Leadtools.MediaFoundation 
Imports LeadtoolsMediaFoundationExamples.Fixtures 
 
Public _result As Boolean = False 
Public _form As New CaptureCtrlForm() 
 
Public Sub GetStillDIBExample() 
   ' reference the capture control 
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl 
 
   Try 
      ' set the video capture device, use your capture device name here 
      If capturectrl.VideoDevices("Logitech") Is Nothing Then 
         Throw New Exception("No Logitech video device available") 
      End If 
 
      capturectrl.VideoDevices("Logitech").Selected = True 
 
      ' set the capture mode to still and start 
      capturectrl.StartCapture(CaptureMode.Still) 
 
      ' capture device independent bitmap 
      Dim dib As IntPtr = capturectrl.GetStillDIB(-1) 
 
      ' stop the capture 
      capturectrl.StopCapture() 
 
      _result = (dib <> Nothing) 
 
      'free allocated global memory 
      Marshal.FreeHGlobal(dib) 
   Catch generatedExceptionName As COMException 
      _result = False 
   Catch generatedExceptionName As Exception 
      _result = False 
   End Try 
End Sub 

Requirements

Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.MediaFoundation Assembly