glGetString.3gl




Name

  glGetString -	returns	a string describing the	current	GL connection


C Specification

  const	GLubyte	* glGetString( GLenum name )


Parameters


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

Description

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

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

  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.

  GL_VERSION	      Returns a	version	or release number.

  GL_EXTENSIONS	      Returns a	space-separated	list of	supported extensions
		      to GL.

  Because GL does not include queries for the performance characteristics of
  an implementation, it	is expected that some applications will	be written to
  recognize known platforms and	will modify their GL usage based on known
  performance characteristics of these platforms.  Strings GL_VENDOR and
  GL_RENDERER together uniquely	specify	a platform, and	will not change	from
  release to release.  They should be used by such platform recognition
  algorithms.

  Some applications will want to make use of features which are	not part of
  the standard GL.  These features may be implemented as extensions to the
  standard GL.	The GL_EXTENSIONS string is a space seperated list of
  supported GL extensions. (Extension names never contain a space character.)

  The GL_VERSION string	begins with a version number.  The version number is
  of the form major_number.minor_number	or
  major_number.minor_number.release_number. Vendor specific information	may
  follow the version number. Its format	depends	on the implementation, but a
  space	always seperates the version number and	the vendor specific
  information.

  All strings are null-terminated.

Notes

  If an	error is generated, glGetString	returns	zero.

  The client and server	may support different versions or extensions.
  glGetString always returns a compatible version number or list of
  extensions. The release number always	describes the server.

Errors

  GL_INVALID_ENUM is generated if name is not an accepted value.

  GL_INVALID_OPERATION is generated if glGetString is executed between the
  execution of glBegin and the corresponding execution of glEnd.




Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV