Tao.OpenGl SDK Documentation

Glu.gluPickMatrix Method 

Defines a picking region.

[Visual Basic]
Public Shared Sub gluPickMatrix( _
   ByVal x As Double, _
   ByVal y As Double, _
   ByVal width As Double, _
   ByVal height As Double, _
   ByVal viewport As Integer() _
)
[C#]
public static void gluPickMatrix(
   double x,
   double y,
   double width,
   double height,
   int[] viewport
);

Parameters

x
The center of a picking region in x axis window coordinates.
y
The center of a picking region in y axis window coordinates.
width
The width of the picking region in window coordinates.
height
The height of the picking region in window coordinates.
viewport
The current viewport (as from a glGetIntegerv call).

Remarks

gluPickMatrix creates a projection matrix that can be used to restrict drawing to a small region of the viewport. This is typically useful to determine what objects are being drawn near the cursor. Use gluPickMatrix to restrict drawing to a small region around the cursor. Then, enter selection mode (with glRenderMode) and rerender the scene. All primitives that would have been drawn near the cursor are identified and stored in the selection buffer.

The matrix created by gluPickMatrix is multiplied by the current matrix just as if Gl.glMultMatrix* is called with the generated matrix. To effectively use the generated pick matrix for picking, first call glLoadIdentity to load an identity matrix onto the perspective matrix stack. Then call gluPickMatrix, and finally, call a command (such as gluPerspective) to multiply the perspective matrix by the pick matrix.

When using gluPickMatrix to pick NURBS, be careful to turn off the NURBS property GLU_AUTO_LOAD_MATRIX. If GLU_AUTO_LOAD_MATRIX is not turned off, then any NURBS surface rendered is subdivided differently with the pick matrix than the way it was subdivided without the pick matrix.

EXAMPLE

When rendering a scene as follows:

            Gl.glMatrixMode(Gl.GL_PROJECTION);
            Gl.glLoadIdentity();
            Glu.gluPerspective(. . .);
            Gl.glMatrixMode(Gl.GL_MODELVIEW);
            // Draw the scene
            

The following code selects a portion of the viewport:

            Gl.glMatrixMode(Gl.GL_PROJECTION);
            Gl.glLoadIdentity();
            Glu.gluPickMatrix(x, y, width, height, viewport);
            Glu.gluPerspective(. . .);
            Gl.glMatrixMode(Gl.GL_MODELVIEW);
            // Draw the scene
            

See Also

Glu Class | Tao.OpenGl Namespace | glLoadIdentity | glRenderMode | gluPerspective