IDC Sampler 3.0b
IDC Version 3.01 (Toolbook 3.0 and Multimedia Toolbook 3.0)
March 1995

K Tait, Computer Based Learning Unit, The University, Leeds LS2 9JT, UK
Email: ken@cbl.leeds.ac.uk
Tel:   +44 113 233 4628   Fax: +44 113 233 4635

---BUG FIX--------------------------------------------------------------
Sampler 3.0a corrected a couple of minor errors in the file RESOURCE.IDX
which made it difficult to get the Linking Other Applications section of
SAMPLER.TBK to work.  Both RESOURCE.IDX and SAMPLER.TBK included in this
distribution are later versions than those included in Sampler 3.0.
------------------------------------------------------------------------

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]

	BUTTONS.TBK	Buttons format (alternative to Menu format)
	EXAMPLE.TBK	An interactive document used by SAMPLER.TBK
	EDIT.WRI	IDC Report 3 (Creation & Editing of Formats)
	IDC.SBK		System Book for all IDCs
	IDCRUN.SBK	Common handlers for all interactive documents
	IDCRUNM.SBK	Common handlers for all interactive documents
			(Multimedia Toolbook version)
	IDCRUNX.SBK	Common handlers for all interactive documents
			allowing exit with ALT-F4 or by closing the
			window
	IDCRUNMX.SBK	Common handlers for all interactive documents
			allowing exit with ALT-F4 or by closing the
			window (Multimedia Toolbook version)
	IDC300.ICO	Icon for IDC
	IDCS30B.TBK	Interactive Document Compiler (Sampler 3.0)
	RESOURCE.IDX	Resource Index for Sampler 3.0b
	SAMPLER.IDC	Source Document for SAMPLER.TBK
	SAMPLER.INF	Information File for SAMPLER.TBK
	SAMPLER.OPT	Options for Sampler 3.0b
	SAMPLER.TBK	Sampler 3.0b
	SAMPLER.WRI	IDC Report 2 (The IDC Sampler)
	SMALL.IDC	A cut-down version of SAMPLER.IDC for you
			to work with
	YOURS.IDC	A copy of SAMPLER.IDC for you to work with

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

	AMPHET.BMP	Structure of amphetamine
	CENTRAL.BMP	A skewed distribution
	COMPUTER.BMP	A typical PC
	COMPUTER.IMU	Markup file for COMPUTER.BMP
	CANALGD2.BMP	Canal Gardens, Leeds
	CWCCH.BMP	Clothworkers Concert Hall
	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
	LIBRARY.BMP	Brotherton Library
	MAN.BMP		Primitive man
	MAN.IMU		Markup for MAN.BMP
	TOWNHALL.BMP	Leeds Town Hall
	VELTIME.BMP	Velocity-time graph
	WHARFDLE.BMP	Wharfedale, Yorkshire

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


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 IMAGES 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 ---------------------------------------------------------------
To use SAMPLER.TBK or the Pharmcology MCQ Bank requires the Toolbook or
the Multimedia Toolbook Run-time system which consists of the following
files:

	--- Toolbook ---

	TB30RUN.EXE
	TB30NET.EXE	*
	TB30BAS.DLL
	TB30CMP.DLL
	TB30FLT.DLL
	TB30UTL.DLL
	TBLOAD.EXE

	--- Multimedia Toolbook ---

	MTB30BAS.DLL
	MTB30BMP.DLL
	MTB30CMP.DLL
	MTB30FLT.DLL
	MTB30LNL.DLL
	MTB30MM.DLL
	MTB30MM.INI
	MTB30NET.EXE	*
	MTB30RUN.EXE
	MTB30UTL.DLL
	PCDLIB.DLL
	PCDXBMP.DLL
	PHOTO.DLL
	TBLOAD.EXE

and also the following optional files supplied with both Toolbook and
Multimedia Toolbook:

	--- Toolbook and Multimedia Toolbook --

	TB30DOS.DLL
	TB30WIN.DLL
	

Those marked * are only necessary if you using a network.

To use IDC to create new or modified applications requires the full
Toolbook or Multimedia Toolbook authoring system.  Neither the run-time
system nor the authoring system for either version is supplied with IDC.
------------------------------------------------------------------------


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

[The equivalents for Multimedia Toolbook are given in square brackets]

