Collision Mesh Format - Revision history

Mzxrules: /* Polygon Types */

2020-10-17T08:24:01Z

‎Polygon Types

Mzxrules: /* Camera Data */

2020-09-07T23:37:32Z

‎Camera Data

Mzxrules: /* Polygon Types */

2020-09-07T22:55:22Z

‎Polygon Types

Mzxrules: /* Polygon Types */

2020-08-25T08:08:45Z

‎Polygon Types

Mzxrules at 03:08, 1 May 2020

2020-05-01T03:08:03Z

Mzxrules: /* Polygon Array */

2019-10-14T01:09:27Z

‎Polygon Array

Mzxrules: /* Polygon Types */ remove old notes

2019-06-10T16:49:51Z

‎Polygon Types: remove old notes

Mzxrules: /* Polygon Types */

2019-06-10T16:48:47Z

‎Polygon Types

Charles445: /* Polygon Types */ Information from research added, high value 0x001C 0000 is never called, high value 0x0003 E000 is used instead

2019-01-18T07:19:32Z

‎Polygon Types: Information from research added, high value 0x001C 0000 is never called, high value 0x0003 E000 is used instead

Mzxrules: /* Polygon Types */

2019-01-17T07:48:35Z

‎Polygon Types

@@ Line 94: / Line 94: @@
          [0 0]  0 = None
          [0 2]  1 = Camera Related? Used in Haunted Wasteland. Part of Function 80036870
-         [0 4]  2 = Lava
+         [0 4]  2 = Hurt Floor (Spikes). See Wall Damage below.
-         [0 6]  3 = Lava
+         [0 6]  3 = Hurt Floor (Lava). See Wall Damage below.
          [0 8]  4 = Shallow Sand
          [0 A]  5 = Slippery
@@ Line 110: / Line 110: @@
   Low Value (+ 0x04)
-   & 0x0800 0000 //Wall Damage
+   & 0x0800 0000 //Wall Damage, prevents flames from being drawn at Link's feet if touching Hurt Floor
    & 0x07E0 0000 //Conveyor Surface Direction (value << 10)
    & 0x001C 0000 //Conveyor Surface Speed. 4-7 = keeps momentum when entering after stepping on a polygon with speed 1-3

@@ Line 176: / Line 176: @@
 The collision mesh's camera data pointer points to an array of the following struct:
 <pre>
-struct //0x08 bytes per record
+typedef struct {
+    /* 0x00 */ u16 cameraSType;
-/* 0x00 */ s16 camera_s_type;
+    /* 0x02 */ s16 numCameras;
-/* 0x02 */ s16 numCameras; //What does this mean?
+    /* 0x04 */ Vec3s* camPosData; //only certain Camera S types, null otherwise
-/* 0x04 */ SegmentAddress cameraPositionData; //only certain Camera S types, null otherwise
+} CamData;
 </pre>
@@ Line 187: / Line 186: @@
 ===Camera Position Data===
+{{Todo| This information is incorrect for most camera types }}
 <pre>struct //0x12 bytes
