# Downloading Tongue Viewer

## Windows binaries

I hate having to build from source code, so here are some Windows binaries.

## Building from the source

In this case building from the source is not so bad. I am going to provide instructions for Windows because that is the environment I have experience with. For other systems, you can probably find appropriate instructions without much difficulty, or perhaps you can figure out how to adapt these. I'm going to make the instructions painfully explicit, because I hate build instructions that assume too much.

You will need to install Troltech's Qt, which you can probably find by Googling either of those terms. I have had success with version 4.4.0.

1. Download the source here.
2. Extract the source code. This will create a TongueViewer directory.
3. From a command prompt, navigate to that directory.
4. Run qtvars
5. Run qmake
6. Run make
7. Copy QtCore4.dll, QtGui4.dll, QtOpenGL4.dll, and QtXml4.dll into the “Release” directory that is created.

Here is a sample session, run on my Windows computer. I downloaded the source code onto my desktop and extracted it, so that there was a TongueViewer folder on the Desktop. Then I went to the Start menu, clicked Run, and then typed “cmd” into the box that popped up (no quotes). A command window popped up. I typed these lines:

cd \Documents and Settings\abaker\Desktop\TongueViewer
C:\Qt\4.4.0\bin\qtvars.bat
qmake
make


For you, the first two lines will probably look different. You need to type the appropriate path to your Desktop (or change your username to abaker), and you'll need to specify the appropriate path for qtvars.bat (it might be C:\Qt\4.4.1\bin\qtvars.bat, for instance). After the second and fourth lines, the computer printed some output.

At the end, there was a file called TongueViewer.exe in the Desktop\TongueViewer\release folder. Next I copied QtCore4.dll, QtGui4.dll, QtOpenGL4.dll, and QtXml4.dll from C:\Qt\4.4.0\bin to C:\Documents and Settings\abaker\Desktop\TongueViewer\release. At this point, you should be able to run TongueViewer.exe successfully.

## Download the data files

What you've just downloaded (and perhaps built) doesn't include any of the data files. A list of files is given below. They have all been gzip'd, so it will be necessary to decompress them before you do anything else. (See Misc. “how to” stuff)

If you put all of the data files in C:\TongueData\ directory, and you're using Windows, everything will be fine; otherwise, see the note below.

### For non-Windows and non-cooperative users

If you put the data files someplace else, or are not using Windows, you'll need to modify the XML files that you downloaded. For instance, in D1P1.xml, you'll find the line “<dConnectivity>C:\TongueData\VM21_2k_el.bin</dConnectivity>.” Tongue Viewer will be trying to find a file called, “C:\TongueData\VM21_2k_el.bin”; you need to tell it to look someplace else. For a non-Windows user it might be something like “/TongueData/VM21_2k_el.bin” or for a Windows user, “C:\I\like\to\be\different\VM21_2k_el.bin.”

You'll know if you did something wrong because Tongue Viewer will crash.

### Settings Files

These are the files that Tongue Viewer will prompt you for right off the bat; they tell it where to find the other binary data files. Start with D1P1.xml. But you may as well download all of these. They're described in Appendix C; D1P1_forillustrations.xml is the same as D1P1.xml, except that it only includes the first three parameters.

### Essential Files

You'll need these no matter what.

### Download as needed

You can download these as needed. You can tell if they're needed for whatever settings file you're using, because the settings file will contain references to the filenames. For instance, for D1P1.xml, you'll need all of the files that begin with “b19.”

### Animation Files

These are just for fun. Use them with D1P1.xml.

All contents copyright © 2008 Adam Baker