It is assumed that TB30RUN.EXE [MTB30RUN.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:

	IDCRUN.SBK and SAMPLER.INF with SAMPLER.TBK

and

	IDC.SBK with IDCS30B.TBK

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

	Description:	IDC Sampler 3.0b
	Command Line:	TB30RUN.EXE path\SAMPLER.TBK
			[TB30RUN.EXE 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 TB30RUN.EXE (or TB30.EXE)
[MTB30RUN.EXE (or MTB30.EXE)] then TB30RUN.EXE [MTB30RUN.EXE] 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 IDC300.ICO then exit from the dialogue
boxes by clicking OK.

Make sure SAMPLER.TBK, SAMPLER.INF and a copy of IDCRUN.SBK 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 IDCRUN.SBK 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
	example:=c:\ken\idc\v3\sampler
	windows:=c:\windows
	toolbook:=c:\mtb30\samples
	datapath:=c:\ken\idc\v3
	
Change line 2 so that right hand side of the equals has the path to
the file EXAMPLE.TBK.

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

Change line 4 so that right hand side of the equals has the path to
the file CBT1.TBK.  This file is supplied with Toolbook and Multimedia
Toolbook. It is normally found in the SAMPLES sub-directory of the
[Multimedia] Toolbook directory (normally C:\TB30 [C:\MTB30]).  If
this is not the case thenthe link from SAMPLER.TBK to CBT1.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 5 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 interactive document may not function correctly.
The normal way to leave Toolbook in such circumstances would be to hold
down ALT and press F4 or to double click the [-] at the top left-hand
corner of the window.  Whenever an interactive document produced with
IDC is run with normal Run-time Library (rather than the version found
in IDCRUNX.SBK [IDCRUNMX.SBK]) then this is password protected to ensure
that the normal exit route is takenand datafiles are correctly updated.
The request for the password occurs after ALT-F4 or the double-click 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. It is possible to
create interactive documents with pages of various sizes.
------------------------------------------------------------------------

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 Multimedia Toolbook 3.0 Authoring System and it is
assumed that TB30.EXE [MTB30.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 3.01 Sampler 3.0b
	Command Line:	TB30 path\IDCS30B.TBK
			[TB30 path\IDCS30B.TBK]
	Working directory: anything

where 'path' gives the full path of IDCS30B.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 IDC300.ICO then exit from the dialogue
boxes by clicking OK.

Make sure IDCS30B.TBK and IDC.SBK 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.
------------------------------------------------------------------------

--- PASSWORDS ----------------------------------------------------------
Editing formats: <null>
Saving compiler with the same name: CHANGE
Exiting an interactive document by closing the window or pressing
ALT+F4: PLEASE
------------------------------------------------------------------------

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

Only a fragment of the Pharmacology MCQ Bank is supplied.  In the full
bank contains over 2000 questions in 23 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 1994.

It is assumed that TB30RUN.EXE [MTB30RUN.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 fragment of Pharmacology MCQ Bank (Standalone) [IDC 3.0]
distributed with Sampler 3.0.

14th December 1994

Lines beginning with * are notes on installation.

* To install this fragment copy all the files from PHARM.ZIP into a single
* directory and change the following two lines so that the values of both
* content and control are the path to that directory.  Also put a copy of
* IDCRUN.SBK in the same directory.

content:=c:\ken\idc\v3\sampler\pharm
control:=c:\ken\idc\v3\sampler\pharm

* The path mentioned in the following line can point at any directory for
* which the user has write-access.

datapath:=c:\ken

* The next line can be left unchanged.

recordfiles=idcpharm.srf tright/twrong/tdontknow

* The three values in the next line determine the weights for correctly answered
* branches, incorrectly answered branches and branches left unanswered used in
* calculating scores.  They may be changed as desired.

weights=1,-1,0

* There is no point in modifying this next line.

bookmarks=none

--- end of MENU.INF ----------------------------------------------------

--- 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 may have any string as a value.  Make
any changes necessary as advised in the file.
------------------------------------------------------------------------

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

	Description:	Pharmacology MCQ Bank
	Command Line:	TB30RUN path\MENU.TBK
			[MTB30RUN path\MENU.TBK]

where path gives the full path of MENU.TBK.  If .TBK is associated with
TB30RUN.EXE [MTB30RUN.EXE] then TB30RUN [MTB30RUN] 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 IDC300.ICO then exit from the dialogue
boxes by clicking OK.

Copy IDCRUN.SBK 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 of Leeds
	Leeds LS2 9JT, UK.
	Tel: +44 113 233 4313
	Email: pha6ieh@south-01.novell.leeds.ac.uk
------------------------------------------------------------------------

Final Remarks
-------------

This Sampler (version 3.0b) is the fifth to be distributed, but the first
using Toolbook 3.0.  At present the earlier version for Toolbook 1.53
remains available, but it is not intended to maintain that version.
Sampler 3.0 and its compiler represent the adaptation of IDC to Toolbook
3.0 and although there are some changes (see SAMPLER.WRI) the underlying
functionality remains almost the same and he source files for Versions
1.1 and 3.0b of the Sampler are nearly identical and material developed
with one can be compiled with the other.

This sampler is free and may be distributed to anyone who is
interested provided that the complete kit is passed on.  This
version unlike earlier versions allows formats to be edited
and users to create their own formats.  Even though this means
allowing author level access to the compiler, most of the code
remains password protected though I am never convinced that any
system is entirely secure.

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, 1st March 1995

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

-- 3.0b March 1995 ------------

Uses IDC 3.01, a version for both Toolbook and Multimedia Toolbook

Shell (1 March 1995)
IDC.SBK (28 February 1995)
IDCRUN.SBK (13 February 1995)
IDCRUNM.SBK (17 February 1995)

-- 3.0a February 1995 ------------

As 3.0 with a couple of minor bugs fixed in source files.

-- 3.0 January 1995 --------------

Shell 23-01-95
IDC.SBK 23-01-95
IDCRUN.SBK 30-01-95

Essentially a reworking of version 1.40 for Multimedia Toolbook 3.0.
The majority of the IDC code is now in IDC.SBK (which replaces
SYS140.TBK) and COMM140.TBK has been replaced by IDCRUN.SBK.
Some formats have changed in minor ways and users are now permitted
to modify or create formats.  Some support is given to multimedia.

--- 1.40 September 1994 -----------

Shell 05-09-94
SYS140 05-09-94
COMM140 05-09-94

Problem with setting bullets to 'Other' fixed.
Bug if line in information file began with = fixed.
Bug with creation of datafiles when datapath: is null or not
specified.

--- 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.
========================================================================


