FAQ

Welcome to the FAQ page! In here, we try to answer the most common questions that users may have in regards to TSGL.

Q: A test keeps crashing with the error "the font file could not be opened and read"! What do I do?

A: Are you in the bin folder of the tsgl folder? Some tests won't work unless you are in the bin folder. Specifically:

testBlurImage, testCalcPi, testCosineIntegral, testGetPixels, testGreyscale, testImage, testImageCart, testInverter, testMandelbrot, testPhilosophers, testProgressBar, testSpectrogram, testText, testTextCart, testTextTwo, testUnits

If the test that keeps crashing is in the list above, go into the bin folder and execute it from there.

Q: What is the maximum number of threads I can use in Windows?

A: You can only have up to 64 threads at a time in Windows.

Q: Why won't my tsgl Solution build in Windows?

A: Have you built the tsgl project first? You must build that first in order to create the lib file for TSGL. Then, you can build the entire Solution.

Q: Does TSGL have Debug messages in case things break?

A: In fact it does. Check out the Error.h file and you will see a commented out line:

//#define TSGL_DEBUG

Uncommenting out this line will turn on Debug messages for the TSGL library in case things break (font not loading, image not found, etc...).

Q: With which operating systems does TSGL work?

A: Good question! TSGL has been successfully tested on: Ubuntu 14.04 (Trusty Tahr), Ubuntu 16.04 (Xenial Xerus), Arch Linux, MacOS 10.9.5 (Wrangler), MacOS 10.10.x (Yosemite), and MacOS 10.11.x (El Capitan) using g++-4.8, g++-4.9 and g++-5.1. It has also been successfully tested on Windows 7 & Windows 10, using Visual Studio 2012, Visual Studio 2013, & Visual Studio 2015. As for Red Hat distributions, CentOS 7 and Fedora 24.

Q: How do I update the Doxygen?

A: I'm glad you asked! Follow this process (via terminal or command-line):

1). Navigate into the TSGL root directory (where the Makefile is).

2). Type "make cleandocs".

3). cd into the "docs" folder.

4). Type "git rm -r html".

5). cd back out of the "docs" folder (cd ..).

6). Type "make docs".

7). cd into the "docs" folder again.

8). Type "git add html".

9). Do a "git commit" inside of the docs folder.

10). Type "git push origin gh-pages".

11). cd back out of the "docs" folder.

12). Do a "git add docs".

13). Do a "git commit".

14). Type "git push origin master".

NOTE: This process is for people who have cloned the repository on Linux/Mac. Windows users may use gitbash, though that has not been tested.

BIG NOTE: You NEED doxygen 1.8.6 in order to update the documentation correctly. Previous versions will cause a LOT of problems.

Q: I'm an Ubuntu user. Is there a Debian package out there for TSGL?

A: Indeed there is! As of summer 2016, TSGL has a Debian package for easy installation. See the Debian (Aptitude) page.

Q: What about Red Hat users? Is there an RPM package?

A: Of course! See the RPM page!

Q: So, if TSGL has a Debian package, and an RPM package made, how do I create new ones?

A: Take a look at our Creating New Deb Packages and Creating New RPM Packages pages. However, it is not recommended, as the process for creating these packages has already been automated.

Q: A new version of Visual Studio has come out, but there's no TSGL Solution made! How do I create one?

A: Good question! Check out our New Visual Studio Versions page for detailed instructions on how to make a new Visual Studio Solution.

Q: What about a binary installer for MacOS X? If I recall correctly, it was especially difficult to install TSGL on a Mac...

A: Yes, the process was a tad bit difficult for MacOS X users. Luckily, we have made a new MacOS X .pkg Installer which automates the entire installation process. Take a look at the MacOS X page.

Q: What about creating new MacOS X .pkg Installers?

A: Excellent question! See the Creating New MacOS X Packages page.