Loading Bar UI for NSIS Readme
------------------------------

Loading Bar UI for NSIS is a special UI used to create a real
"Loading Bar" for any installer.

  1. Installation
  ---------------

    Put the .exe files inside "NSIS\Contrib\UIs" folder, other files
    can be installed anywhere

  2. Using LoadingBar UI
  ----------------------

    First, the program that will be called from a parent program needs
    to use "ChangeUI" command to use one of the three UIs included
    in this package:

    - LoadingBar.exe (Progress Bar and Description)
    - LoadingBar_NoDesc.exe (Progress Bar only)
    - LoadingBar_Icon.exe (Progress Bar, Description and Icon)

    You need to use all of the dialogs inside these UIs.

    Second, you have to use this line below, or the program will
    freeze at the end:

      AutoCloseWindow true

    Use this line to remove the subcaption ": Installing":

      Subcaption 3 " "

    And use this line at the end of the section to do not appear the
    word "Completed" after completing the loading process:

      SetDetailsPrint None

    Third, put the commands you want to load inside a section. The
    Progress Indicator Bar will increase depending on how many commands
    are inside the section. And use "DetailsPrint" command for each
    step description.

    And finally, use "ExecWait" command from the parent program to call
    the program you made with LoadingBar UI.

    TIP: You can customize the ProgressBar using NSIS commands,
         including "InstProgressFlags" and "XPStyle".

    NOTE: Has an example included in this package "LoadingBarTest.nsi",
          compile it to see this UI at work.

Version History
---------------

1.00 - 04/04/2004

  - First version

Credits
-------

- Made by Diego Pedroso (aka deguix).
- Based on "Default" UI provided by NSIS.

License
-------

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

Permission is granted to anyone to use this UI for any purpose,
including commercial applications, and to alter it and redistribute
it freely, subject to the following restrictions:

1. The origin of this UI must not be misrepresented;
   you must not claim that you wrote this original UI.
   If you use this UI in a product, an acknowledgment in the
   product documentation would be appreciated but is not required.
2. Altered versions must be plainly marked as such,
   and must not be misrepresented as being the original UI.
3. This notice may not be removed or altered from any distribution.