home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glrect.z / glrect
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllRRRReeeecccctttt((((3333GGGG))))                     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                     ggggllllRRRReeeecccctttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllRRRReeeeccccttttdddd,,,, ggggllllRRRReeeeccccttttffff,,,, ggggllllRRRReeeeccccttttiiii,,,, ggggllllRRRReeeeccccttttssss,,,, ggggllllRRRReeeeccccttttddddvvvv,,,, ggggllllRRRReeeeccccttttffffvvvv,,,, ggggllllRRRReeeeccccttttiiiivvvv,,,,
  10.      ggggllllRRRReeeeccccttttssssvvvv - draw a rectangle
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      void ggggllllRRRReeeeccccttttdddd( GLdouble _x_1,
  15.                    GLdouble _y_1,
  16.                    GLdouble _x_2,
  17.                    GLdouble _y_2 )
  18.      void ggggllllRRRReeeeccccttttffff( GLfloat _x_1,
  19.                    GLfloat _y_1,
  20.                    GLfloat _x_2,
  21.                    GLfloat _y_2 )
  22.      void ggggllllRRRReeeeccccttttiiii( GLint _x_1,
  23.                    GLint _y_1,
  24.                    GLint _x_2,
  25.                    GLint _y_2 )
  26.      void ggggllllRRRReeeeccccttttssss( GLshort _x_1,
  27.                    GLshort _y_1,
  28.                    GLshort _x_2,
  29.                    GLshort _y_2 )
  30.  
  31.  
  32. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  33.      _x_1, _y_1 Specify one vertex of a rectangle.
  34.  
  35.      _x_2, _y_2 Specify the opposite vertex of the rectangle.
  36.  
  37. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  38.      void ggggllllRRRReeeeccccttttddddvvvv( const GLdouble *_v_1,
  39.                     const GLdouble *_v_2 )
  40.      void ggggllllRRRReeeeccccttttffffvvvv( const GLfloat *_v_1,
  41.                     const GLfloat *_v_2 )
  42.      void ggggllllRRRReeeeccccttttiiiivvvv( const GLint *_v_1,
  43.                     const GLint *_v_2 )
  44.      void ggggllllRRRReeeeccccttttssssvvvv( const GLshort *_v_1,
  45.                     const GLshort *_v_2 )
  46.  
  47.  
  48. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  49.      _v_1   Specifies a pointer to one vertex of a rectangle.
  50.  
  51.      _v_2   Specifies a pointer to the opposite vertex of the rectangle.
  52.  
  53. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  54.      ggggllllRRRReeeecccctttt supports efficient specification of rectangles as two corner
  55.      points.  Each rectangle command takes four arguments, organized either as
  56.      two consecutive pairs of (_x,_y) coordinates, or as two pointers to arrays,
  57.      each containing an (_x,_y) pair.  The resulting rectangle is defined in the
  58.      _z = 0 plane.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllRRRReeeecccctttt((((3333GGGG))))                     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                     ggggllllRRRReeeecccctttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      ggggllllRRRReeeecccctttt(_x_1, _y_1, _x_2, _y_2) is exactly equivalent to the following sequence:
  75.  
  76.           glBegin(GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN);
  77.           glVertex2(_x_1, _y_1);
  78.           glVertex2(_x_2, _y_1);
  79.           glVertex2(_x_2, _y_2);
  80.           glVertex2(_x_1, _y_2);
  81.           glEnd();
  82.  
  83.      Note that if the second vertex is above and to the right of the first
  84.      vertex, the rectangle is constructed with a counterclockwise winding.
  85.  
  86. EEEERRRRRRRROOOORRRRSSSS
  87.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllRRRReeeecccctttt is executed between the
  88.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  89.  
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      ggggllllBBBBeeeeggggiiiinnnn, ggggllllVVVVeeeerrrrtttteeeexxxx
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.