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 [] [-a] [-s] [-i] [-p] [-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 where 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 [-w] [-b ] The 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] [-d] [-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 contains an ISO image, 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.