LightWave 3D Rust Parser

Complete LWO2 parser for Rust.

Basic Usage

use lightwave::LightWaveObject;

fn main() {
    LightWaveObject::read_file("path/to/file.lwo");
    // or
    LightWaveObject::read(Cursor::new(vec![0x00, 0x01, ...]))
}

LightWave Object (LWO2)

Fully feature complete following the LWO2 Spec.

Chunk	Tag	Status
Layer	LAYR	✅
Point List	PNTS	✅
Vertex Mapping	VMAP	✅
Polygon List	POLS	✅
Tag Strings	TAGS	✅
Polygon Tag Mapping	PTAG	✅
Discontinuous Vertex Mapping	VMAD	✅
Vertex Map Parameter	VMPA	✅
Envelope Definition	ENVL	✅
Image (-Sequence)	CLIP	✅
Surface Definition	SURF	✅
Bounding Box	BBOX	✅
Description Line	DESC	✅
Commentary Text	TEXT	✅
Thumbnail Icon Image	ICON	✅

Envelope Subchunks

Chunk	Tag	Status
Envelope Type	TYPE	✅
Pre-Behavior	PRE	✅
Post-Behavior	POST	✅
Keyframe Time and Value	KEY	✅
Interval Interpolation	SPAN	✅
Plugin Channel Modifiers	CHAN	✅
Channel Name	NAME	✅

Clip Subchunks

Chunk	Tag	Status
Still Image	STIL	✅
Image Sequence	ISEQ	✅
Plugin Animation	ANIM	✅
Reference (Clone)	XREF	✅
Flag (Undocumented)	FLAG	⚠️
Color-cycling Still	STCC	✅
Time	TIME	✅
Color Space RGB	CLRS	✅
Color Space Alpha	CLRA	✅
Image Filtering	FILT	✅
Image Dithering	DITH	✅
Contrast	CONT	✅
Brightness	BRIT	✅
Saturation	SATR	✅
Hue	HUE	✅
Gamma Correction	GAMM	✅
Negative	NEGA	✅
Plugin Image Filters	IFLT	✅
Plugin Pixel Filters	PFLT	✅

Surface Subchunks

Basic Surface Parameters

Chunk	Tag	Status
Base Color	COLR	✅
Base Shading Values	DIFF LUMI SPEC REFL TRAN TRNL	✅
Specular Glossiness	GLOS	✅
Diffuse Sharpness	SHRP	✅
Bump Intensity	BUMP	✅
Polygon Sidedness	SIDE	✅
Max Smoothing Angle	SMAN	✅
Reflection Options	RFOP	✅
Reflection Map Image	RIMG	✅
Reflection Map Image Seam Angle	RSAN	✅
Reflection Blurring	RBLR	✅
Refractive Index	RIND	✅
Transparency Options	TROP	✅
Refraction Map Image	TIMG	✅
Refraction Blurring	TBLR	✅
Color Highlights	CLRH	✅
Color Filter	CLRF	✅
Additive Transparency	ADRT	✅
Glow Effect	GLOW	✅
Render Outlines	LINE	✅
Alpha Mode	ALPH	✅
Vertex Color Map	VCOL	✅
Surface Blocks	BLOK	✅

Surface Blocks

Ordinal Strings:

• ✅ Image Texture Map IMAP
• ✅ Procedural Texture PROC
• ✅ Gradient Texture GRAD
• ✅ Shader Plugin SHDR

Shared

Chunk	Tag	Status
Texture Channel	CHAN	✅
Enable State	ENAB	✅
Opacity	OPAC	✅
Displacement Axis	AXIS	✅
Negative (Undocumented)	NEGA	⚠️

Texture Mapping

Chunk	Tag	Status
Positioning	CNTR SIZE ROTA	✅
Reference Object	OREF	✅
Falloff	FALL	✅
Coordinate System	CSYS	✅

Image Texture Map

Chunk	Tag	Status
Texture Mapping	TMAP	✅
Projection Mode	PROJ	✅
Major Axis	AXIS	✅
Image Map	IMAG	✅
Image Wrap Options	WRAP	✅
Image Wrap Amount	WRPW WRPH	✅
UV Vertex Map	VMAP	✅
Antialiasing Strength	AAST	✅
Pixel Blending	PIXB	✅
Sticky Projection	STCK	✅
Texture Ampliture	TAMP	✅

Procedural Texture

Chunk	Tag	Status
Axis	AXIS	✅
Basic Value	VALU	✅
Algorithm and Parameters	FUNC	✅

Gradient Texture

Chunk	Tag	Status
Parameter Name	PNAM	✅
Item Name	INAM	✅
Gradient Range	GRST GREN	✅
Repeat Mode	GRPT	✅
Key Values	FKEY	✅
Key Parameters	IKEY	✅

Shaders

Chunk	Tag	Status
Shader Algorithm	FUNC	✅