                        CDTV Pre-Mastering Procedure
                              An Introduction



Introduction
============

This document provides a brief introduction to the process of
pre-mastering CDTV CD-ROM discs. The pre-mastering process is used to
produce an ISO 9660 image.

For a complete description of the pre-mastering and mastering
procedures, please refer to the document "Premastering and Mastering
for CDTV" published in the CDTV Developers Notes, April 8th, 1991
edition.


Preparation
===========

Before beginning the CD pre-mastering procedure, you will need the ISO
Dev-Pak diskette and the CDTV application to be pre-mastered on a hard
disk drive. If you wish to write the ISO 9660 image to a SCSI hard
disk drive, the unit must be connected and configured as SCSI address
5 or 0.


Procedure
=========

The procedure below assumes that the ISO Dev-Pak diskette is in drive
DF0: and the CDTV application to be pre-mastered is on the volume
MyCDTVApp:. If this is not the case, the appropriate substitutions of
volume and directory names must be made.


Boot
----
Boot with the ISO Dev-Pak diskette.


Open Shell
----------

Open the ISO Dev-Pak disk icon. Open the Shell icon in the ISO Dev-Pak
disk window.



Copy rmtm and Bookit to Application Disk
----------------------------------------

Copy the rmtm and Bookit programs from the C directory of the ISO
Dev-Pak disk to the C directory of the application.

For example:

        copy df0:c/rmtm to MyCDTVApp:c
        copy df0:c/Bookit to MyCDTVApp:c


Copy CDTV.TM file to Application Disk
-------------------------------------

Copy the cdtv.tm file from the root directory of the ISO Dev-Pak disk
to the ROOT directory of the application.

For example, if the application is on the volume MyCDTVApp:

        copy DF0:cdtv.tm to MyCDTVApp:


Place rmtm command in Application Startup-sequence
--------------------------------------------------

The rmtm command removes the CDTV Interactive Multimedia logo from the
screen.  For details on how to use rmtm in the best way, please refer
to the article "Making a Startup-Sequence That Works"  in the November
1991 edition of the CDTV Developers Notes.


Place Bookit in Application Startup-sequence
--------------------------------------------

The Bookit command reads the Preferences settings (including palette,
screen centering, and other information) from the bookmark memory of
the CDTV system. The arguments of the Bookit command specify the
settings to read. For more information on the arguments of Bookit,
enter:

        Bookit ?

in a Shell or see the file "bookit.doc" on this diskette.

The best place to put Bookit is the very first line in the
startup-sequence.  We recommend that you use "Bookit bv" in the first
line of the startup-sequence so that you will change all of the
Workbench colors to black, erase the pointer and center the screen
while the trademark image is still on-screen.  Then, when rmtm removes
the trademark image, the user will be looking at a black screen rather
than being surprised by the blue-and-white Workbench Screen.

For further protection against a blue startup-screen, you may include
a "black preferences" file in the devs: directory of your application.
For your convenience, we have included a file called
"system-configurationBLK+P in the iso2 directory of this diskette.
Copy it to the devs: directory of your application, and rename it
as "system-configuration".  For example,

    copy DF0:iso2/system-configurationBLK+P to
            MyCDTVApp:devs/system-configuration


Place Application in Application Startup-sequence
-------------------------------------------------

The command to run the application must be placed in the
startup-sequence. For example, if the command to run the application
is:

        MyCDTVApp

the line:

        MyCDTVApp

must be placed in the Startup-sequence.

This should be the last command in the Startup-sequence, executed
after all other set-up, such as rmtm and Bookit have been executed.


Change Directory to RAM:ISO2
----------------------------

Change to the RAM:ISO2 directory, using the command:

        cd RAM:ISO2


Run ISO Program
---------------

The ISO program creates a control file, describing the contents of the
ISO 9660 image that will be created by the BuildTrack program.

NOTE:  It is possible to include the iso, buildtrack and fixtm programs
in a script, to automate the build procedure.  A sample script file is
described at the end of this document.

