l3d_rs - A Rust Library for Handling L3D Files

l3d_rs is a Rust library designed to read, parse, and manipulate .l3d files, which are ZIP containers that include structured XML files along with other assets such as geometries. This library provides functionality to deserialize .l3d files into usable Rust structures, serialize them back to XML, and perform JSON conversions for flexibility. (https://github.com/globallightingdata/l3d)

Features

• Read .l3d Files: Extract and parse .l3d ZIP containers.
• Handle XML and Assets: Work with the XML data and related assets (e.g., geometries, textures) inside .l3d files.
• XML and JSON Support: Serialize/deserialize .l3d content to/from both XML and JSON formats.
• XML Comparison: Compare extracted and generated XML to ensure data integrity.

Installation

Add l3d_rs to your Cargo.toml dependencies:

[dependencies]
l3d_rs = "0.1.0"

Usage

Reading an .l3d File

You can read and deserialize an .l3d file (which is a ZIP container) into the Luminaire struct.

use l3d_rs::Luminaire;

fn main() {
    let file_path = "path/to/your/file.l3d";

    // Load and parse the .l3d file
    let luminaire = Luminaire::load_l3d(file_path).expect("Failed to load L3D file");

    // Work with the luminaire data
    println!("{:?}", luminaire);
}

Serializing to XML

Once you've loaded the .l3d file, you can serialize the data back into XML:

let luminaire_xml = luminaire.to_xml().expect("Failed to serialize to XML");
println!("{}", luminaire_xml);

Serializing to JSON

You can also serialize the luminaire data into JSON for easy integration with web or other systems:

let luminaire_json = luminaire.to_json().expect("Failed to serialize to JSON");
println!("{}", luminaire_json);

Deserializing from JSON

You can deserialize JSON data back into the Luminaire structure, allowing for easy round-tripping between JSON and XML formats:

let json_data = r#"{ "your": "json_data_here" }"#;

let luminaire_from_json: Luminaire = Luminaire::from_json(json_data).expect("Failed to deserialize from JSON");

println!("{:?}", luminaire_from_json);