Readme


====================================
Graphical Installer for Inno Setup
====================================

Version 3.4.01 (Lenka)


Copyright (c) 2011 - 2013 unSigned Softworks. All Rights Reserved.

Product website: http://www.graphical-installer.com/

Developer website: http://www.unsigned-softworks.com/

Email contact: info@unsigned-softworks.sk


This document is related only to Graphical Installer for Inno Setup.

For information about Graphical Installer for NSIS (Nullsoft Scriptable Install System) see appropriate documents in Graphical Installer for NSIS package.

In file called Version.txt you can find out what is new in this version. Known bugs and problems are mentioned in file Bugs.txt

This version of Graphical Installers was built on 29th October 2013 against Inno Setup 5.5.4 (released on 13th October 2013).


=============
About
=============

Graphical Installer is an extension for Inno Setup. It allows to change the design of whole Inno Setup installer.
This is a third generation of this extension and it has a lot of new features and improvements.

It is possible to set:
- custom picture for installer background
- custom icons (Installer/Uninstaller/...)
- custom picture for buttons (Next/Back/Cancel/Browse/...)
- custom picture for scrollbars (License/Readme/...)
- custom color for texts (Headers/Labels/Links/Static texts/...)
- and many more aspects of the installer.

It is also possible to create installers with irregular windows (Part of window can be fully transparent).

Main features:

* Fully customizable graphical interface
It's possible to change graphic look of whole installer - background picture, icons, buttons picture!

* Creating installers with irregular windows
Part of window can be fully transparent - you are no more tied to rectangular shape!

* Easy integratable to existing Inno Setup scripts
All you need is to add references to this installer, no hard-coding is necessarry!

* Templates and examples for instant start
We provide many templates and examples, so your installer can be finished in few minutes!

* "Graphical Installer Wizard" for creating new and converting existing Inno Setup scripts
Standalone application or plug-in for Inno Script Studio and Visual Studio for fast creating Inno Setup scripts with custom design.

* Full compatibility with other Inno Setup plugins and functions
Our product use the same core as traditional Inno Setup installers - so there is no difference in writing scripts!

* Custom dialogs and interfaces
Thanks to Pascal Scripting language it is easy to add custom wizard pages and elements to them (TextBoxes, CheckBoxes ...)

* Support for multiple languages (also Unicode languages)
Fully multilingual support (including RTL languages) in one installer!

* ... and much more ...


=================
Requirements:
=================

REQUIRED: You need to have Inno Setup installed:

- Inno Setup 5.5.4 (Ansi or Unicode) or newer installed - http://jrsoftware.org/

OPTIONAL: To edit Inno Setup scripts you need any text editor (Notepad/PSPad/...) or you can use advanced IDEs. These are recommended:

- Visual & Installer (recommended tool - addin for Visual Studio with syntax highlighting, complete word functionality, ...) - http://visual-installer.com/
- Inno Script Studio 2.1.0.20 - https://www.kymoto.org/products/inno-script-studio

Please notice:

To create FULL Unicode installers use ***Unicode*** version of all used plug-ins with Unicode build of Inno Setup.


=================
Installation
=================

1. Follow the automatic Setup Wizard.

2. During the setup process all necessarry components will be installed, if they are not present on your machine.
For correct function of Graphical Installer these components will be installed:

- InnoCallback plug-in (v1.0.0.0)

- GraphicalInstaller plug-in v1.0.01

- Graphical Installer core files (.iss files, .exe files, documentation, other tools)

- Graphical Installer Wizard v1.4.01 (optional) - for Visual & Installer, Inno Script Studio and standalone application

- Examples

- Skins

3. At page 'Select Destination Location' choose path to your Inno Setup directory.
Graphical Installer cannot be installed into other directory, because it is tightly linked with Inno Setup core files!

4. At page 'Select Graphical Installer version' choose which version to install: Ansi or Unicode.
Both versions can be installed on the same machine (into different directories).

5. The Setup process offers you to install Inno Setup IDEs. They are recommended, but not required for Graphical Installer.

6. When Setup finishes run your favourite IDE. There is 'Graphical Installer' option in the main menu. Use it to create new installers or to convert your existing scripts.


====================
Creating installer
====================

Basically you have four options:

1) To create scripts manually from the scratch.
2) To edit some of the Examples script (which can be found in Graphical Installer\Examples directory)
3) To use a supplied Graphical Installer Wizard plug-in (Wizard.exe in {Inno Setup}\Graphical Installer directory), which has a lot of functions and will generate new/convert existing scripts for you.
4) To use a Visual & Installer - Visual Studio Add-in for creating Inno Setup installers directly from Microsoft Visual Studio 2005, 2008, 2010, 2012 and 2013.
It also contains Graphical Installer Wizard so you have all tools in one package - download from http://www.visual-installer.com/

Few tips:
- read comments in .iss files, there is a lot of information
- browse the Graphical Installer\Examples directory, there are several useful examples
- graphical settings are configured via .graphics.iss file. This file is unique for each project.
- functions and various macros are defined in GraphicalInstaller_functions.iss file. Do not edit this file if you are not a Inno Setup expert.
- all projects using Graphical Installer must have defined symbol GRAPHICAL_INSTALLER_PROJECT in the .iss file.
- if this symbol is not found the script is compiled normally (without skinning).
- see examples and tutorials for Inno Setup, they can teach you a lot!
- background image size is exactly 690x496 pixels. Other files can be generated via BitmapCutter.exe tool.
- read the enclosed CHM documentation or online manual for more info.


=========================
LICENSES AND COPYRIGHT
=========================


Graphical Installer permission:

By installing this software you agree with using of your name/company name, company logo and installer screenshot for unSigned Softworks marketing purposes.
These details will NOT be provided to third party subjects.


Graphical Installer uses modified sources of Inno Setup compiler, see it's license below:

==================
Inno Setup License
==================

Except where otherwise noted, all of the documentation and software included
in the Inno Setup package is copyrighted by Jordan Russell.

Copyright (C) 1997-2013 Jordan Russell. All rights reserved.
Portions Copyright (C) 2000-2013 Martijn Laan. All rights reserved.

This software is provided "as-is," without any express or implied warranty.
In no event shall the author be held liable for any damages arising from the
use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter and redistribute it,
provided that the following conditions are met:

1. All redistributions of source code files must retain all copyright
notices that are currently in place, and this list of conditions without
modification.

2. All redistributions in binary form must retain all occurrences of the
above copyright notice and web site addresses that are currently in
place (for example, in the About boxes).

3. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software to
distribute a product, an acknowledgment in the product documentation
would be appreciated but is not required.

4. Modified versions in source or binary form must be plainly marked as
such, and must not be misrepresented as being the original software.


Jordan Russell
jr-2010 AT jrsoftware.org
http://www.jrsoftware.org/