IDC Sampler 1.1
IDC Version 1.40
July 1994

K Tait, Computer Based Learning Unit, The University, Leeds LS2 9JT, UK
Email: ken@uk.ac.leeds.cbl, ken@cbl.leeds.ac.uk
Tel:   +44 532 334628   Fax: +44 532 334635
** Telephone numbers in UK will change during 1995.
** The new numbers (which can be used alongside the present ones
** from Autumn 1994) for voice and fax will be +44 113 233 4628
** and +44 113 233 4635.
------------------------------------------------------------------------

This document contains a brief description of the contents of the IDC
Sampler and instructions for installation.

Files (with some restrictions that are specifically mentioned) may be
placed in any directory.  This file does not give complete information
nor does it describe every method of doing something. Those who are
familiar with Windows and Toolbook may wish to proceed differently.
More information on IDC will be found in the document SAMPLER.WRI.

------------------------------------------------------------------------

List of Files
-------------

IDC Sampler
[Packed as SAMPLER.ZIP using PKZIP 2.04g]

	COMM140.TBK	Common handlers for all interctive documents
	EXAMPLE.TBK	An interactive document used by SAMPLER.TBK
	IDC140.ICO	Icon for IDC
	IDCS11.TBK	Interactive Document Compiler (Sampler 1.1)
	PROBLEMS.WRI	Notes on know problems and deficiencies
	RESOURCE.IDX	Resource Index for Sampler 1.1
	SAMPLER.IDC	Source Document for SAMPLER.TBK
	SAMPLER.INF	Information File for SAMPLER.TBK
	SAMPLER.OPT	Options for Sampler 1.1
	SAMPLER.TBK	Sampler 1.1
	SAMPLER.WRI	More detailed information on IDC
	SYS140.TBK	System Book for all IDCs

Working Files (see SAMPLER.WRI)
[Packed as WORKING.ZIP using PKZIP 2.04g]

	AMPHET.BMP	Structure of amphetamine
	BUTTONS.TBK	Buttons format (alternative to Menu format)
	COMPUTER.BMP	A typical PC
	COMPUTER.IMU	Markup file for COMPUTER.BMP
	CANALGD2.BMP	Canal Gardens, Leeds
	CWCCH.BMP	Clothworkers Concert Hall
	DISPLAY.TBK	A simple Toolbook application to obtain display
			characteristics
	GBSMALL.BMP	Map of Great Britain
	GH16.BMP	Great Hall (16 colours)
	GH256.BMP	Great Hall (256 colours)
	ICU1.BMP	Animation of an internal combustion
	 -ICU16.BMP	 engine (16 files)
	ILKLEYMR.BMP	Walkers on Ilkley Moor
	MAN.BMP		Primitive man
	MAN.IMU		Markup for MAN.BMP
	TOWNHALL.BMP	Leeds Town Hall
	VELTIME.BMP	Velocity-time graph
	WHARFDLE.BMP	Wharfedale, Yorkshire
	YOURS.IDC	A copy of SAMPLER.IDC for you to work with

Pharmacology MCQ Bank (Fragment)
[Packed as PHARM.ZIP using PKZIP 2.04g]

	A1.IDC		Source file for Biotransformations (Easy) *
	A1.TBK		Interactive document for Biotransformations (Easy)
	A2.IDC		Source file for Biotransformations (Average) *
	A2.TBK		Interactive document for Biotransformations (Average)
	A3.IDC		Source file for Biotransformations (Hard) *
	A3.TBK		Interactive document for Biotransformations (Hard)
	BHELP.TBK	Help document for Bank
	HELP.TBK	Help document for MCQs
	RESBANK.IDX	Resource Index for question files *
	RESMCQ.IDX	Resource Index for control *
	MENU.IDC	Source file for Menu *
	MENU.INF	Information file for Pharmacology MCQ Bank
			(Includes notes on installation.)
	MENU.TBK	Document which controls access to the Bank
	NOTAVAIL.TBK	A substitute document which is used instead of
			missing documents

Files marked with * are included to provide extra information about the
Pharmacology MCQ Bank.  The are not needed to run the MCQ bank and are
not part of the installation.  It is not possible to make any direct use
of them using the Sampler Kit. 

   **************************************************************
   * For those unfamiliar with PKZIP then here are instructions *
   * for unzipping the files.                                   *
   *                                                            *
   * If you receive the sampler on a floppy disk then type:     *
   *                                                            *
   *     A:                                                     *
   *     PKUNZIP SAMPLER C:\directory                           *
   *                                                            *
   * where directory is a directory of your choice on your hard *
   * disk.  (This assumes A is your floppy drive and C is your  *
   * hard drive.)  Repeat for WORKING and PHARM.  You may use   *
   * different destination directories each time if you wish.   *
   *                                                            *
   * If you have obtained the sampler by another method then    *
   * provided PKUNZIP.EXE is either in the curent directory or  *
   * in a directory given in the PATH environment variable then *
   * it is only necessary to change to the directory containing *
   * the sampler files and type:                                *
   *                                                            *
   *     PKUNZIP SAMPLER C:\directory                           *
   *                                                            *
   * and so on.                                                 *
   **************************************************************

