bionic (3) glGetAttribLocation.3G.gz

Provided by: opengl-4-man-doc_1.0~svn33624-1_all bug

NAME
       glGetAttribLocation - Returns the location of an attribute variable


C SPECIFICATION
       GLint glGetAttribLocation(GLuint program, const GLchar *name);


PARAMETERS
       program
           Specifies the program object to be queried.

       name
           Points to a null terminated string containing the name of the attribute variable whose location is to
           be queried.


DESCRIPTION
       glGetAttribLocation queries the previously linked program object specified by program for the attribute
       variable specified by name and returns the index of the generic vertex attribute that is bound to that
       attribute variable. If name is a matrix attribute variable, the index of the first column of the matrix
       is returned. If the named attribute variable is not an active attribute in the specified program object
       or if name starts with the reserved prefix "gl_", a value of -1 is returned.

       The association between an attribute variable name and a generic attribute index can be specified at any
       time by calling glBindAttribLocation(). Attribute bindings do not go into effect until glLinkProgram() is
       called. After a program object has been linked successfully, the index values for attribute variables
       remain fixed until the next link command occurs. The attribute values can only be queried after a link if
       the link was successful.  glGetAttribLocation returns the binding that actually went into effect the last
       time glLinkProgram() was called for the specified program object. Attribute bindings that have been
       specified since the last link operation are not returned by glGetAttribLocation.


ERRORS
       GL_INVALID_OPERATION is generated if program is not a value generated by OpenGL.

       GL_INVALID_OPERATION is generated if program is not a program object.

       GL_INVALID_OPERATION is generated if program has not been successfully linked.


ASSOCIATED GETS
       glGetActiveAttrib() with argument program and the index of an active attribute

       glIsProgram()


VERSION SUPPORT
       ┌────────────────────┬───────────────────────────────────────────────────────────────────────┐
       │                    │                OpenGL Version                                         │
       ├────────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
       │Function            │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
       │/                   │     │     │     │     │     │     │     │     │     │     │     │     │
       │Feature             │     │     │     │     │     │     │     │     │     │     │     │     │
       │Name                │     │     │     │     │     │     │     │     │     │     │     │     │
       ├────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │glGetAttribLocation │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
       └────────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘


SEE ALSO
       glBindAttribLocation(), glLinkProgram(), glVertexAttrib(), glVertexAttribPointer()


       Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010-2014 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/.


       Copyright © 2003-2005 3Dlabs Inc. Ltd.
       Copyright © 2010-2014 Khronos Group

[FIXME: source]                                    01/03/2018                            GLGETATTRIBLOCATION(3G)