Adding `gdtf` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add gdtf

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

gdtf = "0.2.0"

The gdtf library will be automatically available globally. Read the gdtf library documentation.

Back to the crate overview.

Readme

gdtf-rs

The General Device Type Format (GDTF) is an open standard for describing devices of the entertainment industry. The latest version, 1.2, is standardised as DIN SPEC 15800:2022.

This crate provides tools to read and inspect GDTF files. This is made up of three parts:

An object model which closely matches the structure defined in the GDTF specification.
A fairly lax parser capable of parsing mostly well-formed GDTF files into the object model.
A small number of utilities for validating and inspecting the object model. Importantly, the crate aims to stay close to the GDTF specification. It is not a goal to provide a higher-level interface for fixtures represented by a GDTF file.

Install

Run the following Cargo command in your project directory:

cargo add gdtf

Or add the following line to your Cargo.toml:

gdtf = "0.2"

Example

use gdtf_rs::GdtfFile;

let file = std::fs::File::open("Generic@RGBW8@test.gdtf").expect("failed to read file");
let gdtf = GdtfFile::new(file).expect("failed to parse gdtf");
println!("GDTF file defines {} fixture types", gdtf.description.fixture_types.len());

License

Provided under the MIT license.

Adding gdtf library as a dependency

Adding `gdtf` library as a dependency