1GLGETSTRING(3G)                                                GLGETSTRING(3G)
2
3
4

NAME

6       - return a string describing the current GL connection
7
8

C SPECIFICATION

10       const GLubyte* glGetString( GLenum name )
11

PARAMETERS

13       name  Specifies  a  symbolic  constant,  one of GL_VENDOR, GL_RENDERER,
14             GL_VERSION, or GL_EXTENSIONS.
15

DESCRIPTION

17       glGetString returns a pointer to a static string describing some aspect
18       of the current GL connection.  name can be one of the following:
19
20       GL_VENDOR           Returns  the company responsible for this GL imple‐
21                           mentation.  This name does not change from  release
22                           to release.
23
24       GL_RENDERER         Returns  the  name  of  the renderer.  This name is
25                           typically specific to a particular configuration of
26                           a  hardware  platform.   It  does  not  change from
27                           release to release.
28
29       GL_VERSION          Returns a version or release number.
30
31       GL_EXTENSIONS       Returns a space-separated list of supported  exten‐
32                           sions to GL.
33
34       Because  the GL does not include queries for the performance character‐
35       istics of an implementation, some applications are written to recognize
36       known  platforms  and  modify their GL usage based on known performance
37       characteristics of these platforms.  Strings GL_VENDOR and  GL_RENDERER
38       together  uniquely  specify a platform. They do not change from release
39       to release and should be used by platform-recognition algorithms.
40
41       Some applications want to make use of features that are not part of the
42       standard  GL.  These  features  may be implemented as extensions to the
43       standard GL.  The GL_EXTENSIONS string is  a  space-separated  list  of
44       supported  GL extensions.  (Extension names never contain a space char‐
45       acter.)
46
47       The GL_VERSION string begins with a version number.  The version number
48       uses one of these forms:
49
50       major_number.minor_number
51       major_number.minor_number.release_number
52
53       Vendor-specific information may follow the version number. Its  depends
54       on the implementation, but a space always separates the version  number
55       and the vendor-specific information.
56
57       All strings are null-terminated.
58

NOTES

60       If an error is generated, glGetString returns 0.
61
62       The  client  and  server  may support different versions or extensions.
63       glGetString always returns a  compatible  version  number  or  list  of
64       extensions.  The release number always describes the server.
65

ERRORS

67       GL_INVALID_ENUM is generated if name is not an accepted value.
68
69       GL_INVALID_OPERATION  is  generated  if glGetString is executed between
70       the execution of glBegin and the corresponding execution of glEnd.
71
72
73
74                                                               GLGETSTRING(3G)