diff -r 000000000000 -r d5ce4c64ef88 Docs/ExperienceUI/pages/skin.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Docs/ExperienceUI/pages/skin.htm Tue Oct 16 00:07:41 2007 -0400 @@ -0,0 +1,137 @@ + + + ExperienceUI Documentation Content Frame + + + + + + + + + + + + + + + + + + + +
+ +

ExperienceUI Skin Support

+

+ + Of course, the main feature of the ExperienceUI is that is changes your normal, boring-looking setup wizard into a + user-friendly, themed environment for installing a program - a functional, fast, and pretty alternative to InstallShieldŽ + and WISEŽ Installer. But, if the ExperienceUI had only one look that gets boring after awhile, who would want to use it, + when InstallShieldŽ has tons of free downloadable skins? That's where the skinning support comes in. The ExperienceUI + allows you to use several preset skins, or even create your own, even if you have little or no scripting knowledge.
+
+    If you have read the Global Defines > Basic Settings section, you already know + how to use a skin; it only needs one line of code. But, you can write your own skins, too. You can integrate + the skin file into your script, or create a redistributable skin file that can be downloaded off of the Web and installed + just by being clicked on. See the next section for more information. +

+ + + +

Writing Skins

+ +

+ How to write your own custom skins + step-by-step
+ +

+ + + Tip: To make your skin easily customizable, use !insertmacro XPUI_DEFAULT instead of !define.
+ Another Tip: If you still need help, look at the example skins. + + +

+ + + + 1. Define XPUI_CUSTOMSKIN + +

+ The first thing you need to do is define XPUI_CUSTOMSKIN. This notifies the XPUI header file that you are using a non-default skin for your installer.

+ +

+ 2. Define Colors and BGGradient Options +

+ Next, you need to define the custom colors for your skin.

+ +

+ 3. Create header/footer images and the Left Logo +

+ Fire up your favorite image editor and whip up a header image, a Left Logo (the picture on the left of the installer), and a footer image if you want one. Then, put the images in (NSIS Directory)\Contrib\ExperienceUI\Skins\(Skin name).
+
+ Click here for the recommended dimensions. + +

+ 4. Define the Image locations + +

+ Next, you need to tell the ExperienceUI script where to find the pictures you created. It is recommended that you put the bitmap files in <ExperienceUI Install Dir>\Skins\<skin name>. + +

+ 5. Create an XPUI_SET_BG macro +

+ NOTE: This step is now optional.
+
+ You no longer need to create this macro, but if you want to, you can. Any code that is used here should be compatible with the NSIS .onGUIInit function. Use the following code example for your background:
+

+ !macro XPUI_SET_BG

+ + !ifndef XPUI_SET_BG_INSERTED
+ !define XPUI_SET_BG_INSERTED
+ [your code here...]
+ !endif

!macroend + + +

+ 6. Create an XPUI_BGFILES_DELETE macro +

+ You will need to create a macro that deletes any files in the user's TEMP folder and call any finishing plugin calls here. + Use the following code example:

+

+ !macro XPUI_BGFILES_DELETE
+ + [your code here...]
+ !macroend +

+ +

+ 7. Save the File +

+ + Save the file as "${NSISDIR}\Contrib\ExperienceUI\Skins\skin_name.XPUIskin".
+ Then, to use the skin in your script, simply use the following line:
+

+ !define XPUI_SKIN "skin_name"
+ +

+ + Remember not to add the .XPUIskin at the end of the define. This is done automatically for you.
+ + +

+ + Congratulations! You just wrote your own skin for the ExperienceUI! +
+ + +

+ +

Copyright © 2004-2006 Dan Fuhry. All rights except those explicitly given in the license agreement reserved.

+ +
+ + + +