CourseDownloads.com Logo
Welcome Guest - Login | Register
 Install Courses for Tiger Woods 2003
 
Tutorials - Tiger Woods Course Installation
Install Courses for Tiger Woods 2003
Install Courses for Tiger Woods 2003
Added by: Guest
Date Added: Jan 4 07 @ 7:12:25 AM
Total Views: 8,809

CLSetup - A course and library installer for Tiger Woods 2003

Version 1.5, released October 2nd, 2003
For release information, please see the included readme.txt file

This document was last updated on October 2nd, 2003

Table of contents

License agreement
Background
A solution
A sample installation
The property dialog
Other features of CLSetup
Tips and tricks
A note to course designers
Uninstalling CLSetup
Support
Credits

License agreement

It's simple: CLSetup is the intellectual property of me, J￿n Ekroth. CLSetup is 100% freeware, and you may use it as you see fit, for your own pleasure. CLSetup may however not be placed on web servers or included on media such as CD-ROMs targeted for purchase without my permission.

This program is not endorsed by or affiliated with Electronic Arts, or its licensors. Trademarks are the property of their respective owners. Game content and materials copyright Electronic Arts Inc. and its licensors. All Rights Reserved.

Background

The Tiger Woods 2003 golf sim comes with a course utility tool that can be used for installing and uninstalling courses and libraries. However, installing courses is not as easy and straightforward as in other golf sims like Jack Nicklaus 6 (GBC) or the Microsoft Links series. In those sims you simply copy the course file into the course folder and you are set. In Tiger Woods, you need to perform at least two manual steps before the installation can be done, namely unzipping the distribution archive, and create a folder for the course or library to be installed in. There are also a few course assets that the Tiger Woods game can use, but the supplied Course Utility program cannot assign them.

A solution

CLSetup offers a solution to these shortcomings by making things easier for the end user. The program handles the unzipping and directory creation automatically, and can also make full use of all available course assets, provided that the designer of the course has included them in the distribution archive.

A sample installation

When you start CLSetup, the dialog to browse for a release archive automatically opens, since this is the most likely operation the user will select. When you have located either a ZIP, TCX or TCL archive, press Ok to continue. Note that you can select more than one file.

HINT: If you want to install a course and a library that the course requires, make sure you select the files in the correct order. The library needs to be to the left of the course in the file name box. For this to work, first click on the course, then hold down the Ctrl key and click on the library.

CLSetup will now unpack the ZIP or TCX file. In case the ZIP file contains a TCX file, the included TCX file will unpack at the same time. After that, CLSetup searches through the supplied files and tries to determine what actions should be taken.

  • If CLSetup finds a TCR file, the package is assumed to be a course.
  • If a TCL file is found, the package is assumed to be a library.
  • If neither a TCR nor a TCL file is found, CLSetup will abort the current installation.

CLSetup then automatically suggests an installation folder based on the type of installation:

  • If the installation is a course, the suggested installation folder is a subfolder to the EA SPORTS/Tiger Woods PGA Tour 2003/Courses folder. The name of the suggested subfolder is the name of the course, as found in the TCR file.
  • If the installation is a library, the suggested installation folder is a subfolder to the EA SPORTS/Tiger Woods PGA Tour 2003/libraries folder. The name of the suggested subfolder is the name of the library, as found in the TCL file. Note that there is no original libraries subfolder to the Tiger Woods PGA Tour 2003 folder. This is just a suggested way to keep things nice and tidy, and avoid problems caused by libraries with identical file names. If you accept the suggested folder, the libraries folder will be created for you.

NOTE: If you have selected not to use the suggested default library target path, the user-specified library target path will be used instead. See the program properties for more information on this option.

You now have four choices:

  • Accept the suggested folder by pressing Ok.
  • Browse to an existing folder by clicking on the folder button to the right of the field where the suggested folder is displayed.
  • Edit the suggested folder by making changes in the edit field.
  • Cancel the installation by pressing Cancel.

