From 7a4107291d1545fbdd9f144cac76a89e9f49b634 Mon Sep 17 00:00:00 2001 From: Emil Velikov Date: Wed, 29 Nov 2017 15:09:01 +0000 Subject: docs/specs: annotate MESA_agp_offset as obsolete No Mesa driver has implemented the extension in ages. Seemingly non Mesa drivers don't implement it either. As mentioned by Ian, the extension is effectively superseded by ARB_vertex_buffer_object. v2: Move the extension to OLD/ Signed-off-by: Emil Velikov Reviewed-by: Brian Paul (v1) Reviewed-by: Adam Jackson (v1) Reviewed-by: Ian Romanick --- docs/extensions.html | 2 +- docs/specs/MESA_agp_offset.spec | 95 ------------------------------------- docs/specs/OLD/MESA_agp_offset.spec | 94 ++++++++++++++++++++++++++++++++++++ 3 files changed, 95 insertions(+), 96 deletions(-) delete mode 100644 docs/specs/MESA_agp_offset.spec create mode 100644 docs/specs/OLD/MESA_agp_offset.spec diff --git a/docs/extensions.html b/docs/extensions.html index 8191200d114..1fbd35d9dda 100644 --- a/docs/extensions.html +++ b/docs/extensions.html @@ -23,7 +23,7 @@ The specifications follow.
    -
  • MESA_agp_offset.spec +
  • MESA_agp_offset.spec
  • MESA_copy_sub_buffer.spec
  • MESA_drm_image.spec
  • MESA_multithread_makecurrent.spec diff --git a/docs/specs/MESA_agp_offset.spec b/docs/specs/MESA_agp_offset.spec deleted file mode 100644 index 06e1d902edd..00000000000 --- a/docs/specs/MESA_agp_offset.spec +++ /dev/null @@ -1,95 +0,0 @@ -Name - - MESA_agp_offset - -Name Strings - - GLX_MESA_agp_offset - -Contact - - Brian Paul, Tungsten Graphics, Inc. (brian.paul 'at' tungstengraphics.com) - Keith Whitwell, Tungsten Graphics, Inc. (keith 'at' tungstengraphics.com) - -Status - - Shipping (Mesa 4.0.4 and later. Only implemented in particular - XFree86/DRI drivers.) - -Version - - 1.0 - -Number - - TBD - -Dependencies - - OpenGL 1.0 or later is required - GLX_NV_vertex_array_range is required. - This extensions is written against the OpenGL 1.4 Specification. - -Overview - - This extensions provides a way to convert pointers in an AGP memory - region into byte offsets into the AGP aperture. - Note, this extension depends on GLX_NV_vertex_array_range, for which - no real specification exists. See GL_NV_vertex_array_range for more - information. - -IP Status - - None - -Issues - - None - -New Procedures and Functions - - unsigned int glXGetAGPOffsetMESA( const void *pointer ) - -New Tokens - - None - -Additions to the OpenGL 1.4 Specification - - None - -Additions to Chapter 3 the GLX 1.4 Specification (Functions and Errors) - - Add a new section, 3.6 as follows: - - 3.6 AGP Memory Access - - On "PC" computers, AGP memory can be allocated with glXAllocateMemoryNV - and freed with glXFreeMemoryNV. Sometimes it's useful to know where a - block of AGP memory is located with respect to the start of the AGP - aperture. The function - - GLuint glXGetAGPOffsetMESA( const GLvoid *pointer ) - - Returns the offset of the given memory block from the start of AGP - memory in basic machine units (i.e. bytes). If pointer is invalid - the value ~0 will be returned. - -GLX Protocol - - None. This is a client side-only extension. - -Errors - - glXGetAGPOffsetMESA will return ~0 if the pointer does not point to - an AGP memory region. - -New State - - None - -Revision History - - 20 September 2002 - Initial draft - 2 October 2002 - finished GLX chapter 3 additions - 27 July 2004 - use unsigned int instead of GLuint, void instead of GLvoid diff --git a/docs/specs/OLD/MESA_agp_offset.spec b/docs/specs/OLD/MESA_agp_offset.spec new file mode 100644 index 00000000000..ac5ad7d7679 --- /dev/null +++ b/docs/specs/OLD/MESA_agp_offset.spec @@ -0,0 +1,94 @@ +Name + + MESA_agp_offset + +Name Strings + + GLX_MESA_agp_offset + +Contact + + Brian Paul, Tungsten Graphics, Inc. (brian.paul 'at' tungstengraphics.com) + Keith Whitwell, Tungsten Graphics, Inc. (keith 'at' tungstengraphics.com) + +Status + + Obsolete. Effectively superseded by ARB_vertex_buffer_object. + +Version + + 1.0 + +Number + + TBD + +Dependencies + + OpenGL 1.0 or later is required + GLX_NV_vertex_array_range is required. + This extensions is written against the OpenGL 1.4 Specification. + +Overview + + This extensions provides a way to convert pointers in an AGP memory + region into byte offsets into the AGP aperture. + Note, this extension depends on GLX_NV_vertex_array_range, for which + no real specification exists. See GL_NV_vertex_array_range for more + information. + +IP Status + + None + +Issues + + None + +New Procedures and Functions + + unsigned int glXGetAGPOffsetMESA( const void *pointer ) + +New Tokens + + None + +Additions to the OpenGL 1.4 Specification + + None + +Additions to Chapter 3 the GLX 1.4 Specification (Functions and Errors) + + Add a new section, 3.6 as follows: + + 3.6 AGP Memory Access + + On "PC" computers, AGP memory can be allocated with glXAllocateMemoryNV + and freed with glXFreeMemoryNV. Sometimes it's useful to know where a + block of AGP memory is located with respect to the start of the AGP + aperture. The function + + GLuint glXGetAGPOffsetMESA( const GLvoid *pointer ) + + Returns the offset of the given memory block from the start of AGP + memory in basic machine units (i.e. bytes). If pointer is invalid + the value ~0 will be returned. + +GLX Protocol + + None. This is a client side-only extension. + +Errors + + glXGetAGPOffsetMESA will return ~0 if the pointer does not point to + an AGP memory region. + +New State + + None + +Revision History + + 20 September 2002 - Initial draft + 2 October 2002 - finished GLX chapter 3 additions + 27 July 2004 - use unsigned int instead of GLuint, void instead of GLvoid -- cgit v1.2.3