Site Tools


documentation:development:opera:pf25:ppgfldr:smmfldr:cdmfldr:03cdm002

Required Files and Folders


Before you can run the layout script file to create a CD-ROM image file you must set up the files and folders for your title. You need to complete the following steps, discussed in detail in the sections below:

Preparing Your Title's Files for the Layout Process

Before you can use the layout tool to create the CD-ROM image, put all files needed in the image into one folder as follows:

  1. Find your most recent operating system CD-ROM and locate the /cdrommaster folder.

This folder contains a number of important system files.

  1. Copy the /cdrommaster folder to your hard drive.
  1. Place copies of your application's executable and data folders (or folder hierarchies) in the /takeme folder inside the folder named after the current operating system version.
  1. Rename the main executable of the application to launchme.

Checking the AppStartup File

The AppStartup script file is in the /takeme folder. In this file, you can define aliases and add commands that are executed upon system startup. Make sure that the file follows these guidelines:

  • Any user-defined aliases should point to $app or $boot, not to /cd-rom or /remote.)
  • If your title has a mechanism to take advantage of additional memory if it becomes available, make sure there is no minmem command at the end of the file so your title can take advantage of additional memory if it becomes available.

Modifying the BannerScreen File

Starting with 3DO Portfolio 2.5, your title can use a banner screen instead of the three-second 3DO licensed product symbol required by the license agreement.

Note: Using a banner screen is highly recommended, but you may choose to use the 3DO licensed product symbol instead.

The banner screen is a video image that the system displays early in the boot sequence. This video image is title-specific and is displayed while the system completes the boot sequence.

Reasons for Using a Banner Screen

Although a banner screen is not required, there are several advantages to using one:

  • A banner screen reduces the boot time of a title significantly.
  • Presenting a title-related image early in the boot sequence gets the user excited about the title.
  • A banner screen fulfills the “three second 3DO licensed product symbol” requirement, so there is no need for an additional screen to display the 3DO licensed product symbol.

If you use a banner screen, it must meet certain requirements.

Warning: If you use a banner screen, it has to meet the requirements or the title will not receive the Right to Manufacture.

  • A banner screen is a 3DO image that has been processed with the MakeBannerScreen utility (see below).
  • The banner screen must contain an image of the 3DO licensed product symbol in at least quarter-screen height.
  • The banner screen must contain the name of the title, prominently displayed. The company name alone is not sufficient.
  • The banner screen must be specific to each title.
  • The banner screen must contain appropriate copyright notices for the title.

Preparing and Using a Banner Screen

One sample banner screen in BannerScreen format and samples in 3DO image format are included in the cdrommaster folder.

To prepare your own BannerScreen file, follow these steps:

  1. Create a picture with the name and copyright for the title and the 3DO licensed product symbol (at least)1/4 screen height), as specified above.
  1. Convert the picture to 3DO image format using the 3DO Image Writer custom plug-in.
  1. Launch MPW, make the cdrommaster folder the current directory, and execute MakeBannerScreen by typing to the MPW Shell:

MakeBannerScreen your_file

This reads your file and produces a file named BannerScreen.

  1. Drag the new BannerScreen file into your takeme folder, replacing the sample file provided by The 3DO Company.

Note: Make sure you choose the takeme folder; not a higher-level folder.

If you choose not to use a banner screen, leave the sample BannerScreen file untouched in the /takeme folder. As a result, any CD-ROM images you create will use this sample screen. The sample screen is not used during encryption.

documentation/development/opera/pf25/ppgfldr/smmfldr/cdmfldr/03cdm002.txt · Last modified: 2022/10/12 22:03 (external edit)