bracket-terminal 0.8.7

ASCII/Codepage 437 terminal emulator with a game loop. Defaults to OpenGL, also support WebGPU (for Vulkan/Metal/WGPU), Curses and Crossterm for output. Part of the bracket-lib family.
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

use super::{BufferId, Font, Shader, VertexArrayId};
use crate::gl_error_wrap;
use crate::hal::BACKEND;
use glow::HasContext;
use std::mem;

#[derive(Debug)]
pub(crate) struct VertexArray {
    vbo: Option<BufferId>,
    vao: Option<VertexArrayId>,
    ebo: Option<BufferId>,
    pub vertex_buffer: Vec<f32>,
    pub index_buffer: Vec<i32>,
}

pub(crate) struct VertexArrayEntry {
    pub index: u32,
    pub size: i32,
}

impl VertexArray {
    pub(crate) fn float_builder(
        gl: &glow::Context,
        entries: &[VertexArrayEntry],
        vertex_capacity: usize,
        index_capacity: usize,
    ) -> Self {
        let mut buffer = VertexArray {
            vbo: None,
            vao: None,
            ebo: None,
            vertex_buffer: Vec::with_capacity(vertex_capacity),
            index_buffer: Vec::with_capacity(index_capacity),
        };
        unsafe {
            // Generate buffers and arrays, as well as attributes.
            gl_error_wrap!(
                gl,
                buffer.vao = Some(gl.create_vertex_array().expect("Unable to create VAO"))
            );
            gl_error_wrap!(
                gl,
                buffer.vbo = Some(gl.create_buffer().expect("Unable to create VBO"))
            );
            gl_error_wrap!(
                gl,
                buffer.ebo = Some(gl.create_buffer().expect("Unable to create EBO"))
            );

            gl.bind_vertex_array(buffer.vao);
            gl.bind_buffer(glow::ARRAY_BUFFER, buffer.vbo);

            let stride: i32 =
                entries.iter().map(|e| e.size).sum::<i32>() * mem::size_of::<f32>() as i32;

            let mut cumulative_offset: i32 = 0;
            for entry in entries.iter() {
                gl_error_wrap!(
                    gl,
                    gl.vertex_attrib_pointer_f32(
                        entry.index,
                        entry.size,
                        glow::FLOAT,
                        false,
                        stride,
                        (cumulative_offset * mem::size_of::<f32>() as i32) as i32,
                    )
                );
                gl_error_wrap!(gl, gl.enable_vertex_attrib_array(entry.index));
                cumulative_offset += entry.size;
            }

            gl_error_wrap!(gl, gl.bind_buffer(glow::ELEMENT_ARRAY_BUFFER, buffer.ebo));
        }

        buffer
    }

    fn bind(&self, gl: &glow::Context) {
        unsafe {
            gl_error_wrap!(gl, gl.bind_vertex_array(self.vao));
            gl_error_wrap!(gl, gl.bind_buffer(glow::ARRAY_BUFFER, self.vbo));
            gl_error_wrap!(gl, gl.bind_buffer(glow::ELEMENT_ARRAY_BUFFER, self.ebo));
        }
    }

    pub(crate) fn upload_buffers(&self) {
        let be = BACKEND.lock();
        let gl = be.gl.as_ref().unwrap();
        unsafe {
            self.bind(gl);
            gl_error_wrap!(
                gl,
                gl.buffer_data_u8_slice(
                    glow::ARRAY_BUFFER,
                    self.vertex_buffer.align_to::<u8>().1,
                    glow::STATIC_DRAW,
                )
            );

            gl_error_wrap!(
                gl,
                gl.buffer_data_u8_slice(
                    glow::ELEMENT_ARRAY_BUFFER,
                    self.index_buffer.align_to::<u8>().1,
                    glow::STATIC_DRAW,
                )
            );

            gl_error_wrap!(gl, gl.bind_vertex_array(None));
        }
    }

    pub(crate) fn draw_elements(&self, shader: &Shader, font: &Font) {
        let be = BACKEND.lock();
        let gl = be.gl.as_ref().unwrap();
        unsafe {
            self.bind(gl);
            shader.useProgram(gl);
            font.bind_texture(gl);
            gl_error_wrap!(gl, gl.enable(glow::BLEND));
            gl_error_wrap!(
                gl,
                gl.blend_func(glow::SRC_ALPHA, glow::ONE_MINUS_SRC_ALPHA)
            );
            gl_error_wrap!(
                gl,
                gl.draw_elements(
                    glow::TRIANGLES,
                    self.index_buffer.len() as i32,
                    glow::UNSIGNED_INT,
                    0,
                )
            );
            gl_error_wrap!(gl, gl.disable(glow::BLEND));

            gl_error_wrap!(gl, gl.bind_vertex_array(None));
        }
    }
}