GLGETSTRING(3G)

    .SH "NAME" glGetString - return a string describing the current GL connection
    .SH "C SPECIFICATION"

            .HP u const GLubyte *glGetString(GLenum name);

            .HP u const GLubyte *glGetStringi(GLenum name, GLuint index);

    .SH "PARAMETERS"

        .PP name

                    Specifies a symbolic constant, one of GL_VENDOR, GL_RENDERER, GL_VERSION, or GL_SHADING_LANGUAGE_VERSION. Additionally, glGetStringi accepts the GL_EXTENSIONS token.

            .RE
            .PP index

                        For glGetStringi, specifies the index of the string to return.

                .RE

            .SH "DESCRIPTION"
                .PP glGetString returns a pointer to a static string describing some aspect of the current GL connection. name can be one of the following:

                    .PP GL_VENDOR

                                Returns the company responsible for this GL implementation. This name does not change from release to release.

                        .RE
                        .PP GL_RENDERER

                                    Returns the name of the renderer. This name is typically specific to a particular configuration of a hardware platform. It does not change from release to release.

                            .RE
                            .PP GL_VERSION

                                        Returns a version or release number.

                                .RE
                                .PP GL_SHADING_LANGUAGE_VERSION

                                            Returns a version or release number for the shading language.

                                    .RE

                                .PP glGetStringi returns a pointer to a static string indexed by index. name can be one of the following:

                                    .PP GL_EXTENSIONS

                                                For glGetStringi only, returns the extension string supported by the implementation at index.

                                        .RE

                                    .PP Strings GL_VENDOR and GL_RENDERER together uniquely specify a platform. They do not change from release to release and should be used by platform-recognition algorithms.
                                    .PP The GL_VERSION and GL_SHADING_LANGUAGE_VERSION strings begin with a version number. The version number uses one of these forms:
                                    .PP major_number.minor_number major_number.minor_number.release_number
                                    .PP Vendor-specific information may follow the version number. Its format depends on the implementation, but a space always separates the version number and the vendor-specific information.
                                    .PP All strings are null-terminated.

                                .SH "NOTES"
                                    .PP If an error is generated, glGetString returns 0.
                                    .PP The client and server may support different versions. glGetString always returns a compatible version number. The release number always describes the server.

                                .SH "ERRORS"
                                    .PP GL_INVALID_ENUM is generated if name is not an accepted value.
                                    .PP GL_INVALID_VALUE is generated by glGetStringi if index is outside the valid range for indexed state name.

                                .SH "VERSION SUPPORT"
                                    .TS allbox tab(:); lB cB s s s s s s s s s s s lB cB cB cB cB cB cB cB cB cB cB cB cB. T{ T}:T{ OpenGL Version T} T{ Function / Feature Name T}:T{ 2.0 T}:T{ 2.1 T}:T{ 3.0 T}:T{ 3.1 T}:T{ 3.2 T}:T{ 3.3 T}:T{ 4.0 T}:T{ 4.1 T}:T{ 4.2 T}:T{ 4.3 T}:T{ 4.4 T}:T{ 4.5 T} l c c c c c c c c c c c c l c c c c c c c c c c c c. T{ glGetString T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T} T{ glGetStringi T}:T{ - T}:T{ - T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}:T{ ✔ T}

                                .SH "SEE ALSO"

                                .SH "COPYRIGHT"
                                    .PP Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2014 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see https://khronos.org/registry/OpenGL-Refpages/LICENSES/LicenseRef-FreeB.txt.

COPYRIGHT
Copyright © 1991-2006 Silicon Graphics, Inc.
Copyright © 2010-2014 Khronos Group