nightshade-api 0.56.0

Procedural high level API for the nightshade game engine
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

//! A diegetic control panel that lives in the 3D scene: a floating world panel
//! with labels and buttons you click in space to recolor a cube or burst
//! particles from it, viewed through the default orbit camera.

use nightshade_api::prelude::*;

struct Scene {
    cube: Entity,
    red_button: Entity,
    blue_button: Entity,
    burst_button: Entity,
    status: Entity,
}

fn main() {
    run(setup, update).unwrap();
}

fn setup(world: &mut World) -> Scene {
    set_window_title(world, "World-space UI");
    set_background(world, Background::Space);
    show_grid(world, true);
    point_light(world, vec3(2.0, 4.0, 4.0), [1.0, 0.9, 0.7], 8.0);

    spawn_floor(world, 10.0);

    let cube = spawn_cube(world, vec3(0.0, 0.6, 2.5));
    set_color(world, cube, GRAY);

    let panel = spawn_world_panel(
        world,
        vec3(0.0, 2.2, 0.0),
        3.2,
        1.8,
        rgba(0.05, 0.06, 0.1, 0.9),
    );
    set_rotation(world, panel, Vec3::y(), 0.35);
    let title = world_panel_label(world, panel, "Cube control", -1.3, 0.6);
    set_text_color(world, title, WHITE);

    let red_button = world_panel_button(world, panel, -0.9, 0.0, 0.7, 0.4, RED);
    world_panel_label(world, panel, "Red", -1.05, 0.0);
    let blue_button = world_panel_button(world, panel, 0.0, 0.0, 0.7, 0.4, BLUE);
    world_panel_label(world, panel, "Blue", -0.15, 0.0);
    let burst_button = world_panel_button(world, panel, 0.9, 0.0, 0.7, 0.4, GOLD);
    world_panel_label(world, panel, "Burst", 0.72, 0.0);

    let status = spawn_text(
        world,
        "Click a button in the scene",
        ScreenAnchor::BottomCenter,
    );
    set_text_color(world, status, WHITE);

    Scene {
        cube,
        red_button,
        blue_button,
        burst_button,
        status,
    }
}

fn update(world: &mut World, scene: &mut Scene) {
    if world_button_hovered(world, scene.burst_button) {
        set_text(world, scene.status, "Burst ready");
    }

    if world_button_clicked(world, scene.red_button) {
        set_color(world, scene.cube, RED);
        set_text(world, scene.status, "Cube set to red");
    }

    if world_button_clicked(world, scene.blue_button) {
        set_color(world, scene.cube, BLUE);
        set_text(world, scene.status, "Cube set to blue");
    }

    if world_button_clicked(world, scene.burst_button) {
        let at = position(world, scene.cube);
        emit_burst(world, at + vec3(0.0, 0.5, 0.0), GOLD, 48);
        set_text(world, scene.status, "Burst!");
    }
}