If you decide to continue after either accepting the suggested folder, or after choosing a new folder, CLSetup will show a final acceptance dialog box where you can either accept to go ahead with the installation, or to abort it. If you decide to proceed, CLSetup first verifies that the course or library isn't already installed, and that all dependant libraries are present. (If one or more required libraries are missing, you will get a warning message, but you can still install the course) After that, CLSetup creates the installation folder, copies all the needed files, and finally registers the course or library in the TW2003 course and library registry.

The property dialog

CLSetup has a special dialog box to edit the available program properties. You reach this dialog from the menu, or by pressing Ctrl/P on the keyboard. The following properties are available:
  • Warn when overwriting files in the target folder - If a file with the same name as the file being copied is present in the target folder, you will be asked if you want to keep the original file or overwrite it. Uncheck this box if you always want CLSetup to overwrite the files in the target installation folder.
  • Warn on cloaked libraries - If a library required for the course you are installing is cloaked using the CLTool utility, you will be presented with a warning. Uncheck this box to hide the warnings in future installations.
  • Save properties at program exit - If you make changes in the property dialog, these will be saved when you exit the program. Uncheck this box if you want to make a temporary change to the properties during an installation session.
  • Always ask for a target installation folder - If this box is checked, you will get a dialog box where the target installation folder can be specified. Uncheck this box if you always want CLSetup to install in the suggested default location.
  • Always ask the user to acknowledge the installation - If this box is checked, you will get a popup box where CLSetup asks you to acknowledge the installation. Uncheck this box if you always want CLSetup to automatically proceed with the installation.
  • Installation path - The root folder to use when suggesting the installation folder. Default is the Tiger Woods PGA Tour 2003 folder. Change this if you want to install your custom courses outside the game folder structure.
  • Install libraries in dedicated subfolders under the libraries folder - When checked, CLSetup will suggest a library installation path based on the installation path root followed by a libraries subfolder, and a subfolder based on the library name. Uncheck this to install all libraries into the same folder.
  • Library folder - If the dedicated library folder option is unchecked, this folder will be the target folder for all libraries being installed.
  • Remember the folder where you last opened an installation archive - When checked, CLSetup will automatically record the folder you navigated to when opening the last install archive and update the Archive folder property with it.
  • Archive folder - The folder in which to look for installation archives.
  • Always ask for a flag if no flag is present in a course - If this box is checked, CLSetup will ask the user to choose a custom flag file if no flag file has been detected in the selected installation archive.
  • Flag folder -  The folder in which to look for custom flag files.

Other features of CLSetup

  • CLTool integration - In case you have CLTool installed, CLSetup will take any cloaked courses and libraries into account when looking for installed and required courses and libraries, which means that there is no need to uncloak anything before installing. If required libraries are cloaked during installation, you will get warning messages about this. These warnings can be disabled through the program properties.
  • You can replace the splash screen image in the program window with your own customized image. Just replace the supplied clsetup.bmp file with your own graphics. For best results, please keep the image size identical to the original graphics. Any valid Windows bitmap will work as long as the name of the file is clsetup.bmp.

Tips and tricks

For the more experienced PC users, CLSetup has the ability to automatically open an installation archive if the name of the archive is given as an argument to CLSetup. This can be done in two ways:
  • In Windows Explorer, click on the ZIP file, then hold down the shift key and right-click on the ZIP file again and choose "Open with...". Select "Other program..." and browse to the CLSetup executable. Click ok. If you are running Windows XP, this choice will be remembered next time, so you will have an "Open with" submenu where CLSetup is one of the choices. Note that "Open with" only works with one file, even though more than one file is selected. This is the way Windows works.
  • Create a shortcut to the CLSetup executable in the "Send to" folder. Depending on your version of Windows, the send-to folder is either in your Windows directory (Win95/98/Me) or in your Documents and Settings/<user> folder. (Win2000/XP) Send-to works with multiple files, so you can select more than one file, right-click on one of them and choose CLTool as the target for "Send to".

