mapi/glapi: Remove glX_doc.py.

[mesa.git] / docs / GL3.txt

diff --git a/docs/GL3.txt b/docs/GL3.txt
index d41c052c2342630ffd1ef0bf233f5832b0401d2d..b7e4c87649977b2a95ce13e182dd421ed7afcb0d 100644 (file)
--- a/docs/GL3.txt
+++ b/docs/GL3.txt
@@ -7,157 +7,177 @@ infrastructure is complete but it may be the case that few (if any) drivers
 implement the features.
 
 
 implement the features.
 
 

+OpenGL Core and Compatibility context support
+
+OpenGL 3.1 and later versions are only supported with the Core profile.
+There are no plans to support GL_ARB_compatibility. The last supported OpenGL
+version with all deprecated features is 3.0. Some of the later GL features
+are exposed in the 3.0 context as extensions.
+
+

 Feature                                               Status
 ----------------------------------------------------- ------------------------
 
 Feature                                               Status
 ----------------------------------------------------- ------------------------
 

-GL 3.0:
-
-GLSL 1.30                                             DONE
-glBindFragDataLocation, glGetFragDataLocation         DONE
-Conditional rendering (GL_NV_conditional_render)      DONE (i965, r300, r600, swrast)
-Map buffer subranges (GL_ARB_map_buffer_range)        DONE (i965, r300, r600, swrast)
-Clamping controls (GL_ARB_color_buffer_float)         DONE (i965, r300, r600)
-Float textures, renderbuffers (GL_ARB_texture_float)  DONE (i965, r300, r600)
-GL_EXT_packed_float                                   DONE (i965, r600)
-GL_EXT_texture_shared_exponent                        DONE (i965, r600, swrast)
-Float depth buffers (GL_ARB_depth_buffer_float)       DONE (i965, r600)
-Framebuffer objects (GL_ARB_framebuffer_object)       DONE (i965, r300, r600, swrast)
-Half-float                                            DONE
-Non-normalized Integer texture/framebuffer formats    DONE (i965)
-1D/2D Texture arrays                                  DONE
-Per-buffer blend and masks (GL_EXT_draw_buffers2)     DONE (i965, r600, swrast)
-GL_EXT_texture_compression_rgtc                       DONE (i965, r300, r600, swrast)
-Red and red/green texture formats                     DONE (i965, swrast, gallium)
-Transform feedback (GL_EXT_transform_feedback)        DONE (i965)
-Vertex array objects (GL_APPLE_vertex_array_object)   DONE (i965, r300, r600, swrast)
-sRGB framebuffer format (GL_EXT_framebuffer_sRGB)     DONE (i965, r600)
-glClearBuffer commands                                DONE
-glGetStringi command                                  DONE
-glTexParameterI, glGetTexParameterI commands          DONE
-glVertexAttribI commands                              ~50% done (converts int
-                                                                 values to floats)
-Depth format cube textures                            DONE
-GLX_ARB_create_context (GLX 1.4 is required)          DONE
-
-
-GL 3.1:
-
-GLSL 1.40                                             needs UBOs (in progress)
-Forward compatibile context support/deprecations      not started
-Instanced drawing (GL_ARB_draw_instanced)             DONE (i965, gallium, swrast)
-Buffer copying (GL_ARB_copy_buffer)                   DONE (i965, r300, r600, swrast)
-Primitive restart (GL_NV_primitive_restart)           DONE (i965, r600)
-16 vertex texture image units                         DONE
-Texture buffer objs (GL_ARB_texture_buffer_object)    needs GL3.1 enabling (i965)
-Rectangular textures (GL_ARB_texture_rectangle)       DONE (i965, r300, r600, swrast)
-Uniform buffer objs (GL_ARB_uniform_buffer_object)    DONE (i965)
-Signed normalized textures (GL_EXT_texture_snorm)     DONE (i965, r300, r600)
-
-
-GL 3.2:
-
-Core/compatibility profiles                           not started
-GLSL 1.50                                             not started
-Geometry shaders (GL_ARB_geometry_shader4)            partially done (Zack)
-BGRA vertex order (GL_ARB_vertex_array_bgra)          DONE (i965, r300, r600, swrast)
-Base vertex offset(GL_ARB_draw_elements_base_vertex)  DONE (i965, r300, r600, swrast)
-Frag shader coord (GL_ARB_fragment_coord_conventions) DONE (i965, r300, r600, swrast)
-Provoking vertex (GL_ARB_provoking_vertex)            DONE (i965, r300, r600, swrast)
-Seamless cubemaps (GL_ARB_seamless_cube_map)          DONE (i965, r600)
-Multisample textures (GL_ARB_texture_multisample)     not started
-Frag depth clamp (GL_ARB_depth_clamp)                 DONE (i965, r600, swrast)
-Fence objects (GL_ARB_sync)                           DONE (i965, r300, r600, swrast)
-GLX_ARB_create_context_profile                        DONE
-
-
-GL 3.3:
-
-GLSL 3.30                                             new features in this version pretty much done
-GL_ARB_blend_func_extended                            DONE (i965, r600, softpipe)
-GL_ARB_explicit_attrib_location                       DONE (i915, i965, r300, r600, swrast)
-GL_ARB_occlusion_query2                               DONE (r300, r600, swrast)
-GL_ARB_sampler_objects                                DONE (i965, r300, r600)
-GL_ARB_shader_bit_encoding                            DONE
-GL_ARB_texture_rgb10_a2ui                             DONE (r600)
-GL_ARB_texture_swizzle                                DONE (same as EXT version) (i965, r300, r600, swrast)
-GL_ARB_timer_query                                    DONE
-GL_ARB_instanced_arrays                               DONE (i965, r300, r600)
-GL_ARB_vertex_type_2_10_10_10_rev                     DONE (r600)
+GL 3.0 --- all DONE: i965, nv50, nvc0, r600, radeonsi
+
+  GLSL 1.30                                             DONE ()
+  glBindFragDataLocation, glGetFragDataLocation         DONE
+  Conditional rendering (GL_NV_conditional_render)      DONE (r300, swrast)
+  Map buffer subranges (GL_ARB_map_buffer_range)        DONE (r300, swrast)
+  Clamping controls (GL_ARB_color_buffer_float)         DONE (r300)
+  Float textures, renderbuffers (GL_ARB_texture_float)  DONE (r300)
+  GL_EXT_packed_float                                   DONE ()
+  GL_EXT_texture_shared_exponent                        DONE (swrast)
+  Float depth buffers (GL_ARB_depth_buffer_float)       DONE ()
+  Framebuffer objects (GL_ARB_framebuffer_object)       DONE (r300, swrast)
+  GL_ARB_half_float_pixel                               DONE (all drivers)
+  GL_ARB_half_float_vertex                              DONE (r300, swrast)
+  GL_EXT_texture_integer                                DONE ()
+  GL_EXT_texture_array                                  DONE ()
+  Per-buffer blend and masks (GL_EXT_draw_buffers2)     DONE (swrast)
+  GL_EXT_texture_compression_rgtc                       DONE (r300, swrast)
+  GL_ARB_texture_rg                                     DONE (r300, swrast)
+  Transform feedback (GL_EXT_transform_feedback)        DONE ()
+  Vertex array objects (GL_ARB_vertex_array_object)     DONE (all drivers)
+  sRGB framebuffer format (GL_EXT_framebuffer_sRGB)     DONE ()
+  glClearBuffer commands                                DONE
+  glGetStringi command                                  DONE
+  glTexParameterI, glGetTexParameterI commands          DONE
+  glVertexAttribI commands                              DONE
+  Depth format cube textures                            DONE ()
+  GLX_ARB_create_context (GLX 1.4 is required)          DONE
+  Multisample anti-aliasing                             DONE (r300)
+
+
+GL 3.1 --- all DONE: i965, nv50, nvc0, r600, radeonsi
+
+  GLSL 1.40                                             DONE ()
+  Forward compatible context support/deprecations       DONE ()
+  Instanced drawing (GL_ARB_draw_instanced)             DONE (swrast)
+  Buffer copying (GL_ARB_copy_buffer)                   DONE (r300, swrast)
+  Primitive restart (GL_NV_primitive_restart)           DONE (r300)
+  16 vertex texture image units                         DONE ()
+  Texture buffer objs (GL_ARB_texture_buffer_object)    DONE for OpenGL 3.1 contexts ()
+  Rectangular textures (GL_ARB_texture_rectangle)       DONE (r300, swrast)
+  Uniform buffer objs (GL_ARB_uniform_buffer_object)    DONE (swrast)
+  Signed normalized textures (GL_EXT_texture_snorm)     DONE (r300)
+
+
+GL 3.2 --- all DONE: i965, nv50, nvc0, r600, radeonsi
+
+  Core/compatibility profiles                           DONE
+  GLSL 1.50                                             DONE ()
+  Geometry shaders                                      DONE ()
+  BGRA vertex order (GL_ARB_vertex_array_bgra)          DONE (r300, swrast)
+  Base vertex offset(GL_ARB_draw_elements_base_vertex)  DONE (r300, swrast)
+  Frag shader coord (GL_ARB_fragment_coord_conventions) DONE (r300, swrast)
+  Provoking vertex (GL_ARB_provoking_vertex)            DONE (r300, swrast)
+  Seamless cubemaps (GL_ARB_seamless_cube_map)          DONE ()
+  Multisample textures (GL_ARB_texture_multisample)     DONE ()
+  Frag depth clamp (GL_ARB_depth_clamp)                 DONE (swrast)
+  Fence objects (GL_ARB_sync)                           DONE (r300, swrast)
+  GLX_ARB_create_context_profile                        DONE
+
+
+GL 3.3 --- all DONE: i965, nv50, nvc0, r600, radeonsi
+
+  GLSL 3.30                                             DONE ()
+  GL_ARB_blend_func_extended                            DONE (softpipe)
+  GL_ARB_explicit_attrib_location                       DONE (all drivers that support GLSL)
+  GL_ARB_occlusion_query2                               DONE (r300, swrast)
+  GL_ARB_sampler_objects                                DONE (all drivers)
+  GL_ARB_shader_bit_encoding                            DONE ()
+  GL_ARB_texture_rgb10_a2ui                             DONE ()
+  GL_ARB_texture_swizzle                                DONE (r300, swrast)
+  GL_ARB_timer_query                                    DONE ()
+  GL_ARB_instanced_arrays                               DONE (r300)
+  GL_ARB_vertex_type_2_10_10_10_rev                     DONE ()

 
 
 GL 4.0:
 
 
 
 GL 4.0:
 

