Delphi library for simplifying image load/save, conversion and transformation. Can load/save png, jpg, jxl, webp, avif, tiff, gif and bmp. Can get image from different resources: file, stream, http, imagelist, associated windows icon, executable file icon, etc… Rotate, flip, grayscale and many other transformations.
GDI+, Graphics32, OpenCV, Vampyre and LibVips engines available.
Give it a star
Please “star” this project in GitHub! It costs nothing but helps to reference the code.
Star History
Support
If you find this project useful, please consider making a donation.
*NEW: Delphi 12 Athens support
*NEW: LibVips engine added
*NEW: Interface based
*NEW: Vampyre lib engine added
*NEW: New functions added
*NEW: Refactory classes
*NEW: Delphinus support
You can select one or more of the available engines ImageFX supports. Add one or more of below units to your uses clause:
-
Quick.ImageFX.GDI: Uses GDI+ engine. No needs external libraries but it’s slow.
Needed libraries:
-
Quick.ImageFX.GR32: Uses Graphics32 engine to rotate, transform, resize, etc
Needed libraries:
-
Quick.ImageFX.OpenCV: OpenCV Engine. Uses a thrid party delphi warper for Intel Open Vision library. It’s very fast and powerfull. Needs OpenCV external dll’s in your project dir.
Needed libraries:
-
Quick.ImageFX.Vampyre: Vampyre Imaging Library Engine. Uses a thrid party delphi warper for Vampyre Imaging native library. Fast and supports many image formats.
Needed libraries:
-
Quick.ImageFX.Vips: LibVips Imaging Library Engine. Uses a thrid party delphi warper for LibVips library. Ultra fast and supports many image formats like Webp, Avif, JXL, etc.
Needed libraries:
Create: Create instance of ImageFX to load/manipulate images.
var
ImageFX : IImageFX;
begin
ImageFX := TImageFXGDI //You can create as TImageFXGDI, TImageFXGR32, TImageFXOpenCV or TImageFXVampyre to use different graphic engines
ImageFX.LoadFromFile('.\test.jpg');
ImageFX.Rotate90;
ImageFX.SaveAsPNG('.\Test.png');
end;
Load/Save: Can load/save png, jpg, gif and bmp and get image from different resources like file, stream, http, imagelist, associated windows icon, executable file icon, etc…
//Load image from files like jpg, gif, png and bmp
ImageFX.LoadFromFile('.\file.jpg');
//Load/Save image from/to a memorystream, filestream, etc...
ImageFX.LoadFromStream(MyStream);
ImageFX.SaveToStream(MyStream,ifJPG);
//Load image from an icon class
ImageFX.LoadFromIcon(MyIcon);
//Load image from an icon file
ImageFX.LoadFromFileIcon('.\file.ico');
//Get image associated in windows with this type of extension
ImageFX.LoadFromFileExtension('.\file.xls',True);
//Load from exe resource
ImageFX.LoadFromResource('Main.ico');
//Get image from a http link
ImageFX.LoadFromHTTP('http://www.mysite.com/file.jpg',ReturnHTTPCode,True);
//Load/Save from string
ImageFX.LoadFromString(MyImageString);
ImageFX.SaveToString(MyImageString);
Image Info: Get resolution, aspect ratio of an image.
ImageFX.GetResolution(x,y)
ImageFX.AspectRatioStr //aspect ratio (4:3,16:9)
ImageFX.IsGray
Image Resize:
//Resize image to fit max bounds of 500x300 and fills rest of target size with a border black color
ImageFX.ResizeOptions.BorderColor := clBlack;
ImageFX.Resize(500,300, rmFitToBounds, [rfCenter], rmLinear);
//Same image resize alternative/advanced mode
ImageFX.ResizeOptions.ResamplerMode := rmLinear;
ImageFX.ResizeOptions.ResizeMode := rmFitToBounds;
ImageFX.ResizeOptions.Center := True;
ImageFX.ResizeOptions.FillBorders := True;
ImageFX.ResizeOptions.BorderColor := clBlack;
ImageFX.Resize(500,300);
ResizeOptions:
-
NoMagnify: If true not resize image if smallest than especified new size.
-
ResizeMode: Resize algorithms to calculate desired final size:
- rmStretch Stretch original image to fit target size without preserving original aspect ratio.
- rmScale Recalculate width or height target size to preserve original aspect ratio.
- rmCropToFill Preserve target aspect ratio cropping original image to fill whole size.
- rmFitToBounds Resize image to fit max bounds of target size.
-
ResamplerMode: Resize algorithms to be applied:
- rsAuto Uses rmArea for downsampling and rmLinear for upsampling
- rsGDIStrech GDI only mode.
- rsNearest Low quality - High performance.
- rsGR32Draft GR32 only. Medium quality - High performance (downsampling only).
- rsOCVArea OpenCV only. Medium quality - High performance (downsampling only).
- rsLinear Medium quality - Medium performance.
- rsGR32Kernel GR32 only. High quality - Low performance (depends on kernel width).
- rsOCVCubic OpenCV only. High quality - Medium/Low performance.
- rsOCVLanczos4 OpenCV only. High quality - Low performance.
-
Center: Centers image
-
FillBorders: Fill borders of a scaled image in destination rectangle if smaller.
-
BorderColor: Color of filling borders.
Transforms: Apply rotations, flips, scanline effects, bright and others transformations to your images.
//Rotate image 90 degrees
ImageFX.Rotate90;
//Rotate image 45 degrees
ImageFX.RotateAngle(45);
//Convert to grayscale
ImageFX.GrayScale;
//Flip image horizontally
ImageFX.FlipX;
//Increase bright by 50%
ImageFX.Lighten(50);
//Change color of a pixel
PixInfo.R := Random(255); //R
PixInfo.G := Random(255); //G
PixInfo.B := Random(120); //B
PixInfo.A := 200; //Alpha
imageFX.Pixel[x,y] := PixInfo;
//Draw an overlay image over current image with 50% transparency
ImageFX.DrawCentered(pngimage,0.5);
Format conversions: Can convert between image formats.
ImageFX.LoadFromFile('.\myfile.jpg');
ImageFX.SaveAsPNG('.\myfile.png');
Almost all functions return self class, so you can chain many actions and effects like this:
//Rotate 90 degrees and flip horizontally, convert to grayscale and save to a png file.
ImageFX.Rotate90.FlipX.GrayScale.SaveToPNG('.\myfile.png');
// Load from file, rotate180, resize to 100x100 and assign to a TImage.
MyImage.Picture.Asssign(ImageFX.LoadFromFile('.\myfile.jpg').Rotate180.Resize(100,100).AsBitmap);
Do you want to learn delphi or improve your skills? learndelphi.org
评论