Declaration
procedure Assign(Source: TObject);
Description
Copies an image from source object. Source can be a
TIEBitmap, TBitmap, TGraphic, TPicture, TImage, TIcon or TImageList.
Note:
◼The
Params are also copied if Source.
ParamsEnabled is true
◼Assign copies the
alpha channel of a TIEBitmap, use
AssignImage to only copy the image
◼To assign a
TIEVisionImage, use
AssignIEVisionImage
◼If assigning from a TIEBitmap with with
Location of ieTBitmap and
PixelFormat of ie16g, ie32f, ieCMYK, ieCIELab or ie48RGB, the result will be ie24RGB
◼An exception is raised if Source is an unsupported type
Examples
// Display the same image as a TImage
ImageEnView1.IEBitmap.Assign( Image1.Picture.Graphic );
ImageEnView1.Update();
// Copy from a TGraphic class
jpg := TJpegImage.Create();
try
jpg.LoadFromFile( 'D:\Image.jpg' );
ImageEnView1.IEBitmap.Assign( jpg );
ImageEnView1.Update();
finally
jpg.free
end;
// Copy from a TImage
ImageEnView1.IEBitmap.Assign( Image1 );
ImageEnView1.Update();
// Assign a 32bit Bitmap with alpha channel to an ImageEnView (keeping the alpha)
var
bmp: TBitmap;
begin
bmp := TBitmap.Create();
bmp.LoadFromFile( 'Bmp32_with_Alpha.bmp' );
ImageEnView1.IEBitmap.Assign( bmp );
ImageEnView1.IEBitmap.SynchronizeRGBA( True, True );
ImageEnView1.Update();
bmp.Free();
end;
See Also
◼SynchronizeRGBA
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 |