XV3 (v1.1) Lance Ewing (be@ihug.co.nz) ========== This archive contains a program called XV3 which is designed to extract LOGIC, PICTURE, VIEW, and SOUND data files out of AGI version 3 VOL files. AGIv3 logic resources are slightly different in format from the AGIv2 logics. For this reason they cannot be directly used with some of the viewers that are available (SHOWLOG has a -3 option). This release of XV3 provides an option that will perform the conversion to AGIv2 if it is requested for a particular logic (see further below). With this release I have tried to provide all the same features that VOLX has. It now supports the conversion of WORDS.TOK and OBJECT files to more readible formats as VOLX does, and it also allows you to extract ALL resources in one pop. In this case the resources are extracted into directories of their individual type. Here is a description of the command line options for XV3: xv3 -l[2] logicnumber This option extracts the LOGIC file whose number is the same as the logicnumber parameter. The optional 2 determines whether the conversion to AGIv2 will take place. Examples: xv3 -l2 120 (extract LOGIC.120 and convert to AGIv2) xv3 -l 0 (extract LOGIC.0 and retain AGIv3 format) xv3 -p picturenumber This option extracts the PICTURE file whose number is the same as the picturenumber parameter. Note that there is no optional 2 in this case. Previously XV3 had extracted AGIv3 pictures in compressed form which is not really desirable, so pictures are now decompressed. The result is that AGIv3 pictures are in indentical format to AGIv2 pictures. Examples: xv3 -p 24 (extract PICTURE.24) xv3 -v viewnumber This option extracts the VIEW file whose number is the same as the viewnumber parameter. Note that there is no optional 2 in this case since the formats appear to be the same. Example: xv3 -v 234 (extract VIEW.234) xv3 -s soundnumber This option extracts the SOUND file whose number is the same as the soundnumber parameter. Note that there is no optional 2 in this case since the formats appear to be the same. Example: xv3 -s 8 (extract SOUND.8) xv3 -l[2] ALL xv3 -p ALL xv3 -v ALL xv3 -s ALL The ALL option can be used in the place of the resource number when extracting LOGIC, PICTURE, VIEW, and SOUND resources. In each case, all of the resources of the given type will be extracted into a directory with the same name as the resource type. Examples: xv3 -l2 ALL (extract all LOGICs in AGIv2 format) xv3 -p ALL (extract all PICTUREs) xv3 -w This option converts the WORDS.TOK into a readible text document called WORDS.TXT. xv3 -o This option decrypts the OBJECT file. xv3 -a This option performs a complete extraction of the game data. All resources are extracted into their relevant directories and the WORDS.TOK and OBJECT files are converted as described above.