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 / glloadmatrix.z / glloadmatrix
Encoding:
Text File  |  2002-10-03  |  5.5 KB  |  142 lines
  1.  
  2.  
  3.  
  4. ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxx((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxx((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxxdddd,,,, ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxxffff - replace the current matrix with the
  10.      specified matrix
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      void ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxxdddd( const GLdouble *_m )
  15.      void ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxxffff( const GLfloat *_m )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _m  Specifies a pointer to 16 consecutive values, which are used as the
  20.         elements of a 4 x 4 column-major matrix.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxx replaces the current matrix with the one whose elements are
  24.      specified by _m.  The current matrix is the projection matrix, modelview
  25.      matrix, or texture matrix, depending on the current matrix mode (see
  26.      ggggllllMMMMaaaattttrrrriiiixxxxMMMMooooddddeeee).
  27.  
  28.      The current matrix, M, defines a transformation of coordinates.  For
  29.      instance, assume M refers to the modelview matrix.  If
  30.      v = (v[0],v[1],v[2],v[3]) is the set of object coordinates of a vertex,
  31.      and _m points to an array of 16 single- or double-precision floating-point
  32.      values m[0],m[1],...,m[15], then the modelview transformation M(v) does
  33.      the following:
  34.  
  35.  
  36.  
  37.                        (     m[0]      m[4]       m[8]        m[12] )      (      v[0] )
  38.  
  39.                        |                              |      |       |
  40.                             m[1]       m[5]        m[9]        m[13]              v[1]
  41.                        |                              |      |       |
  42.                 M(v) =                                  x
  43.                        |     m[2]       m[6]        m[10]        m[14]  |      |      v[2] |
  44.  
  45.                        |                              |      |       |
  46.                         m[3]   m[7]   m[11]   m[15]          v[3]
  47.                        (                             )     (      )
  48.  
  49.  
  50.  
  51.  
  52.      Where ``x'' denotes matrix multiplication.
  53.  
  54.      Projection and texture transformations are similarly defined.
  55.  
  56. NNNNOOOOTTTTEEEESSSS
  57.      While the elements of the matrix may be specified with single or double
  58.      precision, the GL implementation may store or operate on these values in
  59.      less than single precision.
  60.  
  61. EEEERRRRRRRROOOORRRRSSSS
  62.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxx is executed between the
  63.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  64.  
  65. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  66.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAATTTTRRRRIIIIXXXX____MMMMOOOODDDDEEEE
  67.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX
  68.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMOOOODDDDEEEELLLLVVVVIIIIEEEEWWWW____MMMMAAAATTTTRRRRIIIIXXXX
  69.  
  70.  
  71.  
  72.                                                                         PPPPaaaaggggeeee 1111
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79. ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxx((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllLLLLooooaaaaddddMMMMaaaattttrrrriiiixxxx((((3333GGGG))))
  80.  
  81.  
  82.  
  83.      ggggllllGGGGeeeetttt with argument GGGGLLLL____PPPPRRRROOOOJJJJEEEECCCCTTTTIIIIOOOONNNN____MMMMAAAATTTTRRRRIIIIXXXX
  84.      ggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____MMMMAAAATTTTRRRRIIIIXXXX
  85.  
  86.  
  87. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.      ggggllllLLLLooooaaaaddddIIIIddddeeeennnnttttiiiittttyyyy, ggggllllMMMMaaaattttrrrriiiixxxxMMMMooooddddeeee, ggggllllMMMMuuuullllttttMMMMaaaattttrrrriiiixxxx, ggggllllPPPPuuuusssshhhhMMMMaaaattttrrrriiiixxxx
  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.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                                                                         PPPPaaaaggggeeee 2222
  139.  
  140.  
  141.  
  142.