#descriptor-set #layout #pipeline #dsl #vulkan #macro #playout

nightly macro playout_macro

DSL for creating Vulkan pipeline layout and descriptor set layout

1 unstable release

0.1.0 Jul 27, 2024

#12 in #descriptor-set

MIT/Apache

74KB
1.5K SLoC

Playout

playout is a Rust library implementing a domain-specific language (DSL) for defining pipeline layouts and descriptor set layouts in a shared format usable by both shading languages and host-side programming languages.

Currently, playout supports generating code for GLSL and Rust.

Benefits

  • Shared Format: Define pipeline and descriptor set layouts once and use them in both shading languages and your host-side code.
  • Improved Readability: Write layouts in a human-readable format instead of boilerplate code.
  • Reduced Errors: Avoid typos and inconsistencies by defining layouts in a single place.

Compile playout to GLSL

let playout_str = "...";
let module = PlayoutModule::try_from(playout_str).unwrap();


let mut writer = String::new();
module.show(&mut writer);
println!("{}", writer)

Compile playout to Rust as a procedural macro

use ash::vk;
// Extract descriptor set 3 from the playout file
let out = playout_macro::layout!("./example.playout", 3);

Dependencies

~1–1.4MB
~30K SLoC