cat_engine_basement 0.0.0-alpha7

The CatEnigne's basement
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

use crate::graphics::{
    core::GLError,
    core::buffer::{
        BufferTarget,
        BufferUsage,
    },
    level0::Buffer,
};

pub struct VertexBuffer<V:Sized>{
    buffer:Buffer<V>
}

impl<V:Sized> VertexBuffer<V>{
    #[inline(always)]
    pub fn generate()->VertexBuffer<V>{
        Self{
            buffer:Buffer::generate(),
        }
    }

    #[inline(always)]
    pub unsafe fn raw(buffer:Buffer<V>)->VertexBuffer<V>{
        Self{
            buffer,
        }
    }

    pub fn new(vertices:&[V],usage:BufferUsage)->Result<VertexBuffer<V>,GLError>{
        let buffer=VertexBuffer::generate();
        let result=buffer.rewrite(vertices,usage);
        if result.is_error(){
            Err(result)
        }
        else{
            Ok(buffer)
        }
    }

    pub fn empty(size:isize,usage:BufferUsage)->Result<VertexBuffer<V>,GLError>{
        let buffer=VertexBuffer::generate();
        let result=buffer.rewrite_empty(size,usage);
        if result.is_error(){
            Err(result)
        }
        else{
            Ok(buffer)
        }
    }

    #[inline(always)]
    pub fn as_raw(&self)->&Buffer<V>{
        &self.buffer
    }

    #[inline(always)]
    pub fn into_raw(self)->Buffer<V>{
        self.buffer
    }

    #[inline(always)]
    pub fn bind(&self)->GLError{
        self.buffer.bind(BufferTarget::ArrayBuffer)
    }

    pub fn write(&self,offset:isize,vertices:&[V])->GLError{
        let result=self.bind();
        if result.is_error(){
            result
        }
        else{
            Buffer::write(BufferTarget::ArrayBuffer,offset,vertices)
        }
    }

    /// Creates and initializes a buffer object's data store.
    /// 
    /// Returns `GLError::NoError` if no error has accured.
    /// 
    /// Returns `GLError::InvalidOperation` if the reserved buffer object name 0 is bound to target.
    /// 
    /// Returns `GLError::OutOfMemory` if the GL is unable to create a data store with the specified size.
    /// 
    /// Panics if `data` is empty.
    pub fn rewrite(&self,vertices:&[V],usage:BufferUsage)->GLError{
        let result=self.bind();
        if result.is_error(){
            result
        }
        else{
            Buffer::rewrite(BufferTarget::ArrayBuffer,vertices,usage)
        }
    }

    pub fn rewrite_empty(&self,size:isize,usage:BufferUsage)->GLError{
        let result=self.bind();
        if result.is_error(){
            result
        }
        else{
            Buffer::<V>::rewrite_empty(BufferTarget::ArrayBuffer,size,usage)
        }
    }
}