Difference between revisions of "Image file"

From Worms Knowledge Base

Jump to: navigation, search
(Create table from file format specification.)
(Add OW and WWPA icons. Display possible alignment in table.)
 
Line 7: Line 7:
 
! Game !! Type !! Size !! Name !! Description
 
! Game !! Type !! Size !! Name !! Description
 
|-
 
|-
| {{software|W2|WA|WWP}} || uint8[4] || 4 || Signature || Always "IMG\x1A".
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint8[4] || 4 || Signature || Always "IMG\x1A".
 
|-
 
|-
| {{software|W2|WA|WWP}} || uint32 || 4 || File Size || Complete length of the file, in bytes.
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint32 || 4 || File Size || Complete length of the file, in bytes.
 
|-
 
|-
| {{software|W2}} || string0 || - || Description || An optional, null-terminated string, only present in some Worms 2 images.
+
| {{SoftwareEx|W2|OW}} || string0 || - || Description || An optional, null-terminated string, only present in some [[Worms 2]] and [[Online Worms]] images.
 
|-
 
|-
| {{software|W2|WA|WWP}} || uint8 || 1 || Bits Per Pixel || Usually 8 (256 colors).
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint8 || 1 || Bits Per Pixel || Usually 8 (256 colors).
 
|-
 
|-
| {{software|W2|WA|WWP}} || uint8 || 1 || Image Flags || A [[w:Bit field|bit field]] of the following values:
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint8 || 1 || Image Flags || A [[w:Bit field|bit field]] of the following values:
 
* 1 << 6 (0x40) = Image data is [[Team17 compression|compressed]]; otherwise, it is an array of Width &times; Height pixels.
 
* 1 << 6 (0x40) = Image data is [[Team17 compression|compressed]]; otherwise, it is an array of Width &times; Height pixels.
 
* 1 << 7 (0x80) = Image has a palette, defined as follows:
 
* 1 << 7 (0x80) = Image has a palette, defined as follows:
 
|- style="background:#EEE"
 
|- style="background:#EEE"
| {{software|W2|WA|WWP}} || uint16 || 2 || Palette Color Count || Only if palletized, excludes black<ref name=Black>The black colour isn't listed in the image palette, nor counted in the "number of colours" word. It is counted as the colour 0, so the palette stored in the file should be loaded starting from colour 1.</ref>.
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint16 || 2 || Palette Color Count || Only if palletized, excludes black<ref name=Black>The black colour isn't listed in the image palette, nor counted in the "number of colours" word. It is counted as the colour 0, so the palette stored in the file should be loaded starting from colour 1.</ref>.
 
|- style="background:#EEE"
 
|- style="background:#EEE"
| {{software|W2|WA|WWP}} || rgb[colorCount] || 3 &times; color count || Palette Colors || Only if palletized, excludes black<ref name=Black/>. 3 bytes each color (RGB).  
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || rgb[colorCount] || 3 &times; color count || Palette Colors || Only if palletized, excludes black<ref name=Black/>. 3 bytes each color (RGB).  
 
|-
 
|-
| {{software|W2|WA|WWP}} || uint16 || 2 || Image Width || In pixels.
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint16 || 2 || Image Width || In pixels.
 
|-
 
|-
| {{software|W2|WA|WWP}} || uint16 || 2 || Image Height || In pixels.
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint16 || 2 || Image Height || In pixels.
 +
|- style="background:#EEE"
 +
| {{SoftwareEx|WWP|WWPA}} || align4 || - || Alignment || Only when embedded in [[Land Data file|land.dat files]], aligns to the next 4-byte boundary.
 
|-
 
|-
| {{software|W2|WA|WWP}} || uint8[] || - || Image Data || Raw image data, according to the above<ref name=DataAlignment>Embedded images in WWP land.dat files align their data by 4 bytes.</ref>.
+
| {{SoftwareEx|W2|WA|WWP|OW|WWPA}} || uint8[] || - || Image Data || Raw image data, according to the above.
 
|}
 
|}
 
<references />
 
<references />

Latest revision as of 20:14, 30 June 2020

(Up to File formats)

Team17's image files (typically with an .img file extension) are usually compressed palleted images.

File format

Game Type Size Name Description
[W2][WA][WWP][OW][WWPA] uint8[4] 4 Signature Always "IMG\x1A".
[W2][WA][WWP][OW][WWPA] uint32 4 File Size Complete length of the file, in bytes.
[W2][—][—][OW][—] string0 - Description An optional, null-terminated string, only present in some Worms 2 and Online Worms images.
[W2][WA][WWP][OW][WWPA] uint8 1 Bits Per Pixel Usually 8 (256 colors).
[W2][WA][WWP][OW][WWPA] uint8 1 Image Flags A bit field of the following values:
  • 1 << 6 (0x40) = Image data is compressed; otherwise, it is an array of Width × Height pixels.
  • 1 << 7 (0x80) = Image has a palette, defined as follows:
[W2][WA][WWP][OW][WWPA] uint16 2 Palette Color Count Only if palletized, excludes black[1].
[W2][WA][WWP][OW][WWPA] rgb[colorCount] 3 × color count Palette Colors Only if palletized, excludes black[1]. 3 bytes each color (RGB).
[W2][WA][WWP][OW][WWPA] uint16 2 Image Width In pixels.
[W2][WA][WWP][OW][WWPA] uint16 2 Image Height In pixels.
[—][—][WWP][—][WWPA] align4 - Alignment Only when embedded in land.dat files, aligns to the next 4-byte boundary.
[W2][WA][WWP][OW][WWPA] uint8[] - Image Data Raw image data, according to the above.
  1. 1.0 1.1 The black colour isn't listed in the image palette, nor counted in the "number of colours" word. It is counted as the colour 0, so the palette stored in the file should be loaded starting from colour 1.
Personal tools