A note to course designers

CLSetup has the ability to assign some special assets to a course that the standard Course Utility program cannot currently handle. These assets are:
  • Custom flag - It is possible to assign a flag manually by copying a file named flag.dds into the folder where the course is installed. However, the game has a special registry entry for assigning the flag, so now you can name the flag anything you like, as long as it is a DDS file. If CLSetup finds a DDS file in the course ZIP archive, it will automatically assign this file as the custom flag.
  • Hole sounds for the caddy book - These are MP3 files that play when the user presses the "Caddie strategy" button in the caddy book. The files must be named hole1.mp3 through hole18.mp3. CLSetup will assign them to the course if they are included in the course ZIP archive.
  • Course initialization file - This is a file with extension .ini that should be in the same location as the .tcr course file. It must also have the exact same name as the course.  (Except for the extension) Have a look in the stock course folders for a guide on what you can customize. CLSetup will copy the file to the proper location if it is included in the ZIP archive.
  • Caddy book notes - This is a file with extension .tcn found in the EA SPORTS/Tiger Woods PGA Tour 2003/Data/CaddieBook/Course Notes folder. It must have the exact same name as the course file. (Except for the extension) CLSetup will copy the file to the proper location if it is included in the ZIP archive.

CLSetup tries to determine the course assets by looking at the contents of the release archive, so if you follow a few golden rules, CLSetup will do its best to assign the correct assets to your course. These are the rules:

  • Always use the standard Course Utility program when you pack your course and its basic assets for release. This ensures 100% compatibility with users who do not use CLSetup.
  • Don't pack an extra copy of the splash screen in the ZIP archive unless the extra copy is identical to the splash screen inside the TCX file. If CLSetup finds more than one BMP or TGA file, it always assigns the last one it finds as the splash screen.
  • If you want to pack a README or design notes text file in the release archive, make sure the file you pack is larger than the course text file in the TCX file. If CLSetup finds more than one TXT file, it will always assign the smallest of the files as the course text.
  • Never use a DDS file as course splash screen, even though the Course Utility program will allow it. If more than one DDS file exists, CLSetup will not be able to tell which DDS file is the splash screen and which one is the custom flag.
  • Never use a RTF or HTM file as course text. These formats aren't supported by the game anymore, even though the Course Utility program allows them to be used. CLSetup will ignore RTF and HTM files.
  • If you decide to include caddy book sounds, make sure you include a file for each hole.

That's basically it. Future versions of CLSetup may incorporate an initialization file to simplify the asset assignment, but for now I feel that the deterministic way is good enough, provided that you obey the rules above.

Uninstalling CLSetup

You uninstall CLSetup by manually deleting all files in the folder in which the program was installed. CLSetup keeps all its data in the file system and does not create any application level entries in the system registry.

Credits

  • CLSetup contains zlib code. Zlib is copyright (C) 1995-2002 Jean-loup Gailly and Mark Adler. See http://www.zlib.org for more information.
  • CLSetup also contains the contributed zlib Unzip package. Unzip is written by Alessandro Iacopetti and maintained by Gilles Vollant. See http://www.winimage.com/zLibDll for more information.
  • The CLSetup icon is a modified version of an icon found in the SketchCons package. For more information, see http://www.iconfactory.com.
There are 1 active members online
Marklk,
 
Forum Statistics

RSS Feed

Install Courses for Tiger Woods 2003 Loaded in 0.156 seconds
Wednesday, August 21, 2019 @ 11:06:20 PM

Copyright 2019 - CourseDownloads.com
All Rights Reserved - No part of this site may be reproduced or used without express written permission of the CourseDownloads.com Staff

CourseDownloads.com is not endorsed by or affiliated with Electronic Arts, or its licensors. Trademarks are the property of their respective owners.
Game content and materials copyright Electronic Arts Inc. and its licensors. All Rights Reserved.