-GLSL 4.0                                             not started
-GL_ARB_texture_query_lod                             not started
-GL_ARB_draw_buffers_blend                            DONE (i965, r600, softpipe)
-GL_ARB_draw_indirect                                 not started
-GL_ARB_gpu_shader5                                   not started
-GL_ARB_gpu_shader_fp64                               not started
-GL_ARB_sample_shading                                not started
-GL_ARB_shader_subroutine                             not started
-GL_ARB_tessellation_shader                           not started
-GL_ARB_texture_buffer_object_rgb32                   not started
-GL_ARB_texture_cube_map_array                        not started
-GL_ARB_texture_gather                                not started
-GL_ARB_transform_feedback2                           DONE
-GL_ARB_transform_feedback3                           DONE
+  GLSL 4.0                                             not started
+  GL_ARB_texture_query_lod                             DONE (i965)
+  GL_ARB_draw_buffers_blend                            DONE (i965, nv50, nvc0, r600, radeonsi, softpipe)
+  GL_ARB_draw_indirect                                 DONE (i965)
+  GL_ARB_gpu_shader5                                   started
+  GL_ARB_gpu_shader_fp64                               not started
+  GL_ARB_sample_shading                                DONE (i965)
+  GL_ARB_shader_subroutine                             not started
+  GL_ARB_tessellation_shader                           not started
+  GL_ARB_texture_buffer_object_rgb32                   DONE (i965, nvc0, r600, radeonsi, softpipe)
+  GL_ARB_texture_cube_map_array                        DONE (i965, nv50, nvc0, r600, softpipe)
+  GL_ARB_texture_gather                                DONE (i965, nv50)
+  GL_ARB_transform_feedback2                           DONE (i965, nv50, nvc0, r600, radeonsi)
+  GL_ARB_transform_feedback3                           DONE (i965, nv50, nvc0, r600, radeonsi)

 
 
 GL 4.1:
 
 
 
 GL 4.1:
 

