第４章　ＣＤイメージ部分更新ツール VCDUTL

4.1　コマンド仕様

コマンド:

VCDUTL

コマンド名:

CDイメージ部分更新

書　式:

VCDUTL　プロジェクトファイル名　ISOファイル名　旧DOSファイル名 新DOSファイル名　[-f 更新情報ファイル名]

引　数:

プロジェクトファイル名：

CDイメージ作成時に使用したプロジェクトファイル

ISOファイル名：

更新されるCDイメージ内のファイル名

旧DOSファ

更新されるISOファイル内のファイル名

新DOSファイル名：

置き換えられるDOSファイル

更新情報ファイル名：

CDイメージは更新せず、更新情報ファイルのみを生成する。

更新した情報を記録したファイル。バーチャルCDエミュレータで使用する。

機　能:

　VCDBUILDで生成されたCDイメージ中のファイルの更新を行うツールです。

1. CDイメージの一部のISOファイルを指定されたDOSファイルに置き換え、CDイメージを更新します。ISOファイルは、ファイルインタリーブ、チャネルインターリーブされていても構いません。ディスク全体を生成し直すよりは短時間でエミュレーションを行えます。

2. CDイメージの一部のISOファイルを指定されたDOSファイルに置き換え、CDイメージはそのままの状態で、その変更された情報を作成します。ISOファイルは、ファイルインタリーブされていても構いませんが、チャネルインタリーブは変更の対象としません。更新部分だけをダイレクトDOSファイルアクセスでエミュレーションします。

注　意:

　(1.)の場合は、置き換えるDOSファイルは、置き換えられるDOSファイルの大きさと同じか、もしくは小さくなければなりません。新しいファイルの容量が古いファイルよりも大きい場合は、エラーを表示しイメージの更新は行われません。
　また現行では、変更対象となるDOSファイルはMPEG,CD-DA以外のファイルです。
(2.)の場合は、特に制限はありません。

使用例:

VCDUTL△TSTGAME△ISO1FILE.DDD△DOSFILE.D01△DOSFILE.D02△[-f△TSTGAME.PAT][ENTER]

VCDUTL	実行ファイル名
TSTGAME	変更の対象となるCDイメージを作成したプロジェクト名
ISO1FILE.DDD	変更対象のDOSファイルを含むISOファイル名
DOSFILE.D01	変更対象のDOSファイル名
DOSFILE.D02	置き換えるDOSファイル名

オプション指定:

-f:

　TSTGAME.PATはDOSファイル置き換えに伴う更新情報ファイル名(任意)。
このオプションを指定するとCDイメージ自身は更新されません。エミュレーション時に更新情報ファイルを基に再生されます。
このオプションを指定しない場合は、更新情報ファイルは出力されずCDイメージを書き換えて更新します。

　一つのCDイメージのデータに対して複数のDOSファイルを変更したい場合には、次の二つの方法があります。

1. 「-f」オプションなしでコマンドを複数回実行する。

2. 「-f」オプション付きで更新情報ファイル名を変えずにコマンドを複数回実行する。

　(2.)の方法ではCDイメージはそのままの状態で残っているので注意が必要です。

備　考:

　「-f」オプション付きの場合において、指定された変更対象のDOSファイルを含むISOファイルが、チャネルインタリーブで構成されている場合にはコマンドの実行は行わず、エラーとなります。
「-f」オプションがない場合において、DOSファイルのサイズがそぐわない場合はエラーとなります。

VCDUTLのエラーメッセージ

Cannot open CD image file.

　更新するCDイメージファイルが存在しないか、ファイルのオープンに失敗した。
　更新するCDイメージファイルの存在を確認する。

Cannot found iso file [ test ].

　"test"というISOファイルがCDイメージファイル中から見つけられなかった。スクリプトファイルを参照して存在するISOファイル名を入力する。

Cannot found dos file [ test ].

　これから更新しようとするファイル"test"をRTIファイル中から見つけられなかった。スクリプトファイルを参照して存在するDOSファイル名を入力する。

Cannot found Project file [ test ].

