Declaration
procedure SwitchTo(Target: TIEBitmap);
Description
Assigns the current image to the target object. The source object will then be empty/invalid (should be freed and no longer used).
This method executes more quickly than a copy operation because the image is transferred in memory rather than copied.
Specifically, it assigns all fields to
Target, and zeroes all parameters.
var
tempBmp: TIEBitmap;
begin
tempBmp := TIEBitmap.Create();
// Perform an operation that takes in a bitmap and outputs to another
_ConvertBitmapFormat( ImageEnView1.IEBitmap, tempBmp );
// Move content from our temp bitmap to our ImageEnView bitmap
tempBmp.SwitchTo( ImageEnView1.IEBitmap );
// Get rid of our tempBmp (content is no longer valid)
FreeAndNil( tempBmp );
// Update the display
ImageEnView1.Update();
end;
TIEBitmap Assignment and Drawing Methods
TIEBitmap Methods
| Method | Mode | Purpose |
| Assign | From TIEBitmap/TBitmap/TGraphic/TIcon | Copy whole image |
| AssignImage | From TIEBitmap | Like assign, but does not copy the alpha channel |
| AssignRect | From TIEBitmap/TBitmap | Copy a specified rect |
| CopyAndConvertFormat | From TIEBitmap | Copy whole image |
| CopyRectTo | To TIEBitmap | Copy rect to another image (without scaling) |
| CopyWithMask1 | To TIEBitmap | Copy image using a mask to specify what is copied from the source |
| CopyWithMask2 | To TIEBitmap | Copy image using a mask to specify what is replaced in the destintation |
| DrawToTIEBitmap | To TIEBitmap | Copies all or part of the image to a specified position and/or size |
| JoinBitmaps | From two TIEBitmaps | Draws two bitmaps to a single bitmap |
| MergeAlphaRectTo | With TIEBitmap | Merges the alpha channels of two TIEBitmaps using merge rules |
| MergeWithAlpha | With TIEBitmap | Merges all or part of two TIEBitmaps with alpha channels to a specified position |
| RenderToTIEBitmapEx | To TIEBitmap | Extended drawing of content to a TIEBitmap |
| StretchRectTo | To TIEBitmap | Copy rect to dest rect in another image (with scaling) |
| SwitchTo | To TIEBitmap | Move content from one TIEBitmap to another |
| Method | Mode | Purpose |
| Assign | From TIEBitmap/TBitmap/TGraphic/TIcon | Copy whole image |
| AssignTo | To TIEBitmap/TBitmap | Copy whole image with optional scaling |
| AssignRect | From TIEBitmap/TBitmap | Copy a specified rect |
| CopyFromTBitmap | From TBitmap | Copy whole image |
| CopyToTBitmap | To TBitmap | Copy whole image |
| RenderToTBitmapEx | To TBitmap | Extended drawing of content to a TBitmap |