Installing the Library
Installation on a Web Server
The library is deliverd as a zip file. Upload the zip file to your private protected web
server and unpack it into the document root directory
(or alternatively upload the unpacked zip). The zip file contains
a single top-level folder named taccgl062.
Installation of taccgl on a public web server is discussed below.
Afterwards point your browser to /taccgl062/index.html on your web site.
On successful installation this shows some simple examples.
Multiple versions of the library can coexist on a server, see the Upgrading section below.
The library is deliverd as a zip file.
You can simply unpack the zip file in a directory of your choice and
then open the index.html file contained therein with your web browser.
Opening the index.html file while it is still stored in the zip will not
work, you need to completely unpack the zip file.
Note, however, that some browsers (e.g. chrome and webkit) apply
stronger security checks for local access and so not all features
will work locally unless you start the browser with specific
options. Therefore we would recommend to install a local web
server and then follow the "Installation on a Web Sever" below.
If you nevertheless install it locally, you need to use the
options without them many examples will silently stop working
(i.e. there are security messages on the debugging console only)
which can be very frustrating.
Please go ahead and read about the options.
Installation on a Public Web Server
After installation of the zip file on a web site, besides the
library itself, some simple documenation and example files appear on
the web site. Since this is not normally intended on a public web site it is recommended
to install the zip on a protected private test site only.
Afterwards just deploy the taccgl.js file to a public web server.
The doc, parallax-scrolling-examples, and pic directories and
the README, README.md, index.html, LICENSE, and WARNINGS files are not needed for normal
The files in the src subdirectory are needed for
debugging and development of the library and contain an uncompressed
version of the library. They are not needed on a production server,
unless debugging is needed.
Final Installation Steps
On a production server we recommend to enable gzip compression (e.g. using the apache deflate module)
to compress the library and the 3D model files and so speed up page loading times.
Upgrading from older Versions
You can install multiple versions of the library at the same time.
After installation of a new version, you need to update the version number
in the <script> statements of pages using the old version, see Including the Library.
Only afterwards, you can delete the old version by deleting the corresponding /taccgl??? directory.
WebGL™ is a trademark of the Khronos Group Inc.