Difference between revisions of "VOL File (AGI)"
m (Andrew Branscom moved page VOL File to VOL File (AGI) without leaving a redirect) |
|||
| (7 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | Vol files store the data for an AGI game. They are essentially little more than files which have | + | Vol files store the data for an AGI game. They are essentially little more than files which have packed all of the [[AGI Logic Resource|logic]], [[AGI Picture Resource|picture]], [[AGI View Resource|view]], and [[AGI Sound Resource|sound]] resources together in a single file. Most Sierra AGI games have multiple Vol files for two reasons: |
* the original distribution media for AGI games was 360 KB floppy disks; most games were larger than 360 KB – multiple Vol files allows the game to be split across multiple disks | * the original distribution media for AGI games was 360 KB floppy disks; most games were larger than 360 KB – multiple Vol files allows the game to be split across multiple disks | ||
* due to the way the Vol files are indexed, they have a rough maximum of 1 MB in size | * due to the way the Vol files are indexed, they have a rough maximum of 1 MB in size | ||
| − | There is no required ordering of the resources within a Vol file. The resources are indexed in the LOGDIR, PICDIR, VIEWDIR, and SNDDIR files, which contain entries for every resource in the game, indicating which Vol file the resource appears in and where in that Vol file it appears. See [[ | + | There is no required ordering of the resources within a Vol file. The resources are indexed in the LOGDIR, PICDIR, VIEWDIR, and SNDDIR files, which contain entries for every resource in the game, indicating which Vol file the resource appears in and where in that Vol file it appears. See [[AGI DIR Files|directory files]]. |
Another limitation imposed by the way the directory files are stored is that there can be only 16 Vol files. As a practical matter, this is well above the limit required by any existing AGI game. | Another limitation imposed by the way the directory files are stored is that there can be only 16 Vol files. As a practical matter, this is well above the limit required by any existing AGI game. | ||
| Line 30: | Line 30: | ||
== Version 3 format == | == Version 3 format == | ||
| − | + | {{ToDo}} | |
Latest revision as of 14:49, 26 March 2019
Vol files store the data for an AGI game. They are essentially little more than files which have packed all of the logic, picture, view, and sound resources together in a single file. Most Sierra AGI games have multiple Vol files for two reasons:
- the original distribution media for AGI games was 360 KB floppy disks; most games were larger than 360 KB – multiple Vol files allows the game to be split across multiple disks
- due to the way the Vol files are indexed, they have a rough maximum of 1 MB in size
There is no required ordering of the resources within a Vol file. The resources are indexed in the LOGDIR, PICDIR, VIEWDIR, and SNDDIR files, which contain entries for every resource in the game, indicating which Vol file the resource appears in and where in that Vol file it appears. See directory files.
Another limitation imposed by the way the directory files are stored is that there can be only 16 Vol files. As a practical matter, this is well above the limit required by any existing AGI game.
Each resource in a Vol file contains a header that is followed by resource-specific data, as described in the following sections:
Version 2 format
| Byte | Meaning |
|---|---|
| 0-1 | Signature (always 0x12 0x34) |
| 2 | Vol number that the resource is contained in |
| 3 | Length of the resource, not including the header |
As is clear from this table, 3 of the 5 bytes provide fairly useless information. The most interesting bytes are bytes 3 and 4, which give the size of the resource. Because this value is two bytes in length, resources can never be any larger than 65535 bytes.
