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

<< FrameExtensions