Hi, i'm currently updating the XCal - MiniCal, to make it skinable.
Here is a Developers Preview of this new XCal. It is not yet ready for daily use, it isn't tested much and has known bugs, so it might be unstable and might crash your computer!
Please Backup your existing XCal-Folder, before testing this version!
I release it, because i need you, to create skins for it, and send them to me, so I can included some skins in the final release ![]()
XCal - MiniCal Skinning Tutorial
(If something is wrong, missing or not working, please leave a comment.)
A: Fast start
1. Navigate to ../xwindowsdock/docklets/xcal/themes - Folder in Windows Explorer.
2. Do never change or delete anything in the default folders "current/", "Mr Black/", "Mr White/"!!!
3. Duplicate the default skin-Folder "Mr White".
4. Rename your duplicated Folder. The Name of the Folder, is the Name of your skin.
5. Open and change the png-Files in this Folder, adjust the values in the "settings.ini".
6. Done. Open the XCal-Settings and select your Skin to test it, then zip the folder and share it in the Forum.
B: Advanced Information
1. MiniCal-Size
The general Size of the Minical is determinated by the "bg.png". You can set the general Size, by creating a "bg.png" with your preferred dimensions.
2. Color Values:
In the "settings.ini" you have to use Delphi Color Values, which are different from standard HTML-Colors.
You have to use this format: $00bbggrr
"$00" must stand in the front, "bb","gg","rr" are Hex-Values for blue, green and red. Default HTML would be the different sequence #rrggbb.
So Orange (#FF7F00 in html) should be $00007FFF in the settings.ini
3. Font Rendering:
Due to the way, i render the Font, you might end up with ugly font-edges (see second Screenshot).
There are three ways to avoid this (all have cons and pros):
a) Use a FontName of a Font, that doesn't have half-transparent edges. "MS Sans Serif" and "MS Serif" are such Fonts.
Use a Background-Color for the Panel where the font is located. "[General] GridBgColor=" and "[Title] BackgroundColor=" are the values in the ini-File.
c) (my favorite solution) Choose a Transparency Color, that is close to the color of your "bg.png". The ugly edges will still be drawn, but are nearly invisible now.
4. Font:
Please make sure, the user have the fonts you specified in the "settings.ini". Otherwise "Arial" will be used. So please provide a download-Link or include the Font, if legally possible.
5. FontStyle
Can be "bold", "italic" or "bold italic".
6. Preview Image:
"preview.png" should be 185 x 185px and contain your name. It is shown in the XCal-Settings Dialog.
7. Events:
Even if the [Event] section in the settings.ini is currently not used, please fill it to make the skin compatible with upcoming version. Test the values with the [Today] - Section, to see how it will look.
C: Tipps for skinning:
To apply your changes in the png-files or the ini-file, you have to restart the dock or, what is much faster:
1. close the MiniCal (if open)
2. enter XCal Settings (rightclick -> edit)
3. exit XCal Settings by pressing OK
4. open the MiniCal


Aqua-Soft Forums