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 / ftn / rotate.z / rotate
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. rrrroooottttaaaatttteeee((((3333GGGG))))                                                          rrrroooottttaaaatttteeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrroooottttaaaatttteeee,,,, rrrrooootttt - rotates the current matrix
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee rrrroooottttaaaatttteeee((((aaaa,,,, aaaaxxxxiiiissss))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 aaaa
  14.      cccchhhhaaaarrrraaaacccctttteeeerrrr aaaaxxxxiiiissss
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee rrrrooootttt((((aaaa,,,, aaaaxxxxiiiissss))))
  17.      rrrreeeeaaaallll aaaa
  18.      cccchhhhaaaarrrraaaacccctttteeeerrrr aaaaxxxxiiiissss
  19.  
  20. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  21.      _a      expects the angle of rotation.
  22.  
  23.      _a_x_i_s   expects the relative axis of rotation.  There are three character
  24.             literal values for this parameter:
  25.  
  26.             ''''xxxx'''' indicates the _x-axis.
  27.  
  28.             ''''yyyy'''' indicates the _y-axis.
  29.  
  30.             ''''zzzz'''' indicates the _z-axis.
  31.  
  32. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.      rrrroooottttaaaatttteeee and rrrrooootttt specify an angle (_a) and an axis of rotation (_a_x_i_s).  The
  34.      angle given to rrrroooottttaaaatttteeee is an integer and is specified in tenths of degrees
  35.      according to the right-hand rule.  The angle given to rrrrooootttt is a floating
  36.      point value and is specified in degrees according to the right-hand rule.
  37.  
  38.      The angle and axis are used to compute a 4x4 rotation matrix, which then
  39.      premultiplies the current matrix, as specified by mmmmmmmmooooddddeeee.  Thus if _T is
  40.      the current matrix, and _R is the rotation matrix computed by rrrroooottttaaaatttteeee or
  41.      rrrrooootttt, _T is replaced with _R*_T.  The current matrix is the top matrix on the
  42.      transformation stack if mmmmmmmmooooddddeeee is MMMMSSSSIIIINNNNGGGGLLLL, the top matrix on the ModelView
  43.      matrix stack if mmmmmmmmooooddddeeee is MMMMVVVVIIIIEEEEWWWWIIII, the Projection matrix if mmmmmmmmooooddddeeee is
  44.      MMMMPPPPRRRROOOOJJJJEEEE, or the Texture matrix if mmmmmmmmooooddddeeee is MMMMTTTTEEEEXXXXTTTTUUUU.
  45.  
  46.      All objects drawn after rrrroooottttaaaatttteeee or rrrrooootttt is called while mmmmmmmmooooddddeeee is either
  47.      MMMMSSSSIIIINNNNGGGGLLLL or MMMMVVVVIIIIEEEEWWWWIIII are rotated.  Use ppppuuuusssshhhhmmmmaaaa and ppppooooppppmmmmaaaatttt to preserve and
  48.      restore the unrotated coordinate system.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      mmode, popmat, pushma, scale, transl
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.