GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GLUPICKMATRIX (3)

NAME

gluPickMatrix - define a picking region

CONTENTS

C Specification
Parameters
Description
Example
See Also

C SPECIFICATION

void gluPickMatrix( GLdouble x,

                  GLdouble y,
                  GLdouble delX,
                  GLdouble delY,
                  GLint *viewport )

PARAMETERS

x, y Specify the center of a picking region in window coordinates.
delX, delY Specify the width and height, respectively, of the picking region in window coordinates.
viewport Specifies the current viewport (as from a glGetIntegerv call).

DESCRIPTION

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 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:


.Ex glMatrixMode(GL_PROJECTION); glLoadIdentity(); gluPerspective(...); glMatrixMode(GL_MODELVIEW); /* Draw the scene */
.Ee

a portion of the viewport can be selected as a pick region like this:


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

SEE ALSO

glGet, glLoadIndentity, glMultMatrix, glRenderMode, gluPerspective

Search for    or go to Top of page |  Section 3 |  Main Index


GLUPICKMATRIX (-->)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.