[go: up one dir, main page]

glium 0.5.3

High-level and safe OpenGL wrapper.
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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341

use std::ffi::CStr;
use version::Version;
use version::Api;
use gl;

/// Contains data about the list of extensions.
#[derive(Debug, Clone, Copy)]
pub struct ExtensionsList {
    /// GL_APPLE_vertex_array_object
    pub gl_apple_vertex_array_object: bool,
    /// GL_ARB_buffer_storage
    pub gl_arb_buffer_storage: bool,
    /// GL_ARB_compute_shader
    pub gl_arb_compute_shader: bool,
    /// GL_ARB_copy_buffer
    pub gl_arb_copy_buffer: bool,
    /// GL_ARB_debug_output
    pub gl_arb_debug_output: bool,
    /// GL_ARB_depth_texture
    pub gl_arb_depth_texture: bool,
    /// GL_ARB_direct_state_access
    pub gl_arb_direct_state_access: bool,
    /// GL_ARB_compatibility
    pub gl_arb_compatibility: bool,
    /// GL_ARB_ES2_compatibility
    pub gl_arb_es2_compatibility: bool,
    /// GL_ARB_ES3_compatibility
    pub gl_arb_es3_compatibility: bool,
    /// GL_ARB_ES3_1_compatibility
    pub gl_arb_es3_1_compatibility: bool,
    /// GL_ARB_fragment_shader
    pub gl_arb_fragment_shader: bool,
    /// GL_ARB_framebuffer_sRGB
    pub gl_arb_framebuffer_srgb: bool,
    /// GL_ARB_geometry_shader4
    pub gl_arb_geometry_shader4: bool,
    /// GL_ARB_get_program_binary
    pub gl_arb_get_programy_binary: bool,
    /// GL_ARB_instanced_arrays
    pub gl_arb_instanced_arrays: bool,
    /// GL_ARB_invalidate_subdata
    pub gl_arb_invalidate_subdata: bool,
    /// GL_ARB_map_buffer_range
    pub gl_arb_map_buffer_range: bool,
    /// GL_ARB_multi_draw_indirect
    pub gl_arb_multi_draw_indirect: bool,
    /// GL_ARB_occlusion_query
    pub gl_arb_occlusion_query: bool,
    /// GL_ARB_occlusion_query2
    pub gl_arb_occlusion_query2: bool,
    /// GL_ARB_pixel_buffer_object
    pub gl_arb_pixel_buffer_object: bool,
    /// GL_ARB_program_interface_query
    pub gl_arb_program_interface_query: bool,
    /// GL_ARB_sampler_objects
    pub gl_arb_sampler_objects: bool,
    /// GL_ARB_shader_image_load_store
    pub gl_arb_shader_image_load_store: bool,
    /// GL_ARB_shader_objects
    pub gl_arb_shader_objects: bool,
    /// GL_ARB_sync
    pub gl_arb_sync: bool,
    /// GL_ARB_tessellation_shader
    pub gl_arb_tessellation_shader: bool,
    /// GL_ARB_texture_compression_bptc
    pub gl_arb_texture_compression_bptc: bool,
    /// GL_ARB_texture_float
    pub gl_arb_texture_float: bool,
    /// GL_ARB_texture_multisample
    pub gl_arb_texture_multisample: bool,
    /// GL_ARB_texture_non_power_of_two
    pub gl_arb_texture_non_power_of_two: bool,
    /// GL_ARB_texture_rg
    pub gl_arb_texture_rg: bool,
    /// GL_ARB_texture_rgb10_a2ui
    pub gl_arb_texture_rgb10_a2ui: bool,
    /// GL_ARB_texture_storage
    pub gl_arb_texture_storage: bool,
    /// GL_ARB_timer_query
    pub gl_arb_timer_query: bool,
    /// GL_ARB_transform_feedback3
    pub gl_arb_transform_feedback3: bool,
    /// GL_ARB_uniform_buffer_object
    pub gl_arb_uniform_buffer_object: bool,
    /// GL_ARB_vertex_array_object
    pub gl_arb_vertex_array_object: bool,
    /// GL_ARB_vertex_buffer_object
    pub gl_arb_vertex_buffer_object: bool,
    /// GL_ARB_vertex_shader
    pub gl_arb_vertex_shader: bool,
    /// GL_ARM_rgba8
    pub gl_arm_rgba8: bool,
    /// GL_ATI_meminfo
    pub gl_ati_meminfo: bool,
    /// GL_EXT_debug_marker
    pub gl_ext_debug_marker: bool,
    /// GL_EXT_direct_state_access
    pub gl_ext_direct_state_access: bool,
    /// GL_EXT_disjoint_timer_query
    pub gl_ext_disjoint_timer_query: bool,
    /// GL_EXT_framebuffer_blit
    pub gl_ext_framebuffer_blit: bool,
    /// GL_EXT_framebuffer_object
    pub gl_ext_framebuffer_object: bool,
    /// GL_EXT_framebuffer_sRGB
    pub gl_ext_framebuffer_srgb: bool,
    /// GL_EXT_geometry_shader4
    pub gl_ext_geometry_shader4: bool,
    /// GL_EXT_gpu_shader4
    pub gl_ext_gpu_shader4: bool,
    /// GL_EXT_multi_draw_indirect
    pub gl_ext_multi_draw_indirect: bool,
    /// GL_EXT_occlusion_query_boolean
    pub gl_ext_occlusion_query_boolean: bool,
    /// GL_EXT_packed_depth_stencil
    pub gl_ext_packed_depth_stencil: bool,
    /// GL_EXT_texture_compression_s3tc
    pub gl_ext_texture_compression_s3tc: bool,
    /// GL_EXT_texture_filter_anisotropic
    pub gl_ext_texture_filter_anisotropic: bool,
    /// GL_EXT_texture_integer
    pub gl_ext_texture_integer: bool,
    /// GL_EXT_texture_sRGB
    pub gl_ext_texture_srgb: bool,
    /// GL_EXT_transform_feedback
    pub gl_ext_transform_feedback: bool,
    /// GL_GREMEDY_string_marker
    pub gl_gremedy_string_marker: bool,
    /// GL_KHR_debug
    pub gl_khr_debug: bool,
    /// GL_NV_copy_buffer
    pub gl_nv_copy_buffer: bool,
    /// GL_NV_conditional_render
    pub gl_nv_conditional_render: bool,
    /// GL_NV_pixel_buffer_object
    pub gl_nv_pixel_buffer_object: bool,
    /// GL_NVX_gpu_memory_info
    pub gl_nvx_gpu_memory_info: bool,
    /// GL_OES_depth_texture
    pub gl_oes_depth_texture: bool,
    /// GL_OES_packed_depth_stencil
    pub gl_oes_packed_depth_stencil: bool,
    /// GL_OES_rgb8_rgba8
    pub gl_oes_rgb8_rgba8: bool,
    /// GL_OES_vertex_array_object
    pub gl_oes_vertex_array_object: bool,
}

