IC Imaging Control .NET

FrameExtensions.CreateBitmapCopy Method

FrameExtensions.CreateBitmapCopy Method

Creates a System.Drawing.Bitmap object and copies the image contents of the IFrame parameter into it.
Syntax:
[C#]
public static System.Drawing.Bitmap CreateBitmapCopy( this IFrame frm );
Parameter Description
frm

The IFrame to use for the Bitmap object.

Returns:

Either a pointer to a valid System.Drawing.Bitmap object or a nullptr if the IFrame parameter could not be converted to a Bitmap.

Remarks:

The Bitmap object returned is completly indepent of the IFrame used to create it, and can be used in any capacity.

The FrameType of the IFrame passed in must contain something that a Bitmap may handle. When FrameType.PixelFormat returns something undefined this method returns nullptr.

Note: FrameExtensions.CreateBitmapCopy copies the full image data, so it is slower then FrameExtensions.CreateBitmapWrap on the other hand, you cannot use a Bitmap created by FrameExtensions.CreateBitmapWrap without meticulous tracking its lifetime.

Information:

Introduced in version 3.5

See also: FrameExtensions, IFrame, IFrame.FrameType, FrameType.PixelFormat, FrameExtensions.CreateBitmapWrap

<< FrameExtensions

Get in touch with us


About The Imaging Source

Established in 1990, The Imaging Source is one of the leading manufacturers of industrial cameras, frame grabbers and video converters for production automation, quality assurance, logistics, medicine, science and security.

Our comprehensive range of cameras with USB 3.1, USB 3.0, USB 2.0, GigE interfaces and other innovative machine vision products are renowned for their high quality and ability to meet the performance requirements of demanding applications.

Automated Imaging Association ISO 9001:2015 certified

Contact us