GetStillHDIB Method

Summary

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

Syntax

C#
C++/CLI
public virtual IntPtr GetStillHDIB( 
   int timeOut 
) 
public:  
   virtual System::IntPtr GetStillHDIB( 
      Int32 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#
using Leadtools; 
using Leadtools.MediaFoundation; 
using LeadtoolsMediaFoundationExamples.Fixtures; 
 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(false); 
 
public void GetStillHDIBExample() 
{ 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   try 
   { 
      // set the video capture device, use your capture device name here 
      if (capturectrl.VideoDevices["USB"] == null) 
         throw new Exception("No USB video device available"); 
 
      capturectrl.VideoDevices["USB"].Selected = true; 
 
      // set the capture mode to still and start 
      capturectrl.StartCapture(CaptureMode.Still); 
 
      // capture device independent bitmap 
      IntPtr dib = capturectrl.GetStillHDIB(-1); 
 
      // stop the capture 
      capturectrl.StopCapture(); 
 
      _result = (dib != null); 
 
      //free allocated global memory 
      Marshal.FreeHGlobal(dib); 
   } 
   catch (COMException) 
   { 
      _result = false; 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 

Requirements

Target Platforms

See Also

CaptureCtrl Class

CaptureCtrl Members

Leadtools.MediaFoundation Namespace

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

Leadtools.MediaFoundation Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.