Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Dune 2 SHP specification
====================== Dune 2 SHP file format ====================== Sourced from Red Horizon Utilities by Emanuel Rabina http://www.ultraq.net.nz/redhorizon/ The Dune 2 SHP file, is a multiple image filetype, where each image can have it's own set of dimensions. The file is structured as follows: File header: NumImages (2 bytes) - the number of images in the file Offsets[NumImages + 1] - offset to the image header for an image. The last (2 or 4 bytes each) offset points to the end of the file. The offsets don't take into account the NumImages bytes at the beginning, so add 2 bytes to the offset value to get the actual position of an image header in the file The size of the offsets can be either 2 or 4 bytes. There is no simple way to determine which it will be, but checking the file's 4th byte to see if it's 0, seems to be a commonly accepted practice amongst existing Dune 2 SHP file readers: eg: A 2-byte offset file: 01 00 06 00 EC 00 45 0A ... A 4-byte offset file: 01 00 08 00 00 00 EC 00 ... ^^ The marked byte will be 0 in 4-byte offset files, non 0 in 2-byte offset files. Lastly, like C&C SHP files, there is an extra offset, pointing to the end of the file (or what would have been the position of another image header/data pair). Following the file header, are a series of image header & image data pairs. The image header is structured as follows: Image header: Flags (2 bytes) - flags to identify the type of data following the Datasize field, and/or the compression schemes used Slices (1 byte) - number of Format2 slices used to encode the image data. Often this is the same as the height of the image Width (2 bytes) - width of the image Height (1 byte) - height of the image Filesize (2 bytes) - size of the image data in the file Datasize (2 bytes) - size of the image data when Format2 encoded/compressed Regarding the flags, there seem to be 4 values: - 00000000 (0) = Decompress with Format80, then Format2 - 00000001 (1) = (see 3) - 00000010 (2) = Decompress with Format2 - 00000011 (3) = A small 16-byte lookup table follows, and the image data should be decompressed with Format80 then Format2. - 00000101 (5) = The first byte gives the size of the lookup table that follows, and the image data should be decompressed with Format80 then Format2. And after this image header is the image data.
Clone this wiki locally
Press h to open a hovercard with more details.