This class enables you to convert a bitmap from one pixel format to another one.

The following tables list the members exposed by the PixelFormatConverter type.

Public Methods

  NameDescription
{dtor}
Enables using delete operator in C++ applications. It is strongly not recommended to use it directly.
(Overrides {dtor}().)
Abort
Aborts current operation.
(Inherited from SyncHandler.)
ApplyTransformOverloaded.
Transforms given bitmap.

Continue
Resumes execution of the operation previously paused with Pause() method.
(Inherited from SyncHandler.)
ConvertArrayOverloaded.
Converts several colors into another color space. These colors are represented by array.

ConvertColorOverloaded.
Converts Color value into another color space.

Dispose
Releases all resources used by this PixelFormatConverter.
(Overrides Dispose().)
Equals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
GetHashCode
Serves as a hash function for a particular type. GetHashCode() is suitable for use in hashing algorithms and data structures like a hash table.
(Inherited from Object.)
GetType
Gets the Type of the current instance.
(Inherited from Object.)
IsPixelFormatSupported
Verifies if bitmap with specified pixel format is supported by this transform.
(Inherited from BitmapTransform.)
Lock
Locks the object.
(Inherited from SyncHandler.)
Pause
Pauses execution of the current operation.
(Inherited from SyncHandler.)
ToString
Returns a String that represents the current Object.
(Inherited from Object.)
Unlock
Unlocks the object previously locked with method Lock().
(Inherited from SyncHandler.)
WaitForCompletion
Suspends the calling thread until the operation currently run is completed.
(Inherited from SyncHandler.)

Protected Methods

  NameDescription
MemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
ResetEventsHostSettings (Inherited from SyncHandler.)

Public Constructors

  NameDescription
PixelFormatConverterNew
Creates and initializes new PixelFormatConverter class instance.

Public Properties

  NameDescription
BackgroundColor
Gets/sets a background color used when alpha channel is flatten.

BackgroundEnabled
Gets/sets value that specifies if it is necessary to use BackgroundColor value to flatten alpha channel when converting from pixel format with alpha to pixel format without it.

BuildAdaptivePaletteWithAlpha
Gets/sets a value which specifies whether the alpha channel should be taken into account when building an adaptive palette.

CmykColorProfile
Gets/sets an output color profile which is used to convert bitmap to CMYK color space.

ColorManagementEngine
Gets/sets color management engine (module) which will be used during image transformation. Graphics Mill for .NET supports the following engines: LittleCMS and Adobe CMM. The property also allows to disable color management and perform transformation without color matching.

ColorQuantizationAlgorithm
Gets/sets a color quantiztion algorithm used to reduce colors.

Completed
Returns value indicating if the operation is currently running.
(Inherited from SyncHandler.)
CustomPalette
Gets/sets a custom palette used during conversion to indexed pixel formats.

DestinationPixelFormat
Gets/sets a destination pixel format.

Dithering
Gets/sets dithering algorithm used when performing conversion to indexed pixel format.

DitheringIntensity
Gets/sets dithering intensity used when performing conversion to indexed pixel format.

ExceptionThrowEnabled
Gets/sets value that specifies if to throw exception in synchronous mode.
(Inherited from SyncHandler.)
GrayScaleColorProfile
Gets/sets an output color profile which is used to convert bitmap to grayscale color space.

Locked
Indicates if the object has been locked.
(Inherited from SyncHandler.)
Opacity
Gets/sets a value which will initialize alpha channel when converting from pixel format which does not support alpha to pixel format which does.

PaletteAlphaThreshold
Gets/sets a value which specifies the alpha threshold.

PaletteAlphaThresholdUsed
Gets/sets a value which specifies whether the alpha threshold should be used when building an adaptive palette.

PaletteEntryCount
Gets/sets the maximum number of colors in palette that should be used when performing conversion to an indexed pixel format.

PaletteType
Gets/sets a value that specifies a palette used when performing conversion to indexed pixel format.

Priority
Gets/sets a priority for the auxilary thread.
(Inherited from SyncHandler.)
QuantizationTo8bBitsUsed
Gets/sets the number of bits which are in fact used for this channel.

QuantizationTo8bOffset
Gets/sets the offset on which intensity of a pixel will be calculated.

QuantizationTo8bScale
Gets/sets the range in which pixel intensity values will vary.

RgbColorProfile
Gets/sets an output color profile which is used to convert bitmap to RGB color space.

SupportedPixelFormats
Returns an array of pixel formats that are supported by this transform.
(Inherited from BitmapTransform.)
SynchronizationMode
Gets/sets synchronization mode for the object.
(Inherited from SyncHandler.)
TargetColorProfile
Gets/sets target device profile used for chain transformations.

Timeout
Gets/sets value specifying maximum time for which object can be locked.
(Inherited from SyncHandler.)
TransformationIntent
Gets/sets rendering intent used during color management.

Unit
Gets/sets unit used to measure all the coordinates, sizes and other spatial values.
(Inherited from UnitConverterHandler.)

Public Events

  NameDescription
Continued
Fires when operation has been resumed with Continue() method.
(Inherited from SyncHandler.)
Paused
Fires when operation has been paused with Pause() method.
(Inherited from SyncHandler.)
Progress
Fires on the operation progress notifications.
(Inherited from SyncHandler.)
Stopping
Fires before operation is stopped.
(Inherited from SyncHandler.)

Protected Events

  NameDescription
Aborted
Fires when operation has been aborted.
(Inherited from SyncHandler.)
Started
Fires after operation has been started.
(Inherited from SyncHandler.)
Starting
Fires before operation is started.
(Inherited from SyncHandler.)
Stopped
Fires after operation has been stopped.
(Inherited from SyncHandler.)

See Also