starsight 0.3.3

A unified scientific visualization crate for Rust — from zero-config one-liners to GPU-accelerated interactive 3D.
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

pub use starsight_layer_1::theme::{DEFAULT_DARK, DEFAULT_LIGHT, Theme};

/// Read `STARSIGHT_THEME` and return the corresponding default theme.
///
/// `dark` → [`DEFAULT_DARK`]; anything else (or unset) → [`DEFAULT_LIGHT`].
/// Used by the chrome examples so a single example binary can render both
/// theme variants based on its environment.
#[must_use]
pub fn theme_from_env() -> Theme {
    match std::env::var("STARSIGHT_THEME").as_deref() {
        Ok("dark") => DEFAULT_DARK,
        _ => DEFAULT_LIGHT,
    }
}

/// Filename suffix paired with [`theme_from_env`]. `"_dark"` for dark mode,
/// `""` for light. Lets examples write `<name>.png` and `<name>_dark.png`
/// from the same code path with no other branching.
#[must_use]
pub fn theme_suffix_from_env() -> &'static str {
    match std::env::var("STARSIGHT_THEME").as_deref() {
        Ok("dark") => "_dark",
        _ => "",
    }
}

/// Read `STARSIGHT_FORMAT` and return the matching file extension.
///
/// `svg` → `"svg"`; anything else (or unset) → `"png"`. Used together with
/// [`theme_suffix_from_env`] so a single example binary can render any of
/// the four (theme × format) variants based purely on its environment.
/// `Figure::save` dispatches on the extension.
#[must_use]
pub fn format_extension_from_env() -> &'static str {
    match std::env::var("STARSIGHT_FORMAT").as_deref() {
        Ok("svg") => "svg",
        _ => "png",
    }
}