This file (README.TXT) is included in the kit but is not packed with
any of the above sets.

--- NOTE ---------------------------------------------------------------
The Sampler and the Pharmcology MCQ Bank require the Toolbook Run-time
system which consists of the following files:

	tbook.exe 
	tbkbase.dll
	tbkcomp.dll
	tbkutil.dll
	tbkfile.dll
	tbkwin.dll
	tbknet.exe	*

The one marked * is only necessary if you using a network.
------------------------------------------------------------------------


Installing the Sampler
----------------------

It is assumed that TBOOK.EXE and its components are in a directory
which is mentioned in the PATH environment variable.

Copy the files to one or more directories of your choice.  Files can
reside in whatever directories you wish. However there are some files
which must be kept together.  These are:

	COMM140.TBK and SAMPLER.INF with SAMPLER.TBK

and

	SYS140.TBK with IDCS11.TBK

Create a new program item in a program group of your choice and complete
the dialogue as follows:

	Description:	IDC Sampler 1.1
	Command Line:	TBOOK path\SAMPLER.TBK
	Working directory: anything

where 'path' gives the full path of SAMPLER.TBK and the working
directory should be on a disk for which you have write access to the
root directory.  If there is no disk that meets this criterion then add
the following line to SAMPLER.INF.

	datapath:=pathname

where pathname is the path of a directory to which you do have write
access.

If the filetype TBK is associated with TBOOK.EXE then TBOOK may be
omitted from the command line.

If you would like to use the icon provided then click on Change Icon and
browse till you find the file IDC140.ICO then exit from the dialogue
boxes by clicking OK.

Make sure SAMPLER.TBK, SAMPLER.INF and a copy of COMM140.TBK are in the
same directory.

--- ** NETWORK ** ------------------------------------------------------
If you are installing the IDC Sampler on a network drive then it is
important that any files which may be shared should be set to READ-ONLY.
In particular this applies to COMM140.TBK which is used several times
even if you are the only user working with SAMPLER.TBK.
------------------------------------------------------------------------

The Information File SAMPLER.INF must be edited to reflect the
organisation of your system (use Notepad or other text editor).

This is the file as supplied:

	Information file for IDC Sampler
	sampler:=c:\ken\idc\sampler
	example:=c:\ken\idc\sampler
	windows:=c:\windows
	toolbook:=c:\toolbook
	
Change line 3 so that right hand side of the equals has the path to
the file EXAMPLE.TBK.

Change line 4 so that right hand side of the equals has the path to
the file WINHELP.HLP.

Change line 5 so that right hand side of the equals has the path to
the file PAGES.TBK.  This file is supplied with Toolbook and is normally
found in the same directory as TOOLBOOK.EXE and TBOOK.EXE.  (If this is
not the case then the link from SAMPLER.TBK to PAGES.TBK may prove
problematic and can only be fixed by editing RESOURCE.IDX and
recompiling SAMPLER.TBK -- this procedure is described in SAMPLER.WRI.)

Change line 6 so that right hand side of the equals gives a path which
is valid on your system and to which you have write access.

Open the Sampler by double clicking its icon.  Using SAMPLER.TBK is
quite straightforward, but more information about using interactive
documents is given in SAMPLER.WRI.  You should also read the section
in SAMPLER.WRI about display devices.

--- WARNING ------------------------------------------------------------
Errors in the information file may lead to run-time errors and even the
possibility that the intereactive document may not function correctly.
The normal way to leave Toolbook in such circumstances would be to type
control-X.  In any interactive document produced with IDC this is
password protected to ensure that the normal exit route is taken and
datafiles are correctly updated.  The request for the password occurs
after control-X is typed and the password for SAMPLER.TBK is please.

It is possible to change the password for a particular interactive
document.  The procedure is described in SAMPLER.WRI.
--- NOTE ---------------------------------------------------------------
The IDC and interactive documents supplied in this sampler are designed
for a VGA screen.  If your screen is VGA then the pages will completely
fill the screen.  If your screen has a resolution which is greater than
VGA then the page will be centred on your screen.  If it has a lower
resolution that VGA then an error message will be generated.  This last
case has not been tested.  It is possible to create interactive
documents with pages which are either VGA size or SVGA size.
------------------------------------------------------------------------

Installing the Compiler
-----------------------

This will allow you to re-compile the Sampler or compile a source
document of your own. (Ways of doing these are outlined in the document
SAMPLER.WRI in the section SOME THINGS TO TRY.)

IDC requires the full Tolbook Authoring Ssystem and it is assumed that
TOOLBOOK.EXE and all its components are in a directory mentioned in the
PATH environment variable.