The syntax of the ISO program is:

        iso [<source path>] [-a<source path>] [-s<s|n] [-d<destination]
            [-v<VolumeID>]  [-i<VolumeSetID>] [-p<PublisherID>] [-h]

If no options are entered, the iso utility prompts you for information.
Details are described below.

The -a option specifies the source of the ISO 9660 image.

The -sn option is used to sort directory entries by filename and -ss is
used to sort directory entries by file size. The default is no sorting.

The -d option specifies the destination path for the ISO 9660 image.

The -v option specifies the AmigaDOS volume name of the disc.

The -i option specifies the Volume Set Identifier of the disc.

The -p option specifies the Publisher Identification of the disc.

The -h option displays a help message.

The source argument specifies the source of the ISO 9660 image.  If no
source argument is given, and the -a option is not used, iso assumes
the source path is the current directory.

For example, if the CDTV application disk is on the volume MyCDTVApp:
and no directory entry sorting is desired, use the command:

        iso MyCDTVApp:

If the CDTV application disk is in the directory Projects:MyCDTVApp
and directory entries are to be sorted by name, use the command:

        iso -sn Projects:MyCDTVApp

The following example uses options to provide all the necessary
information to iso:

        iso -aMyCDTVApp: -sn -dDH1:Dest_file -vMyAppsVolName -iVol1of1
            -pMeandmyDogPublishing

CAUTION: The iso program should be run in the RAM disk, or the
controlfile should be created elsewhere than on the source disk.
Running iso on the source drive would modify the disk you are building
as it is being built, producing incorrect results.




Input Destination Path
----------------------

At the prompt:

        Volume ISO9660          :

enter the destination path for the ISO 9660 image.

If you wish to execute a low-level write of the image to a SCSI hard
disk drive, enter:

        DR1:

[WARNING] The low-level write to your target SCSI hard disk will
eliminate the formatting and all of the data on your target disk.
Please do this only on a hard disk that you can overwrite.

If you wish to write the image to an AmigaDOS file, enter the
filename. For example, if you wish to write the image to the
Work:MyCDTVApp/ISOImage, enter:

        Work:MyCDTVApp/ISOImage


Input Volume Identifier
-----------------------

The volume identifier is used as the AmigaDOS volume name of the disc.

At the prompt:

        VolumeIdentifier                :

enter the volume identifier of the volume to be created. The volume
identifier may not contain any spaces.

For example, if you wish the volume identifier to be "My_CDTV_App",
enter:

        My_CDTV_App


Input Volume Set Identifier
---------------------------

At the prompt:

        VolumeSetIdentifier     :

enter the volume set identifier of the volume to be created. The
volume identifier may not contain any spaces.

Some applications of the volume set identifier are disc numbers (for
example, "Disc1of2") or version numbers (for example, "Version1.2").

For example, if you wish the volume identifier to be "Disc1of2",
enter:

        Disc1of2


Input Publisher Identifier
--------------------------

At the prompt:

        PublisherIdentifier     :

enter the publisher identifier. The publisher identifier may not
contain any spaces.

The publisher identifier is used to identify the publisher of the disc
and should be the name of your company.

For example, if you wish the publisher identifier to be
"Excellent_Apps", enter:

        Excellent_Apps



Control File Creation
---------------------

After the responses to the above prompts are entered, the ISO program
will begin to create the control file. The control file is stored in
the file "ControlFile" in the current directory (RAM:ISO2 in this
case).

This process may require several minutes, depending on the complexity
of the directory structure of the application.



Run bytedrive Program
---------------------

If you wish to execute a low-level write of the ISO 9660 image on a
SCSI hard disk drive, the bytedrive program must be used. Do not
perform this step if you are writing the ISO 9660 image to an AmigaDOS
file.

[WARNING] The low-level write to your target SCSI hard disk will
eliminate the formatting and all of the data on your target disk.
Please do this only on a hard disk that you can overwrite.

The syntax of the bytedrive program is:

        run bytedrive scsi.device <unit number>

where <unit number> is the SCSI address of the SCSI hard disk drive to
write the ISO 9660 image to.

