C2M: Difference between revisions

A '''C2M '''file (having the extension .c2m) is the file format which [[Chip's Challenge 2]] individual levels are commonly stored in.

All data in the file is little-endian.

!Bytes

!Content

=== Section types ===

!Section ID

!Content Type

=== OPTN section ===

The size of the section can differ between file versions (and even between files with the same file version). Data beyond the size of the section is not read. (E.g. if the section size is 3, only the time and the view are stored.)

!Bytes

!Content

The PACK and PRPL sections contain compressed versions of the MAP and REPL sections respectively. The compression scheme is as follows:

!Bytes

!Content

|}

When encountered during decompression, the data block's N bytes of data are added to the list..

!Bytes

!Content

|}

When encountered during decompression, COUNT bytes are copied from position (CURRENT - OFFSET) in the list to position CURRENT in the list. (Where CURRENT is the current position in the list, while COUNT and OFFSET are defined below)

Note that COUNT can be larger than OFFSET, allowing arbitrary pattern repetition to be efficiently encoded.

!Bytes

!Content

=== MAP / PACK section ===

This section contains the map data. If this is a PACK section, it must be unpacked using the above compression scheme first. The contents of this section is as follows:

!Bytes

!Content

|}

The tile specification consists of 1 or more bytes. The first byte is always the tile value, decoded as follows:

!Value

!Tile

==== Direction Byte ====

The direction byte comes after enemy tiles and some others:

!Value

!Meaning

==== Panel/Canopy Bitmask ====

Any number of these bits can be combined:

!Bitmask

!Meaning

==== Directional Arrows Bitmask ====

Any number of these bits can be combined:

!Bitmask

!Meaning

==== Wire Modifier ====

This is an 8-bit modifier that affects floors, metal walls, on/off switches, transformers, and blue/red fans (possibly more?). It adds wires to the tile it affects. Any number of these bits can be combined:

!Bitmask

!Meaning

==== ASCII Modifier ====

This is an 8-bit modifier that affects "sunken" floors by adding a symbol (usually an ASCII symbol) to them:

!Values

!Meaning

|-

|0x20 through 0x5f

|}

==== Clone Machine Arrow Modifier ====

This is an 8-bit modifier that affects clone machines by specifying their direction. The values can be combined and will show up on the clone machine appropriately, but the game will only clone in one direction:

!Value

!Meaning

==== Custom Floor/Wall Modifier ====

This is an 8-bit modifier that affects custom walls or floors by replaces their style:

!Value

!Meaning

==== Logic Modifier ====

!Values

!Meaning

==== Track Modifier ====

This is an 8- or 16-bit modifier that affects the train tracks base tile. The low-order byte specifies which tracks exist; any number of bits can be combined:

!Bitmask

!Meaning

|Track Switch

|}

The high order byte is optional and specifies which track is the active one. If omitted, the North East track is the active one. For tiles with a track switch, the active track is the only one that can be used (the other are shown red).

!Value

!Meaning

The contents of this section are as follows:

!Bytes

!Content

==== Input Change ====

Specifies a change in input:

!Bytes

!Content

==== Input Bitmask ====

Specifies which keys are pressed, any number of bits can be combined:

!Bitmask

!Meaning

|}

[[Category:Terminology]]