ash/generator/src/lib.rs

623 lines
20 KiB
Rust
Raw Normal View History

2018-03-10 20:07:12 +11:00
#![recursion_limit = "256"]
2018-03-10 07:45:58 +11:00
// extern crate serde;
// #[macro_use]
// extern crate serde_derive;
extern crate heck;
2018-04-01 18:52:21 +10:00
extern crate proc_macro2;
2018-03-10 07:45:58 +11:00
#[macro_use]
extern crate quote;
extern crate syn;
2018-06-04 19:26:14 +10:00
pub extern crate vk_parse;
2018-03-10 07:45:58 +11:00
pub extern crate vkxml;
2018-06-04 19:26:14 +10:00
use heck::{CamelCase, ShoutySnakeCase, SnakeCase};
2018-04-01 18:52:21 +10:00
use proc_macro2::Term;
2018-03-10 20:47:02 +11:00
use quote::Tokens;
2018-03-10 07:45:58 +11:00
use syn::Ident;
2018-04-01 18:52:21 +10:00
pub enum Constant {
Number(i32),
Hex(String),
BitPos(u32),
CExpr(vkxml::CExpression),
Text(String),
}
impl Constant {
pub fn value(&self) -> Option<i64> {
match *self {
Constant::Number(n) => Some(n as i64),
2018-06-04 19:26:14 +10:00
Constant::Hex(ref hex) => i64::from_str_radix(&hex, 16).ok(),
2018-04-01 18:52:21 +10:00
Constant::BitPos(pos) => Some((1 << pos) as i64),
_ => None,
}
}
pub fn to_tokens(&self) -> Tokens {
match *self {
Constant::Number(n) => {
let term = Term::intern(&n.to_string());
quote!{#term}
}
Constant::Hex(ref s) => {
2018-06-04 19:26:14 +10:00
let term = Term::intern(&format!("0x{}", s));
2018-04-01 18:52:21 +10:00
quote!{#term}
}
Constant::Text(ref text) => {
quote!{#text}
}
Constant::CExpr(ref cexpr) => {
let rexpr = cexpr.replace("~", "!").replace("U", "u32");
let term = Term::intern(&rexpr);
quote!{#term}
}
Constant::BitPos(pos) => {
let value = 1 << pos;
let term = Term::intern(&format!("0b{:b}", value));
quote!{#term}
}
}
}
pub fn from_constant(constant: &vkxml::Constant) -> Self {
let number = constant.number.map(|n| Constant::Number(n));
let hex = constant.hex.as_ref().map(|hex| Constant::Hex(hex.clone()));
let bitpos = constant.bitpos.map(|bit| Constant::BitPos(bit));
let expr = constant
.c_expression
.as_ref()
.map(|e| Constant::CExpr(e.clone()));
number.or(hex).or(bitpos).or(expr).expect("")
}
pub fn from_extension(extension: &vkxml::ExtensionConstant) -> Self {
let number = extension.number.map(|n| Constant::Number(n));
let hex = extension.hex.as_ref().map(|hex| Constant::Hex(hex.clone()));
let bitpos = extension.bitpos.map(|bit| Constant::BitPos(bit));
let expr = extension
.c_expression
.as_ref()
.map(|e| Constant::CExpr(e.clone()));
let text = extension.text.as_ref().map(|e| Constant::Text(e.clone()));
number.or(hex).or(bitpos).or(expr).or(text).expect("")
}
}
pub trait ConstantExt {}
impl ConstantExt for vkxml::Constant {}
2018-03-10 08:43:45 +11:00
pub trait FeatureExt {
fn version_string(&self) -> String;
}
impl FeatureExt for vkxml::Feature {
fn version_string(&self) -> String {
let version = format!("{:.10}", self.version);
let first_0 = version.find("0").expect("should have at least one 0");
// + 1 is correct here because we always have 10 zeroes.
let (version, _) = version.split_at(first_0 + 1);
version.replace(".", "_")
}
}
2018-03-10 07:45:58 +11:00
pub trait CommandExt {
/// Returns the ident in snake_case and without the 'vk' prefix.
fn is_device_command(&self) -> bool;
///
/// Returns true if the command is a device level command. This is indicated by
/// the type of the first parameter.
fn command_ident(&self) -> Ident;
}
impl CommandExt for vkxml::Command {
fn command_ident(&self) -> Ident {
Ident::from(self.name[2..].to_snake_case().as_str())
}
fn is_device_command(&self) -> bool {
self.param
.iter()
.nth(0)
.map(|field| match field.basetype.as_str() {
"VkDevice" | "VkCommandBuffer" | "VkQueue" => true,
_ => false,
})
.unwrap_or(false)
}
}
pub trait FieldExt {
/// Returns the name of the paramter that doesn't clash with Rusts resevered
/// keywords
fn param_ident(&self) -> Ident;
/// Returns the basetype ident and removes the 'Vk' prefix
2018-03-10 20:47:02 +11:00
fn type_tokens(&self) -> Tokens;
2018-03-10 07:45:58 +11:00
}
2018-03-11 02:21:35 +11:00
fn to_type_tokens(type_name: &str, reference: Option<&vkxml::ReferenceType>) -> Tokens {
let new_name = match type_name {
"void" => "c_void",
"char" => "c_char",
"float" => "c_float",
"long" => "c_ulong",
_ => {
let prefix = &type_name[0..2];
if prefix == "Vk" {
&type_name[2..]
} else {
type_name
}
}
};
let ptr_name = reference
.as_ref()
.map(|reference| match *reference {
&vkxml::ReferenceType::Pointer => "*mut",
&vkxml::ReferenceType::PointerToPointer => "*mut",
&vkxml::ReferenceType::PointerToConstPointer => "*const",
})
.unwrap_or("");
let ty: syn::Type = syn::parse_str(&format!("{} {}", ptr_name, new_name)).expect("parse field");
quote!{#ty}
}
2018-03-10 07:45:58 +11:00
impl FieldExt for vkxml::Field {
fn param_ident(&self) -> Ident {
let name = self.name.as_ref().map(|s| s.as_str()).unwrap_or("field");
let name_corrected = match name {
"type" => "ty",
_ => name,
};
Ident::from(name_corrected.to_snake_case().as_str())
}
2018-03-10 20:47:02 +11:00
fn type_tokens(&self) -> Tokens {
2018-03-11 02:21:35 +11:00
to_type_tokens(&self.basetype, self.reference.as_ref())
2018-03-10 07:45:58 +11:00
}
}
use std::collections::HashMap;
pub type CommandMap<'a> = HashMap<vkxml::Identifier, &'a vkxml::Command>;
2018-03-10 20:07:12 +11:00
fn generate_function_pointers(ident: Ident, commands: &[&vkxml::Command]) -> quote::Tokens {
let names: Vec<_> = commands.iter().map(|cmd| cmd.command_ident()).collect();
let names_ref = &names;
let raw_names: Vec<_> = commands
.iter()
.map(|cmd| Ident::from(cmd.name.as_str()))
.collect();
let raw_names_ref = &raw_names;
let names_left = &names;
let names_right = &names;
2018-03-10 20:47:02 +11:00
let params: Vec<Vec<(Ident, Tokens)>> = commands
2018-03-10 20:07:12 +11:00
.iter()
.map(|cmd| {
let fn_name_raw = cmd.name.as_str();
let fn_name_snake = cmd.command_ident();
let params: Vec<_> = cmd.param
.iter()
.map(|field| {
let name = field.param_ident();
2018-03-10 20:47:02 +11:00
let ty = field.type_tokens();
2018-03-10 20:07:12 +11:00
(name, ty)
})
.collect();
params
})
.collect();
let params_names: Vec<Vec<_>> = params
.iter()
.map(|inner_params| {
inner_params
.iter()
.map(|&(param_name, _)| param_name)
.collect()
})
.collect();
let param_names_ref = &params_names;
let expanded_params: Vec<_> = params
.iter()
.map(|inner_params| {
2018-03-10 20:47:02 +11:00
let inner_params_iter = inner_params.iter().map(|&(ref param_name, ref param_ty)| {
2018-03-10 20:07:12 +11:00
quote!{#param_name: #param_ty}
});
quote!{
#(#inner_params_iter,)*
}
})
.collect();
let expanded_params_ref = &expanded_params;
let params_ref = &params;
let return_types: Vec<_> = commands
.iter()
2018-03-10 20:47:02 +11:00
.map(|cmd| cmd.return_type.type_tokens())
2018-03-10 20:07:12 +11:00
.collect();
let return_types_ref = &return_types;
quote!{
pub struct #ident {
#(
#names_ref: extern "system" fn(#expanded_params_ref) -> #return_types_ref,
)*
}
unsafe impl Send for #ident {}
unsafe impl Sync for #ident {}
impl ::std::clone::Clone for #ident {
pub fn clone(&self) -> Self {
#ident{
#(#names_left: self.#names_right,)*
}
}
}
impl #ident {
pub fn load<F>(mut f: F) -> ::std::result::Result<Self, Vec<&'static str>>
where F: FnMut(&::std::ffi::CStr) -> *const c_void
{
use std::ffi::CString;
use std::mem;
let mut err_str = Vec::new();
let s = #ident {
#(
#names_ref: unsafe {
let raw_name = stringify!(#raw_names_ref);
let cname = CString::new(raw_name).unwrap();
let val = f(&cname);
if val.is_null(){
err_str.push(raw_name);
}
mem::transmute(val)
},
)*
};
if err_str.is_empty() {
Ok(s)
}
else{
Err(err_str)
}
}
#(
pub fn #names_ref(#expanded_params_ref) -> #return_types_ref {
(self.#names_left)(#(#param_names_ref,)*)
}
)*
}
}
}
2018-03-11 02:21:35 +11:00
pub fn generate_extension(extension: &vkxml::Extension, commands: &CommandMap) -> quote::Tokens {
let extension_commands: Vec<&vkxml::Command> = extension
.elements
.iter()
.flat_map(|extension| {
if let &vkxml::ExtensionElement::Require(ref spec) = extension {
spec.elements
.iter()
.filter_map(|extension_spec| {
if let &vkxml::ExtensionSpecificationElement::CommandReference(
ref cmd_ref,
) = extension_spec
{
Some(cmd_ref)
} else {
None
}
})
.collect()
} else {
vec![]
}
})
.filter_map(|cmd_ref| commands.get(&cmd_ref.name))
.map(|&cmd| cmd)
.collect();
if extension_commands.is_empty() {
return quote!{};
}
let name = format!("{}Fn", extension.name.to_camel_case());
let ident = Ident::from(&name[2..]);
generate_function_pointers(ident, &extension_commands)
}
pub fn generate_typedef(typedef: &vkxml::Typedef) -> Tokens {
let typedef_name = to_type_tokens(&typedef.name, None);
let typedef_ty = to_type_tokens(&typedef.basetype, None);
quote!{
2018-04-01 18:52:21 +10:00
pub type #typedef_name = #typedef_ty;
2018-03-11 02:21:35 +11:00
}
}
2018-06-04 19:26:14 +10:00
pub fn generate_bitmask(bitmask: &vkxml::Bitmask) -> Option<Tokens> {
// Workaround for empty bitmask
if bitmask.name.len() == 0 {
return None;
}
2018-04-01 18:52:21 +10:00
let name = &bitmask.name[2..];
let name_without_flags = name.replace("Flags", "");
let ident = Ident::from(name);
let ident_without_flags = Ident::from(name_without_flags.as_str());
2018-03-11 02:21:35 +11:00
let type_token = to_type_tokens(&bitmask.basetype, None);
2018-06-04 19:26:14 +10:00
Some(quote!{
2018-04-01 18:52:21 +10:00
pub type #ident = BitFlags<flags::#ident_without_flags>;
2018-06-04 19:26:14 +10:00
})
2018-04-01 18:52:21 +10:00
}
pub fn to_variant_ident(enum_name: &str, variant_name: &str) -> Ident {
let tag = ["AMD", "NN", "KHR", "NV", "EXT", "NVX", "KHX"]
.iter()
.filter_map(|tag| {
if enum_name.ends_with(tag) {
Some(tag)
} else {
None
}
})
.nth(0);
let name_without_tag = tag.map(|t| enum_name.replace(t, ""))
.unwrap_or(enum_name.into());
let variant_without_tag = tag.map(|t| variant_name.replace(t, ""))
.unwrap_or(variant_name.into());
let camel_case_name_enum = &name_without_tag.to_camel_case();
let name = variant_without_tag.to_camel_case()[2..].replace(camel_case_name_enum, "");
let is_digit = name.chars().nth(0).map(|c| c.is_digit(10)).unwrap_or(false);
if is_digit {
Ident::from(format!("Type{}", name).as_str())
} else {
Ident::from(name)
2018-03-11 02:21:35 +11:00
}
}
2018-04-01 18:52:21 +10:00
pub enum EnumType {
Bitflags(Tokens),
Enum(Tokens),
}
pub fn generate_enum(_enum: &vkxml::Enumeration) -> EnumType {
2018-06-06 00:47:21 +10:00
println!("{}", _enum.name);
2018-04-01 18:52:21 +10:00
let name = &_enum.name[2..];
2018-06-06 00:47:21 +10:00
let _name = name.replace("FlagBits", "Flags");
2018-04-01 18:52:21 +10:00
if name.contains("Bit") {
2018-06-06 00:47:21 +10:00
let ident = Ident::from(_name.as_str());
let all_bits = _enum
.elements
.iter()
.filter_map(|elem| match elem {
vkxml::EnumerationElement::Enum(ref constant) => {
let c = Constant::from_constant(constant);
c.value()
}
_ => None,
})
.fold(0, |acc, next| acc | next);
let all_bits_term = Term::intern(&format!("0b{:b}", all_bits));
2018-04-01 18:52:21 +10:00
let variants = _enum.elements.iter().filter_map(|elem| {
let (variant_name, value) = match *elem {
vkxml::EnumerationElement::Enum(ref constant) => {
2018-06-06 00:47:21 +10:00
let variant_name = &constant.name[3..];
2018-04-01 18:52:21 +10:00
let c = Constant::from_constant(constant);
if c.value().map(|v| v == 0).unwrap_or(false) {
return None;
}
2018-06-06 00:47:21 +10:00
(variant_name, c.to_tokens())
2018-04-01 18:52:21 +10:00
}
_ => {
return None;
}
};
2018-06-06 00:47:21 +10:00
let variant_ident = Ident::from(variant_name);
2018-04-01 18:52:21 +10:00
Some(quote!{
2018-06-06 00:47:21 +10:00
pub const #variant_ident: #ident = #ident { flags: #value };
2018-04-01 18:52:21 +10:00
})
});
let q = quote!{
2018-06-06 00:47:21 +10:00
#(#variants)*
vk_bitflags_wrapped!(#ident, #all_bits_term, Flags);
2018-04-01 18:52:21 +10:00
};
EnumType::Bitflags(q)
} else {
let variants = _enum.elements.iter().filter_map(|elem| {
let (variant_name, value) = match *elem {
vkxml::EnumerationElement::Enum(ref constant) => {
let c = Constant::from_constant(constant);
2018-06-04 19:26:14 +10:00
//println!("value {:?}", c.value());
2018-04-01 18:52:21 +10:00
(constant.name.as_str(), c.to_tokens())
}
_ => {
return None;
}
};
let variant_ident = to_variant_ident(&_name, variant_name);
Some(quote!{
#variant_ident = #value
})
});
let ident = Ident::from(_name.as_str());
let q = quote!{
#[derive(Copy, Clone, Debug)]
#[repr(C)]
pub enum #ident {
#(#variants,)*
}
};
EnumType::Enum(q)
}
2018-03-11 02:21:35 +11:00
}
pub fn generate_struct(_struct: &vkxml::Struct) -> Tokens {
let name = Ident::from(&_struct.name[2..]);
let params = _struct
.elements
.iter()
.filter_map(|elem| match *elem {
vkxml::StructElement::Member(ref field) => Some(field),
_ => None,
})
.map(|field| {
let param_ident = field.param_ident();
let param_ty_tokens = field.type_tokens();
quote!{pub #param_ident: #param_ty_tokens}
});
quote!{
#[derive(Clone, Debug)]
#[repr(C)]
pub struct #name {
#(#params,)*
}
}
}
2018-06-04 19:26:14 +10:00
pub fn generate_definition(definition: &vkxml::DefinitionsElement) -> Option<Tokens> {
2018-03-11 02:21:35 +11:00
match *definition {
2018-06-04 19:26:14 +10:00
vkxml::DefinitionsElement::Typedef(ref typedef) => Some(generate_typedef(typedef)),
vkxml::DefinitionsElement::Struct(ref _struct) => Some(generate_struct(_struct)),
2018-03-11 02:21:35 +11:00
vkxml::DefinitionsElement::Bitmask(ref mask) => generate_bitmask(mask),
2018-06-04 19:26:14 +10:00
_ => None,
2018-03-11 02:21:35 +11:00
}
}
2018-03-10 20:07:12 +11:00
pub fn generate_core_spec(feature: &vkxml::Feature, commands: &CommandMap) -> quote::Tokens {
2018-03-10 07:45:58 +11:00
let (device_commands, instance_commands) = feature
.elements
.iter()
.flat_map(|feature| {
if let &vkxml::FeatureElement::Require(ref spec) = feature {
spec.elements
.iter()
.filter_map(|feature_spec| {
if let &vkxml::FeatureReference::CommandReference(ref cmd_ref) =
feature_spec
{
Some(cmd_ref)
} else {
None
}
})
.collect()
} else {
vec![]
}
})
.filter_map(|cmd_ref| commands.get(&cmd_ref.name))
.fold((Vec::new(), Vec::new()), |mut acc, &cmd_ref| {
2018-03-10 08:43:45 +11:00
if cmd_ref.is_device_command() {
acc.0.push(cmd_ref);
} else {
acc.1.push(cmd_ref);
2018-03-10 07:45:58 +11:00
};
acc
});
let name = Ident::from("Test");
2018-03-10 08:43:45 +11:00
let version = feature.version_string();
let instance = generate_function_pointers(
Ident::from(format!("InstanceFnV{}", version).as_str()),
&instance_commands,
);
let device = generate_function_pointers(
Ident::from(format!("DeviceFnV{}", version).as_str()),
2018-03-10 20:07:12 +11:00
&device_commands,
2018-03-10 08:43:45 +11:00
);
quote! {
#instance
#device
}
2018-03-10 07:45:58 +11:00
}
2018-03-11 02:21:35 +11:00
pub fn write_source_code(spec: &vkxml::Registry) {
use std::fs::File;
2018-06-04 19:26:14 +10:00
use std::io::Write;
2018-03-11 02:21:35 +11:00
let commands: HashMap<vkxml::Identifier, &vkxml::Command> = spec.elements
.iter()
.filter_map(|elem| match elem {
&vkxml::RegistryElement::Commands(ref cmds) => Some(cmds),
_ => None,
})
.flat_map(|cmds| cmds.elements.iter().map(|cmd| (cmd.name.clone(), cmd)))
.collect();
let features: Vec<&vkxml::Feature> = spec.elements
.iter()
.filter_map(|elem| match elem {
&vkxml::RegistryElement::Features(ref features) => Some(features),
_ => None,
})
.flat_map(|features| features.elements.iter().map(|feature| feature))
.collect();
let extensions: Vec<&vkxml::Extension> = spec.elements
.iter()
.filter_map(|elem| match elem {
&vkxml::RegistryElement::Extensions(ref extensions) => Some(extensions),
_ => None,
})
.flat_map(|extensions| extensions.elements.iter().map(|extension| extension))
.collect();
let definitions: Vec<&vkxml::DefinitionsElement> = spec.elements
.iter()
.filter_map(|elem| match elem {
&vkxml::RegistryElement::Definitions(ref definitions) => Some(definitions),
_ => None,
})
.flat_map(|definitions| definitions.elements.iter().map(|definition| definition))
.collect();
2018-04-01 18:52:21 +10:00
let enums: Vec<&vkxml::Enumeration> = spec.elements
.iter()
.filter_map(|elem| match elem {
&vkxml::RegistryElement::Enums(ref enums) => Some(enums),
_ => None,
})
.flat_map(|enums| {
enums.elements.iter().filter_map(|_enum| match *_enum {
vkxml::EnumsElement::Enumeration(ref e) => Some(e),
_ => None,
})
})
.collect();
let constants: Vec<&vkxml::Constant> = spec.elements
.iter()
.filter_map(|elem| match elem {
&vkxml::RegistryElement::Constants(ref constants) => Some(constants),
_ => None,
})
.flat_map(|constants| constants.elements.iter())
.collect();
//println!("{:#?}", constants);
let (enum_code, bitflags_code) = enums.into_iter().map(generate_enum).fold(
(Vec::new(), Vec::new()),
|mut acc, elem| {
match elem {
EnumType::Enum(token) => acc.0.push(token),
EnumType::Bitflags(token) => acc.1.push(token),
};
acc
},
);
2018-06-06 00:47:21 +10:00
let definition_code: Vec<_> = definitions
.into_iter()
.filter_map(generate_definition)
.collect();
2018-03-11 02:21:35 +11:00
let feature_code: Vec<_> = features
.iter()
.map(|feature| generate_core_spec(feature, &commands))
.collect();
let extension_code: Vec<_> = extensions
.iter()
.map(|ext| generate_extension(ext, &commands))
.collect();
2018-04-01 18:52:21 +10:00
let mut file = File::create("../ash/src/vk_test.rs").expect("vk");
2018-03-11 02:21:35 +11:00
let source_code = quote!{
//#(#feature_code)*
//#(#extension_code)*
2018-04-01 18:52:21 +10:00
//#(#definition_code)*
//#(#enum_code)*
pub mod flags {
#(#bitflags_code)*
}
2018-03-11 02:21:35 +11:00
};
write!(&mut file, "{}", source_code);
}