For example, if the SCSI hard disk drive is configured to SCSI
address 5:

        run bytedrive scsi.device 5


Mount DR1:
----------

If you wish to execute a low-level write of the ISO 9660 image on a
SCSI hard disk drive, the device DR1: must be mounted. Do not perform
this step if you are writing the ISO 9660 image to an AmigaDOS file.

[WARNING] The low-level write to your target SCSI hard disk will
eliminate the formatting and all of the data on your target disk.
Please do this only on a hard disk that you can overwrite.

To perform this step, enter:

        mount DR1:


Build ISO 9660 Image
--------------------

After the control file is created and the device DR1: is mounted, if
necessary, the ISO 9660 image may be created.

To create the ISO 9660 image, the buildtrack program is used.

The syntax of the buildtrack program is:

        buildtrack <control file> [-w] [-b <buffers>]

The <control file> argument specifies the name of the control file
created by the iso program. This is generally "controlfile".

The -w argument is used to suppress warnings related to ISO file
naming conventions.

The -b argument is used to specify the number of buffers to use. 200
is the suggested value. The default value is 64. You may increase or
decrease this value based on the amount of RAM available.

For example, to build the ISO 9660 image based on the control file
"controlfile", suppressing file name warnings and using 200 buffers:

        buildtrack controlfile -w -b 200

The ISO 9660 image will be created, based on the control file and
source path.

This process will require several minutes, depending on the size of
the application being pre-mastered.


Complete Trademark Image Processing
-----------------------------------

After the ISO 9660 image is created, the fixtm program must be used to
complete the processing of the cdtv.tm file.

The syntax for the fixtm command is:

        fixtm [-f<filename>] [-d<scsiunitnumber>] [-q] [-h]

The -f option specifies the AmigaDOS file to be updated.  If this
option is used, by default no Y/N confirmation prompt will be issued.

The -d option specifies the SCSI unit where the ISO 9660 image resides.

The -q option generates a Y/N prompt from fixtm before updating the ISO
9660 image.

The -h option displays a help message.

For example, to update an ISO 9660 image file called
Work:MyCDTVApp/ISOImage, you may enter:

        fixtm Work:MyCDTVApp/ISOImage

In this case, fixtm will locate the file ISOImage, and ask you if you
want to update the image or not.

Alternatively, you may enter the command

        fixtm -fWork:MyCDTVApp/ISOImage

In this case, no prompt will be generated.  This method is recommended
if you want to include fixtm in a script.


If no filename is specified, fixtm will search for an ISO 9660 image on
SCSI units 5 and 0. If an ISO 9660 image is located, the prompt:

        Device <n> contains an ISO image, volume name <volume name>.
        Update this image? (y/n)

will appear. Enter:

        y

If an ISO 9660 image is not found on SCSI unit 5 or 0, fixtm will
prompt:

        Input the name of AmigaDOS image file to be updated:

Enter the filename of the ISO 9660 image file. This should be the
destination path entered at the "Volume ISO9660" prompt of the ISO
program.

At this point, the CD pre-mastering is complete.


Using a script file to automate the build process
-------------------------------------------------

A sample script file, called Bldtest, is included in the s: directory
of this diskette.  This script will build an ISO track image to your
AmigaDOS hard disk drive.

This example assumes that your hard disk drive is called q1:.  If your
hard disk is not called q1:, you will need to change the bldtest file
to replace q1: with the appropriate name.

To begin the build, type in the following:


                        cd ram:iso2
                        execute bldtest

Bldtest launches the iso utility, telling it to build the q1:isodp
directory.  The iso utility builds a file called controlfile in the
current directory.  This controlfile describes the structure of the
disc, and is used by the buildtrack utility.

Bldtest displays "here goes buildtrack", and launches buildtrack.  This
utility builds the ISO image of the SCSI directory q1:isodp.  It
stores the ISO image in the file q1:bldtest.trk.

Next bldtest launches the fixtm utility.  Fixtm modifies the cdtv.tm
file in the ISO image just created.

