PROGRAMMER'S GUIDEVirtual CD system
BackForward
Virtual CD System User's Manual

Chapter 2 CD emulation operating procedure


In this chapter, the operation procedure is explained by dividing it into the following three types of emulation models.
The procedure is almost the same, but the files required to perform the emulation are different. These files are generated by the emulation preprocessing program.

● "Direct DOS file access"
You need a collection of data files before they become a CD image and a configuration information file for the CD.
This CD configuration information file is generated from the script file using the CD builder XBLD. This is explained in Section 2.1.

● "Real-time emulation"
Prepare a file that contains the CD image as it is.
This CD image file is generated from the script file using CD Builder XBLD. This is explained in Section 2.2.

● "Partial update of CD image"
You will need the CD image file, the MS-DOS file for the modified part, and the update information file.
Create an update information file using the CD image partial update tool VCDUTL.
The parameters when executing emulation are also different. This is explained in Section 2.3.

Figure-3. Outline of operating procedure

2.1 When emulating as an MS-DOS file

This section describes the operating procedure for "Direct DOS File Access".

[Procedure 0]
If a file with the project name as the body and the extension "DSK" exists, delete that file.
If this file exists, it will not work as "Direct DOS File Access". This file was generated when the "real-time emulation" in the next section was performed before.

[Example 0]

C: \> DEL △ TSTGAME.DSK [ENTER]
    ~~~~~~~~~~~~~~~~~~~~~~~

[Procedure 1]
Decide on a project name.
It is used as the body part of the file name of the MS-DOS file. Please follow the rules of MS-DOS files.

[Example 1] TST GAME

The instructions in this chapter use "TST GAME".

[Procedure 2]
Create a script file.
The script file specifies the data layout on the CD to be created.
The script description method is explained in the "CD Builder User's Manual".
The file name of the script file should be the project name with the extension "SCR".

[Example 2] TSTGAME.SCR

[Procedure 3]
Start the CD builder (XBLD.EXE) with the "-p" option.
Entering the command as in the example will launch the CD Builder (XBLD.EXE) and create the files needed for emulation.

[Example 3]

C: \> XBLD △ -p △ TST GAME [ENTER]
    ~~~~~~~~~~~~~~~~~~~~~~~~

[Result 3]
A PVD file that stores the volume descriptor information of the CD and an RTI file that describes the CD configuration information are created.

[Procedure 4]
Make it an English environment.
The virtual CD emulator does not work in Japanese mode, so put your display in English mode. Type the following command line:


C: \> CHEV △ US [ENTER]
    ~~~~~~~~~~~~~~~

[Result 4]
If you are in Japanese mode, the screen will flash and you will be prompted at the top of the screen.

[Procedure 5]
Start the virtual CD emulator (VCDEMU.EXE).
By entering the command as in the example, the virtual CD emulator will start and perform "direct DOS access" operation.

[Example 5]

C: \> VC DEMU △ TST GAME [ENTER]
    ~~~~~~~~~~~~~~~~~~~~~~

[Result 5]
The initial screen of the virtual CD emulator is displayed.
The virtual CD emulator is running.

[Procedure 6]
Start the operation from the target box.
The commands received from the target box, data transfer status, error messages, etc. are displayed on the screen of the virtual CD emulator. See Chapter 3 for the displayed contents.

2.2 When creating a CD image

This chapter describes the operation procedure of "Real-time emulation".
If you have already performed "Direct DOS file access", start from step 3.
If not, perform steps 1 and 2 in the previous section.

[Procedure 3]
Start the CD builder (XBLD.EXE) with the "-r" option.
Entering the command as in the example will launch the CD Builder (XBLD.EXE) and create the files needed for emulation.

[Example 3]

C: \> XBLD △ -r △ TST GAME
    ~~~~~~~~~~~~~~~~~

[Result 3]
With a DSK file that stores the CD image
An RTI file is created that describes the CD configuration information.

Perform steps 4 to 6 in the previous section to emulate.

2.3 When updating a part of the CD image

This chapter describes the operation procedure of "Partial update of CD image".
It can be used when "real-time emulation" has already been performed.
A file with the extension "DSK" must be generated by preprocessing for "real-time emulation". Perform steps 1 to 3 in the previous section.

[Procedure 4]
Start the CD image partial update tool (VCDUTL.EXE) with the "-f" option.
When you enter the command as in the example, the CD image partial update tool (VCDUTL.EXE) starts and creates the files required for emulation.
If this preprocessing is performed without the "-f" option, only the "real-time emulation" file will be generated (modified). In this case, perform "real-time emulation" according to step 4 and subsequent steps in the previous section.

[Example 4]

C: \> VCDUTL △ TST GAME △ ISOFILE.DDD △ DOSFILE.D01
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    DOSFILE.D02 △ -f △ TSTGAME.PAT [ENTER]
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This example shows replacing the DOS file DOSFILE.D01 in the data files that make up the ISO9660 file ISOFILE.DDD in the CD image generated by TSTGAME with the DOS file DOSFILE.D02.

[Result 4]
Update information file: TESTGAME.PAT is generated.

There is no rule for the file name of the update information file.

[Procedure 5]
Make it an English environment. (Refer to the previous section)

[Procedure 6]
Start the virtual CD emulator (VCDEMU.EXE) with the "-u" option.
If you enter the command as in the example, the virtual CD emulator will start and the "CD image partial update" operation will be performed.

[Example 6]

C: \> VCDEMU △ TST GAME △ -u △ DOS GAME.PAT [ENTER]
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[Result 6]
The initial screen of the virtual CD emulator is displayed.
The virtual CD emulator is running.

[Procedure 7]
After this state, start the operation from the target box.
(Refer to the previous section)


BackForward
PROGRAMMER'S GUIDEVirtual CD system
Copyright SEGA ENTERPRISES, LTD ,. 1997