nightshade-api 0.40.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

//! Lights beyond the default sun.

use crate::runner::{SUN_NAME, lookup_named};
use nightshade::prelude::*;

/// A point light at `position`. Color is linear RGB, intensity scales with
/// inverse square falloff so values around 3.0 to 10.0 read well.
pub fn point_light(world: &mut World, position: Vec3, color: [f32; 3], intensity: f32) -> Entity {
    let entity = spawn_light_entity(world, position, "api::light::point");
    world.core.set_light(
        entity,
        Light {
            light_type: LightType::Point,
            color: Vec3::new(color[0], color[1], color[2]),
            intensity,
            range: 30.0,
            cast_shadows: false,
            shadow_bias: 0.007,
            ..Default::default()
        },
    );
    entity
}

/// A shadow casting spot light at `position` aimed at `target`.
pub fn spot_light(
    world: &mut World,
    position: Vec3,
    target: Vec3,
    color: [f32; 3],
    intensity: f32,
) -> Entity {
    let entity = spawn_light_entity(world, position, "api::light::spot");
    if let Some(transform) = mutate_local_transform(world, entity) {
        transform.rotation = camera_look_rotation(position, target, 0.0);
    }
    world.core.set_light(
        entity,
        Light {
            light_type: LightType::Spot,
            color: Vec3::new(color[0], color[1], color[2]),
            intensity,
            range: 50.0,
            inner_cone_angle: 0.3,
            outer_cone_angle: 0.5,
            cast_shadows: true,
            shadow_bias: 0.0001,
            ..Default::default()
        },
    );
    entity
}

/// Adjusts the default sun's color and intensity.
pub fn set_sun(world: &mut World, color: [f32; 3], intensity: f32) {
    if let Some(sun) = lookup_named(world, SUN_NAME)
        && let Some(light) = world.core.get_light_mut(sun)
    {
        light.color = Vec3::new(color[0], color[1], color[2]);
        light.intensity = intensity;
    }
}