Create a new program item in a program group of your choice and complete
the dialogue as follows:

	Description:	IDC 1.40 Sampler 1.1
	Command Line:	TOOLBOOK path\IDCS11.TBK

	Working directory: anything

where 'path' gives the full path of IDCS11.TBK and the working
directory should be on a disk for which you have write access to the
root directory.

If you would like to use the icon provided then click on Change Icon and
browse till you find the file IDC140.ICO then exit from the dialogue
boxes by clicking OK.

Make sure IDCS11.TBK and SYS140.TBK are in the same directory.

Open the Compiler by double clicking its icon.

In the file SAMPLER.WRI in the section headed SOME THINGS TO TRY there
is a detailed step-by-step guide to using the compiler.

--- NOTE ---------------------------------------------------------------
It is recommended that the compiler is run from a local disk -- NOT a
network disk.  Although this is possible it should keep things simpler.
------------------------------------------------------------------------

Installing the Pharmacology MCQ Bank
------------------------------------

Only a fragment of the Pharmacology MCQ Bank is supplied.  In the full
bank contains some 1500 questions in 22 topics.  These questions have
been collected over more than ten years.  The system supplied with this
sampler has been in use since the beginning of October 1993.

It is assumed that TBOOK.EXE and its components are in a directory
which is mentioned in the PATH environment variable.

Copy the files to a directory of your choice.  (At Leeds the bank
resides in two directories but for simplicity only one need be used for
this fragment.)

Modify the text files MENU.INF using NotePad or another text editor.

The file as supplied looks like:

	Information File for Pharmacology MCQ Bank
	content:=c:\ken\idc\sampler
	control:=c:\ken\idc\sampler
	datapath=c:\ken
	recordfile=pharm93.srf
	scores=tright,twrong,tdontknow
	weights=1,-1,0
	bookmarks=none
	end

--- NOTE ---------------------------------------------------------------
Those variables (names to the left of the equals) which have colons at
the end of their names (for example, sampler:) must always be given file
paths as values.  Other variables (there is only datapath) in this case
may have any string as a value.  In this particular case datapath is
assigned a file path as a value.

For consistency datapath has been changed to datapath: in version 1.40,
but this copy of the Pharmacology MCQ Bank was created with IDC 1.36.
------------------------------------------------------------------------

It is only necessary to change lines 2, 3  and 4.  Lines 2 and 3 should
be changed so that (in each case) the part to the right of the equals
gives the directory into which you have copied the bank.  Line 4 should
be changed so that the path given to the right of the equals is valid on
your system.  (This is the directory used to store performance records.)

Create a new program item in a program group of your choice and complete
the dialogue as follows:

	Description:	Pharmacology MCQ Bank
	Command Line:	TBOOK path\MENU.INF

where path gives the full path of MENU.TBK.  If .TBK is associated with
TBOOK.EXE then TBOOK may be omitted from the Command Line.

If you would like to use the icon provided then click on Change Icon and
browse till you find the file IDC140.ICO then exit from the dialogue
boxes by clicking OK.

Copy COMM136.TBK to the directory containing the Pharmacology MCQ Bank.

Open the Pharmacology MCQ Bank by double clicking its icon.

--- ** WARNING ** ------------------------------------------------------
As most of the Pharmacology MCQ Bank is not supplied.  Only the FIRST
option on the main menu will work.  Further information about the bank
can be obtained from Ian Hughes, Department of Pharmacology, The
University, Leeds LS2 9JT, UK.  Tel: +44 532 334313
------------------------------------------------------------------------

Final Remark
------------

This Sampler (version 1.1) is the second to be distributed.  This
sampler is free and may be distributed to anyone who is interested
provided that the complete kit is passed on.  However, the compiler
only has a life of 400 days from the date it was created.  Please let
know if you would like this extended.

It is inevitable that there are bugs in the system which I have not
detected and aspects of the functionality that are unsatisfatory as
well as errors in the documentation.  Please let me know of anything
that will help me make the next distribution better.

Ken Tait, 20th July 1994

========================================================================
VERSION HISTORY

1.40 July 1994

Better handling of higher resolution displays (see PROBLEMS.WRI)
Improvement in the error checking including FIND button.
Interactive (marked up) images.
Animation.
More information on title page.
Closing page.
Extraction of text to clipboard.
Annotation of pages.
Remarks can be displayed without the format having its own pop-up
	mechanism.
Improvement in options file format.
End no longer required in information files.
Improvements to format compiling.
Background script for use at run-time is stored in label field.
Open with TBOOK.EXE randomizes the seed for the pseudo-random number
	generator.  Opening with TOOLBOOK.EXE does not.
Extra options on run-time IDC menu (author level only) to view
	values of variables, page lists and page keys.
Format information stored with compiled document.
Run-time error handling uses request.
Known bugs removed.
Some new and as-yet-undetected bugs introduced.

1.36 December 1993
The first version to be distributed.
========================================================================


