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 / standard / rectf.z / rectf
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrreeeeccccttttffff((((3333GGGG))))                                                            rrrreeeeccccttttffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrreeeeccccttttffff,,,, rrrreeeeccccttttffffiiii,,,, rrrreeeeccccttttffffssss - fills a rectangular area
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd rrrreeeeccccttttffff((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  13.      CCCCoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  14.  
  15.      vvvvooooiiiidddd rrrreeeeccccttttffffiiii((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  16.      IIIIccccoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  17.  
  18.      vvvvooooiiiidddd rrrreeeeccccttttffffssss((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  19.      SSSSccccoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  20.  
  21.      All of the above routines are functionally the same.  They differ only in
  22.      the type declarations of their parameters.
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _x_1   expects the x coordinate of one corner of the rectangle that is to
  26.           be drawn.
  27.  
  28.      _y_1   expects the y coordinate of one corner of the rectangle that is to
  29.           be drawn.
  30.  
  31.      _x_2   expects the x coordinate of the opposite corner of the rectangle
  32.           that is to be drawn.
  33.  
  34.      _y_2   expects the y coordinate of the opposite corner of the rectangle
  35.           that is to be drawn.
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      rrrreeeecccctttt draws a filled rectangle in the _x-_y plane with _z assumed to be zero.
  39.      The sides of the rectangle are parallel to the _x and _y axes.  To create a
  40.      rectangle that does not lie in the _x-_y plane, draw the rectangle in the
  41.      _x-_y plane, then rotate and/or translate the rectangle.
  42.  
  43.      A rectangle is drawn as a single polygon, and therefore inherits all
  44.      properties that affect the drawing of polygons.  These include the
  45.      current color, writemask, fill pattern, shade model, polygon antialiasing
  46.      mode, polygon scan conversion mode, and subpixel mode.  Front-face and
  47.      back-face elimination work correctly with filled rectangles.  The front-
  48.      face of a rectangle faces the positive z half-space when (_x_1, _y_1) is the
  49.      lower-left corner of the rectangle in object coordinates.  Some polygon
  50.      modes are applicable only if old-style scan conversion is defeated.  (See
  51.      note below.)
  52.  
  53.      After rrrreeeeccccttttffff executes, the graphics position is undefined.
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      backface, bgnpolygon, glcompat, frontface, polymode, polysmooth, rect,
  57.      scrsubdivide, setpattern, shademodel, subpixel
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrreeeeccccttttffff((((3333GGGG))))                                                            rrrreeeeccccttttffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEESSSS
  75.      Previous graphics library implementations set the current graphics
  76.      position to (_x_1, _y_1) after the rectangle was drawn.  Current graphics
  77.      position is now undefined after a rectangle is drawn.
  78.  
  79.      By default rrrreeeeccccttttffff draws a polygon using the old-style scan conversion
  80.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollllyyyyggggoooonnnn
  81.      and eeeennnnddddppppoooollllyyyyggggoooonnnn.  Point sampling is prefered over old-style scan
  82.      conversion because it has higher performance, it results in higher-
  83.      quality images when blending, logical operations, or stenciling are used,
  84.      and it supports new rendering features such as texture mapping, fog, and
  85.      antialiasing.  Call ggggllllccccoooommmmppppaaaatttt((((GGGGLLLLCCCC____OOOOLLLLDDDDPPPPOOOOLLLLYYYYGGGGOOOONNNN,,,,0000)))) to enable point sampling
  86.      of polygons generated by rrrreeeeccccttttffff.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  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.