Geometry Layouts [Hack64 Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Geometry Layouts ======

These scripts load display lists within the [[banjo_kazooie:model_data|model file]], with certain aspects, properties, and checks applied. They are found at the end of a model file.

==== 0x01: SORT ==== 

Runs one or both child geometry layouts, sorting based on positions. If vectors are u and v, run first child first if (v-u).u >= 0. Used to depth sort translucent geometry. 
Usage:
^ Value/Syntax ^ Description ^
| [00 00 00 01] | Sort Command ID |
| [<color #ff7f27>aa aa aa aa</color>] | Command Length* (0x28)|
| [<color darkred>xx xx xx xx</color>] | first child x (float) |
| [<color darkgreen>yy yy yy yy</color>] | first child y (float) |
| [<color darkblue>zz zz zz zz</color>] | first child z (float) |
| [<color darkred>xx xx xx xx</color>] | second child x (float) |
| [<color darkgreen>yy yy yy yy</color>] | second child y (float) |
| [<color darkblue>zz zz zz zz</color>] | second child z (float) |
| [00 <color #b5e61d>bb</color> <color purple>cc cc</color>] | if <color #b5e61d>bb</color>&1, draw only nearer child; <color purple>cc cc</color>=first child offset |
| [00 00 <color darkred>dd dd</color>] | second child offset |
----

==== 0x02: BONE ==== 

Loads a display list from the DL segment and attaches it to the current group of bones with ID.
Usage:
^ Value/Syntax ^ Description ^
| [00 00 00 02] | Bone Command ID |
| [00 00 <color darkred>aa aa</color>] | Load DL - DL Segment Address/8 (Example: 0x1C = 0xE0)|
| [<color darkgreen>bb</color> <color darkblue>cc</color> <color purple>dd dd</color>] | <color darkgreen>bb</color>=Command Length* (0x10), <color darkblue>cc</color>=Bone ID, <color purple>dddd</color>=?? |
| [00 00 00 00] | If <color darkgreen>bb</color>=10, these four bytes are written before the next command. (Padding) |

----

==== 0x03: LOAD DL ====

Loads a display list from offset of F3DEX segment
Usage:
^ Value/Syntax ^ Description ^
| [00 00 00 03] | Load DL Command ID |
| [<color darkred>aa aa aa aa</color>] | Command Length* (0x10)|
| [<color darkgreen>bb bb</color> <color darkblue>cc cc</color>] | <color darkgreen>bbbb</color>=Offset in DL Segment/0x08, <color darkblue>cccc</color>=Tri Count |
| [00 00 00 00] | If <color darkred>aa</color>=10, these four bytes are written before the next command. (Padding)|

''Example: 00 00 00 03 00 00 00 00 00 2D 00 10''

Addr= 0x2D*0x08 offset from F3DEX Segment Start, 0x168
0x10= 16 triangles in DL

----

==== 0x05: SKINNING ====

Draw triangles across bones. Usage:

^ Value/Syntax ^ Description ^
| [00 00 00 05] | Skinning Command ID |
| [<color darkred>aa aa aa aa</color>] | Command Length* (Varies)|
| [<color darkgreen>bb bb</color> <color darkblue>cc cc</color>] | <color darkgreen>bb bb</color>=DL segment offset, sets up vertics on previous bone |
| [<color purple>dd dd</color> <color #b5e61d>ee ee</color>] | <color darkblue>cc cc</color>, <color purple>dd dd</color>, <color #b5e61d>ee ee</color>, ...=zero-terminated list of DL offsets for current bone, using setup vertices |

----

==== 0x06: BRANCH ====
(unused?)

Jumps. Usage:

^ Value/Syntax ^ Description ^
| [00 00 00 06] | Branch Command ID |
| [<color darkred>aa aa aa aa</color>] | Command Length* (0x10)|
| [<color darkgreen>bb bb bb bb</color>] | GeoLayout Command Target Offset (This should accept negative values)|
| [<color #FFFFFF>00 00 00 00</color>] | Padding |

----

==== 0x08: LOD ====

Runs a geometry layout if the distance from the camera is in a certain range.


^ Value/Syntax ^ Description ^
| [00 00 00 08] | LOD Command ID |
| [<color orange>aa aa aa aa</color>] | Command Length* (0x20)*|
| [<color #b5e61d>bb bb bb bb</color>] | max distance (float) |
| [<color #99d9ea>cc cc cc cc</color>] | min distance (float) |
| [<color darkred>xx xx xx xx</color>] | test position x (float) |
| [<color darkgreen>yy yy yy yy</color>] | test position y (float) |
| [<color darkblue>zz zz zz zz</color>] | test position z (float) |
| [<color #c8bfe7>dd dd dd dd</color>] | geometry layout offset | 

*Note that the command length actually includes the length of the child GL list to run, and the length can be 0 to denote the end of a list, but there could still be MANY child commands to run.
----

==== 0x0A: REFERENCE POINT ====

Computes a point on the current model to be referenced later. Used for spawning sparkle particles and Clanker's teeth/bolt positions. Usage:


^ Value/Syntax ^ Description ^
| [00 00 00 0A] | Reference Point Command ID |
| [<color orange>aa aa aa aa</color>] | Command Length* (0x18)|
| [<color #b5e61d>bb bb</color> <color purple>cc cc</color>] | <color #b5e61d>bb bb</color>= reference point index, <color purple>cc cc</color>=bone index |
| [<color darkred>xx xx xx xx</color>] | bone offset x (float) |
| [<color darkgreen>yy yy yy yy</color>] | bone offset y (float) |
| [<color darkblue>zz zz zz zz</color>] | bone offset z (float) |

----

==== 0x0C: SELECTOR ====

Selects one or more child geometry layouts to run. Used for blinking and many other model part selections, like Mumbo's hut. 
Each model sets a list of selectors, where positive values are the index of a (single) child layout to run 
and negative values (after being negated) are bitfields indicating multiple children to run. Usage:

^ Value/Syntax ^ Description ^
| [00 00 00 0C] | Reference Point Command ID |
| [<color orange>aa aa aa aa</color>] | Command Length* (Varies) |
| [<color #b5e61d>bb bb</color> <color purple>cc cc</color>] | <color #b5e61d>bb bb</color>=child count, <color purple>cc cc</color>=selector index |
| [<color darkred>dd dd dd dd</color>] | <color darkred>dd dd dd dd</color>, <color darkgreen>ee ee ee ee</color>, ...=list of <color #b5e61d>bb bb</color> offsets to geometry layouts that might be selected |
| [<color darkgreen>ee ee ee ee</color>] |  |
| ... | |

----

==== 0x0D: DRAW DISTANCE ====

Applies draw distance to descending geometry
Usage:
^ Value/Syntax ^ Description ^
| [00 00 00 0D] | Command |
| [<color orange>aa aa aa aa</color>] | Command Length*  |
| [<color darkred>XX XX</color> <color darkgreen>YY YY</color> <color darkblue>ZZ ZZ</color>] | Draw distance: Negative Coords|
| [<color darkred>XX XX</color> <color darkgreen>YY YY</color> <color darkblue>ZZ ZZ</color>] | Draw distance: Positive Coords |
| [<color darkred>bb bb</color> <color darkgreen>cc cc</color>] | <color darkred>bbbb</color>= ?? Usually 0018, <color darkgreen>cccc</color>= ????? |

*Command Length: If value is nonzero, GeoLayout continues, else it is the last command.

----

==== 0x0E: UNKNOWN ====

Usage:
^ Value/Syntax ^ Description ^
| [00 00 00 0E] | Command |
| [<color orange>aa aa aa aa</color>] | Command Length |
| [<color darkred>XX XX</color> <color darkgreen>YY YY</color> <color darkblue>ZZ ZZ</color>] | Coords |
| [<color darkred>XX XX</color> <color darkgreen>YY YY</color> <color darkblue>ZZ ZZ</color>] | Coords |
| [00 00 00 00] | padding |
| ... | Child commands*  |

*Child commands: if Command Length is not zero, then read commands until size is reached

----
User Tools

Site Tools

Page Tools
