Difference between revisions of "Vertex"
From DoomWiki.org
| [unchecked revision] | [checked revision] |
m (→PlayStation / Doom 64 format: +wl fixed point) |
|||
| (21 intermediate revisions by 12 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{Doom level format}} | |
| + | '''Vertices''' are nothing more than coordinates on the map. [[Linedef]]s and [[seg]]s reference vertices for their start-point and end-point. | ||
| − | + | The vertices for a map are stored in the {{c|VERTEXES}} [[lump]], which consists of a raw sequence of x, y coordinates as pairs of 16-bit signed integers. The bytes are in {{wp|Endianness|little-endian}} order (least significant byte first). | |
| − | + | ||
| − | bytes | + | Due to the 16-bit signed {{wp|two's complement}} format, each coordinate can range from -32768 to +32767. |
| − | 2: x | + | |
| − | 2: y | + | ==Vertex structure== |
| − | + | {| {{prettytable|style=text-align: center;}} | |
| + | ! Offset | ||
| + | ! Size (bytes) | ||
| + | ! C99 type | ||
| + | ! Description | ||
| + | |- | ||
| + | | 0 || 2 || int16_t | ||
| + | | style="text-align: left;" | ''x'' position | ||
| + | |- | ||
| + | | 2 || 2 || int16_t | ||
| + | | style="text-align: left;" | ''y'' position | ||
| + | |} | ||
| + | |||
| + | ===Lump size=== | ||
| + | The number of vertices displayed in an [[editing utility]] is less than the size of the VERTEXES lump divided by 32 bits. This is because the map designer cannot manipulate the extra vertices required for all [[seg]]s to have endpoints; these are generated by the [[node builder]] (and then concealed from the user by nearly all mapping programs). | ||
| + | |||
| + | ===PlayStation / Doom 64 format=== | ||
| + | Midway's ports of Doom to the [[Sony PlayStation]], as well as [[Doom 64]] for the [[Nintendo 64]], feature additional precision by storing vertex coordinates as [[Fixed point|fixed_t]] (32-bit integers where 16 bits are used for the integral part and 16 for the fractional part). The range is therefore the same as in the original format, but fractional coordinates are possible. | ||
| + | |||
| + | {| {{prettytable|style=text-align: center;}} | ||
| + | ! Offset | ||
| + | ! Size (bytes) | ||
| + | ! C99 type | ||
| + | ! Description | ||
| + | |- | ||
| + | | 0 || 4 || int32_t | ||
| + | | style="text-align: left;" | ''x'' position | ||
| + | |- | ||
| + | | 4 || 4 || int32_t | ||
| + | | style="text-align: left;" | ''y'' position | ||
| + | |} | ||
| + | |||
| + | == Sources == | ||
| + | * {{dwforums|52150|Discrepancy in VERTEXES and other on-disk structs counts}}, thread at the [[Doomworld forums]] | ||
| + | * [[Unofficial Doom Specs]], especially section 4.5 | ||
| + | * {{idgames|file=docs/editing/d64techbible|title=Doom 64 Tech Bible}} | ||
| + | |||
| + | [[Category:Doom engine]] | ||
| + | [[Category:WAD lumps]] | ||
Latest revision as of 13:06, 17 January 2021
| Doom level format |
|---|
Vertices are nothing more than coordinates on the map. Linedefs and segs reference vertices for their start-point and end-point.
The vertices for a map are stored in the VERTEXES lump, which consists of a raw sequence of x, y coordinates as pairs of 16-bit signed integers. The bytes are in little-endian order (least significant byte first).
Due to the 16-bit signed two's complement format, each coordinate can range from -32768 to +32767.
Vertex structure[edit]
| Offset | Size (bytes) | C99 type | Description |
|---|---|---|---|
| 0 | 2 | int16_t | x position |
| 2 | 2 | int16_t | y position |
Lump size[edit]
The number of vertices displayed in an editing utility is less than the size of the VERTEXES lump divided by 32 bits. This is because the map designer cannot manipulate the extra vertices required for all segs to have endpoints; these are generated by the node builder (and then concealed from the user by nearly all mapping programs).
PlayStation / Doom 64 format[edit]
Midway's ports of Doom to the Sony PlayStation, as well as Doom 64 for the Nintendo 64, feature additional precision by storing vertex coordinates as fixed_t (32-bit integers where 16 bits are used for the integral part and 16 for the fractional part). The range is therefore the same as in the original format, but fractional coordinates are possible.
| Offset | Size (bytes) | C99 type | Description |
|---|---|---|---|
| 0 | 4 | int32_t | x position |
| 4 | 4 | int32_t | y position |
Sources[edit]
- Discrepancy in VERTEXES and other on-disk structs counts, thread at the Doomworld forums
- Unofficial Doom Specs, especially section 4.5
- Doom 64 Tech Bible at Doomworld/idgames
