raylib-ffi 5.5.1

Automatic raw Rust bindings to raylib
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use std::path::PathBuf;

use crate::wrap::enums::get_blocked_enum_names;

/// Compiles raylib
pub fn compile_raylib(raylib_path: &str) {
    // Construct a config for running cmake
    let mut cmake_config = cmake::Config::new(raylib_path);
    let mut cmake_config = cmake_config
        .define("BUILD_EXAMPLES", "OFF")
        .define("CMAKE_BUILD_TYPE", "Release");

    if cfg!(feature = "dylib") {
        cmake_config.define("BUILD_SHARED_LIBS", "ON");
    }

    // Set the correct build profile
    #[cfg(debug_assertions)]
    {
        cmake_config = cmake_config.profile("Debug");
    }

    #[cfg(not(debug_assertions))]
    {
        cmake_config = cmake_config.profile("Release");
    }

    // Build the cmake project
    let destination = cmake_config.build();

    // Tell cargo where the libraries might be
    println!(
        "cargo:rustc-link-search=native={}",
        destination.join("lib").display()
    );
    println!(
        "cargo:rustc-link-search=native={}",
        destination.join("lib32").display()
    );
    println!(
        "cargo:rustc-link-search=native={}",
        destination.join("lib64").display()
    );
}

/// Links libraries
pub fn link_libs() {
    // Handle windows libs
    if cfg!(windows) {
        println!("cargo:rustc-link-lib=dylib=winmm");
        println!("cargo:rustc-link-lib=dylib=gdi32");
        println!("cargo:rustc-link-lib=dylib=user32");
        println!("cargo:rustc-link-lib=dylib=shell32");
    }
    // Handle MacOS
    else if cfg!(target_os = "macos") {
        println!("cargo:rustc-link-search=native=/usr/local/lib");
        println!("cargo:rustc-link-lib=framework=OpenGL");
        println!("cargo:rustc-link-lib=framework=Cocoa");
        println!("cargo:rustc-link-lib=framework=IOKit");
        println!("cargo:rustc-link-lib=framework=CoreFoundation");
        println!("cargo:rustc-link-lib=framework=CoreVideo");
    }
    // Handle UNIX
    else if cfg!(unix) {
        println!("cargo:rustc-link-search=/usr/local/lib");
        println!("cargo:rustc-link-lib=X11");
    }
    // Fail on other platforms
    else {
        panic!("Unsupported platform");
    }

    // Link raylib itself
    if cfg!(feature = "dylib") {
        println!("cargo:rustc-link-lib=dylib=raylib");
    }
    else {
        println!("cargo:rustc-link-lib=static=raylib");
    }
}

/// Generates `bindings.rs` file
pub fn generate_bindings(header_file: &str) {
    // Construct a builder for generating bindings
    let mut builder = bindgen::Builder::default()
        .header(header_file)
        .parse_callbacks(Box::new(bindgen::CargoCallbacks::new()))
        .blocklist_item("DEG2RAD")
        .blocklist_item("PI")
        .blocklist_item("RAD2DEG")
        .blocklist_item("__GNUC_VA_LIST")
        .blocklist_item("__bool_true_false_are_defined")
        .blocklist_item("false_")
        .blocklist_item("true_");

    // Deny all blocked enums
    for enum_name in get_blocked_enum_names() {
        builder = builder.blocklist_type(format!("{}.*", enum_name));
    }

    // Generate the bindings
    let bindings = builder.generate().expect("Unable to generate bindings");

    // Write `src/bindings.rs`
    let out_path = PathBuf::from(std::env::var("OUT_DIR").unwrap());
    bindings
        .write_to_file(out_path.join("bindings.rs"))
        .expect("Couldn't write bindings!");
}