Here's how to install the MlSkin package in the Delphi IDE, using 32-bit as the example.
Open the Delphi IDE and choose Component → Install Packages…Open the component installation dialog in the Delphi IDE
Click the Add… button in the dialog
Click Add to add the component package
Select the MlSkinVCL*.bpl file (* is the Delphi version), then click Open
Select the bpl file that matches your Delphi version
Click OK to confirm the installation
Choose Tools → Options, find Library Path, set Selected Platform to 32-bit Windows, add the MlSkin directory to the Library Path list, and click OK to finish
Add the MlSkin directory to the library path
Extra settings for 64-bit builds
To compile 64-bit programs with MlSkin, you also need to:
Extract the MlSkin.*.x64 package for your Delphi version
Copy the 64bit folder inside it into your installed MlSkin directory (make sure the location is right)
Choose Tools → Options, find Library Path, and set Selected Platform to 64-bit Windows
Add both the 64bit directory and your MlSkin directory. Order matters: the 64bit directory must come first
Add both directories, with 64bit first
Upgrading to the latest version
Download the package for your Delphi version from the download page and extract it
Close Delphi, then copy all extracted files over the files in your old MlSkin directory
If you're a licensed user, put your license file in the directory too (trial users can skip this step)
Restart Delphi, and the upgrade is done
Back up firstBack up your current MlSkin directory before upgrading so you can roll back if anything goes wrong.
Upgrading from 2.x to 3.x or laterVersion 3.x redefined all image properties, so custom image properties in old projects must be re-bound. Back up your old project (especially the images it uses) before installing the new version.
Enabling High-DPI
MLSkin supports High-DPI displays. You need:
Delphi 10.3 or later
Project option Application → Manifest → DPI Awareness set to Per Monitor V2Set DPI Awareness in the project options
In your project's .dpr file, put uMlSkinActiveHighDPI.pas first in the uses clause
Reference uMlSkinActiveHighDPI in the project file
Build and run, and High-DPI takes effect. Some images may look a little blurry because they're scaled up for high DPI. Here's how to fix that.
Adding images for different DPI scales
In MlSkinResManager, add the normal-size image first, then select its image ID, e.g. apple-logo-48
Check DPI Scale on the right, choose the scale to add (e.g. 200%), and click Add to import the image
Add image resources for different DPI scales
The ImageID automatically gets an @DPIxxx suffix (xxx is the scale)
Image IDs generated for each DPI
At runtime the program picks the image that matches the current screen DPI, and only scales up the original when no match is found.
References
Embarcadero's articles on High-DPI support in Delphi:
This mainly happens when compiling 64-bit programs in Delphi 11 and later. The fix: in the project options, uncheck the two options shown below.
Uncheck these two options
This resolves most of these compilation errors.
Offline documentation
Read the component documentation without an internet connection. Extract the download to view it: it includes complete usage instructions, API documentation and example tutorials.
MLSkin