/// Returns the list of extensions supported by the backend.
///
/// The version must match the one of the backend.
///
/// *Safety*: the OpenGL context corresponding to `gl` must be current in the thread.
///
/// ## Panic
///
/// Can panic if the version number doesn't match the backend, leading to unloaded functions
/// being called.
///
pub unsafe fn get_extensions(gl: &gl::Gl, version: &Version) -> ExtensionsList {
    let strings = get_extensions_strings(gl, version);

    let mut extensions = ExtensionsList {
        gl_apple_vertex_array_object: false,
        gl_arb_buffer_storage: false,
        gl_arb_copy_buffer: false,
        gl_arb_compute_shader: false,
        gl_arb_debug_output: false,
        gl_arb_depth_texture: false,
        gl_arb_direct_state_access: false,
        gl_arb_compatibility: false,
        gl_arb_es2_compatibility: false,
        gl_arb_es3_compatibility: false,
        gl_arb_es3_1_compatibility: false,
        gl_arb_fragment_shader: false,
        gl_arb_framebuffer_srgb: false,
        gl_arb_geometry_shader4: false,
        gl_arb_get_programy_binary: false,
        gl_arb_instanced_arrays: false,
        gl_arb_invalidate_subdata: false,
        gl_arb_occlusion_query: false,
        gl_arb_occlusion_query2: false,
        gl_arb_map_buffer_range: false,
        gl_arb_multi_draw_indirect: false,
        gl_arb_pixel_buffer_object: false,
        gl_arb_program_interface_query: false,
        gl_arb_sampler_objects: false,
        gl_arb_shader_image_load_store: false,
        gl_arb_shader_objects: false,
        gl_arb_sync: false,
        gl_arb_tessellation_shader: false,
        gl_arb_texture_compression_bptc: false,
        gl_arb_texture_float: false,
        gl_arb_texture_multisample: false,
        gl_arb_texture_non_power_of_two: false,
        gl_arb_texture_rg: false,
        gl_arb_texture_rgb10_a2ui: false,
        gl_arb_texture_storage: false,
        gl_arb_timer_query: false,
        gl_arb_transform_feedback3: false,
        gl_arb_uniform_buffer_object: false,
        gl_arb_vertex_array_object: false,
        gl_arb_vertex_buffer_object: false,
        gl_arb_vertex_shader: false,
        gl_arm_rgba8: false,
        gl_ati_meminfo: false,
        gl_ext_debug_marker: false,
        gl_ext_direct_state_access: false,
        gl_ext_disjoint_timer_query: false,
        gl_ext_framebuffer_blit: false,
        gl_ext_framebuffer_object: false,
        gl_ext_framebuffer_srgb: false,
        gl_ext_geometry_shader4: false,
        gl_ext_gpu_shader4: false,
        gl_ext_multi_draw_indirect: false,
        gl_ext_occlusion_query_boolean: false,
        gl_ext_packed_depth_stencil: false,
        gl_ext_texture_compression_s3tc: false,
        gl_ext_texture_filter_anisotropic: false,
        gl_ext_texture_integer: false,
        gl_ext_texture_srgb: false,
        gl_ext_transform_feedback: false,
        gl_gremedy_string_marker: false,
        gl_khr_debug: false,
        gl_nv_conditional_render: false,
        gl_nv_copy_buffer: false,
        gl_nv_pixel_buffer_object: false,
        gl_nvx_gpu_memory_info: false,
        gl_oes_depth_texture: false,
        gl_oes_packed_depth_stencil: false,
        gl_oes_rgb8_rgba8: false,
        gl_oes_vertex_array_object: false,
    };

    for extension in strings.into_iter() {
        match &extension[..] {
            "GL_APPLE_vertex_array_object" => extensions.gl_apple_vertex_array_object = true,
            "GL_ARB_buffer_storage" => extensions.gl_arb_buffer_storage = true,
            "GL_ARB_compute_shader" => extensions.gl_arb_compute_shader = true,
            "GL_ARB_copy_buffer" => extensions.gl_arb_copy_buffer = true,
            "GL_ARB_debug_output" => extensions.gl_arb_debug_output = true,
            "GL_ARB_depth_texture" => extensions.gl_arb_depth_texture = true,
            "GL_ARB_direct_state_access" => extensions.gl_arb_direct_state_access = true,
            "GL_ARB_compatibility" => extensions.gl_arb_compatibility = true,
            "GL_ARB_ES2_compatibility" => extensions.gl_arb_es2_compatibility = true,
            "GL_ARB_ES3_compatibility" => extensions.gl_arb_es3_compatibility = true,
            "GL_ARB_ES3_1_compatibility" => extensions.gl_arb_es3_1_compatibility = true,
            "GL_ARB_fragment_shader" => extensions.gl_arb_fragment_shader = true,
            "GL_ARB_framebuffer_sRGB" => extensions.gl_arb_framebuffer_srgb = true,
            "GL_ARB_geometry_shader4" => extensions.gl_arb_geometry_shader4 = true,
            "GL_ARB_get_program_binary" => extensions.gl_arb_get_programy_binary = true,
            "GL_ARB_instanced_arrays" => extensions.gl_arb_instanced_arrays = true,
            "GL_ARB_invalidate_subdata" => extensions.gl_arb_invalidate_subdata = true,
            "GL_ARB_occlusion_query" => extensions.gl_arb_occlusion_query = true,
            "GL_ARB_occlusion_query2" => extensions.gl_arb_occlusion_query2 = true,
            "GL_ARB_pixel_buffer_object" => extensions.gl_arb_pixel_buffer_object = true,
            "GL_ARB_program_interface_query" => extensions.gl_arb_program_interface_query = true,
            "GL_ARB_map_buffer_range" => extensions.gl_arb_map_buffer_range = true,
            "GL_ARB_multi_draw_indirect" => extensions.gl_arb_multi_draw_indirect = true,
            "GL_ARB_sampler_objects" => extensions.gl_arb_sampler_objects = true,
            "GL_ARB_shader_image_load_store" => extensions.gl_arb_shader_image_load_store = true,
            "GL_ARB_shader_objects" => extensions.gl_arb_shader_objects = true,
            "GL_ARB_sync" => extensions.gl_arb_sync = true,
            "GL_ARB_tessellation_shader" => extensions.gl_arb_tessellation_shader = true,
            "GL_ARB_texture_compression_bptc" => extensions.gl_arb_texture_compression_bptc = true,
            "GL_ARB_texture_float" => extensions.gl_arb_texture_float = true,
            "GL_ARB_texture_multisample" => extensions.gl_arb_texture_multisample = true,
            "GL_ARB_texture_non_power_of_two" => extensions.gl_arb_texture_non_power_of_two = true,
            "GL_ARB_texture_rg" => extensions.gl_arb_texture_rg = true,
            "GL_ARB_texture_rgb10_a2ui" => extensions.gl_arb_texture_rgb10_a2ui = true,
            "GL_ARB_texture_storage" => extensions.gl_arb_texture_storage = true,
            "GL_ARB_timer_query" => extensions.gl_arb_timer_query = true,
            "GL_ARB_transform_feedback3" => extensions.gl_arb_transform_feedback3 = true,
            "GL_ARB_uniform_buffer_object" => extensions.gl_arb_uniform_buffer_object = true,
            "GL_ARB_vertex_array_object" => extensions.gl_arb_vertex_array_object = true,
            "GL_ARB_vertex_buffer_object" => extensions.gl_arb_vertex_buffer_object = true,
            "GL_ARB_vertex_shader" => extensions.gl_arb_vertex_shader = true,
            "GL_ARM_rgba8" => extensions.gl_arm_rgba8 = true,
            "GL_ATI_meminfo" => extensions.gl_ati_meminfo = true,
            "GL_EXT_debug_marker" => extensions.gl_ext_debug_marker = true,
            "GL_EXT_direct_state_access" => extensions.gl_ext_direct_state_access = true,
            "GL_EXT_disjoint_timer_query" => extensions.gl_ext_disjoint_timer_query = true,
            "GL_EXT_framebuffer_blit" => extensions.gl_ext_framebuffer_blit = true,
            "GL_EXT_framebuffer_object" => extensions.gl_ext_framebuffer_object = true,
            "GL_EXT_framebuffer_sRGB" => extensions.gl_ext_framebuffer_srgb = true,
            "GL_EXT_geometry_shader4" => extensions.gl_ext_geometry_shader4 = true,
            "GL_EXT_gpu_shader4" => extensions.gl_ext_gpu_shader4 = true,
            "GL_EXT_multi_draw_indirect" => extensions.gl_ext_multi_draw_indirect = true,
            "GL_EXT_occlusion_query_boolean" => extensions.gl_ext_occlusion_query_boolean = true,
            "GL_EXT_packed_depth_stencil" => extensions.gl_ext_packed_depth_stencil = true,
            "GL_EXT_texture_compression_s3tc" => extensions.gl_ext_texture_compression_s3tc = true,
            "GL_EXT_texture_filter_anisotropic" => extensions.gl_ext_texture_filter_anisotropic = true,
            "GL_EXT_texture_integer" => extensions.gl_ext_texture_integer = true,
            "GL_EXT_texture_sRGB" => extensions.gl_ext_texture_srgb = true,
            "GL_EXT_transform_feedback" => extensions.gl_ext_transform_feedback = true,
            "GL_GREMEDY_string_marker" => extensions.gl_gremedy_string_marker = true,
            "GL_KHR_debug" => extensions.gl_khr_debug = true,
            "GL_NV_conditional_render" => extensions.gl_nv_conditional_render = true,
            "GL_NV_copy_buffer" => extensions.gl_nv_copy_buffer = true,
            "GL_NV_pixel_buffer_object" => extensions.gl_nv_pixel_buffer_object = true,
            "GL_NVX_gpu_memory_info" => extensions.gl_nvx_gpu_memory_info = true,
            "GL_OES_depth_texture" => extensions.gl_oes_depth_texture = true,
            "GL_OES_packed_depth_stencil" => extensions.gl_oes_packed_depth_stencil = true,
            "GL_OES_rgb8_rgba8" => extensions.gl_oes_rgb8_rgba8 = true,
            "GL_OES_vertex_array_object" => extensions.gl_oes_vertex_array_object = true,
            _ => ()
        }
    }

    extensions
}

/// Returns the list of all extension names supported by the OpenGL implementation.
///
/// The version must match the one of the backend.
///
/// *Safety*: the OpenGL context corresponding to `gl` must be current in the thread.
///
/// ## Panic
///
/// Can panic if the version number doesn't match the backend, leading to unloaded functions
/// being called.
///
unsafe fn get_extensions_strings(gl: &gl::Gl, version: &Version) -> Vec<String> {
    if version >= &Version(Api::Gl, 3, 0) || version >= &Version(Api::GlEs, 3, 0) {
        let mut num_extensions = 0;
        gl.GetIntegerv(gl::NUM_EXTENSIONS, &mut num_extensions);

        (0 .. num_extensions).map(|num| {
            let ext = gl.GetStringi(gl::EXTENSIONS, num as gl::types::GLuint);
            String::from_utf8(CStr::from_ptr(ext as *const i8).to_bytes().to_vec()).unwrap()
        }).collect()

    } else {
        let list = gl.GetString(gl::EXTENSIONS);
        assert!(!list.is_null());
        let list = String::from_utf8(CStr::from_ptr(list as *const i8).to_bytes().to_vec())
                                     .unwrap();
        list.split(' ').map(|e| e.to_string()).collect()
    }
}