GLAPI/glGetVertexAttribPointer: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
m Bot: Adjusting API page category.
m Bot: Adding better formatting.
 
(5 intermediate revisions by the same user not shown)
Line 8: Line 8:
== Function Definition ==
== Function Definition ==


   void '''glGetVertexAttribPointerv'''(GLuint ''index'', GLenum ''pname'', GLvoid **''pointer'');
   void '''glGetVertexAttribPointerv'''(GLuint {{param|index}}, GLenum {{param|pname}}, GLvoid **{{param|pointer}});


; index
; index
: Specifies the generic vertex attribute parameter to be returned.
: Specifies the generic vertex attribute parameter to be returned.
; pname
; pname
: Specifies the symbolic name of the generic vertex attribute parameter to be returned. Must be {{code|GL_VERTEX_ATTRIB_ARRAY_POINTER}}.
: Specifies the symbolic name of the generic vertex attribute parameter to be returned. Must be {{enum|GL_VERTEX_ATTRIB_ARRAY_POINTER}}.
; pointer
; pointer
: Returns the pointer value.
: Returns the pointer value.
Line 19: Line 19:
== Description ==
== Description ==


'''glGetVertexAttribPointerv''' returns pointer information. ''index'' is the generic vertex attribute to be queried, ''pname'' is a symbolic constant indicating the pointer to be returned, and ''params'' is a pointer to a location in which to place the returned data.
'''glGetVertexAttribPointerv''' returns pointer information. {{param|index}} is the generic vertex attribute to be queried, {{param|pname}} is a symbolic constant indicating the pointer to be returned, and {{param|params}} is a pointer to a location in which to place the returned data.


The ''pointer'' returned is a byte offset into the data store of the buffer object that was bound to the {{code|GL_ARRAY_BUFFER}} target (see [[GLAPI/glBindBuffer|glBindBuffer]]) when the desired pointer was previously specified.
The {{param|pointer}} returned is a byte offset into the data store of the buffer object that was bound to the {{enum|GL_ARRAY_BUFFER}} target (see {{apifunc|glBindBuffer}}) when the desired pointer was previously specified.


== Notes ==
== Notes ==
Line 31: Line 31:
== Errors ==
== Errors ==


{{code|GL_INVALID_OPERATION}} is generated if no vertex array object is currently bound.
{{enum|GL_INVALID_OPERATION}} is generated if no vertex array object is currently bound.


{{code|GL_INVALID_VALUE}} is generated if ''index'' is greater than or equal to {{code|GL_MAX_VERTEX_ATTRIBS}}.
{{enum|GL_INVALID_VALUE}} is generated if {{param|index}} is greater than or equal to {{enum|GL_MAX_VERTEX_ATTRIBS}}.


{{code|GL_INVALID_ENUM}} is generated if ''pname'' is not an accepted value.
{{enum|GL_INVALID_ENUM}} is generated if {{param|pname}} is not an accepted value.


== Associated Gets ==
== Associated Gets ==


[[GLAPI/glGet|glGet]] with argument {{code|GL_MAX_VERTEX_ATTRIBS}}
{{apifunc|glGet}} with argument {{enum|GL_MAX_VERTEX_ATTRIBS}}


== See Also ==
== See Also ==


[[GLAPI/glGetVertexAttrib|glGetVertexAttrib]], [[GLAPI/glVertexAttribPointer|glVertexAttribPointer]]
{{apifunc|glBindVertexArray}}, {{apifunc|glVertexAttribPointer}}


== Copyright ==
== Copyright ==
Line 49: Line 49:
Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. [http://opencontent.org/openpub/ http://opencontent.org/openpub/].
Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. [http://opencontent.org/openpub/ http://opencontent.org/openpub/].


[[Category:API Reference 4|GetVertexAttribPointerv]]
[[Category:Core API Ref Vertex Arrays|GetVertexAttribPointer]]
[[Category:GL 4 API Vertex Arrays|GetVertexAttribPointer]]
[[Category:Core API Reference|GetVertexAttribPointer]]
[[Category:Vertex Array Object API State Functions|GetVertexAttribPointer]]

Latest revision as of 10:02, 15 August 2013

glGetVertexAttribPointerv
Core in version 4.6
Core since version 2.0

glGetVertexAttribPointerv: return the address of the specified generic vertex attribute pointer

Function Definition

 void glGetVertexAttribPointerv(GLuint index​, GLenum pname​, GLvoid **pointer​);
index
Specifies the generic vertex attribute parameter to be returned.
pname
Specifies the symbolic name of the generic vertex attribute parameter to be returned. Must be GL_VERTEX_ATTRIB_ARRAY_POINTER.
pointer
Returns the pointer value.

Description

glGetVertexAttribPointerv returns pointer information. index​ is the generic vertex attribute to be queried, pname​ is a symbolic constant indicating the pointer to be returned, and params​ is a pointer to a location in which to place the returned data.

The pointer​ returned is a byte offset into the data store of the buffer object that was bound to the GL_ARRAY_BUFFER target (see glBindBuffer) when the desired pointer was previously specified.

Notes

The state returned is retrieved from the currently bound vertex array object.

The initial value for each pointer is 0.

Errors

GL_INVALID_OPERATION is generated if no vertex array object is currently bound.

GL_INVALID_VALUE is generated if index​ is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

GL_INVALID_ENUM is generated if pname​ is not an accepted value.

Associated Gets

glGet with argument GL_MAX_VERTEX_ATTRIBS

See Also

glBindVertexArray, glVertexAttribPointer

Copyright

Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.