Installation and Usage

1. Installation/Usage Guide for Linux , OSX and Sun OS Users
2. Installation/Usage Guide for Microsoft Visual Studio 2005 Users (BETA)

Installation/Usage Guide for Linux, OSX, and Sun OS Users

Requirements

  • g++   (g++32 does not work)
  • Qt3 (see FAQ on installations on Ubuntu)
  • GTNetS is not supported for 64 bit systems

Installation Steps

1. Create Dependency List
  
    In the GTNetS (main folder)
    $ make depend

Note: “make depend” may result in an error in the EXAMPLES directory when using the sun studio compilers. This can be safely ignored

2. Create libraries with debugging symbols
   
    $ make debug

3. Create libraries with optimal code
   
    $ make opt

Note: make sure you have done make depend atleast once after checking out the sources


Usage

You can run your code by placing them in the EXAMPLES folder or executing the examples present in the EXAMPLES folder


$ make debug
This should create the executables with a dbg extension (debug code with debugging symbols).Make detects any out-dated source code and builds it.Each time you can make a change to some code in the EXAMPLES folder, just issue "make debug" and a new executable will be created.

Or

$ make opt
This should create the executables with a opt extension (optimal code without debugging symbols)

Installation/Usage Guide for Microsoft Visual Studio 2005 Users (BETA)


Requirments

  1. Microsoft Visual Studio

  2. Qt 3 From Trolltech (Note: Currently GTNetS does not support Qt 4)

  3. You can download Qt 3 (Open source) for Windows from Click Here

  4. Microsoft Windows XP

Steps

Please follow the steps in the same order
  1. Ensuring Visual Studio is installed correctly

  2. Installing Qt 3

  3. Setting the Qt 3 environment variables

  4. Testing your installation

  5. Testing your Code/Examples

Ensuring Visual Studio is Installed Correctly

  1. Remember to install Visual studio 2005 (not the express edition)

  2. Once installed check if the following environment variables are set 

VCINSTALLDIR

For example:

VCINSTALLDIR=C:\Program Files\Microsoft Visual Studio 8\VC


For instructions on how to set environment variables, click here:

http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/environment_variables.mspx?mfr=true

You may need to reopen Visual Studio each time you add/edit an environment variable.

      

      INCLUDE

                     For example:

INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\ATLMFC\INCLUDE;C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE;C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\include;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\include;%INCLUDE%


  LIB

For example:

LIB=C:\Program Files\Microsoft Visual Studio 8\VC\ATLMFC\LIB;C:\Program Files\Microsoft Visual Studio 8\VC\LIB;C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\lib;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\lib;%LIB%


  LIBPATH

For example:

LIBPATH=C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\ATLMFC\LIB

   

  DevEnvDir

For example:

DevEnvDir=C:\Program Files\Microsoft Visual Studio 8\Common7\IDE


     YOU MAY NEED TO RESTART YOUR COMPUTER AT THIS POINT 


  3. The following executables should be in any one of the directories indicated by the PATH variable
            1. link.exe
            2. cl.exe
            3. nmake.exe

For example:

PATH =C:\Program Files\Microsoft Visual Studio 8\VC\bin

PLEASE REVIEW THE FAQ's SECTION AT THIS POINT IF YOU GET ERRORS

Installing Qt 3

  1. Make a directory such as “C:\qt”


  2. Unzip the qt source from the tar ball qt-win-free-3.3-2006-10-20-src.tar.bz2 to some temporary directory. It will contain a folder named "qt-3". Copy the entire "qt-3" folder to c:\qt. Like so..."c:\qt\qt-3".
  3. Open the command prompt again and go to the directory “c:\qt\qt-3” and enter the following commands

            1. C:\qt\qt-3> set QTDIR=C:\qt\qt-3

            2. C:\qt\qt-3> set PATH=%QTDIR%\bin;%PATH%

            3. C:\qt\qt-3> set QMAKESPEC=win32-msvc2005
  1. Set the Qt build to generate static libraries using the following command:

                C:\qt\qt-3>configure.bat -fast –static -verbose

This could take 10-20 minutes on some PCs.If all goes well you should get something similar to the following.If you get a fatal error,please review FAQ section (perhaps FAQ 7 or 6)


  1. Building the static libraries using the following command

            C:\qt\qt-3>nmake

  This could take a few minutes to complete on some PCs .

  1. Check if the static libraries have been built in c:\qt\qt-3\lib and check if the following two files are available

qt-mt.lib and qui.lib. Check their time-stamps too, if they have been just recently built.

Setting the Qt 3 Environment Variables


The following environment variables should be set

  1. QTDIR

It should point to the directory where Qt 3 is installed

For example:

QTDIR=C:\Qt\qt-3


  1. QTLIB

It should point to the directory where the Qt static libraries are stored

For example:

QTLIB=C:\Qt\qt-3\lib


  1. QTINCLUDE

It should point to the directory where the Qt header files are stored

For example:

QTINCLUDE=C:\Qt\qt-3\include

Testing Your Installation

  1. Unzip the GTNetS.zip folder to a location (For example :C:\GTNetS)
  2. Open the “GTNetS.sln” file using Visual Studio.
  3. Once the complete solution is loaded, select “Build Rebuild Solution” or Ctrl+Alt+F7
  4. If all goes well you could see something similar to this


Testing Your Code/Examples

      1. Your code needs to replace the current code present in the “Main folder” under the “Solution Explorer”


      2. During the first run, you would find that “testanim.cc” is present in the “Main folder” under the Solution Explorer.You should replace this code with your code or the code in the “Examples“directory


      3. Select "Build Solution" or Ctrl+F5