glMapGrid.3gl

Name

  glMapGrid1d, glMapGrid1f, glMapGrid2d, glMapGrid2f - define a	one- or	two-

  dimensional mesh

C Specification

  void glMapGrid1d( GLint un,

		    GLdouble u1,

		    GLdouble u2	)

  void glMapGrid1f( GLint un,

		    GLfloat u1,

		    GLfloat u2 )

  void glMapGrid2d( GLint un,

		    GLdouble u1,

		    GLdouble u2,

		    GLint vn,

		    GLdouble v1,

		    GLdouble v2	)

  void glMapGrid2f( GLint un,

		    GLfloat u1,

		    GLfloat u2,

		    GLint vn,

		    GLfloat v1,

		    GLfloat v2 )

Parameters

  un  Specifies	the number of partitions in the	grid range interval [u1, u2].

      Must be positive.



  u1, u2

      Specify the mappings for integer grid domain values i=0 and i=un.



  vn  Specifies	the number of partitions in the	grid range interval [v1, v2]

      (glMapGrid2 only).



  v1, v2

      Specify the mappings for integer grid domain values j=0 and j=vn

      (glMapGrid2 only).

Description

  glMapGrid and	glEvalMesh are used in tandem to efficiently generate and

  evaluate a series of evenly spaced map domain	values.	 glEvalMesh steps

  through the integer domain of	a one- or two-dimensional grid,	whose range

  is the domain	of the evaluation maps specified by glMap1 and glMap2.



  glMapGrid1 and glMapGrid2 specify the	linear grid mappings between the i

  (or i	and j) integer grid coordinates, to the	u (or u	and v) floating-point

  evaluation map coordinates.  See glMap1 and glMap2 for details of how	u and

  v coordinates	are evaluated.



  glMapGrid1 specifies a single	linear mapping such that integer grid

  coordinate 0 maps exactly to u1, and integer grid coordinate un maps

  exactly to u2.  All other integer grid coordinates i are mapped such that



			     u = i(u2-u1)/un + u1



  glMapGrid2 specifies two such	linear mappings.  One maps integer grid

  coordinate i=0 exactly to u1,	and integer grid coordinate i=un exactly to

  u2.  The other maps integer grid coordinate j=0 exactly to v1, and integer

  grid coordinate j=vn exactly to v2.  Other integer grid coordinates i	and j

  are mapped such that



			     u = i(u2-u1)/un + u1



			     v = j(v2-v1)/vn + v1



  The mappings specified by glMapGrid are used identically by glEvalMesh and

  glEvalPoint.

Errors

  GL_INVALID_VALUE is generated	if either un or	vn is not positive.



  GL_INVALID_OPERATION is generated if glMapGrid is called between a call to

  glBegin and the corresponding	call to	glEnd.

Associated Gets

  glGet	with argument GL_MAP1_GRID_DOMAIN

  glGet	with argument GL_MAP2_GRID_DOMAIN

  glGet	with argument GL_MAP1_GRID_SEGMENTS

  glGet	with argument GL_MAP2_GRID_SEGMENTS

See Also

  glEvalCoord, glEvalMesh, glEvalPoint,	glMap1,	glMap2

Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV