| Windows download and installation | |||
|
Windows installation of the PD2 is a two step process. These step are automated so you don't need to do anything special,
but you will see several windows come and go as the installation progresses. Since PD2 is a Java application there isn't
any special registry entries that need to be made as there are with a typical Windows application. Because of this, our
system doesn't need the overhead of a Windows Installer. Here we are using simple self-extracting WinZip files and a
Windows command file to make sure everything get put in the proper locations.
Please take a moment to review the notes below related to Setting the amount of memory available to the application and Initial Setup. The following steps describe the process of downloading and installing PD2 on your Windows machine. |
|||
| 1. |
Select the version you want and download it to an area of your hard drive. (Most people save it to their desktop.)
If you are offered the option to Run or Save, please select the Save option. Do not run it from the web. |
||
| 2. |
Double-click the downloaded file. This file will have a WinZip icon associated with it and is a self-extracting WinZip
file.
You may see a Security Warning telling you the publisher can not be verified. This is ok, just select the Run option. |
||
| 3. |
Depending on the speed of your machine you may see a WinZip window telling you that contents are being extracted
to your temporary folder. You do not need to do anything at this point.
Eventually, this screen will be replaced by a Windows command shell window and then you will see the PD2 welcome screen overlaid on it. When this screen appears, click the OK button. |
||
| 4. |
You will see another WinZip window telling you that contents are being extracted. Again you do not need to do
anything at this point. This is the actual installation.
When the extraction is complete all the windows will disappear and you will see the PD2 icon on your desktop. The application is installed and you are ready to use the software. You can remove the download file now if you wish or copy it to a backup area so you can reinstall it later or on another machine. To uninstall the application simply drag the PD2 shortcut (from your desktop) and the entire tbcpd2 folder to the Trash. |
||
|
* Vista users note: Due to Vista's security restrictions, a shortcut to the application may not be placed on your desktop. If this should happen you can copy the shortcut installed in the application folder to your desktop manually. The shortcut is named PD2 and is locacted in the c:\tbcpd2 folder. |
|||
| Setting the amount of memory available to the application | |||
|
The Java Runtime Environment (JRE), as do most language systems, limits the amount of memory an application can
use. This is to prevent programs from running away with your computer and thereby crashing your operating system.
Unlike other languages, Java allows us to tell it how much memory an application can use. This is accomplished by providing
parameters to the JRE at the time the application is started. Since our program runs within the JRE these can not be set
from within the program but must be specified before the program is started.
Because Java is designed to run on almost any computer, the default memory allocated to an application is rather small. PD2 is a graphical program and by its very nature is rather memory intensive. The default memory allocation will not be sufficient to make any but the smallest patterns. The shortcut created during installation changes Java memory allocation such that you can create moderately large patterns. You will probably not need to changes these entries. You will only need to modify these parameters if you are getting "out of memory" errors while creating patterns, or if your machine has less than 512Mb of physical memory. Follow these steps if you find you need to change the amount of memory allocated to the JRE. |
|||
| 1. | Locate the shortcut you use to start PD2. Using the right mouse button, click on the icon. | ||
| 2. | Select the properties option from the pop-up window | ||
| 3. | You will see a line reading %windir%\system32\javaw.exe -Xms40m -Xmx512m -jar tbcpd.jar in the text box labeled Target: | ||
| 4. |
Find the entry -Xmx512m. This entry indicates the maximum memory our application can
use and is specified in mega-bytes. As a general rule you can set this value to approximately 75% of your physical
memory so if you have 2Gb (giga-bytes) of RAM then you could increase this entry to 1536. If on the other hand,
you only have 256Mb of RAM you would want to change this entry to 192. This value is alway specified in mega-bytes. Change the number 512 to the value appropriate for your machine. |
||
| 5. | Click the OK button to save your changes. | ||
| Caution: make sure you don't change any other entries or any of the spacing in the command line. If the application fails to start after changing the parameter, repeat the steps above and check that the command line looks exactly as described above. You can alway retype it or copy and paste it from this page if necessary. | |||
| Initial Setup | |||
|
You must set the path to your PDF Reader application before you will be able to access the User's Guide from within the application.
The steps you take to set this entry are cover in the User's Guide (TBCPDUsersGuide.pdf) which is located in the \tbcpd2\Docs folder
in the section titled Setting your preferences in Lesson 10 - Customizing your application. For your convienence it is
reprinted here:
The most popular PDF viewer for Window is the Acrobat Reader from Adobe Systems. This examples uses version 8 of the Acrobat reader but these steps should work for any other version. Note: This example assumes you have installed the Acrobat Reader to the default location. If you have installed to any other place you must substitute the path in our example with that location. Most installations default to C:\Program Files\Adobe. Click on the folder icon to the right of the PDF Reader input area. The File Open window will start in the current folder which will most probably be C:\tbcpd2. Regardless, use the Look In: list box to find where your reader is installed. In most cases it will be found at C:\Program Files\Adobe. Click on the downward pointing triangle next to the Look In: list box and select Local Disk (C:). You will see a list of files and folders. Double-click on the folder named Program Files (substitute the folder where you installed your reader if other than the default location). Single clicking a folder selects it while double-clicking opens that folder. Now double-click on the folder named Adobe. You may have more than one version of the Reader installed on your system so you may see more than one folder here. Each should be identified by a number. In the case of this example, we are using version 8 of the reader so our folder is named Reader 8.0. You may use whatever version you want. Double click on the version numbered folder to open it. Open the folder named Reader. Select (single click) the file named AcroRd32.exe and click the Open button. The finder window will close and the full path and file name will be inserted into the PDF Reader input box. Example: C:\Program Files\Adobe\Acrobat 7.0\Reader\AcroRd32.exe |
|||