Weller's ToolBook Samples: Details

Background

I have been using ToolBook by Asymetrix Corp. since version 1.0 and have followed its enhancements through versions 1.5, then Multimedia ToolBook 1.5x, through 3, 4 and now into the ToolBook II series. (Note: There were no versions numbered 2.x.) I have found it a powerful tool for developing a variety of Windows-based applications. It is particularly well-suited for use in developing instructional software.
Over the years, I have conducted several training workshops and courses related to different versions of ToolBook. At the request of previous students and colleagues, I have made these various files available over the internet.
 
WARNING: My skills as a programmer have (I hope) improved over the years. I would no doubt revise considerably some of the books offered in the early stages. Take these examples as they are intended: tools for learning. I'm sure that they can all be improved.
 

Downloading ToolBook files

Many of the sample files are provided only in zipped file format. These zipped files may contain additional media files and were not originally intended for interactive access over the web.

Running Sample ToolBook files

Some of the sample files (those that are not zipped) can be run directly from the internet, if you have your system set up properly.  WARNING:  It's been quite some time since I tested these books with Neuron.  Here's the current (8/99) link to the Asymetrix site to get Neuron:  http://www.asymetrix.com/support/downloads.html  
 

(Of course, if you wish to look at samples from 1.5x and want them to work as originally intended, you'll need the 1.53 runtime files.)

Runtime Files

Asymetrix periodically changes the location of runtime files on their web site.   For current information (as of 8/99), check here:

http://www.asymetrix.com/kbsearch/showart.html?article=964

For convenience, I am placing some of the runtime files here. I am also assuming a certain degree of prior knowledge. You should know how to create subdirectories on your hard drive, how to use either pkunzip or another unzipping utility and how to edit your autoexec.bat file to modify the path statement. If you do not know how to do any of these, please seek help from a more experienced Windows user.

Multimedia Toolbook 1.53 (includes all patches, upgrades... I think). I would recommend getting this set of files; I know that my samples work properly with these. This is a zipped file. Create a new subdirectory on your hard drive. You can call the directory whatever you like, but I would suggest something informative like: mtb15run. Move the m153run.zip file to your new subdirectory and unzip it. Add the path to this directory to the path statement in your autoexec.bat file.

The 1.53 runtime version of Multimedia ToolBook cannot be run without specifying a book (later versions allow you to do this). So, if you download the sample files, you should run them by trying the following:

a. Double-click the name of the file in the file manager (or explorer). This may cause problems, however, if you have additional versions of ToolBook installed on your system.

b. Create a group and add items to the group for the various samples. In the command line, include the path to the 1.53 runtime file and tbook.exe. For example, if you have downloaded some sample files to a subdirectory called "samp153" on the c: drive

Multimedia Toolbook 3.0 runtime.

Multimedia ToolBook 1.53 samples

In 1993, I gave an 8-week, noncredit course at the University of Illinois to introduce students and faculty to Multimedia ToolBook 1.5.

I prepared a number of sample files for use in this class. A former student asked if I would make these files available over the web. They are provided "as is." Since posting these files, I've added a few in response to questions received via e-mail.

If you look at these files, please keep in mind that they were used in a classroom setting -- so they were supplemented by additional explanations and demonstrations.

Session 1: Overview of ToolBook and a practice exercise on the tool palette. You can look at both of these files with just the runtime version, but you won't be able to do the practice exercises unless you have the full authoring system. Sess1.zip (121K).

Session 2: Introduction to Properties. Sess2.zip (86K).

Session 3: Several books related to sound:

Ex3.zip (47k). This zipped file contains 1 book and 3 sound files. Illustrates various ways of controlling sound using MCI openscript statements.

Chiffres.zip (978K). This zipped file contains 1 book and a very large wave file (over 2 MB unzipped). It is an example of playing sections of a large wave file. (Uses French numbers.)

Story1.zip (211K). This zipped file contains 1 book and several wave files used in the book. It was an exercise I had my class work on -- to explore playing sounds by clicking on objects. There is also a large collection of wave and midi files that can be accessed through the book for exploration purposes. To get this, download Allsnds.zip (1.4 MB). But you can look at the basic book without it.

Session 4: Two books and related files -- deals with graphics.

Sess4.zip (1.1MB). (Unzipped files = 14, totalling just under 2 MB.)

Session 5: The ex5.zip file contains one book and 29 related files. More about controlling external bitmaps. To look at this book, be sure you have the 1.53a upgrade for Multimedia ToolBook.

Ex5.zip (670 K). (Unzipped files = 30, totalling about 1.7 MB.)

Session 6: No NEW files -- it was a catch-up week.

Session 7: Data collection -- how to write external ascii files.

Important: password to switch to author level = demo

Ex7.zip (54 K). (Only 1 file, unzipped = 164 K.)


SPECIAL REQUESTS (from students, e-mail colleagues, etc. These files were NOT part of the original workshop.)


Ques1.zip (8K). First in several (I hope) examples of how to set up question / answer interactions. This book shows one strategy, involving the use of recordfields. August 1, 1995.

Ques2.zip (15K). Second question/answer example. This book shows how to use a single page and load questions and answers from a field on a different page of the book. August 3, 1995. MODIFIED August 8, 1995: added randomization of question items.

ctrlarr.zip (8K). Shows how to deactivate use of ctrl+arrow keys for navigation. February 2, 1996.

scroll.zip (4K). Answers a colleagues question about scrolling a field (not a scrolling field), to show a specific number of lines up and down. Oct. 1996.

Toolbook 3.0 samples

I haven't done a lot of samples in "plain" vanilla ToolBook. Any that are here can, of course, be opened with the Multimedia versions of 3 and above.

shell1.tbk (77K). (Requires non-secure mode!) This is a very simple program that could be used as a model. Explains some basic navigation scripts. Why non-secure mode: it contains a book-mark feature that must write to and save the book. If you leave your Neuron plug-in set to secure mode, you'll get an error message when you try to quit (but nothing catastrophic). If you cache the file, then return to the page, you can actually see the bookmark work!

shell1.zip (23K). Same file as above, but zipped.

dtcoltb3.tbk (87K) (Requires non-secure mode if you run with Neuron). This is the same sample data collection book using ascii text files that I have included for other versions of toolbook. Shows how you might set up a simple student registration and data tracking system.

dtcoltb3.zip (31K) Same file as above, but zipped.

Multimedia ToolBook 3.0 samples

These are the files that were originally listed as my "crashcourse." (Not intended to make your computer crash.....)

From Session #1:

Lesson 1 (less1.tbk = 560K). You can go through this lesson with only the runtime files, but you won't be able to perform all of the suggested tasks. It covers basic ToolBook components and the user interface.

Practice 1 (prac1.zip = 62K for zipped file, which contains two files: prac1.tbk = 193K and jet.bmp = 31K). You can look at this with just the runtime files, but it is really intended for use with the full authoring environment. It steps the student through using various tools; simple object creation, moving, and resizing.

From Session #3:

Lesson 3 (less3.tbk = 154K). This lesson introduces fields and record fields, how to change character and paragraph attributes and various openScript programming concepts.

From Session #4:

Kiosk Design Sample 1 (Samp1.tbk = about 1059K). Since this is such a large file, I've also provided it in zipped format: Zipped Kiosk Design Sample 1 (Samp1.zip = about 527K). In this book I present some screens taken from a commercial cd-rom to discuss the layout and user interface design.Upgraded: 4/21/95

From Session #5:

View1 (about 569K for zipped file, which contains nine files: view1.tbk = 360K, opening.wav = 137K, narr1.wav=187K, quit.avi=133K, close1.gif=62K ,close2.gif=52K, close3.gif=19K, close4.gif=45K, and nopic.gif=3K. This sample was done to illustrate how students might use viewers in their kiosk projects. It has some, but not all of the features of the kiosk template program.

Kiosk Design Sample 2 (Samp2.tbk = about 1145K). Since this is such a large file, I've also provided it in zipped format: Zipped Kiosk Design Sample 2 (Samp2.zip = about 573K). As in sample 1, the purpose of this book is to show students some screens captured from a commercial CD-ROM and discuss various interface design elements.Upgraded: 4/21/95

From Session #6:

Slides.zip (about 528K for zipped file, which contains 7 files: slides.tbk = 46K, v2arriv.bmp = 196K, bump.bmp = 208K, matador4.bmp =210K, song1.wav = 171K, song2.wav = 175K, song3.wav = 201k.) This is a sample slide show, allowing you to store lists of external images and wav files. Controls allow you to change the speed and to disable the sound. Check the book script for explanation of how things work.

From Session #7:

CueClip (about 450K for zipped file, which contains three files: cueclip.tbk = 416K, Jim1.avi = 191K, and Jim2.avi = 186K.) This is a simple demonstration of how to cue clips before playing them. Note: Thanks to James Ponder, former flight instructor at the Institute of Aviation. (He's the star of the video clips.)

Combo.tbk (about 27K). Demonstrates how to script a combo box to respond not only to changes in the selection, but also to the user having simply opened and closed the drop down list.

From Session #8:

Lesson 8 (about 278K for zipped file, which contains two files: less8.tbk = 442K and dummy.avi = 262K). This lesson deals with transition effects and contains an example of looping a video clip until you click the mouse.

Kiosk Template(about 488K). This is a template for a kiosk that I developed for my students. It contains a timer script to allow resetting to the opening screen after a predetermined time.

From Session #9:

Lesson 9 (about 227K for zipped file, which contains 18 files totalling 1045K when unzipped.) This lesson provides an example of using the built-in database features of Multimedia ToolBook 3.0 to access a dBASE 3 file. The lesson discusses using the Database Exchange book that comes with Multimedia ToolBook to create a front-end and then how to modify the front-end for a suitable kiosk design.

From Session #10:

Sess10.zip This zipped file (about 425K) contains the following: mtchdemo.tbk (691K), minibio.tbk (337K), audio.tbk (35K), and all.wav (137K). The mtchdemo.tbk book is the main portion of the lesson. It is a demo version of "Astronaut Concentration," a simple memory game where the user tries to match up pictures of astronauts hidden beneath playing cards. The player can control two options: sound effects and the display of biographies of each matched astronaut. This book illustrates many things including: randomization (of both playing cards and audio feedback), opening a viewer from a separate book, inserting menu items. The audio.tbk book is a utility book that shows how to go through a single wave file that contains separate words and set up a play list based on the duration of the desired playback (based in milliseconds).

FINAL STUDENT PROJECTS

Kisok95.zip WARNING! WARNING! EXTREMELY LARGE FILE! (about 26 MB for the zipped; about 60 MB for the unzipped) This is the final version of the kiosk we created during the course. It is designed for use on machines with THOUSANDS of colors available. We've been running it on an IBM PS/2 33 MHZ (8 MB RAM) ValuePoint, with a SONY touch monitor (ELOGRAPHICS) card. You can view it with only 256 colors, but you will get palette shift problems. Be sure to unzip the file with the -d parameter to preserve the subdirectory structures. (The top subdirectory's name and location do not matter.)

Please keep in mind that the final integrated version of the kiosk was put together rather quickly (one week) and although we have tested it, there may be bugs. It illustrates how to open viewers in separate books and how to run a timer from the main book to control shutting down other books.


Miscellaneous examples:
Drag.tbk = A very simple drag and drop example (18K).New: 6/29/95

Objsamp.tbk = An example of using the objects property (47K).New: 7/17/95

Hword.zip = Contains one zipped file, hword.tbk. This small book (30K) illustrates how you might handle switching the color used for hotwords, once the hotword has been clicked.New:12/19/95

Combofnt.tbk = This small book (20K) illustrates how you can use combo boxes in a palette viewer to change font/style/size text settings.New:1/11/96

toolLBL.zip = This small book(18K, when unzipped) illustrates how to use a timer to display an identifying label (actually another viewer) when the mouse is left inside a button on a tool bar.New:1/23/96


smaptb3.zip = This small book(18K, when unzipped) illustrates how to scroll a viewer whose scrollbar has been hidden, by placing the mouse inside the viewer.New:6/2/96

haitb3.zip = This small book(12K, when unzipped) was developed by Nick Romeos. It gives another approach for scrolling a large bitmap.New:5/28/96

Multimedia ToolBook 4.0 samples

scrlmap.tbk (77K) This small book illustrates one method for creating a scrollable viewer that can be scrolled by placing the mouse within the viewer (in corners, at top, bottom, left and right sides).

scrlmap.zip (23K; same file as above, zipped.)

more.tbk (23K) This file accesses a number of bitmap graphics, to illustrate 2 ways to display graphics (setting up separate clips for each image or setting up one clip and changing the source.) If you access this with Neuron, it will take time to download the images.

overflow.tbk (23K) How to check for text overflow and correct.

datacoll.zip (37K) This is a revised version of the data collection example I did originally for Toolbook 1.5x. This book shows how to set up a log to keep track of new users who register and how to create text files, write data to them and read the data back again. This approach to data collection is not as sophisticated as using either the CBT versions of Toolbook or using "real" databases, but it works well, especially for students who wish to collect various data for research projects. NOTE: I'm providing only the zipped version here, because the unzipped version won't work properly with Neuron (wrong DLL references). See the corresponding version for Instructor II.

newless9.zip (about 227K for zipped file, which contains 18 files totalling 1045K when unzipped.) THIS IS THE SAME AS LESS9.ZIP FOR MMTB3.0 ABOVE, but has been updated to work in MMTB4.0. This lesson provides an example of using the built-in database features of Multimedia ToolBook to access a dBASE 3 file. The lesson discusses using the Database Exchange book that comes with Multimedia ToolBook to create a front-end and then how to modify the front-end for a suitable kiosk design.

pophelp.tbk (30K). This book illustrates one way to do tooltips (pophelp viewer that appears as you enter an object). It takes into account the position of the object on the desktop and adjusts the location of the pophelp viewer to make sure the help text will always be visible. New: Oct. 1996. WARNING: If you're viewing this with Neuron, be sure to change to non-secure mode. If you just want to download, get the zipped version: pophelp.zip (about 10K).

play1.tbk (54K). This book illustrates 3 ways to control volume. It can be examined using Neuron. It contains 2 audio files that will download when needed (50K + 75K). Jan. 11, 1997

play1.zip (94K). Same as above, includes book and both audio files. Jan. 11, 1997

banner.tbk(17K). Bare-bones example of using a timer to make text appear in a field to give a special effect. Illustrates doing this both as you enter the page or by clicking a button. (Added January 21, 1997)

mtb4calc.tbk(53K). I converted this from the calc.tbk from Multimedia ToolBook 1.53. I had to edit a function in the book script, because MMTBK4.0 didn't like the lack of a final return statement at the end.(Added 3/28/97)

mtb4calc.zip(21K). Same as above, but zipped.

Instructor II samples

genNum.tbk (62K). Example of using openscript to automatically generate a list of numbers, converted to words. (Added 4/4/97)

backdrops.tbk (177K) Demonstrates reading resources into a listbox and changing the backdrop via openscript.

datacol5.tbk (103K) Same as datacoll.zip above, but modified to call the correct DLLs to work with Neuron. If you run this with Neuron, you will need to set Neuron to the non-secure mode, because it writes files to your computer. If you register, it will create a data directory in the cache directory of your browser.

NEW: 12/96: A shell for Windows 95 (to replace the explorer.exe standard shell).

I have created an application to meet our needs in our student lab. We wanted a program that we could add buttons to (links to other programs) and essentially keep students from having easy access to everything on the system. I am offering this AS IS. We are using it and I've already fixed a few bugs (but there could be more). If I make changes, I will update the files here. The current version is: 1.0.4. (Upgraded 1/14/97) IMPORTANT: Password for the installation version is:

hogwash

You can set your own password once you gain access to the shell controls.

This program works ONLY for Windows 95. Do NOT try to use it with any other version of Windows. There is a readme.doc file and some help buttons sprinkled here and there.

This was created using Instructor II and I don't have the time to recreate it using other versions of ToolBook. So, if you don't have Instructor II, but would like to try out the shell, you can download the complete installation set:

disk1.zip (1.4 MB)-- unzipped, 3 files: setup.exe, avishell.asu, avishell.001

disk2.zip (.89 MB) -- unzipped, 1 file: avishell.002

readme.doc (14K) -- overview of the program

After you download you can unzip to a single directory on your hard drive and run the setup.exe program (or you can copy to individual disks and run setup from disk1).

If you have Instructor II and would just like to see the program (all scripts are intact), you can download just this file:

avishell.zip (54K). It unzips to the avishell.exe program. This file should be placed in your windows directory to function properly.

Note: Even if you install the program, nothing is done automatically to your windows setup. You have to run the avishell program and explicitly tell it to use it as the shell (and then restart).

I would welcome comments and bug reports. Send me e-mail: m-weller@uiuc.edu.


Added 4/8/98: dbexchng.zip. (148K). This has been "fixed" to work with Toolbook Instructor, version 6.1. Please note: I needed it to work well enough to let me import Paradox and dBASE files into toolbook recordfields. The biggest problem I had with it was that it wouldn't save the new book. It still won't work right if you try to overwrite an existing book, but other than that it works for what I wanted. If anyone downloads it and improves it and would like to have it put back up here -- great!