　"test"というプロジェクトファイルが存在しないか、ファイルのオープンに失敗した。正しいプロジェクト名を指定する。

Cannot found RTI file [ test ].

　"test"というRTIファイルが存在しないか、ファイルのオープンに失敗した。プロジェクトファイル中に記述しているRTIファイルの存在を確認する。

DOS file [ test ] is channel interleaved.

　[-f]オプションで更新情報ファイルを作成するときに、ファイル"test"がチャネルインタリーブされている。チャネルインタリーブされているファイルはダイレクトDOSモードでエミュレーションできないため、このファイルは指定できない。

New DOS file [ test ] open error.

　新しく置き換えようとするDOSファイルが存在しないか、ファイルのオープンに失敗した。存在するDOSファイルを指定する。

New DOS file size [ a byte ] is larger than old DOS [ b byte ].

　新しく置き換えようとするDOSファイルの大きさが、置き換えられるDOSファイルの大きさより大きい。置き換えられるDOSファイルの大きさと同じか、小さいサイズのDOSファイルを指定する。

4.2　部分更新の実行例

　(1)サンプルスクリプト

;             test1.scr
;
Disc          ".¥test1.dsk"
Session          SEMIXA
LeadIn           MODE1
EndLeadIn
    Track          MODE1
                   Volume     ISO9660      test1.pvd    ；ISOファイル名ではない
                              PrimaryVolume          0:02:16
                              EndPrimaryVolume
                   EndVolume
                   PostGap    75
    EndTrack
    Track          MODE1
                   PreGap     150
                   File       ISOF_1.DAT;1                ；ISOファイル名
                              FileSource    "pat_7.dat"
                              EndFileSource     ↓
                   EndFile                    このDOSファイルをpat_1.datと
                   PostGap    75              置き換える。
    EndTrack
    Track          CDDA
                   Pause      150
                   File       CDDA1.DAT;1                  ；ISOファイル名
                              FileSource    "sound1.dat"
                              EndFileSource    ↓
                    EndFile                  このDOSファイルはCDDAなので現行の
    EndTrack                                 VCDUTL.EXE Ver. 1.0では更新できま
LeadOut    CDDA                              せん。
    Empty          300
EndLeadOut
EndSession
EndDisc

　(2).部分更新の実行

• プロジェクトファイル名test1のディスクイメージ(test1.dsk)を構成するISOファイル（ISOF1_1.DAT;1）中のDOSファイル（pat_7.dat）を、DOSファイル（pat_1.dat）で置き換え、ディスクイメージの更新を行う場合、つぎの様に入力します。なお、指定するISOファイル名は英大文字で入力する必要があります。

  正：VCDUTL    test1    ISOF1_1.DAT;1    pat_7.dat    pat_1.dat
  誤：VCDUTL    test1    TEST1.PVD        pat_7.dat    pat_1.dat
  

  ＊VCDUTL.EXEは、ボリュームディスクリプタセット(test1.pvd)を直接更新するものではありません。

  　この結果、pat_1.datのファイルサイズがpat_7.datと同じか小さい場合、ディスクイメージのpat_7.datの部分がpat_1.datに置き換えられます。
  ひきつづきエミュレーションを実行する場合

  　VCDEMU△test1

  と入力し、リアルタイムモードのエミュレーションを行います。

• また、−fオプションを付けるとディスクイメージを更新せず、更新情報ファイルを作成します。

  　VCDUTL△test1△ISOF1_1.DAT;1△pat_7.dat△pat_1.dat△-f△test1.pat

  この結果、更新情報ファイル(test1.pat)が作成されます。
  ひきつづきエミュレーションを実行する場合、- uオプションを付けてVCDエミュレータを起動します。

  　VCDEMU△test1△-u△test1.pat

  と入力すると、ダイレクトDOSアクセスモードのエミュレーションを行います。
  単に

  　VCDEMU△test1

  と入力すると、既作成のディスクイメージtest1.dskを使用するリアルタイムモードのエミュレーションを実行してしまいますのでご注意ください。