-GLSL 4.1                                             not started
-GL_ARB_ES2_compatibility                             DONE (i965, r300, r600)
-GL_ARB_get_program_binary                            not started
-GL_ARB_separate_shader_objects                       some infrastructure done
-GL_ARB_shader_precision                              not started
-GL_ARB_vertex_attrib_64bit                           not started
-GL_ARB_viewport_array                                not started
+  GLSL 4.1                                             not started
+  GL_ARB_ES2_compatibility                             DONE (i965, nv50, nvc0, r300, r600, radeonsi)
+  GL_ARB_get_program_binary                            DONE (0 binary formats)
+  GL_ARB_separate_shader_objects                       started (Ian Romanick, Gregory Hainaut)
+  GL_ARB_shader_precision                              not started
+  GL_ARB_vertex_attrib_64bit                           not started
+  GL_ARB_viewport_array                                DONE (i965, nv50, r600)

 
 
 GL 4.2:
 
 
 
 GL 4.2:
 

-GLSL 4.2                                             not started
-GL_ARB_texture_compression_bptc                      not started
-GL_ARB_compressed_texture_pixel_storage              not started
-GL_ARB_shader_atomic_counters                        not started
-GL_ARB_texture_storage                               DONE (r300, r600, swrast)
-GL_ARB_transform_feedback_instanced                  DONE
-GL_ARB_base_instance                                 DONE (nv50, nvc0, r600, radeonsi)
-GL_ARB_shader_image_load_store                       not started
-GL_ARB_conservative_depth                            DONE (softpipe)
-GL_ARB_shading_language_420pack                      not started
-GL_ARB_internalformat_query                          not started
-GL_ARB_map_buffer_alignment                          not started
+  GLSL 4.2                                             not started
+  GL_ARB_texture_compression_bptc                      not started
+  GL_ARB_compressed_texture_pixel_storage              not started
+  GL_ARB_shader_atomic_counters                        DONE (i965)
+  GL_ARB_texture_storage                               DONE (all drivers)
+  GL_ARB_transform_feedback_instanced                  DONE (i965, nv50, nvc0, r600, radeonsi)
+  GL_ARB_base_instance                                 DONE (i965, nv50, nvc0, r600, radeonsi)
+  GL_ARB_shader_image_load_store                       in progress (curro)
+  GL_ARB_conservative_depth                            DONE (all drivers that support GLSL 1.30)
+  GL_ARB_shading_language_420pack                      DONE (all drivers that support GLSL 1.30)
+  GL_ARB_internalformat_query                          DONE (i965, nv50, nvc0, r300, r600, radeonsi)
+  GL_ARB_map_buffer_alignment                          DONE (all drivers)

 
 
 GL 4.3:
 
 
 
 GL 4.3:
 

