Home
| 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: the VCL component is deprecated, we recommend to use SVGIconImageCollection + SVGIconVirtualImageList also for older Delphi versions! |
You can install a copy of this project from GetIt Package manager, but if you want to use the latest version, clone this repository into a {DevDirectory} (for example C:\Dev\SVGIconImageList).
WARNING: from versione 3.7.0 to 3.8.0 the package names for Delphi 10.4 and 11 are changed to Libsuffix (auto), so you must uninstall older packages before installing new packages.
Build RunTime package: SVGIconImageList_DXXX
Install DesignTime package: dclSVGIconImageList_DXXX
**WARNING: from versione 3.7.0 to 3.8.0 the package names for Delphi 11 are changed from D11_0 to D11, so you must uninstall older packages before installing new packages.
Remember to add those folders to Search Path:
{DevDirectory}\Source
{DevDirectory}\Image32\Source
{DevDirectory}\Skia4Delphi\Source
or if you want to use dcu units:
_{DevDirectory}\Lib\D11$(Platform)$(Config)
(if you need 64 bit dcu files, rebuild packages with 64Bit platform).
The correct use of these components are in "virtual" mode: TVirtualImageList (available from D10.3) and TSVGIconVirtualImageList both use images from TSVGIconImageCollection as explained here...
We advise that TSVGIconVirtualImageList should be used only for versions of Delphi before 10.3.
The TSVGIconImageCollection inherits from TCustomImageCollection, so you can also use it with the TVirtualImage component and place SVG icons into the new TControlList component (available from Delphi 10.4.2), as explained here...
Go to the Index of the guide form complete support!
There are four "SVG engines" implementation:
-
Native Delphi Image32 (default): the new implementatio, using Image32 library by Angus Johnson
-
Native Delphi TSVG: the first native Delphi code, based on Martin's work which is using GDI+
-
Using SKIA4Delphi library, a cross-platform 2D graphics API based on Google's Skia Graphics Library
-
A wrapper to the native Windows Direct2D implementation
You can read more details here.
This table shows the performance of the four rendering engines tested with SVGExplorer, using a significant amount of icons from different sets, rendered at 128x128 pixels.
| Count | Icon set | TSVG | Image32 | D2D | SKIA4Delphi |
|---|---|---|---|---|---|
| 997 | Font-Awesome | 1171ms | 1265ms | 1453ms | 1172ms |
| 654 | Papirus | 1093ms | 2750ms(1) | 937ms | 1266ms(1) |
| 5366 | Material-Design | 10796ms | 11015ms | 12001ms | 10688ms |
As you can see, the four 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.
The VCL components are compatible with Delphi versions starting from Delphi XE6 to actual version.
The FMX components are compatible with Delphi versions starting from Delphi 10.2 to actual version. Now the only platform supported is Windows!
In this repository you can find all the sources of components and some demos.
This image shows the component editor and the Demo (VCL version)
This image shows the VCL SVGText-property editor (into a Dark styled Delphi IDE)
This image shows the FMX SVGText-property editor
This image shows the component editor and the Demo (FMX version)
Use the advanced Component Editor (VCL) to easily create your SVG Icons, loading from files or settings SVGText property. You can also define categories for icons.
Resize Icons at any pixel size settings Size (or Width and Height) of the ImageList.
For recent versions of Delphi the recommended combination should be TSVGIconImageCollection + TVirtualImageList. 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.
The SVG Icon Explorer utility is located into SVGExplorer folder
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.
The VCL Demo is located into specific Delphi version folder: Demo\DXXX\SVGIconImageListDemo.dpr
With the demo you can resize icons at any dimension, change VCL style to check visibility on different colors, apply GrayScale effect or Fixed Color effect and resize SVGIconImage to se a perfect rescaling of icons.
The FMX Demo is located into specific Delphi version folder: Demo\DXXX\SVGIconImageListDemoFMX.dpr
With the demo you can see the icons at different dimension, into ListBoxitems, and into different TGliph with perfect rescaling of icons. You can apply GrayScale effect or Fixed Color Effect.
Those Demos uses a sample of free SVG Icons from "Icons8", stored into Demo/flat-color-icons folder.
Licensed under the Apache License, Version 2.0, (the "License")
These components use the followin libraries:
-
SVG library by Martin Walter (Original version (c) 2005, 2008) with license:
Use of this file is permitted for commercial and non-commercial. Use, as long as the author is credited.
home page: http://www.mwcs.de email: [email protected]
This library is included in the svg folder of this project. -
Image32 library by Angus Johnson These files are included in the Image32/Source and Image32/source/Image32_SVG folders
-
SKIA4Delphi library SKIA4Delphi project These files are included in the Skia4Delphi/Source, Skia4Delphi/Source/VCL and Skia4Delphi/Source/FMX folders
Many thanks to Vincent Parrett and Kiriakos Vlahos for their great contibution.
TSVGIconImageList and TSVGIconImage are similar to TSVGImageList and TSVGImage included into project: https://github.com/ekot1/DelphiSVG.git but those versions are more efficient in performances, with many fixes added, plus some features like SVGText property, store icons in Text format into dfm, GrayScale and FixedColor, VirtualImageList support and more...
TSVGIconImageListFMX and TSVGIconImageFMX are similar to TIconFontsImageListFMX and TIconFontsImage included into similar project made by Ethea for Icon Fonts: https://github.com/EtheaDev/IconFontsImageList