BitmapDataExtensionsMakeTransparent(IReadWriteBitmapData, ParallelConfig) Method

If possible, makes the background of this bitmapData transparent, taking the bottom-left pixel as the background color. If the bitmapData does not support transparency, then the pixels that have the same color as the bottom-left pixel will be set to the BackColor of bitmapData.

Definition

Namespace: KGySoft.Drawing.Imaging
Assembly: KGySoft.Drawing.Core (in KGySoft.Drawing.Core.dll) Version: 10.0.0-rc.1

C#

public static bool MakeTransparent(
	this IReadWriteBitmapData bitmapData,
	ParallelConfig? parallelConfig
)

VB

<ExtensionAttribute>
Public Shared Function MakeTransparent ( 
	bitmapData As IReadWriteBitmapData,
	parallelConfig As ParallelConfig
) As Boolean

C++

public:
[ExtensionAttribute]
static bool MakeTransparent(
	IReadWriteBitmapData^ bitmapData, 
	ParallelConfig^ parallelConfig
)

F#

[<ExtensionAttribute>]
static member MakeTransparent : 
        bitmapData : IReadWriteBitmapData * 
        parallelConfig : ParallelConfig -> bool

Parameters

bitmapData IReadWriteBitmapData: The IReadWriteBitmapData to make transparent.
parallelConfig ParallelConfig: The configuration of the operation such as parallelization, cancellation, reporting progress, etc. When Progress is set in this parameter, then this library always passes a DrawingOperation instance to the generic methods of the IAsyncProgress interface. If , then the degree of parallelization is configured automatically.

Return Value

Boolean
, if the operation completed successfully.
, if the operation has been canceled and the ThrowIfCanceled property of the parallelConfig parameter was .

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IReadWriteBitmapData. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

Note

This method blocks the caller as it executes synchronously, though the parallelConfig parameter allows configuring the degree of parallelism, cancellation and progress reporting. Use the BeginMakeTransparent(IReadWriteBitmapData, AsyncConfig) or MakeTransparentAsync(IReadWriteBitmapData, TaskConfig) (in .NET Framework 4.0 and above) methods to perform the operation asynchronously.

Unlike the Bitmap.MakeTransparent method, this one preserves the original PixelFormat. If bitmapData does not support transparency and cannot set Palette either, then every occurrence of the color of the bottom-left pixel will be changed to the BackColor of bitmapData. To make such bitmaps transparent use the ToTransparent method instead, which returns a new instance that has a PixelFormat with alpha support.

To force replacing even non-completely opaque pixels use the MakeTransparent(IReadWriteBitmapData, Color32) overload instead.