-GLSL 4.3                                             not started
-ARB_arrays_of_arrays                                 not started
-ARB_ES3_compatibility                                not started
-ARB_clear_buffer_object                              not started
-ARB_compute_shader                                   started (gallium)
-ARB_copy_image                                       not started
-ARB_debug_group                                      not started
-ARB_debug_label                                      not started
-ARB_debug_output                                     DONE
-ARB_debug_output2                                    not started
-ARB_explicit_uniform_location                        not started
-ARB_fragment_layer_viewport                          not started
-ARB_framebuffer_no_attachments                       not started
-ARB_internalformat_query2                            not started
-ARB_invalidate_subdata                               not started
-ARB_multi_draw_indirect                              not started
-ARB_program_interface_query                          not started
-ARB_robust_buffer_access_behavior                    not started
-ARB_shader_image_size                                not started
-ARB_shader_storage_buffer_object                     not started
-ARB_stencil_texturing                                not started
-ARB_texture_buffer_range                             not started
-ARB_texture_query_levels                             not started
-ARB_texture_storage_multisample                      not started
-ARB_texture_view                                     not started
-ARB_vertex_attrib_binding                            not started
+  GLSL 4.3                                             not started
+  GL_ARB_arrays_of_arrays                              started
+  GL_ARB_ES3_compatibility                             DONE (i965)
+  GL_ARB_clear_buffer_object                           DONE (all drivers)
+  GL_ARB_compute_shader                                started (Paul Berry)
+  GL_ARB_copy_image                                    not started
+  GL_KHR_debug                                         DONE (all drivers)
+  GL_ARB_explicit_uniform_location                     not started
+  GL_ARB_fragment_layer_viewport                       not started
+  GL_ARB_framebuffer_no_attachments                    not started
+  GL_ARB_internalformat_query2                         not started
+  GL_ARB_invalidate_subdata                            DONE (all drivers)
+  GL_ARB_multi_draw_indirect                           DONE (i965)
+  GL_ARB_program_interface_query                       not started
+  GL_ARB_robust_buffer_access_behavior                 not started
+  GL_ARB_shader_image_size                             not started
+  GL_ARB_shader_storage_buffer_object                  not started
+  GL_ARB_stencil_texturing                             DONE (i965/gen8+)
+  GL_ARB_texture_buffer_range                          DONE (nv50, nvc0, i965, r600, radeonsi)
+  GL_ARB_texture_query_levels                          DONE (i965)
+  GL_ARB_texture_storage_multisample                   DONE (all drivers that support GL_ARB_texture_multisample)
+  GL_ARB_texture_view                                  started (Courtney Goeltzenleuchter, Chris Forbes)
+  GL_ARB_vertex_attrib_binding                         DONE (all drivers)
+
+
+GL 4.4:
+
+  GLSL 4.4                                             not started
+  GL_MAX_VERTEX_ATTRIB_STRIDE                          not started
+  GL_ARB_buffer_storage                                DONE (i965, r300, r600, radeonsi)
+  GL_ARB_clear_texture                                 not started
+  GL_ARB_enhanced_layouts                              not started
+  GL_ARB_multi_bind                                    started (Fredrik Höglund)
+  GL_ARB_query_buffer_object                           not started
+  GL_ARB_texture_mirror_clamp_to_edge                  DONE (i965, nv30, nv50, nvc0, r300, r600, radeonsi, swrast)
+  GL_ARB_texture_stencil8                              not started
+  GL_ARB_vertex_type_10f_11f_11f_rev                   DONE (i965, nv50, nvc0, r600)

 
 
 More info about these features and the work involved can be found at
 
 
 More info about these features and the work involved can be found at