XTrkCad Installation Notes

Downloading Help

When you click on the link to download XTrkCad your browser will attempt to open the file. Your browser may not recognize this file format and prompt to ask you what you want to do with the file. You should indicate you want to save the file on disk in a temporary directory (such as C:\TMP).

Check that you have the necessary disk space for the downloaded file.

MS-Windows Installation Notes

XTrkCad runs under MS-Windows9x/NT/2k.

You will need approximately 3Mb of disk space. A Pentium (x86) is the minimum recommended system.

XTrkCad is shipped as a self-extracting, self-expanding program using the Freeman Installer from TipTec Development. The installation program runs on MS-Windows.

Installing XTrkCad

Download XTrkCad from the WWW or insert the floppy disk containing XTrkCad into your A: drive.
You can rename the downloaded file, if desired. Note that renaming the file with a name longer than 15 characters can cause errors when trying to install.
From the Program Manager File|Run menu (or from the File Manager) execute XTC32314.EXE from your download directory or the A: drive. You will be prompted for a destination directory. A new program group with XTrkCad icons will be created.
Open the XTrkCad icon and try it.

You can install the new version over top of your existing version or you can install the new version in a different directory. If you choose a different directory be sure to copy the files from your XTrkCad working directory to your new version. This files include xtrkcad.ini, xtrkcad.key and xtrkcad.cus.

Common Problems

Install program fails with an error dialog: "Check failed at line 116 in file BSFSPN.CPP" or "Check failed at line 1691 in File ICTRLLER.CPP"
The download was not complete. Check that the file size is correct and download the file again.
I've installed a new version but it appears that I'm not registered any more. Also, my custom turnouts are missing.
Remember to copy files from the XTrkCad working directory as noted above.

Special notes for certain video cards:

S3 Savage4: Users with this card report severe system corruption problems. The driver must be updated. The latest driver version can be downloaded from S3
ATI ALL IN WONDER 128, driver version 4.12.6269: Users report extraneous vertical and horizontal lines being drawn when objects staddle the Left or Top edge of the main canvas. This can be corrected by adding the following to the XTRKCAD.INI file:
```
    [msw tweak]
    NoNegDrawArgs=1
```

Linux Installation Notes

XTrkCad is an 'elf' program and runs under RedHat Version 7.x (Linux version 2.4.x). It will probably run under other versions of Linux.

XTrkCad requires GTK 1.2 and X11R6:

libgtk-1.2.so.0 => /usr/lib/libgtk-1.2.so.0
libgdk-1.2.so.0 => /usr/lib/libgdk-1.2.so.0
libglib-1.2.so.0 => /usr/lib/libglib-1.2.so.0
libXext.so.6 => /usr/X11R6/lib/libXext.so.6
libX11.so.6 => /usr/X11R6/lib/libX11.so.6
libm.so.6 => /lib/libm.so.6
libc.so.6 => /lib/libc.so.6
libgmodule-1.2.so.0 => /usr/lib/libgmodule-1.2.so.0
libdl.so.2 => /lib/libdl.so.2

XTrkCad is shipped as a gzip'd tar file or as a RPM file:

gzip'd tar file

      download xtrkcad-linux-elf.3.1.4-1.tar.gz to a TEMP directory
      cd /usr/local/lib
      tar xvfz ${TEMP}/xtrkcad-linux-elf.3.1.4-1.tar.gz
      Installation into a directory other than /usr/local/lib requires that you set
      the environment variable XTRKCADLIB to point to the installation directory.

RPM file

      download xtrkcad-3.1.4-1.i386.rpm
      either
      rpm -e xtrkcad                  Remove any previous version of XTrkCad
      rpm -i xtrkcad-3.1.4-1.i386.rpm You will need to be root to run rpm
      or
      rpm -u xtrkcad-3.1.4-1.i386.rpm To Upgrade a current install

An HTML version of the help file will be installed in /usr/local/lib/xtrkcad/html.

The Linux version uses libc6, glib+-1.2 and gtk+-1.2. If you haven't installed glib/gtk yet you can download them from www.gtk.org Note: these files are part of the Gnome release.

Special Notes for Fedora users

If XTrkCad fails to load due to undefined symbols XShmQueryVersion or XListInputDevices, use the following command line to invoke XTrkCad:

LD_PRELOAD=/usr/X11R6/lib/libXext.so.6.4:/usr/X11R6/lib/libXi.so xtrkcad