ImageEn, unit iexHelperFunctions

TIEBitmapHelper.IELoadAsThumbnail

TIEBitmapHelper.IELoadAsThumbnail


Declaration

function IELoadAsThumbnail(const Filename: string;
                           MaxX, MaxY: integer;
                           StretchSmall: Boolean;
                           AutoAdjustOrientation: Boolean = False;
                           QualityFilter : TResampleFilter = rfLanczos3;

                           bAddBorder: Boolean = False;
                           cBorderColor: TColor = clBlack;

                           bAddShadow: Boolean = False;
                           iBlurRadius : Integer = 4;
                           iShadowOffset : Integer = 4;
                           cShadowColor: TColor = clBlack;
                           cBGColor: TColor = clWhite
                           ) : Boolean;


Description

Loads an image of any format into a TIEBitmap reducing it to the specified size (while maintaining the aspect ratio, thus one of the dimensions is likely to be less than the specified value).

Parameter Description
MaxX, MaxY The maximum size of the new image (as the aspect ratio is maintained, one of the dimensions is likely to be less than the specified value)
StretchSmall Set to false to avoid images smaller than MaxX x MaxY from being made larger
AutoAdjustOrientation Sets EnableAdjustOrientation to automatically re-orient JPEG camera images
QualityFilter Specify the quality that is used for rescaling the image
bAddBorder Set to true to add a 1 pixel border to the thumbnail
cBorderColor The color of the added border
bAddShadow Add a solid or soft shadow to the image
iBlurRadius Set to 0 to add a solid shadow or any other value for the width of the Soft Shadow
iShadowOffset The offset of the shadow from the image
cShadowColor The shadow color
cBGColor The color of the image behind the shadow

Note: You must add the iexHelperFunctions unit to your uses clause


Examples

// Load an image at the size 160x120
MyIEBitmap.IELoadAsThumbnail('D:\MyImage.jpeg', 160, 120, False);

// Load an image as 250x250 thumbnail with a shadow
ImageEnView1.IEBitmap.IELoadAsThumbnail( 'D:\MyImage.jpeg',  // Filename
                                         250, 250,           // MaxX, MaxY
                                         True,               // StretchSmall
                                         True,               // AutoAdjustOrientation
                                         rfLanczos3,         // QualityFilter
                                         False,              // bAddBorder
                                         clBlack,            // cBorderColor
                                         TRUE,               // bAddShadow
                                         5,                  // iBlurRadius
                                         1,                  // iShadowOffset
                                         clBlack,            // cShadowColor
                                         clWhite );          // cBGColor
ImageEnView1.Update();