+{

@@ Line 70: / Line 70: @@
   High Value (+ 0x00)
- & 0x8000 0000 //Epona can't walk on the polygon
+  & 0x8000 0000 //Epona can't walk on the polygon
- & 0x4000 0000 //Decreases surface height of poly by 1. Used in rugs and dirt paths.
+  & 0x4000 0000 //Decreases surface height of poly by 1. Used in rugs and dirt paths.
- & 0x3C00 0000 //Floor Settings
+  & 0x3C00 0000 //Floor Settings
-   // [00]  Default
+     [00]  Default
-   // [14]  Void (Small Pits)
+     [14]  Void (Small Pits)
-   // [18]  Instead of jumping, grab wall like vines
+     [18]  Instead of jumping, grab wall like vines
-   // [20]  Stop all momentum in the air
+     [20]  Stop all momentum in the air
-   // [24]  Fall instead of jumping
+     [24]  Fall instead of jumping
-   // [2C]  Dive
+     [2C]  Dive
-   // [30]  Void (Large Pits)
+     [30]  Void (Large Pits)
- & 0x03E0 0000 //Wall Settings (Uses a lookup table at NTSC 1.0 RAM 800EC020 that is then broken up into bit flags.)
+  & 0x03E0 0000 //Wall Settings (Uses a lookup table at NTSC 1.0 RAM 800EC020 that is then broken up into bit flags.)
-   // [0000]  None
+      [00]  None
-   // [0020]  Cannot Grab Ledge
+      [02]  Cannot Grab Ledge
-   // [0040]  Ladder, Cannot Grab Ledge
+      [04]  Ladder, Cannot Grab Ledge
-   // [0060]  Ladder Top, Cannot Grab ledge
+      [06]  Ladder Top, Cannot Grab ledge
-   // [0080]  Vines
+      [08]  Vines
-   // [00A0]  Crawl Space
+      [0A]  Crawl Space
-   // [00C0]  Crawl Space
+      [0C]  Crawl Space
-   // [00E0]  Pushblock
+      [0E]  Pushblock
-   // [0100]+ None
+      [10]+ None
- & 0x0003 E000 //Special
+  & 0x001C 0000 //Unknown
-   // [0000 0000]  None
+  & 0x0003 E000 //Special
-   // [0000 2000]  Camera Related? Used in Haunted Wasteland. Part of Function 80036870
+        [0 0]  0 = None
-   // [0000 4000]  Lava
+        [0 2]  1 = Camera Related? Used in Haunted Wasteland. Part of Function 80036870
-   // [0000 6000]  Lava
+        [0 4]  2 = Lava
-   // [0000 8000]  Shallow Sand
+        [0 6]  3 = Lava
-   // [0000 A000]  Slippery
+        [0 8]  4 = Shallow Sand
-   // [0000 C000]  No Fall Damage
+        [0 A]  5 = Slippery
-   // [0000 E000]  Quicksand Crossing (Epona can't cross)
+        [0 C]  6 = No Fall Damage
-   // [0001 0000]  Jabu Jabu's Belly Wall
+        [0 E]  7 = Quicksand Crossing (Epona can't cross)
-   // [0001 2000]  Void on Contact
+        [1 0]  8 = Jabu Jabu's Belly Wall
-   // [0001 4000]  Unused?
+        [1 2]  9 = Void on Contact
-   // [0001 6000]  Causes Link to look upwards
+        [1 4] 10 = Unused?
-   // [0001 8000]  Quicksand Crossing (Epona can cross)
+        [1 6] 11 = Causes Link to look upwards
-   // [0001 A000]+ Unused?
+        [1 8] 12 = Quicksand Crossing (Epona can cross)
- & 0x0000 1F00 //Scene Exit Table Index
+        [1 A]+ Unused?
- & 0x0000 00FF //Mesh Camera Data Index id (see [[#Camera Data]] for more info)
+  & 0x0000 1F00 //Scene Exit Table Index
   Low Value (+ 0x04)
- & 0x0800 0000 //Wall Damage
+  & 0x0800 0000 //Wall Damage
- & 0x07E0 0000 //Conveyor Surface Direction (value << 10)
+  & 0x07E0 0000 //Conveyor Surface Direction (value << 10)
- & 0x001C 0000 //Conveyor Surface Speed. 0 = None, 1 = slow, 2 = mid, 3 = fast. 4-7 = keeps momentum when entering after stepping on a polygon with speed 1-3
+  & 0x001C 0000 //Conveyor Surface Speed. 4-7 = keeps momentum when entering after stepping on a polygon with speed 1-3
- & 0x0002 0000 //Hookshot Surface
+       [00] 0 = None
- & 0x0001 F800 //Echo
+       [04] 1 = Slow
- & 0x0000 07C0 //Lighting Setting
+       [08] 2 = Mid
- & 0x0000 0030 //Terrain Slope Surface. 0 = Flat, 1 = Sloped, 2 = Flat, preserves scene temporary flags on scene exit
+       [0C] 3 = Fast
- & 0x0000 000F //Sound Effect/Material Type (Uses a lookup table at NTSC 1.0 RAM 800EC0A0 for 0x0 - 0xD, 0xE and 0xF are always NA_SE_PL_WALK_GROUND)
+  & 0x0002 0000 //Hookshot Surface
 === Sound effect or Material Type ===
 {|class = "wikitable"
-!Id || Description
+!Id || Name || Description
 |-
-|0 || Earth/dirt
+|0 || NA_SE_PL_WALK_GROUND || Earth/dirt
 |-
-|1 || Sand
+|1 || NA_SE_PL_WALK_SAND || Sand
 |-
-|2 || Stone
+|2 || NA_SE_PL_WALK_CONCRETE || Stone
 |-
-|3 || Wet stone
+|3 || NA_SE_PL_WALK_DIRT || Wet stone
 |-
-|4 || Shallow water
+|4 || NA_SE_PL_WALK_WATER0 || Shallow water
 |-
-|5 || Not-as-shallow water (lower-pitched sound)
+|5 || NA_SE_PL_WALK_WATER1 || Not-as-shallow water (lower-pitched sound)
 |-
-|6 || Underbrush/grass
+|6 || NA_SE_PL_WALK_WATER2 || Underbrush/grass
 |-
-|7 || Lava/goo
+|7 || NA_SE_PL_WALK_MAGMA || Lava/goo
 |-
-|8 || Earth/dirt
+|8 || NA_SE_PL_WALK_GRASS || Earth/dirt
 |-
-|9 || Wooden plank
+|9 || NA_SE_PL_WALK_GLASS || Wooden plank
 |-
-|A || Packed earth/wood
+|A || NA_SE_PL_WALK_LADDER || Packed earth/wood
 |-
-|B || Earth/dirt
+|B || NA_SE_PL_WALK_GROUND || Earth/dirt
 |-
-|C || Ceramic
+|C || NA_SE_PL_WALK_ICE || Ceramic
 |-
-|D || Loose earth
+|D || NA_SE_PL_WALK_IRON || Loose earth
 |-
-|E || Earth/dirt
+|E || NA_SE_PL_WALK_GROUND || Earth/dirt
 |-
-|F || Earth/dirt
+|F || NA_SE_PL_WALK_GROUND || Earth/dirt
 |}

@@ Line 71: / Line 71: @@
   High Value (+ 0x00)
   & 0x8000 0000 //Epona can't walk on the polygon
-  & 0x4000 0000 //Paths? Decreases surface height in raycast function by 1
+  & 0x4000 0000 //Decreases surface height of poly by 1. Used in rugs and dirt paths.
   & 0x3C00 0000 //Floor Settings
     // [00]  Default

@@ Line 3: / Line 3: @@
 ! Index || Type || Description
 |-
-| 0x00 || s16 || Absolute minimum along the x-axis for collision vertices
+| 0x00 || Vec3s || Collision vertices bounding box, minimum vertex
 |-
-| 0x02 || s16 || Absolute minimum along the y-axis for collision vertices
+| 0x06 || Vec3s || Collision vertices bounding box, maximum vertex
 |-
 | 0x0C || s16? || Number of vertices to load

@@ Line 48: / Line 48: @@
 /* 0x04 */ s16? //Vertex b (& 0x1FFF), Enable Conveyor Surface (land only) (& 0x2000)
 /* 0x06 */ s16? //Vertex c (& 0x1FFF)
-/* 0x08 */ s16 a; //Unit Normal Vector x component (0x8001 to 7FFF representing -1.0 to 1.0)
+/* 0x08 */ s16 a; //Unit Normal Vector x component
-/* 0x0A */ s16 b; //Unit Normal Vector y component (0x8001 to 7FFF representing -1.0 to 1.0)
+/* 0x0A */ s16 b; //Unit Normal Vector y component
-/* 0x0C */ s16 c; //Unit Normal Vector z component (0x8001 to 7FFF representing -1.0 to 1.0)
+/* 0x0C */ s16 c; //Unit Normal Vector z component
 /* 0x0E */ s16 d; //Collision plane's relative distance from origin with respect to the normal.
 </pre>
 === Collision Detection Flags ===

@@ Line 77: / Line 77: @@
   High Value (+ 0x00)
   & 0x8000 0000 //?
-  & 0x4000 0000 //?
+  & 0x4000 0000 //Paths? Decreases surface height in raycast function by 1
   & 0x3C00 0000 //?
   & 0x03E0 0000 //?