proof-engine 0.2.1

Real-time graphics from math: glyphs and particles moved by ODEs, strange attractors and force fields, drawn with HDR bloom on OpenGL.
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


// ── Shader Compilation Diagnostic Helpers ────────────────────────────────────

pub fn diagnostic_kind_name(kind: &DiagnosticKind) -> &'static str {
    match kind {
        DiagnosticKind::Error => "error",
        DiagnosticKind::Warning => "warning",
        DiagnosticKind::Info => "info",
        DiagnosticKind::Hint => "hint",
    }
}

pub fn blend_factor_name(f: &BlendFactor) -> &'static str {
    match f {
        BlendFactor::Zero => "Zero",
        BlendFactor::One => "One",
        BlendFactor::SrcAlpha => "SrcAlpha",
        BlendFactor::OneMinusSrcAlpha => "OneMinusSrcAlpha",
        BlendFactor::DstAlpha => "DstAlpha",
        BlendFactor::OneMinusDstAlpha => "OneMinusDstAlpha",
        BlendFactor::SrcColor => "SrcColor",
        BlendFactor::DstColor => "DstColor",
        BlendFactor::OneMinusSrcColor => "OneMinusSrcColor",
        BlendFactor::OneMinusDstColor => "OneMinusDstColor",
    }
}

pub fn compare_func_name(f: &CompareFunc) -> &'static str {
    match f {
        CompareFunc::Never => "Never",
        CompareFunc::Less => "Less",
        CompareFunc::Equal => "Equal",
        CompareFunc::LessEqual => "LessEqual",
        CompareFunc::Greater => "Greater",
        CompareFunc::NotEqual => "NotEqual",
        CompareFunc::GreaterEqual => "GreaterEqual",
        CompareFunc::Always => "Always",
    }
}

pub fn cull_mode_name(m: &CullMode) -> &'static str {
    match m { CullMode::None => "None", CullMode::Front => "Front", CullMode::Back => "Back" }
}

pub fn polygon_mode_name(m: &PolygonMode) -> &'static str {
    match m { PolygonMode::Fill => "Fill", PolygonMode::Line => "Line", PolygonMode::Point => "Point" }
}

pub fn vertex_format_size(f: &VertexFormat) -> u32 {
    match f {
        VertexFormat::Float32 => 4, VertexFormat::Float32x2 => 8, VertexFormat::Float32x3 => 12,
        VertexFormat::Float32x4 => 16, VertexFormat::Uint8x4 => 4, VertexFormat::Sint8x4 => 4,
        VertexFormat::Unorm8x4 => 4, VertexFormat::Snorm8x4 => 4, VertexFormat::Uint16x2 => 4,
        VertexFormat::Sint16x2 => 4, VertexFormat::Unorm16x2 => 4, VertexFormat::Snorm16x2 => 4,
        VertexFormat::Uint16x4 => 8, VertexFormat::Sint16x4 => 8, VertexFormat::Unorm16x4 => 8,
        VertexFormat::Snorm16x4 => 8, VertexFormat::Uint32 => 4, VertexFormat::Uint32x2 => 8,
        VertexFormat::Uint32x3 => 12, VertexFormat::Uint32x4 => 16, VertexFormat::Sint32 => 4,
        VertexFormat::Sint32x2 => 8, VertexFormat::Sint32x3 => 12, VertexFormat::Sint32x4 => 16,
    }
}

pub fn attachment_format_is_depth(f: &AttachmentFormat) -> bool {
    matches!(f, AttachmentFormat::Depth16 | AttachmentFormat::Depth24 | AttachmentFormat::Depth32F | AttachmentFormat::Depth24Stencil8 | AttachmentFormat::Depth32FStencil8)
}

pub fn buffer_usage_name(u: &BufferUsage) -> &'static str {
    match u { BufferUsage::Vertex => "Vertex", BufferUsage::Index => "Index", BufferUsage::Uniform => "Uniform", BufferUsage::Storage => "Storage", BufferUsage::Indirect => "Indirect", BufferUsage::TransferSrc => "TransferSrc", BufferUsage::TransferDst => "TransferDst" }
}

pub fn shader_compiler_credits() -> &'static str {
    "ShaderCompilerEditor — Built for proof-engine by the core rendering team."
}

pub fn shader_module_summary() -> String {
    format!(
        "Module count: {} | Version: {} | APIs: {} | Keywords: {} | Builtins: {}",
        shader_module_count(),
        shader_system_version(),
        supported_render_apis().len(),
        glsl_keyword_count(),
        glsl_builtin_function_count(),
    )
}