Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members | Related Pages | Examples

ParaGUI & VisualC++

PARGUI project files for Microsoft Visual C++ 6.0

You can either use the precompiled libraries from the ParaGUI web site, or you can build ParaGUI yourself.

Directory structure

The following directories should be created in the ParaGUI root directory:

Library files

First you have to choose if you want to link your application dynamically or statically against ParaGUI. For dynamic linkage you need the dynamic link library (DLL) and the import library (LIB). For static linkage you only need the static library (LIB). If your application should be compiled multi-threaded use the multi-threaded static library.

Note: The ParaGUI library is under LGPL licence. See licence for terms of linking with ParaGUI.

Building ParaGUI

  1. Unzip the VisualC.zip file in the root ParaGUI directory.
    Be certain that you unzip it into this directory and not any other directory. If you are using WinZip, be careful to make sure that it extracts into this folder, because it's convenient feature of unzipping to a folder with the name of the file currently being unzipped will get you in trouble if you use it right now.

  2. Go into the VisualC directory that is created, and open the workspace file " paragui_all.dsw " with MSVC++.
    You may be prompted at this point to upgrade the workspace, if you are using a more recent version of MSVC++. If so, allow the workspace to be upgraded.

  3. Choose dynamic or static paragui project.
    This is done by right clicking on each project in turn (Projects are listed in the Workspace panel in the FileView tab), and selecting "Set as active project".

  4. ParaGUI depends on sdl.lib, sdl_ttf.lib, sdl_image.lib (when HAVE_SDLIMAGE is defined) and freetype.lib<br>
    1. You need to supply these libraries to the linker. There are three ways how to do this:

      Go to "Tools|Options|Directories|Library files", and add proper paths to all listed .lib files
      Go to "Project|Settings|Link|Category: Input|Additional Library Path", add here path to libs (relative or absolute)
      Find .lib files and copy them into /lib directory in your ParaGUI root. This dir is preset to be on the library path.

    2. You also need set paths to header files of these libraries. There are also several ways how to do this:

      Go to "Tools|Options|Directories|Include files", and add proper paths to all listed .lib files
      Go to "Project|Settings|C/C++|Category: Preprocessor|Additional Include directories", add here paths to headers (relative or absolute)
      Find .h files and copy them into /include directory in your ParaGUI root. This dir is preset to be on the include path.

  5. Choose the proper configuration from "Build|Configurations...":

    1. For paragui_dynamic there are

      Release => produces release mode dynamic link library and import library [bin/paragui.dll, lib/paragui.lib]
      Debug => produces debug mode dynamic link library and import library [bin/paraguid.dll, lib/paraguid.lib]

    2. For paragui_static there are

      Release = > produces release mode static link library (single threaded) [lib/paraguis.lib]
      Debug => produces debug mode static link library (single threaded) [lib/paraguisd.lib]
      Release MT => produces release mode static link library (multi threaded) [lib/paraguimts.lib]
      Debug MT => produces debug mode static link library (multi threaded) [lib/paraguimtsd.lib]

  6. Build the project with the "Project|Build" command.
    You may get a few warnings, but you should not get any errors. If yes check again. If you did it all correctly, check types of libraries sdl.lib, sdl_ttf.lib, sdl_image.lib, freetype.lib. They must be compiled in mode Multithreaded DLL. Anyway check troubleshoting section.

  7. Your library files are created. Check if you find them in /lib and /bin directories.

Building example files for ParaGUI

Troubleshooting

© 2001 Documentation written by Antonin Hildebrand
© 2001 ParaGUI library by Alexander Pipelka

The ParaGUI Project - Alexander Pipelka