home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD v1.2 / amidev_cd_12.iso / cdtv / isodevpack-41 / readme.txt < prev    next >
Text File  |  1992-02-25  |  14KB  |  460 lines
  1.                         CDTV Pre-Mastering Procedure
  2.                               An Introduction
  3.  
  4.  
  5.  
  6. Introduction
  7. ============
  8.  
  9. This document provides a brief introduction to the process of
  10. pre-mastering CDTV CD-ROM discs. The pre-mastering process is used to
  11. produce an ISO 9660 image.
  12.  
  13. For a complete description of the pre-mastering and mastering
  14. procedures, please refer to the document "Premastering and Mastering
  15. for CDTV" published in the CDTV Developers Notes, April 8th, 1991
  16. edition.
  17.  
  18.  
  19. Preparation
  20. ===========
  21.  
  22. Before beginning the CD pre-mastering procedure, you will need the ISO
  23. Dev-Pak diskette and the CDTV application to be pre-mastered on a hard
  24. disk drive. If you wish to write the ISO 9660 image to a SCSI hard
  25. disk drive, the unit must be connected and configured as SCSI address
  26. 5 or 0.
  27.  
  28.  
  29. Procedure
  30. =========
  31.  
  32. The procedure below assumes that the ISO Dev-Pak diskette is in drive
  33. DF0: and the CDTV application to be pre-mastered is on the volume
  34. MyCDTVApp:. If this is not the case, the appropriate substitutions of
  35. volume and directory names must be made.
  36.  
  37.  
  38. Boot
  39. ----
  40. Boot with the ISO Dev-Pak diskette.
  41.  
  42.  
  43. Open Shell
  44. ----------
  45.  
  46. Open the ISO Dev-Pak disk icon. Open the Shell icon in the ISO Dev-Pak
  47. disk window.
  48.  
  49.  
  50.  
  51. Copy rmtm and Bookit to Application Disk
  52. ----------------------------------------
  53.  
  54. Copy the rmtm and Bookit programs from the C directory of the ISO
  55. Dev-Pak disk to the C directory of the application.
  56.  
  57. For example:
  58.  
  59.         copy df0:c/rmtm to MyCDTVApp:c
  60.         copy df0:c/Bookit to MyCDTVApp:c
  61.  
  62.  
  63. Copy CDTV.TM file to Application Disk
  64. -------------------------------------
  65.  
  66. Copy the cdtv.tm file from the root directory of the ISO Dev-Pak disk
  67. to the ROOT directory of the application.
  68.  
  69. For example, if the application is on the volume MyCDTVApp:
  70.  
  71.         copy DF0:cdtv.tm to MyCDTVApp:
  72.  
  73.  
  74. Place rmtm command in Application Startup-sequence
  75. --------------------------------------------------
  76.  
  77. The rmtm command removes the CDTV Interactive Multimedia logo from the
  78. screen.  For details on how to use rmtm in the best way, please refer
  79. to the article "Making a Startup-Sequence That Works"  in the November
  80. 1991 edition of the CDTV Developers Notes.
  81.  
  82.  
  83. Place Bookit in Application Startup-sequence
  84. --------------------------------------------
  85.  
  86. The Bookit command reads the Preferences settings (including palette,
  87. screen centering, and other information) from the bookmark memory of
  88. the CDTV system. The arguments of the Bookit command specify the
  89. settings to read. For more information on the arguments of Bookit,
  90. enter:
  91.  
  92.         Bookit ?
  93.  
  94. in a Shell or see the file "bookit.doc" on this diskette.
  95.  
  96. The best place to put Bookit is the very first line in the
  97. startup-sequence.  We recommend that you use "Bookit bv" in the first
  98. line of the startup-sequence so that you will change all of the
  99. Workbench colors to black, erase the pointer and center the screen
  100. while the trademark image is still on-screen.  Then, when rmtm removes
  101. the trademark image, the user will be looking at a black screen rather
  102. than being surprised by the blue-and-white Workbench Screen.
  103.  
  104. For further protection against a blue startup-screen, you may include
  105. a "black preferences" file in the devs: directory of your application.
  106. For your convenience, we have included a file called
  107. "system-configurationBLK+P in the iso2 directory of this diskette.
  108. Copy it to the devs: directory of your application, and rename it
  109. as "system-configuration".  For example,
  110.  
  111.     copy DF0:iso2/system-configurationBLK+P to
  112.             MyCDTVApp:devs/system-configuration
  113.  
  114.  
  115. Place Application in Application Startup-sequence
  116. -------------------------------------------------
  117.  
  118. The command to run the application must be placed in the
  119. startup-sequence. For example, if the command to run the application
  120. is:
  121.  
  122.         MyCDTVApp
  123.  
  124. the line:
  125.  
  126.         MyCDTVApp
  127.  
  128. must be placed in the Startup-sequence.
  129.  
  130. This should be the last command in the Startup-sequence, executed
  131. after all other set-up, such as rmtm and Bookit have been executed.
  132.  
  133.  
  134. Change Directory to RAM:ISO2
  135. ----------------------------
  136.  
  137. Change to the RAM:ISO2 directory, using the command:
  138.  
  139.         cd RAM:ISO2
  140.  
  141.  
  142. Run ISO Program
  143. ---------------
  144.  
  145. The ISO program creates a control file, describing the contents of the
  146. ISO 9660 image that will be created by the BuildTrack program.
  147.  
  148. NOTE:  It is possible to include the iso, buildtrack and fixtm programs
  149. in a script, to automate the build procedure.  A sample script file is
  150. described at the end of this document.
  151.  
  152. The syntax of the ISO program is:
  153.  
  154.         iso [<source path>] [-a<source path>] [-s<s|n] [-d<destination]
  155.             [-v<VolumeID>]  [-i<VolumeSetID>] [-p<PublisherID>] [-h]
  156.  
  157. If no options are entered, the iso utility prompts you for information.
  158. Details are described below.
  159.  
  160. The -a option specifies the source of the ISO 9660 image.
  161.  
  162. The -sn option is used to sort directory entries by filename and -ss is
  163. used to sort directory entries by file size. The default is no sorting.
  164.  
  165. The -d option specifies the destination path for the ISO 9660 image.
  166.  
  167. The -v option specifies the AmigaDOS volume name of the disc.
  168.  
  169. The -i option specifies the Volume Set Identifier of the disc.
  170.  
  171. The -p option specifies the Publisher Identification of the disc.
  172.  
  173. The -h option displays a help message.
  174.  
  175. The source argument specifies the source of the ISO 9660 image.  If no
  176. source argument is given, and the -a option is not used, iso assumes
  177. the source path is the current directory.
  178.  
  179. For example, if the CDTV application disk is on the volume MyCDTVApp:
  180. and no directory entry sorting is desired, use the command:
  181.  
  182.         iso MyCDTVApp:
  183.  
  184. If the CDTV application disk is in the directory Projects:MyCDTVApp
  185. and directory entries are to be sorted by name, use the command:
  186.  
  187.         iso -sn Projects:MyCDTVApp
  188.  
  189. The following example uses options to provide all the necessary
  190. information to iso:
  191.  
  192.         iso -aMyCDTVApp: -sn -dDH1:Dest_file -vMyAppsVolName -iVol1of1
  193.             -pMeandmyDogPublishing
  194.  
  195. CAUTION: The iso program should be run in the RAM disk, or the
  196. controlfile should be created elsewhere than on the source disk.
  197. Running iso on the source drive would modify the disk you are building
  198. as it is being built, producing incorrect results.
  199.  
  200.  
  201.  
  202.  
  203. Input Destination Path
  204. ----------------------
  205.  
  206. At the prompt:
  207.  
  208.         Volume ISO9660          :
  209.  
  210. enter the destination path for the ISO 9660 image.
  211.  
  212. If you wish to execute a low-level write of the image to a SCSI hard
  213. disk drive, enter:
  214.  
  215.         DR1:
  216.  
  217. [WARNING] The low-level write to your target SCSI hard disk will
  218. eliminate the formatting and all of the data on your target disk.
  219. Please do this only on a hard disk that you can overwrite.
  220.  
  221. If you wish to write the image to an AmigaDOS file, enter the
  222. filename. For example, if you wish to write the image to the
  223. Work:MyCDTVApp/ISOImage, enter:
  224.  
  225.         Work:MyCDTVApp/ISOImage
  226.  
  227.  
  228. Input Volume Identifier
  229. -----------------------
  230.  
  231. The volume identifier is used as the AmigaDOS volume name of the disc.
  232.  
  233. At the prompt:
  234.  
  235.         VolumeIdentifier                :
  236.  
  237. enter the volume identifier of the volume to be created. The volume
  238. identifier may not contain any spaces.
  239.  
  240. For example, if you wish the volume identifier to be "My_CDTV_App",
  241. enter:
  242.  
  243.         My_CDTV_App
  244.  
  245.  
  246. Input Volume Set Identifier
  247. ---------------------------
  248.  
  249. At the prompt:
  250.  
  251.         VolumeSetIdentifier     :
  252.  
  253. enter the volume set identifier of the volume to be created. The
  254. volume identifier may not contain any spaces.
  255.  
  256. Some applications of the volume set identifier are disc numbers (for
  257. example, "Disc1of2") or version numbers (for example, "Version1.2").
  258.  
  259. For example, if you wish the volume identifier to be "Disc1of2",
  260. enter:
  261.  
  262.         Disc1of2
  263.  
  264.  
  265. Input Publisher Identifier
  266. --------------------------
  267.  
  268. At the prompt:
  269.  
  270.         PublisherIdentifier     :
  271.  
  272. enter the publisher identifier. The publisher identifier may not
  273. contain any spaces.
  274.  
  275. The publisher identifier is used to identify the publisher of the disc
  276. and should be the name of your company.
  277.  
  278. For example, if you wish the publisher identifier to be
  279. "Excellent_Apps", enter:
  280.  
  281.         Excellent_Apps
  282.  
  283.  
  284.  
  285. Control File Creation
  286. ---------------------
  287.  
  288. After the responses to the above prompts are entered, the ISO program
  289. will begin to create the control file. The control file is stored in
  290. the file "ControlFile" in the current directory (RAM:ISO2 in this
  291. case).
  292.  
  293. This process may require several minutes, depending on the complexity
  294. of the directory structure of the application.
  295.  
  296.  
  297.  
  298. Run bytedrive Program
  299. ---------------------
  300.  
  301. If you wish to execute a low-level write of the ISO 9660 image on a
  302. SCSI hard disk drive, the bytedrive program must be used. Do not
  303. perform this step if you are writing the ISO 9660 image to an AmigaDOS
  304. file.
  305.  
  306. [WARNING] The low-level write to your target SCSI hard disk will
  307. eliminate the formatting and all of the data on your target disk.
  308. Please do this only on a hard disk that you can overwrite.
  309.  
  310. The syntax of the bytedrive program is:
  311.  
  312.         run bytedrive scsi.device <unit number>
  313.  
  314. where <unit number> is the SCSI address of the SCSI hard disk drive to
  315. write the ISO 9660 image to.
  316.  
  317. For example, if the SCSI hard disk drive is configured to SCSI
  318. address 5:
  319.  
  320.         run bytedrive scsi.device 5
  321.  
  322.  
  323. Mount DR1:
  324. ----------
  325.  
  326. If you wish to execute a low-level write of the ISO 9660 image on a
  327. SCSI hard disk drive, the device DR1: must be mounted. Do not perform
  328. this step if you are writing the ISO 9660 image to an AmigaDOS file.
  329.  
  330. [WARNING] The low-level write to your target SCSI hard disk will
  331. eliminate the formatting and all of the data on your target disk.
  332. Please do this only on a hard disk that you can overwrite.
  333.  
  334. To perform this step, enter:
  335.  
  336.         mount DR1:
  337.  
  338.  
  339. Build ISO 9660 Image
  340. --------------------
  341.  
  342. After the control file is created and the device DR1: is mounted, if
  343. necessary, the ISO 9660 image may be created.
  344.  
  345. To create the ISO 9660 image, the buildtrack program is used.
  346.  
  347. The syntax of the buildtrack program is:
  348.  
  349.         buildtrack <control file> [-w] [-b <buffers>]
  350.  
  351. The <control file> argument specifies the name of the control file
  352. created by the iso program. This is generally "controlfile".
  353.  
  354. The -w argument is used to suppress warnings related to ISO file
  355. naming conventions.
  356.  
  357. The -b argument is used to specify the number of buffers to use. 200
  358. is the suggested value. The default value is 64. You may increase or
  359. decrease this value based on the amount of RAM available.
  360.  
  361. For example, to build the ISO 9660 image based on the control file
  362. "controlfile", suppressing file name warnings and using 200 buffers:
  363.  
  364.         buildtrack controlfile -w -b 200
  365.  
  366. The ISO 9660 image will be created, based on the control file and
  367. source path.
  368.  
  369. This process will require several minutes, depending on the size of
  370. the application being pre-mastered.
  371.  
  372.  
  373. Complete Trademark Image Processing
  374. -----------------------------------
  375.  
  376. After the ISO 9660 image is created, the fixtm program must be used to
  377. complete the processing of the cdtv.tm file.
  378.  
  379. The syntax for the fixtm command is:
  380.  
  381.         fixtm [-f<filename>] [-d<scsiunitnumber>] [-q] [-h]
  382.  
  383. The -f option specifies the AmigaDOS file to be updated.  If this
  384. option is used, by default no Y/N confirmation prompt will be issued.
  385.  
  386. The -d option specifies the SCSI unit where the ISO 9660 image resides.
  387.  
  388. The -q option generates a Y/N prompt from fixtm before updating the ISO
  389. 9660 image.
  390.  
  391. The -h option displays a help message.
  392.  
  393. For example, to update an ISO 9660 image file called
  394. Work:MyCDTVApp/ISOImage, you may enter:
  395.  
  396.         fixtm Work:MyCDTVApp/ISOImage
  397.  
  398. In this case, fixtm will locate the file ISOImage, and ask you if you
  399. want to update the image or not.
  400.  
  401. Alternatively, you may enter the command
  402.  
  403.         fixtm -fWork:MyCDTVApp/ISOImage
  404.  
  405. In this case, no prompt will be generated.  This method is recommended
  406. if you want to include fixtm in a script.
  407.  
  408.  
  409. If no filename is specified, fixtm will search for an ISO 9660 image on
  410. SCSI units 5 and 0. If an ISO 9660 image is located, the prompt:
  411.  
  412.         Device <n> contains an ISO image, volume name <volume name>.
  413.         Update this image? (y/n)
  414.  
  415. will appear. Enter:
  416.  
  417.         y
  418.  
  419. If an ISO 9660 image is not found on SCSI unit 5 or 0, fixtm will
  420. prompt:
  421.  
  422.         Input the name of AmigaDOS image file to be updated:
  423.  
  424. Enter the filename of the ISO 9660 image file. This should be the
  425. destination path entered at the "Volume ISO9660" prompt of the ISO
  426. program.
  427.  
  428. At this point, the CD pre-mastering is complete.
  429.  
  430.  
  431. Using a script file to automate the build process
  432. -------------------------------------------------
  433.  
  434. A sample script file, called Bldtest, is included in the s: directory
  435. of this diskette.  This script will build an ISO track image to your
  436. AmigaDOS hard disk drive.
  437.  
  438. This example assumes that your hard disk drive is called q1:.  If your
  439. hard disk is not called q1:, you will need to change the bldtest file
  440. to replace q1: with the appropriate name.
  441.  
  442. To begin the build, type in the following:
  443.  
  444.  
  445.                         cd ram:iso2
  446.                         execute bldtest
  447.  
  448. Bldtest launches the iso utility, telling it to build the q1:isodp
  449. directory.  The iso utility builds a file called controlfile in the
  450. current directory.  This controlfile describes the structure of the
  451. disc, and is used by the buildtrack utility.
  452.  
  453. Bldtest displays "here goes buildtrack", and launches buildtrack.  This
  454. utility builds the ISO image of the SCSI directory q1:isodp.  It
  455. stores the ISO image in the file q1:bldtest.trk.
  456.  
  457. Next bldtest launches the fixtm utility.  Fixtm modifies the cdtv.tm
  458. file in the ISO image just created.
  459.  
  460.