Main

glVertex Framework

Getting the Package

The glVertex framework is used for the CG exercises.
As a development platform Ubuntu 24.04 LTS is recommended!
Windows and Mac is also supported!

The actual framework can be downloaded from here:

This framework has been tested with the following platforms:

  • Ubuntu 16.04, 18.04, 20.04, 22.04, 24.04
  • openSUSE Leap 15
  • Debian, Linux Mint
  • MacOS X, 11 - 15
  • Windows 10 - 11

Installation on Linux

On Linux resp. Ubuntu the installation is as follows on the terminal:

  • unzip glvertex*.zip
  • cd glvertex*/
  • ./installer.sh

This unzips and runs the installer script, which automagically downloads and installs the glvertex framework plus the QtCreator IDE including all required tools like the C++ compiler, build systems, libraries etc. pp.

To check whether or not the entire installation finished successfully, please type the following one-liner on the command line:

url="http://svn.code.sf.net/p/glvertex/code/install/standalone_installer.sh" && \
svn export --force $url installer.sh >/dev/null && ./installer.sh && echo -e "\nSUCCESS"
[Get Code]

If it outputs “SUCCESS”, everything is fine.

Installation on Mac

Same as above except that a working installation of XCode and its command line tools is required as prerequisite. As a workaround it is recommended to install Ubuntu in a virtual machine on your Mac.

As with Linux, the installer script downloads the required tools and libraries with the following caveats:

  • you have to read the installation instructions beforehand
  • you have to install the XCode compiler command line tools manually beforehand
  • you need to install homebrew manually beforehand
  • you need to install subversion via homebrew manually beforehand:
  • brew install subversion
  • then run the automatic installer script
  • ./installer.sh
  • the automatic installation may take up to an hour to finish
  • you have to download QtCreator manually
  • you may have to select a proper development kit manually in QtCreator

Installation on Windows

For Windows the framework and all the required tools such as the compilers, libraries etc. need to be installed manually. As a workaround it is recommended to install Ubuntu in a virtual machine on your Windows computer.

The installation on Windows comes with the following caveats:

  • you have to read the installation instructions beforehand
  • you have to install the MinGW or MSVC compiler manually beforehand
  • you have to install CMake manually beforehand
  • you have to install TortoiseSVN manually beforehand
  • you have to install Qt manually (e.g. via the Qt online installer)
  • you have to install QtCreator manually (e.g. via the Qt online installer)
  • you have to run the installer.bat script
  • .\installer.bat
  • you may completely screw up your system, if you take a wrong turn, so be careful when installing all of the above!

Documentation

The above framework implements and extends the OpenGL 1.2 specification. After successful installation the class documentation is avaiable in the docs/html folder. You can open the “index.html” file in the folder with a browser like Firefox and browse the API via the documentation of the file “glvertex_api.h”.

The complete documentation is available here: 

http://sourceforge.net/p/glvertex/wiki/Documentation

A brief documentation is also available as a cheat sheet:

The official documentation for OpenGL is the so called Red Book or the “OpenGL Programming Guide”. The Programming Guide can be downloaded from here:

Options: