This class represents bitmap, i.e. object which stores raster data.

The following tables list the members exposed by the Bitmap 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 currently running operation.

Clear
Clears the image and sets all pixels to the specified color.

ClearHistory
Discards both undo and redo history.

ClearRedoHistory
Discards redo history.

ClearUndoHistory
Discards undo history.

Clone
Creates a full copy of bitmap. All the bitmap data and object properties are copied.

CreateOverloaded.
Discards old bitmap data and creates new bitmap

Deserialize
Deserializes the bitmap object.

Dispose
Releases all resources used by this Bitmap.
(Overrides Dispose().)
DrawOverloaded.
Draws a bitmap on various surfaces as Bitmap, GdiGraphics, System.Drawing.Graphics classes, or Windows GDI device context.

Equals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Export
Returns pixels of bitmap as 3D array.

static memberFromClipboard
Extracts the image data from the clipboard and creates the Bitmap class instance containing this image data.

static memberFromHdc
Extracts the image data from the specified device context and creates the Bitmap class instance containing this image data.

GetEmptyMask
Returns grayscale image of the same size as current bitmap filled with black color. It can be used as mask template for transforms.

GetGdiGraphics
Returns GdiGraphics object associated with this Bitmap.

GetGdiplusGraphics
Returns System.Drawing.Graphics object associated with this Bitmap.

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.)
GetObjectData
Populates a SerializationInfo with the data needed to serialize the Bitmap object.

GetPixel
Returns pixel value at specified coordinates.

GetType
Gets the Type of the current instance.
(Inherited from Object.)
HorizontalPixelsToUnits
Converts horizontal value from pixels to unit specified in Unit property.
(Inherited from UnitConverterObject.)
HorizontalUnitsToPixels
Converts horizontal value from unit specified in Unit property to pixels.
(Inherited from UnitConverterObject.)
ImplicitOverloaded.
Cast this instance of the Aurigma.GraphicsMill.Bitmap to System.Drawing.Bitmap or vice versa.

Import
Fills pixels of the current bitmap from given 3D array.

LoadOverloaded.
Loads the bitmap from some external source.

LoadFromClipboard
Loads the bitmap from the clipboard.

LoadFromHdc
Captures a bitmap from the specified device context.

LoadThumbnailOverloaded.
Loads the thumbnail from specified file on-the-fly.

Lock
Locks the object.
(Inherited from LockableObject.)
LockBitsOverloaded.
Locks a rectangular area of the bitmap and returns BitmapData object which provides direct access to pixels (without copying).

RedoOverloaded.
Redoes last undone change.

SaveOverloaded.
Saves the bitmap into specified file.

SaveState
Saves state of the object.

SaveToClipboard
Saves the bitmap into the clipboard.

Serialize
Serializes the bitmap object.

SetPixel
Sets pixel value at the specified coordinates.

ToGdiplusBitmap
Returns System.Drawing.Bitmap containing a copy of the image stored in current Bitmap class instance.

ToGdiplusBitmapDirectly
Returns System.Drawing.Bitmap which references to the same bitmap data as the current Bitmap class instance.

ToString
Returns a String that represents the current Object.
(Inherited from Object.)
UndoOverloaded.
Undoes last made change.

Unload
Unloads bitmap data.

Unlock
Unlocks the object previously locked with method Lock().
(Inherited from LockableObject.)
UnlockBits
Unlocks previously locked area of bitmap with LockBits(Int32, Int32, Int32, Int32) method.

VerticalPixelsToUnits
Converts vertical value from pixels to unit specified in Unit property.
(Inherited from UnitConverterObject.)
VerticalUnitsToPixels
Converts vertical value from unit specified in Unit property to pixels.
(Inherited from UnitConverterObject.)

Protected Methods

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

Public Constructors

  NameDescription
BitmapNewOverloaded.
Creates empty Bitmap instance.

Public Properties

  NameDescription
BitsLocked
Indicates if pixels are locked with LockBits(Int32, Int32, Int32, Int32).

BitsPerPixel
Returns number of bits per pixel.

CanRedo
Indicates if last reverted action can be redone.

CanUndo
Indicates if last bitmap modification can be undone.

Channels
Returns object which provides access to various operations with bitmap channels.

ColorAdjustment
Returns object providing methods which are responsible for color adjustment and tone correction (brightness/contrast, levels, hue/saturation/lightness adjustment, etc.).

ColorManagement
Returns object providing methods which are responsible for color management.

ColorProfile
Gets/sets color profile associated with the bitmap.

ColorSpace
Indicates color space of the current bitmap.

CompressSerializedData
Gets/sets a value that specifies whether to compress data during serialization.

Handle
Gets a GDI handle to the bitmap (HBITMAP).

HasAlpha
Specifies whether current pixel format supports alpha channel (information about opacity of pixels).

Height
Returns current bitmap height in pixels.

HorizontalResolution
Specifies horizontal resolution of the image (also known as DPI, dots per inch).
(Inherited from UnitConverterObject.)
IsCmyk
Indicates if color space of current bitmap is CMYK.

IsDisposed (Inherited from LockableObject.)
IsEmpty
Indicates if bitmap is empty (no bitmap data loaded).

IsExtended
Indicates if current pixel format is extended (i.e. 16 bits per channel).

IsGrayScale
Indicates if color space of current bitmap is grayscale.

IsIndexed
Indicates if current bitmap is indexed (palette-based).

IsRgb
Indicates if color space of current bitmap is RGB.

Locked
Indicates if the object has been locked.
(Inherited from LockableObject.)
LogicalHeight
Returns current bitmap height in units specified with Unit property.

LogicalWidth
Returns current bitmap width in units specified with Unit property.

MaxUndoStepCount
Gets/sets maximum number of available undo steps (levels).

MemoryUsed
Returns a number of bytes occupied with pixels of this Bitmap.

Modified
Indicates if the bitmap was changed since last saving.

Palette
Returns palette accosiated with bitmap.

PixelFormat
Returns pixel format of the current bitmap.

RedoStepCount
Returns number of available redo levels (i.e. how much time method Redo() can be called).

Statistics
Returns an object providing methods which retrieves bitmap stats (like histogram, etc).

Timeout
Gets/sets value specifying maximum time for which object can be locked.
(Inherited from LockableObject.)
Transforms
Returns object providing methods which are responsible for geometric transformations of the bitmap (resize, rotate, crop, swirl, etc).

UndoRedoEnabled
Enables or disables undo/redo functionality.

UndoRedoTrackingEnabled
Enables or disables the automatic change tracking.

UndoStepCount
Returns number of available undo levels (i.e. how much time method Undo() can be called).

Unit
Gets/sets unit to convert from/to.
(Inherited from UnitConverterObject.)
VerticalResolution
Specifies vertical resolution (also known as DPI, dots per inch).
(Inherited from UnitConverterObject.)
Width
Returns current bitmap width in pixels.

Public Events

  NameDescription
Changed
Fires when the bitmap was modified (after the end of an operation).

Changing
Fires before an image is being modified (before the start of an operation).

Redoing
Fires when image is being redone (before starting).

Saved
Fires when the image has been saved (after finishing).

StateRestored
Fires when the bitmap state is restored (redone or undone).

Undone
Fires when operation has been undone (after finishing).

Protected Events

  NameDescription
Progress
Fires on progress notifications of the currently applied operation.

Redone
Fires when operation has been redone (after finishing).

Saving
Fires when image is being saved (before starting).

Undoing
Fires when image is being undone (before starting).

See Also