GitHub - EtheaDev/SVGIconImageList: Four engines to render SVG (Delphi Image32, SVGMagic, Skia4Delphi, Direct2D wrapper) and four components to simplify use of SVG images (resize, fixedcolor, grayscale...) for VCL and FMX platforms. (original) (raw)
SVGIconImageList 
Four engines to render SVG (Delphi Image32, SVGMagic, Skia4Delphi, Direct2D wrapper) and four components to simplify use of SVG images (resize, fixedcolor, grayscale...)
Actual official version 4.6.2 (VCL+FMX)
| Component | Description |
|---|---|
 |
TSVGIconImageCollection is collection of SVG Images for Delphi to provide a centralized list of images for SVGIconVirtualImageLists (only for VCL) |
 |
TSVGIconVirtualImageList is a special "virtual" ImageList for Delphi linked to an SVGIconImageCollection (only for VCL) to simplify use of SVG Icons (resize, opacity, grayscale and more...) |
 |
TSVGIconImage is an extended Image component for Delphi (VCL+FMX) to show any SVG image directly or included into a an SVGIconImageList with all functionality (stretch, opacity, grayscale and more...) |
 |
TSVGIconImageList is an extended ImageList for Delphi (VCL+FMX) with an embedded SVG image collection. Use this component to simplify replace of ImageList for older Delphi Apps and obtain auto-scaling of Icons! |
New integration with SVGMagic Library for Animated SVG
Starting with version 4.6.0, a new Delphi/Native library has been added to the project.
This library contains a unique feature: the ability to display animated SVG files. In the current implementation, the library is used as a new available rendering engine for the standard SvgIconImageList components, but other components are available for displaying animated SVGs, as shown in the SVGMagic-specific demo.
New Setup for automatic installation of components
From 4.4.0 version a new "Installer" read-to-use is located in the Release area: Download the Installer.
The Installer automatically detect your Delphi versions, install sources, build and install packages and add source paths.
Documentation
Follow the Project Site to known how to use those components to modernize your Delphi VCL or FMX applications with scalable, colored and beautiful icons.
You can search and download Icons directly from the WEB!
From version 4.3 an integrated service is now available in the component editor to download SVG icons from the WEB, via the API provided by iconify.design.
Now you can select "Add from WEB" in the Component Editor: a new form to search and Download from the WEB is available for both VCL and FMX Platforms.
Read this page to understand how to easily download SVG icons from the WEB and include them in the SVGIconImageList or SVGIconImageCollection.
Important notice
From version 4.0, TSVGIconVirtualImageList inherits from TVirtualImageList (using Delphi 10.3 to latest). For previous Delphi versions TSVGIconVirtualImageList inherits from TSVGIconImageListBase.
An important difference is that a TVirtualImageList may use and create only a subset of the images in the collection.
Although, the standard TVirtualImageList does not have the FixedColor, GrayScale, ApplyToRootOnly and Opacity properties, these properties exist at the TSVGIconImageCollection and they would be reflected on the linked TVirtualImageList, but if you change those properties at collection level, all the VirtualImageList linked changes!
For this reasons, now TSVGIconVirtualImageList have also FixedColor, GrayScale, ApplyToRootOnly and Opacity properties, so you can setup those properties only at VirtualImageList level, and you can share the same TSVGIconImageCollection from many VirtualImageList with different poperties, as you can see in the new SVGIconVirtualImageListDemo.
For this reason, if you are using those components from Delphi 10.3, the recommended combination should be TSVGIconImageCollection + TSVGIconVirtualImageList.
Don't forget also the importance of PreserveItems when you have a large ImageCollection with many linked Actions. Without setting this property to "True", everytime you add or remove an icon in the collection, you have to check and change the ImageIndex of all the Actions.
Another feature available from Delphi 10.4 version, is that TSVGIconImageCollection inherits from TCustomImageCollection, so you can also use it with the TVirtualImage component and place SVG icons into the TControlList component, as explained here...
Choose your preferred SVG engine!
There are four implementations for VCL (three for FMX):
- Native Delphi Image32 (default), uses Image32 library by Angus Johnson (VCL + FMX)
- SVGMagic, advanced SVG engine by Ursa Minor Ltd. with unique support for animated SVG files (VCL only)
- Using Skia4Delphi library, a cross-platform 2D graphics API based on Google's Skia Graphics Library (VCL + FMX)
- A wrapper to the native Windows Direct2D implementation (VCL only)
To choose your preferred Engine, you must edit SVGIconImageList.inc in the correct section:
for VCL, enabling: {$DEFINE Image32_SVGEngine}, {$DEFINE SVGMagic_Engine}, or {$DEFINE Skia_SVGEngine}
for FMX, enabling: {$DEFINE FMX_Image32_SVGEngine} or {$DEFINE FMX_Skia_SVGEngine}
By Default Image32_SVGEngine is Enabled.
Note: SVGMagic is the only engine that fully supports animated SVG files, making it the ideal choice for applications requiring SVG animations.
Performance comparison
This table shows the performance of the three rendering engines tested with SVGExplorer, using a significant amount of icons from different sets, rendered at 128x128 pixels.
| Count | Icon set | Image32 | D2D | Skia4Delphi |
|---|---|---|---|---|
| 997 | Font-Awesome | 1265ms | 1453ms | 1172ms |
| 654 | Papirus | 2750ms(1) | 937ms | 1266ms(1) |
| 5366 | Material-Design | 11015ms | 12001ms | 10688ms |
As you can see, the engines perform differently depending on the icons and their complexity.
(1)Notice that Image32 and Skia4Delphi are the only engines capable of rendering blur effect (that is always slow to calculate): this is the reason of "slow" performance to render Papirus icons that contains blur effect.
Sample image of VCL version
Sample image of FMX (Windows) version
Sample images of the VCL SVGText-property editor (VCL and FMX)
UTILITIES
The SVG Viewer Demo is useful to check the rendering quality of the engines available, including the new SVGMagic engine.
The SVG Icon Explorer utility utility is useful to explore and preview your svg image collections.
All demo applications have been updated to support and test the new SVGMagic engine, including its unique capability to render animated SVG files.
Animated SVG
The SVGMagic Demo located in Demo\SVGMagic folder showcases the SVGMagic library components with a comprehensive demonstration for animated SVG including:
- TWSVGImage, TWSVGImageButton, TWSVGImageList components
- Styled checkboxes and radio buttons with SVG graphics
- SVG browser with animation support and real-time control
- Real-world UI examples (banking and payment forms)
- Full demonstration of animated SVG rendering capabilities Notice that those components are "specific" of SVGMagic Library, because they manage SVG animations.
SVG Shell Extensions Project
You can use SVG Shell Extensions if you want to see your icons directly into Windows Explorer or you want to edit them using a powerful SVG Text Editor.
Other similar library
A similar project made by Ethea for Icon Fonts: https://github.com/EtheaDev/IconFontsImageList
Available from Delphi XE3 to Delphi 13 (VCL and FMX Platforms)
Related links: embarcadero.com - learndelphi.org
RELEASE NOTES
29 Nov 2025 - version 4.6.2
- Fixed Component Editor for older Delphi versions
28 Nov 2025 - version 4.6.1
- Added SkiaSVGUtils.pas to fix Skia rendering
- Fixed Range Check error for SVGMagic engine
- Fixed Setup for D10_4 to DXE3
- Reformat Packages for Build with Android and iOS platforms
- Reformat Packages for Build with MacOSX platform
16 Nov 2025 - version 4.6.0
- Added SVGMagic engine support for VCL applications
- Full support for animated SVG files (available only with SVGMagic Library)
- Created Packages of SVGMagic for all Delphi versions
- Added SVGMagic Demo showcasing animated SVG capabilities
- Updated all demo applications to support and test SVGMagic engine
04 Nov 2025 - version 4.5.3
- Fixed Delphi 12 Packages for Setup
- Separated defines for VCL Apps and FMX Apps
31 Oct 2025 - version 4.5.2
- Aligned to Image32 ver.4.9 of 08 October
- Added support for Dark-Lite FMX Component Editor
17 Oct 2025 - version 4.5.1
- Aligned to Image32 ver.4.9 of 28 September
07 Sep 2025 - version 4.5.0
- Aligned to Image32 ver.4.9 to fix some bugs
23 Aug 2025 - version 4.4.8
- Aligned to Image32 ver.4.9 to fix a serious bug
18 Aug 2025 - version 4.4.7
- Added support for Delphi 13 - 32 and 64 bit IDE
- Aligned to Image32: ver. 4.9 to fix some bugs in TSvgReader
- Updated Setup for Delphi 13
7 Jul 2025 - Version 4.4.6
- Aligned to Image32 4.6 Relesed on 6 Jul 2025
- Fixed FMX Component Editor AV when empty
- Fixed rendering issue with image32 when changing the image size
- Fixed Linux compatibiliy wuth Image32
- Fixed Inverted Color in Android
10 May 2025 - Version 4.4.5
- Aligned to Image32 4.6 Released on 10 May 2025
08 May 2025 - Version 4.4.4
- Aligned to Image32 4.6 Released on 16 Apr 2025
12 Mar 2025 - Version 4.4.3
- Added support for Delphi 12 64bit IDE
26 Feb 2025: version 4.4.2 (VCL+FMX)
- Added option to filter Icons from web by "Collection"
- Aligned to Image32 4.6 Released on 25 Feb 2025
06 Jan 2025: version 4.4.1 (VCL+FMX)
- Aligned to Image32 4.6 Released on 6 Jan 2025
- Added Setup for Delphi XE7, XE8, 10.1, 10.2
- Fixed Setup for Delphi 10
- Updated copyrights 2025
30 Dec 2024: version 4.4.0 (VCL+FMX)
- New Project Site
- New Setup for automatic Installation of Components
- Aligned to Image32 4.6 Released 26 Dec 2024 (more text/font support)
- Changed LibSuffix for Packages (eg. from D10_3 to 260)
26 Nov 2024: version 4.3.0 (VCL+FMX)
- Updated to Image32 4.6 Released on 26 Nov 2024 to fix issue drawing text inside SVG
- NameSpace added to all uses
- Added SVGIconImageListRestClient package
- New Option in Component Editor to select Icons from WEB (VCL and FMX)
- Demos updated
17 Oct 2024: version 4.2.1 (VCL+FMX)
- Updated to Image32 4.6 Released on 16 Oct 2024 to fix some drawing issue
12 Oct 2024: versione 4.2.0 (VCL+FMX)
- Updated to Image32 4.6 Released on 12 Oct 2024 to fix some drawing issue
- Added components info into About and Splash Screen
14 Sep 2024: version 4.1.9 (VCL+FMX)
- Aligned to Image32 4.5 Version of 14 September 2024
- Fixed Range Error rendering some icons (Image32 engine)
- Fixed Rename Icon in FireMonkey ImageList Editor
- Update packages for Delphi 12.2
27 Aug 2024: version 4.1.8 (VCL+FMX)
- Aligned to Image32 4.5 Version of 18 August 2024
- Fixed rendering with Opacity for Skia4Delphi and D2D Engines
13 Aug 2024: version 4.1.7 (VCL+FMX)
- Updated packages for compilation with Skia4Delphi (defined by SVGIconImageList.inc)
- Fixed uses for skia unit
- Aligned to Image32 4.5 Version of 11 August 2024
18 Jul 2024: version 4.1.6 (VCL+FMX)
- Aligned to Image32 4.5 Version of 17 July 2024
- Fixed color of icons in Android
- Added define to use old OpenPicture Dialog into component editor.
22 May 2024: version 4.1.5 (VCL+FMX)
- Fixed TSVGIconImageListBase.Assign
- Fixed TSVGIconImageCollection registration for FMX projects
- Aligned to Image32 version of 14 May 2024
05 May 2024: version 4.1.4 (VCL+FMX)
- Aligned To latest Image32 ver. 4.4
19 Apr 2024: version 4.1.3 (VCL+FMX)
- Aligned To latest Image32
- Fixed compilation with MacOSX
- Added support for Delphi 12.1
08 Jan 2024: version 4.1.2 (VCL+FMX)
- Aligned To latest Image32
- Added copy SVG to Clipboard into "Export to png" dialog
- Updated Copyrights
09 Nov 2023: version 4.1.1 (VCL+FMX)
- Aligned To Skia4Delphi 6.0.0
- Added FMX Components to all platform
- Fixed Demos for Delphi 12
- Added SvgDisableEngineHint option
03 Sep 2023: version 4.1.0 (VCL+FMX)
- Aligned Image32 Library released on 03/09/2023
- Fixed demo (removed "obsolete" SVGColor uses)
- Added support for Delphi 12.1
24 Aug 2023: version 4.0.0 (VCL+FMX)
- Removed old "native" engine TSVG
- Updated to Skia4Delphi ver. 6.0.0
- TSVGIconVirtualImageList inherits from TVirtualImageList (from D10.3 to actual version).
- Added SVGIconVirtualImageListDemo to test multiple TSVGIconVirtualImageList in same form
- Added support for Delphi 12
28 Feb 2023: version 3.9.6 (VCL+FMX)
- Updated to Image32 ver. 4.4 (30 Jan 2023)
- Updated to Skia4Delphi ver. 4.1.1 (26 Feb 2023)
13 Jan 2023: version 3.9.5 (VCL+FMX)
- Updated Copyright 2023
- Updated to Image32 ver. 4.3 (27 Sep 2022)
- Updated to Skia4Delphi ver. 4.0.2
23 Oct 2022: version 3.9.4 (VCL+FMX)
- FMX Component editor: changed selection for fixed color
- Updated to Image32 ver. 4.3 (27 Sep 2022)
15 Sep 2022: version 3.9.3 (VCL+FMX)
- Removed W11 Styles from Demo (available in Delphi only by Get-it)
- Updated D11 packages to Delphi 11.2
28 Aug 2022: version 3.9.2 (VCL+FMX)
- Fixed #240 TSVGGraphic.Assign
- Updated to Image32 ver. 4.2 (28 July 2022)
- Updated to Skia4Delphi 3.4.1 library
- Fixed #241 Alignment from Source and Destination Items (FMX)
21 Jun 2022: version 3.9.1 (VCL+FMX)
- Added support for other Delphi versions (VCL): D10 Seattle
08 May 2022: version 3.8.3 (VCL+FMX)
- Updated to Skia4Delphi 3.4.0 library
- SVGExplorer example moved under "Demo" folder
10 Apr 2022: version 3.8.2 (VCL+FMX)
- Updated to Skia4Delphi 3.3.1 llibrary
- Updated to Image32 4.11 library
29 Mar 2022: version 3.8.1 (VCL+FMX)
- Fixed Aspect-Ratio for Skia engine
- Updated SVGViewer
- Updated Demos
- Alignment to latest Skia4Delphi version
17 Mar 2022: version 3.8.0 (VCL+FMX)
- Support for Delphi 11.1
- Updated Library suffix for Delphi 10.4 and 11 to (auto)
09 Mar 2022: version 3.7.0 (VCL+FMX)
- Support for Skia4Delphi 3.2.0 completed
- Removed support for Cairo Engine
- Fixed rendering with Image32
28 Feb 2022: version 3.6.0 (VCL + FMX)
- Support for Skia4Delphi also in FMX platforms
26 Feb 2022: version 3.5.2 (VCL+FMX)
- Fixed rendering with FMX-Image32
23 Feb 2022: version 3.5.1 (VCL+FMX)
- Updated Image32 Library to 4.1.0 version
- Updated support to Skia4Delphi 3.1.0
19 Feb 2022: version 3.5.0 (VCL+FMX)
- Updated Image32 Library to 4.0.2 version
- Updated support to Skia4Delphi 3.0.3
- Fixed SVGText Editor
- Fixed some Skia4Delphi SVG rendering
14 Feb 2022: version 3.4.0 (VCL+FMX)
- Updated Image32 Library to 4.0.1 version
- Added support to Skia4Delphi 3.0
- Fixed some Image32 drawing problem
13 Jan 2022: version 3.3.0 (VCL+FMX)
- Updated Image32 library to 4.0.0 version
- Added a set of playing cards svg examples
- Fixed Image32 drawing problem with "playing cards"
24 Nov 2021: version 3.2.0 (VCL+FMX)
- Component Editors uses IDE themes (light, dark...) and style
- Fixed available components into palette when working with mobile platforms
05 Nov 2021: version 3.1.1 (VCL+FMX)
- Fixed Image32 drawing problem in FMX
- Added Export to multiple png files to Component Editor
31 Oct 2021: version 3.1.0 (VCL+FMX)
- Updated Image32 library to 3.4.1 version
- Added Skia4Delphi engine (not complete)
28 Aug 2021: version 3.0.0 (VCL+FMX)
- Updated Packages for Delphi 11
- Updated some documentation (Images and Wiki)
24 Aug 2021: version 2.5.0 (VCL+FMX)
- Aligned to Image32 library ver.3.1
22 Jul 2021: version 2.4.0 (VCL+FMX)
- Updated and aligned to Image32 ver.3 library
- Added packages for Delphi 11 Alexandria
18 Jul 2021: version 2.3.1 (VCL+FMX)
- Fixed rendering files with color defined by 8 digits
17 Jul 2021: version 2.3.0 (VCL+FMX)
- Added new engine: Image32 library by Angus Johnson (VCL+FMX)
- Image32 is now the default native Delphi engine
- Added support for Android and iOS platforms (by Image32 engine)
- Added support for backward Delphi versions (from XE3)
- Added demo to compare the four engines (SVGViewer)
- Fixed rendering "centered" in SVGIconImage for Cairo engine.
- Warning: changed TSVGIconImage component ancestor from TCustomControl to TGraphicControl
18 Apr 2021: version 2.2.6 (VCL+FMX)
- Added new ApplyFixedColorToRootOnly property
- Added demo for new TControlList component (only for D10.4.2)
22 Feb 2021: version 2.2.5 (VCL+FMX)
- Added export to PNG option into Component editor
23 Jan 2021: version 2.2.4 (VCL+FMX)
- Fixed #156 Stretch for SVGIconImage
- Fixed #157 SVGIconImage gets correct image from VirtualImageList
17 Jan 2021: version 2.2.3 (VCL+FMX)
- Fixed #151 Antialiasing problems
- Fixed settings of different Width and Height into editor
- Fixed preview of icon with different Height and Width into editor
24 Dec 2020: version 2.2.2 (VCL+FMX)
- Added Width, Height and Zoom property for FMX components
- Redesigned FMX component editor
- Fixed VCL component editor
08 Dec 2020: version 2.2.1 (VCL+FMX)
- Added 64bit platforms for packages
- Minor fixes (empty except blocks)
- Fixed TSVGIconImage inherited color
- Fixed repaint for FMX version
23 Sep 2020: version 2.2.0 (VCL+FMX)
- Added "Cairo" SVG Engine
- Added AntialiasColor to perfect antialias effect
- Added ImageIndex property editor for SVGIconImage
- Added FixedColor and GrayScale to TSVGIconImage component
16 Sep 2020: version 2.1.1 (VCL) 2.1.0 (FMX)
- Fixed issues (#110, #111, #113)
- Editing SVG text in editor shows errors without losing content
04 Sep 2020: version 2.1.0 (VCL) 1.5.1 (FMX)
- Added preview for icons when loading svg files
- Fixed many issue (#81, #86, #87, #88, #91, #94, #103...)
- Refactoring parsing XML to increase performances (using XmlLite)
26 Aug 2020: version 2.0 (VCL) 1.5.0 (FMX)
- Added factory to choose engine
- Added interface to use alternative Third-party SVG engine
- Redesigned component editor to support Categories for icons
- New support for native VirtualImageList (from D10.3)
- StoreAsText icons to dfm by default (and unique mode)
- Fixed many issues (from #35 to #72) Take care of TSVGIconVirtualImageList.Collection renamed to SVGIconVirtualImageList.ImageCollection.
17 Aug 2020: version 1.9 (VCL+FMX)
- FixedColor changed from TSVGColor to TColor
- Fixed assign FixedColor to icon in component editor
- Updated component editor to use TColorBox
13 Aug 2020: version 1.8 (VCL+FMX)
- Complete refactoring for full support of High-DPI
- New SVGIconImageCollection component
- New SVGIconVirtualImageList component
- Redesign of SVGIconImageList component and Component Editor
- Demo updated to test multi-monitor with different DPI
- Fixed issue #20: Coordinates in double (PaintTo methods)
- Fixed issue #25: Transform matrix is wrongly parsed
- Fixed issue #26: Error in CalcMartrix
- Fixed issue #27: TSVGRadialGradient.ReadIn does not read the gradientTransform matrix
- Fixed issue #28: Colors should be reversed in TSVGRadialGradient
- Fixed issue #29: Scaling should be based on ViewBox width/height
- Fixed issue #31: Empty svg properties cause exceptions
- Fixed issue #33: "fill-rule' presentation attribute is not processed
- Fixed issue #34: Exception text elements cause exceptions
05 Aug 2020: version 1.7 (VCL+FMX)
- Added DPIChanged method
- Enhanced SVGExplorer
- Fixed issue #20: replaced Double with Single
- Fixed issue #19 and 18#: Load/SaveToStream inefficient and encoding inconsistency
- Fixed issue #17: Wrong conversion from pt to px
- Fixed issue #14: scaling problem
- Fixed issue #11: Incompatible with Drag-Drop of TImageList
- Fixed issue #6: Rendering of some SVG images is incorrect
15 July 2020: version 1.6 (VCL+FMX)
- Fixed rendering on TButton! (VCL)
- Fixed "Apply" into ImageEditor (VCL)
- Added reformat XML to ImageEditor (VCL)
- Added utility to explore icons into disk/folder (SVGExplorer)
- Fixed inherited color drawing (SVG)
- Fixed storing properties into dfm in binary mode (VCL)
- Fixed storing for some properties (don't store default values)
13 June 2020: versione 1.5 (VCL+FMX)
- Added support for DisabledGrayScale and DisabledOpacity as in VirtualImageList
- Fixed drawing disabled icons also with VCLStyles active
09 June 2020: versione 1.4 (VCL+FMX)
- Added GrayScale and FixedColor to ImageList for every Icons
- Added GrayScale and FixedColor for single Icon
- Added some complex svg demo images
- Updated demos
06 June 2020: version 1.3 (VCL+FMX)
- Added property editor for TSVGIconImage.SVGText and TSVGIconItem.SVGText
- Fixed some drawing problems with transform attribute
- Fixed rescaling icons when monitor DPI changes
28 May 2020: version 1.2 (VCL+FMX)
- Complete support of Delphi 10.4
- Added support for other Delphi versions (VCL): DXE6, DXE8, D10.1
- Added position memory of component editor
- Fixed Issue: Icon Editor not keeping added icons
- Fixed Issue: SVG with exponent notation does not parse correctly and affects image display
25 May 2020: version 1.1 (VCL+FMX)
- Added the component TSVGIconImageListFMX with advanced component editor.
- Added the component TSVGIconImageFMX to show SVG into a TImage.
- Demos to show how they works.
- Very high performance for building hundreds of icons.
24 May 2020: first version 1.0 (VCL)
- Added the component TSVGIconImageList with advanced component editor.
- Added the component TSVGIconImage to show SVG into a TImage.
- Demos to show how they works.
- Very high performance for building hundreds of icons.
- Support from Delphi 10.2 to 10.4 Sydney (other Delphi versions coming soon)
THANKS TO
These components uses the following libraries:
- Image32 library by Angus Johnson
These files are included in the Image32/Source folders
Copyright Boost Software License Version 1 - SVGMagic library by Ursa Minor Ltd.
These files are included in the SVGMagic/source folder
Advanced SVG 1.1 rendering engine with full support for animated SVG files - Skia4Delphi Library by the authors
Copyright MIT-License
Many thanks to Vincent Parrett and Kiriakos Vlahos for their great contribution.
Thanks to George Birbilis for Package updates, build and test with Android, iOS and OSX platform