mirror of
https://github.com/isledecomp/isle.git
synced 2026-02-02 13:11:15 +00:00
Add Kaitai Struct definition for world database files (.wdb) (#1735)
Some checks are pending
Analyze / ${{ matrix.who }} annotations (CONFIG) (push) Waiting to run
Analyze / ${{ matrix.who }} annotations (ISLE) (push) Waiting to run
Analyze / ${{ matrix.who }} annotations (LEGO1) (push) Waiting to run
Build / Download original binaries (push) Waiting to run
Build / Current ${{ matrix.toolchain.name }} (map[clang-tidy:true msys-env:mingw-w64-i686 msystem:mingw32 name:msys2 mingw32 shell:msys2 {0} werror:true]) (push) Waiting to run
Build / Current ${{ matrix.toolchain.name }} (map[name:MSVC setup-cmake:true setup-msvc:true setup-ninja:true shell:sh]) (push) Waiting to run
Build / MSVC 4.20 (push) Waiting to run
Build / MSVC 4.20 (BETA10) (push) Waiting to run
Build / Verify decomp (push) Blocked by required conditions
Build / Upload artifacts (push) Blocked by required conditions
Format / C++ (push) Waiting to run
Naming / C++ (push) Waiting to run
Some checks are pending
Analyze / ${{ matrix.who }} annotations (CONFIG) (push) Waiting to run
Analyze / ${{ matrix.who }} annotations (ISLE) (push) Waiting to run
Analyze / ${{ matrix.who }} annotations (LEGO1) (push) Waiting to run
Build / Download original binaries (push) Waiting to run
Build / Current ${{ matrix.toolchain.name }} (map[clang-tidy:true msys-env:mingw-w64-i686 msystem:mingw32 name:msys2 mingw32 shell:msys2 {0} werror:true]) (push) Waiting to run
Build / Current ${{ matrix.toolchain.name }} (map[name:MSVC setup-cmake:true setup-msvc:true setup-ninja:true shell:sh]) (push) Waiting to run
Build / MSVC 4.20 (push) Waiting to run
Build / MSVC 4.20 (BETA10) (push) Waiting to run
Build / Verify decomp (push) Blocked by required conditions
Build / Upload artifacts (push) Blocked by required conditions
Format / C++ (push) Waiting to run
Naming / C++ (push) Waiting to run
This commit is contained in:
Christian Semmler
GitHub
parent
d892f9beda
commit
776aeaa342
@ -19,6 +19,7 @@ Kaitai Struct allows you to define binary formats in a YAML-based `.ksy` file, w
|
||||
| [`players.ksy`](/docs/players.ksy) | `.gsi` | Player profile save data (usernames) |
|
||||
| [`history.ksy`](/docs/history.ksy) | `.gsi` | Score history and high scores |
|
||||
| [`animation.ksy`](/docs/animation.ksy) | `.ani` | Animation data (keyframes, actor references, camera animation) |
|
||||
| [`wdb.ksy`](/docs/wdb.ksy) | `.wdb` | World database (textures, parts, models, ROI hierarchies, LODs) |
|
||||
|
||||
## Using the Tools
|
||||
|
||||
@ -42,6 +43,9 @@ ksv samples/History.gsi history.ksy
|
||||
|
||||
# View an animation file
|
||||
ksv samples/pns065rd.ani animation.ksy
|
||||
|
||||
# View the world database (from game installation)
|
||||
ksv /path/to/lego/data/world.wdb wdb.ksy
|
||||
```
|
||||
|
||||
### Kaitai Struct Dump (ksdump)
|
||||
@ -60,6 +64,9 @@ ksdump --format yaml samples/History.gsi history.ksy
|
||||
|
||||
# Dump an animation file to JSON
|
||||
ksdump --format json samples/pns065rd.ani animation.ksy
|
||||
|
||||
# Dump world database to YAML (from game installation)
|
||||
ksdump --format yaml /path/to/lego/data/world.wdb wdb.ksy
|
||||
```
|
||||
|
||||
## Sample Files
|
||||
@ -69,3 +76,5 @@ The [`samples/`](/docs/samples/) directory contains example files for testing:
|
||||
- `Players.gsi` - Sample player profile data
|
||||
- `History.gsi` - Sample score history data
|
||||
- `pns065rd.ani` - Sample animation file
|
||||
|
||||
Note: The world database (`world.wdb`) can be found in your LEGO Island installation at `lego/data/world.wdb`.
|
||||
|
||||
784
docs/wdb.ksy
Normal file
784
docs/wdb.ksy
Normal file
@ -0,0 +1,784 @@
|
||||
meta:
|
||||
id: wdb
|
||||
title: World Database File
|
||||
application: LEGO Island
|
||||
file-extension: wdb
|
||||
license: CC0-1.0
|
||||
endian: le
|
||||
|
||||
doc: |
|
||||
World Database file format for LEGO Island (1997). Contains world geometry
|
||||
data including textures, parts (ROI definitions), and models with their
|
||||
transforms and LOD (Level of Detail) information.
|
||||
|
||||
The file is located at `<install_path>/lego/data/world.wdb` on either
|
||||
the hard drive or CD-ROM.
|
||||
|
||||
File structure:
|
||||
1. World headers - list of worlds with part/model references
|
||||
2. Global textures - shared texture data (read once)
|
||||
3. Global parts - shared part definitions (read once)
|
||||
4. Part data blobs - at offsets specified in headers
|
||||
5. Model data blobs - at offsets specified in headers
|
||||
|
||||
seq:
|
||||
- id: num_worlds
|
||||
type: s4
|
||||
doc: Number of world entries in this file.
|
||||
- id: worlds
|
||||
type: world_entry
|
||||
repeat: expr
|
||||
repeat-expr: num_worlds
|
||||
doc: |
|
||||
World entries containing references to parts and models.
|
||||
Each world represents a distinct game area (e.g., "Act1", "Act2", "Act3").
|
||||
- id: global_textures_size
|
||||
type: u4
|
||||
doc: Size in bytes of the global textures block.
|
||||
- id: global_textures
|
||||
type: texture_list
|
||||
size: global_textures_size
|
||||
doc: |
|
||||
Global textures shared across all worlds. These are loaded once
|
||||
when the first world is loaded and cached for subsequent worlds.
|
||||
- id: global_parts_size
|
||||
type: u4
|
||||
doc: Size in bytes of the global parts block.
|
||||
- id: global_parts
|
||||
type: part_list
|
||||
size: global_parts_size
|
||||
doc: |
|
||||
Global parts (ROI definitions) shared across all worlds.
|
||||
Like textures, these are loaded once and cached.
|
||||
|
||||
types:
|
||||
world_entry:
|
||||
doc: |
|
||||
A world entry containing references to parts and models.
|
||||
Parts define reusable geometry, while models are placed instances
|
||||
with specific transforms.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: s4
|
||||
doc: Length of the world name in bytes.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
doc: |
|
||||
World name used to identify this world (e.g., "Act1", "Act2", "Act3").
|
||||
- id: num_parts
|
||||
type: s4
|
||||
doc: Number of part references in this world.
|
||||
- id: parts
|
||||
type: part_reference
|
||||
repeat: expr
|
||||
repeat-expr: num_parts
|
||||
doc: References to part data stored elsewhere in the file.
|
||||
- id: num_models
|
||||
type: s4
|
||||
doc: Number of model entries in this world.
|
||||
- id: models
|
||||
type: model_entry
|
||||
repeat: expr
|
||||
repeat-expr: num_models
|
||||
doc: |
|
||||
Model entries with transform data. Each model references
|
||||
geometry and specifies its position, orientation, and visibility.
|
||||
|
||||
part_reference:
|
||||
doc: |
|
||||
Reference to part data stored at an offset in the file.
|
||||
The actual part data contains ROI definitions with textures and LODs.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: u4
|
||||
doc: Length of the ROI name in bytes.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
doc: ROI (Realtime Object Instance) name identifying this part.
|
||||
- id: data_length
|
||||
type: u4
|
||||
doc: Length of the part data in bytes.
|
||||
- id: data_offset
|
||||
type: u4
|
||||
doc: Absolute file offset to the part data.
|
||||
instances:
|
||||
data:
|
||||
io: _root._io
|
||||
pos: data_offset
|
||||
size: data_length
|
||||
type: part_data
|
||||
doc: The actual part data at the specified offset.
|
||||
|
||||
model_entry:
|
||||
doc: |
|
||||
A model entry defining a placed instance in the world.
|
||||
Contains transform data (location, direction, up vector) and
|
||||
a reference to the model geometry.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: u4
|
||||
doc: Length of the model name in bytes.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
doc: |
|
||||
Model name. Names starting with "isle" have quality variants
|
||||
(isle_lo, isle, isle_hi). Names starting with "haus" have
|
||||
special loading rules.
|
||||
- id: data_length
|
||||
type: u4
|
||||
doc: Length of the model data in bytes.
|
||||
- id: data_offset
|
||||
type: u4
|
||||
doc: Absolute file offset to the model data.
|
||||
- id: presenter_name_length
|
||||
type: u4
|
||||
doc: Length of the presenter class name in bytes.
|
||||
- id: presenter_name
|
||||
type: str
|
||||
size: presenter_name_length
|
||||
encoding: ASCII
|
||||
doc: |
|
||||
Presenter class name determining how the model is created.
|
||||
Common values: "LegoActorPresenter", "LegoEntityPresenter".
|
||||
- id: location
|
||||
type: vertex3
|
||||
doc: World position of the model (X, Y, Z).
|
||||
- id: direction
|
||||
type: vertex3
|
||||
doc: Forward direction vector of the model.
|
||||
- id: up
|
||||
type: vertex3
|
||||
doc: Up direction vector of the model.
|
||||
- id: visible
|
||||
type: u1
|
||||
doc: Visibility flag. Non-zero means the model is initially visible.
|
||||
instances:
|
||||
data:
|
||||
io: _root._io
|
||||
pos: data_offset
|
||||
size: data_length
|
||||
type: model_data
|
||||
doc: The model data (textures, animation, ROI) at the specified offset.
|
||||
|
||||
texture_list:
|
||||
doc: |
|
||||
A list of named textures. Each texture includes palette and pixel data.
|
||||
seq:
|
||||
- id: num_textures
|
||||
type: u4
|
||||
doc: Number of textures in this list.
|
||||
- id: textures
|
||||
type: named_texture
|
||||
repeat: expr
|
||||
repeat-expr: num_textures
|
||||
doc: Array of named textures.
|
||||
|
||||
named_texture:
|
||||
doc: |
|
||||
A named texture with 8-bit indexed color image data.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: u4
|
||||
doc: Length of the texture name in bytes.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
doc: Texture name used for lookup.
|
||||
- id: image
|
||||
type: image
|
||||
doc: The texture image data.
|
||||
|
||||
image:
|
||||
doc: |
|
||||
An 8-bit indexed color image with palette.
|
||||
seq:
|
||||
- id: width
|
||||
type: u4
|
||||
doc: Image width in pixels.
|
||||
- id: height
|
||||
type: u4
|
||||
doc: Image height in pixels.
|
||||
- id: palette_size
|
||||
type: u4
|
||||
doc: Number of entries in the color palette (max 256).
|
||||
- id: palette
|
||||
type: palette_entry
|
||||
repeat: expr
|
||||
repeat-expr: palette_size
|
||||
doc: Color palette entries.
|
||||
- id: pixels
|
||||
size: width * height
|
||||
doc: |
|
||||
Pixel data as palette indices. Each byte is an index into
|
||||
the palette array.
|
||||
|
||||
palette_entry:
|
||||
doc: RGB color palette entry.
|
||||
seq:
|
||||
- id: red
|
||||
type: u1
|
||||
doc: Red component (0-255).
|
||||
- id: green
|
||||
type: u1
|
||||
doc: Green component (0-255).
|
||||
- id: blue
|
||||
type: u1
|
||||
doc: Blue component (0-255).
|
||||
|
||||
part_list:
|
||||
doc: |
|
||||
A list of named parts (ROI definitions). Parts can be shared
|
||||
across multiple models and worlds.
|
||||
seq:
|
||||
- id: texture_info_offset
|
||||
type: u4
|
||||
doc: Offset within this block to texture information.
|
||||
- id: num_rois
|
||||
type: u4
|
||||
doc: Number of ROI definitions.
|
||||
- id: rois
|
||||
type: named_part
|
||||
repeat: expr
|
||||
repeat-expr: num_rois
|
||||
doc: Array of named part definitions.
|
||||
|
||||
named_part:
|
||||
doc: |
|
||||
A named part containing LOD (Level of Detail) definitions.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: u4
|
||||
doc: Length of the ROI name in bytes.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
doc: ROI name for lookup.
|
||||
- id: num_lods
|
||||
type: u4
|
||||
doc: Number of LOD levels for this part.
|
||||
- id: next_roi_offset
|
||||
type: u4
|
||||
doc: Offset to the next ROI definition (for skipping LOD data).
|
||||
- id: lods
|
||||
type: lod
|
||||
repeat: expr
|
||||
repeat-expr: num_lods
|
||||
doc: LOD definitions from highest to lowest detail.
|
||||
|
||||
part_data:
|
||||
doc: |
|
||||
Part data blob containing textures and ROI definitions.
|
||||
This is the format used for part data at offsets in the file.
|
||||
seq:
|
||||
- id: texture_info_offset
|
||||
type: u4
|
||||
doc: Offset within this block to texture information.
|
||||
- id: num_rois
|
||||
type: u4
|
||||
doc: Number of ROI definitions in this part.
|
||||
- id: rois
|
||||
type: named_part
|
||||
repeat: expr
|
||||
repeat-expr: num_rois
|
||||
doc: ROI definitions for this part.
|
||||
|
||||
model_data:
|
||||
doc: |
|
||||
Model data blob containing version info, textures, animation data,
|
||||
and ROI hierarchy. This is the format used for model data at offsets.
|
||||
Parsed by LegoModelPresenter::CreateROI.
|
||||
seq:
|
||||
- id: version
|
||||
type: u4
|
||||
doc: Format version. Must be 19 (MODEL_VERSION).
|
||||
- id: texture_info_offset
|
||||
type: u4
|
||||
doc: Offset within this blob to texture information.
|
||||
- id: num_rois
|
||||
type: u4
|
||||
doc: Number of ROIs (typically 1 for models).
|
||||
- id: anim
|
||||
type: model_anim
|
||||
doc: Animation data for this model.
|
||||
- id: roi
|
||||
type: roi
|
||||
doc: The root ROI containing the model geometry.
|
||||
|
||||
model_anim:
|
||||
doc: |
|
||||
Animation data embedded in model data. This is a simplified form
|
||||
of LegoAnim without camera/scene animation (p_parseScene=FALSE).
|
||||
seq:
|
||||
- id: num_actors
|
||||
type: u4
|
||||
doc: Number of actor entries.
|
||||
- id: actors
|
||||
type: anim_actor_entry
|
||||
repeat: expr
|
||||
repeat-expr: num_actors
|
||||
doc: Actor entries for this animation.
|
||||
- id: duration
|
||||
type: s4
|
||||
doc: Animation duration in milliseconds.
|
||||
- id: root_node
|
||||
type: anim_tree_node
|
||||
doc: Root node of the animation tree.
|
||||
|
||||
anim_actor_entry:
|
||||
doc: |
|
||||
An actor reference in the animation. The name identifies which ROI
|
||||
(Realtime Object Instance) to animate, and the type determines
|
||||
how the actor is managed by the character manager.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: u4
|
||||
doc: Length of the actor name in bytes.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
if: name_length > 0
|
||||
doc: Actor name used to look up the ROI in the scene.
|
||||
- id: actor_type
|
||||
type: u4
|
||||
enum: actor_type
|
||||
if: name_length > 0
|
||||
doc: |
|
||||
Determines how the actor ROI is created and managed.
|
||||
See actor_type enum for possible values.
|
||||
|
||||
anim_tree_node:
|
||||
doc: Node in the animation tree hierarchy.
|
||||
seq:
|
||||
- id: data
|
||||
type: anim_node_data
|
||||
doc: Animation keyframe data for this node.
|
||||
- id: num_children
|
||||
type: u4
|
||||
doc: Number of child nodes.
|
||||
- id: children
|
||||
type: anim_tree_node
|
||||
repeat: expr
|
||||
repeat-expr: num_children
|
||||
doc: Child nodes.
|
||||
|
||||
anim_node_data:
|
||||
doc: Animation keyframe data for a single node.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: u4
|
||||
doc: Length of node name.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
if: name_length > 0
|
||||
doc: Node name for matching to ROI.
|
||||
- id: num_translation_keys
|
||||
type: u2
|
||||
doc: Number of translation keyframes.
|
||||
- id: translation_keys
|
||||
type: translation_key
|
||||
repeat: expr
|
||||
repeat-expr: num_translation_keys
|
||||
doc: Translation keyframes.
|
||||
- id: num_rotation_keys
|
||||
type: u2
|
||||
doc: Number of rotation keyframes.
|
||||
- id: rotation_keys
|
||||
type: rotation_key
|
||||
repeat: expr
|
||||
repeat-expr: num_rotation_keys
|
||||
doc: Rotation keyframes (quaternion format).
|
||||
- id: num_scale_keys
|
||||
type: u2
|
||||
doc: Number of scale keyframes.
|
||||
- id: scale_keys
|
||||
type: scale_key
|
||||
repeat: expr
|
||||
repeat-expr: num_scale_keys
|
||||
doc: Scale keyframes.
|
||||
- id: num_morph_keys
|
||||
type: u2
|
||||
doc: Number of morph (visibility) keyframes.
|
||||
- id: morph_keys
|
||||
type: morph_key
|
||||
repeat: expr
|
||||
repeat-expr: num_morph_keys
|
||||
doc: Morph keyframes.
|
||||
|
||||
anim_key:
|
||||
doc: |
|
||||
Base animation key containing time and flags. The time and flags
|
||||
are packed into a single 32-bit value: bits 0-23 contain the time
|
||||
in milliseconds, and bits 24-31 contain flags.
|
||||
seq:
|
||||
- id: time_and_flags
|
||||
type: s4
|
||||
doc: |
|
||||
Packed time and flags value.
|
||||
- Bits 0-23: Time in milliseconds (mask with 0xFFFFFF)
|
||||
- Bits 24-31: Flags (shift right by 24)
|
||||
instances:
|
||||
time:
|
||||
value: time_and_flags & 0xFFFFFF
|
||||
doc: Keyframe time in milliseconds.
|
||||
flags:
|
||||
value: (time_and_flags >> 24) & 0xFF
|
||||
doc: |
|
||||
Keyframe flags:
|
||||
- 0x01 (active): Key has meaningful data
|
||||
- 0x02 (negate_rotation): Negate quaternion for interpolation
|
||||
- 0x04 (skip_interpolation): Use this key's value without blending
|
||||
|
||||
translation_key:
|
||||
doc: |
|
||||
Translation keyframe containing position offset (LegoTranslationKey).
|
||||
The translation is applied relative to the parent node's transform.
|
||||
seq:
|
||||
- id: key
|
||||
type: anim_key
|
||||
doc: Base key with time and flags.
|
||||
- id: x
|
||||
type: f4
|
||||
doc: X component of translation.
|
||||
- id: y
|
||||
type: f4
|
||||
doc: Y component of translation.
|
||||
- id: z
|
||||
type: f4
|
||||
doc: Z component of translation.
|
||||
|
||||
rotation_key:
|
||||
doc: |
|
||||
Rotation keyframe containing a quaternion (LegoRotationKey).
|
||||
The quaternion is stored as (angle, x, y, z) where angle is the
|
||||
scalar/w component and (x, y, z) is the vector part.
|
||||
seq:
|
||||
- id: key
|
||||
type: anim_key
|
||||
doc: Base key with time and flags.
|
||||
- id: angle
|
||||
type: f4
|
||||
doc: |
|
||||
Quaternion scalar component (w). A value of 1.0 with x=y=z=0
|
||||
represents no rotation (identity quaternion).
|
||||
- id: x
|
||||
type: f4
|
||||
doc: Quaternion x component.
|
||||
- id: y
|
||||
type: f4
|
||||
doc: Quaternion y component.
|
||||
- id: z
|
||||
type: f4
|
||||
doc: Quaternion z component.
|
||||
|
||||
scale_key:
|
||||
doc: |
|
||||
Scale keyframe containing scale factors (LegoScaleKey).
|
||||
Scale is applied relative to the local origin of the node.
|
||||
seq:
|
||||
- id: key
|
||||
type: anim_key
|
||||
doc: Base key with time and flags.
|
||||
- id: x
|
||||
type: f4
|
||||
doc: X scale factor (1.0 = no scaling).
|
||||
- id: y
|
||||
type: f4
|
||||
doc: Y scale factor (1.0 = no scaling).
|
||||
- id: z
|
||||
type: f4
|
||||
doc: Z scale factor (1.0 = no scaling).
|
||||
|
||||
morph_key:
|
||||
doc: |
|
||||
Morph/visibility keyframe (LegoMorphKey). Controls whether the
|
||||
node's ROI is visible at a given time.
|
||||
seq:
|
||||
- id: key
|
||||
type: anim_key
|
||||
doc: Base key with time and flags.
|
||||
- id: visible
|
||||
type: u1
|
||||
doc: Visibility flag. Non-zero means visible.
|
||||
|
||||
roi:
|
||||
doc: |
|
||||
ROI (Realtime Object Instance) defining a piece of geometry.
|
||||
ROIs form a hierarchy with parent-child relationships.
|
||||
seq:
|
||||
- id: name_length
|
||||
type: u4
|
||||
doc: Length of the ROI name in bytes.
|
||||
- id: name
|
||||
type: str
|
||||
size: name_length
|
||||
encoding: ASCII
|
||||
doc: ROI name used for lookup and animation binding.
|
||||
- id: bounding_sphere
|
||||
type: sphere
|
||||
doc: Bounding sphere for visibility culling.
|
||||
- id: bounding_box
|
||||
type: box
|
||||
doc: Axis-aligned bounding box.
|
||||
- id: texture_name_length
|
||||
type: u4
|
||||
doc: Length of texture/material name (0 if none).
|
||||
- id: texture_name
|
||||
type: str
|
||||
size: texture_name_length
|
||||
encoding: ASCII
|
||||
if: texture_name_length > 0
|
||||
doc: |
|
||||
Texture or material name. Names starting with "t_" reference
|
||||
textures; other names are color aliases (e.g., "lego red").
|
||||
- id: shared_lod_list
|
||||
type: u1
|
||||
doc: |
|
||||
If non-zero, LODs are shared with another ROI and not stored here.
|
||||
The ROI name (minus trailing digits) is used to look up shared LODs.
|
||||
- id: num_lods
|
||||
type: u4
|
||||
if: shared_lod_list == 0
|
||||
doc: Number of LOD levels (only if not using shared LODs).
|
||||
- id: next_roi_offset
|
||||
type: u4
|
||||
if: shared_lod_list == 0 and num_lods > 0
|
||||
doc: Offset to continue reading after LOD data.
|
||||
- id: lods
|
||||
type: lod
|
||||
repeat: expr
|
||||
repeat-expr: num_lods
|
||||
if: shared_lod_list == 0 and num_lods > 0
|
||||
doc: LOD definitions from highest to lowest detail.
|
||||
- id: num_children
|
||||
type: u4
|
||||
doc: Number of child ROIs in this hierarchy.
|
||||
- id: children
|
||||
type: roi
|
||||
repeat: expr
|
||||
repeat-expr: num_children
|
||||
doc: Child ROIs forming a hierarchy.
|
||||
|
||||
sphere:
|
||||
doc: Bounding sphere defined by center point and radius.
|
||||
seq:
|
||||
- id: center
|
||||
type: vertex3
|
||||
doc: Center point of the sphere.
|
||||
- id: radius
|
||||
type: f4
|
||||
doc: Radius of the sphere.
|
||||
|
||||
box:
|
||||
doc: Axis-aligned bounding box defined by min and max corners.
|
||||
seq:
|
||||
- id: min
|
||||
type: vertex3
|
||||
doc: Minimum corner (smallest X, Y, Z values).
|
||||
- id: max
|
||||
type: vertex3
|
||||
doc: Maximum corner (largest X, Y, Z values).
|
||||
|
||||
vertex3:
|
||||
doc: A 3D point or vector with X, Y, Z components.
|
||||
seq:
|
||||
- id: x
|
||||
type: f4
|
||||
doc: X component.
|
||||
- id: y
|
||||
type: f4
|
||||
doc: Y component.
|
||||
- id: z
|
||||
type: f4
|
||||
doc: Z component.
|
||||
|
||||
lod:
|
||||
doc: |
|
||||
Level of Detail definition containing mesh data.
|
||||
LODs are ordered from highest to lowest detail.
|
||||
seq:
|
||||
- id: flags
|
||||
type: u4
|
||||
doc: |
|
||||
LOD flags. Bit 0 (0x01) indicates this is an "extra" LOD.
|
||||
Other bits control visibility and rendering behavior.
|
||||
- id: num_meshes
|
||||
type: u4
|
||||
doc: Number of meshes in this LOD.
|
||||
- id: vertex_normal_counts
|
||||
type: u4
|
||||
if: num_meshes > 0
|
||||
doc: |
|
||||
Packed vertex and normal counts.
|
||||
Lower 16 bits: vertex count
|
||||
Upper 15 bits (shifted right by 1): normal count
|
||||
- id: num_texture_vertices
|
||||
type: s4
|
||||
if: num_meshes > 0
|
||||
doc: Number of texture coordinate pairs.
|
||||
- id: vertices
|
||||
type: vertex3
|
||||
repeat: expr
|
||||
repeat-expr: vertex_count
|
||||
if: num_meshes > 0 and vertex_count > 0
|
||||
doc: Vertex positions shared across meshes.
|
||||
- id: normals
|
||||
type: vertex3
|
||||
repeat: expr
|
||||
repeat-expr: normal_count
|
||||
if: num_meshes > 0 and normal_count > 0
|
||||
doc: Normal vectors shared across meshes.
|
||||
- id: texture_vertices
|
||||
type: texture_vertex
|
||||
repeat: expr
|
||||
repeat-expr: num_texture_vertices
|
||||
if: num_meshes > 0 and num_texture_vertices > 0
|
||||
doc: Texture coordinates (UV pairs).
|
||||
- id: meshes
|
||||
type: mesh
|
||||
repeat: expr
|
||||
repeat-expr: num_meshes
|
||||
if: num_meshes > 0
|
||||
doc: Mesh definitions using the shared vertex/normal/UV data.
|
||||
instances:
|
||||
vertex_count:
|
||||
value: '(num_meshes > 0) ? (vertex_normal_counts & 0xFFFF) : 0'
|
||||
doc: Number of vertices (lower 16 bits of packed value).
|
||||
normal_count:
|
||||
value: '(num_meshes > 0) ? ((vertex_normal_counts >> 17) & 0x7FFF) : 0'
|
||||
doc: Number of normals (upper 15 bits, shifted right by 1).
|
||||
|
||||
texture_vertex:
|
||||
doc: Texture coordinate pair (UV).
|
||||
seq:
|
||||
- id: u
|
||||
type: f4
|
||||
doc: U coordinate (horizontal, 0.0-1.0).
|
||||
- id: v
|
||||
type: f4
|
||||
doc: V coordinate (vertical, 0.0-1.0).
|
||||
|
||||
mesh:
|
||||
doc: |
|
||||
A mesh within an LOD, containing polygons and material properties.
|
||||
seq:
|
||||
- id: num_polygons
|
||||
type: u2
|
||||
doc: Number of triangular polygons.
|
||||
- id: num_vertices
|
||||
type: u2
|
||||
doc: Number of vertices used by this mesh.
|
||||
- id: polygon_indices
|
||||
type: polygon_indices
|
||||
repeat: expr
|
||||
repeat-expr: num_polygons
|
||||
doc: Vertex indices for each triangle.
|
||||
- id: num_texture_indices
|
||||
type: u4
|
||||
doc: Number of texture index sets (0 if untextured).
|
||||
- id: texture_indices
|
||||
type: polygon_indices
|
||||
repeat: expr
|
||||
repeat-expr: num_polygons
|
||||
if: num_texture_indices > 0
|
||||
doc: Texture coordinate indices for each triangle.
|
||||
- id: properties
|
||||
type: mesh_properties
|
||||
doc: Material and rendering properties.
|
||||
|
||||
polygon_indices:
|
||||
doc: |
|
||||
Three vertex/normal index pairs forming a triangle. Each 32-bit value
|
||||
is a packed index used by Direct3D Retained Mode, containing both
|
||||
vertex and normal indices.
|
||||
seq:
|
||||
- id: a
|
||||
type: u4
|
||||
doc: First packed vertex/normal index.
|
||||
- id: b
|
||||
type: u4
|
||||
doc: Second packed vertex/normal index.
|
||||
- id: c
|
||||
type: u4
|
||||
doc: Third packed vertex/normal index.
|
||||
|
||||
mesh_properties:
|
||||
doc: |
|
||||
Material and rendering properties for a mesh.
|
||||
seq:
|
||||
- id: color
|
||||
type: color_rgb
|
||||
doc: Base color of the mesh.
|
||||
- id: alpha
|
||||
type: f4
|
||||
doc: Transparency (0.0 = fully transparent, 1.0 = opaque).
|
||||
- id: shading
|
||||
type: u1
|
||||
enum: shading_mode
|
||||
doc: Shading mode for rendering this mesh.
|
||||
- id: unknown_0x0d
|
||||
type: u1
|
||||
doc: Unknown flag. When > 0, special material is applied.
|
||||
- id: unknown_0x20
|
||||
type: u1
|
||||
doc: Unknown field.
|
||||
- id: use_alias
|
||||
type: u1
|
||||
doc: |
|
||||
If non-zero, texture_name and material_name are looked up
|
||||
as aliases rather than literal names.
|
||||
- id: texture_name_length
|
||||
type: u4
|
||||
doc: Length of texture name (0 if no texture).
|
||||
- id: texture_name
|
||||
type: str
|
||||
size: texture_name_length
|
||||
encoding: ASCII
|
||||
if: texture_name_length > 0
|
||||
doc: Texture name for this mesh.
|
||||
- id: material_name_length
|
||||
type: u4
|
||||
doc: Length of material/color name (0 if none).
|
||||
- id: material_name
|
||||
type: str
|
||||
size: material_name_length
|
||||
encoding: ASCII
|
||||
if: material_name_length > 0
|
||||
doc: |
|
||||
Material or color alias name (e.g., "lego red", "lego blue").
|
||||
|
||||
color_rgb:
|
||||
doc: RGB color with 8-bit components.
|
||||
seq:
|
||||
- id: red
|
||||
type: u1
|
||||
doc: Red component (0-255).
|
||||
- id: green
|
||||
type: u1
|
||||
doc: Green component (0-255).
|
||||
- id: blue
|
||||
type: u1
|
||||
doc: Blue component (0-255).
|
||||
|
||||
enums:
|
||||
shading_mode:
|
||||
0: flat
|
||||
1: gouraud
|
||||
2: wireframe
|
||||
|
||||
actor_type:
|
||||
2: managed_lego_actor
|
||||
3: managed_invisible_roi_trimmed
|
||||
4: managed_invisible_roi
|
||||
5: scene_roi_1
|
||||
6: scene_roi_2
|
||||
Loading…
Reference in New Issue
Block a user