upstream-man-pages/man2/xhtml/glMultMatrix.xml

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
   2 <!-- saved from url=(0013)about:internet -->
   3 <?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>glMultMatrix</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glMultMatrix"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glMultMatrix — multiply the current matrix with the specified matrix</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glMultMatrixd</b>(</code></td><td>const GLdouble *  </td><td><var class="pdparam">m</var><code>)</code>;</td></tr></table></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glMultMatrixf</b>(</code></td><td>const GLfloat *  </td><td><var class="pdparam">m</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>m</code></em></span></dt><dd><p>
   4                     Points to 16 consecutive values that are used as the elements of
   5                     a
   6                     <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
   7
   8                         <mml:mrow>
   9                             <mml:mn>4</mml:mn>
  10                             <mml:mo>×</mml:mo>
  11                             <mml:mn>4</mml:mn>
  12                         </mml:mrow>
  13                     </mml:math>
  14                     column-major matrix.
  15                 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
  16             <code class="function">glMultMatrix</code> multiplies the current matrix with the one specified using <em class="parameter"><code>m</code></em>, and
  17             replaces the current matrix with the product.
  18         </p><p>
  19             The current matrix is determined by the current matrix mode (see <a class="citerefentry" href="glMatrixMode.xml"><span class="citerefentry"><span class="refentrytitle">glMatrixMode</span></span></a>). It is either the projection matrix,
  20             modelview matrix,
  21             or the texture matrix.
  22         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="examples"></a><h2>Examples</h2><p>
  23             If the current matrix is
  24             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">C</mml:mi></mml:math>
  25             and the coordinates
  26             to be transformed are
  27             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
  28
  29                 <mml:mrow>
  30                     <mml:mi mathvariant="italic">v</mml:mi>
  31                     <mml:mo>=</mml:mo>
  32                     <mml:mfenced open="(" close=")">
  33                         <mml:mrow>
  34                             <mml:mi mathvariant="italic">v</mml:mi>
  35                             <mml:mo>⁡</mml:mo>
  36                             <mml:mfenced open="[" close="]">
  37                                 <mml:mn>0</mml:mn>
  38                             </mml:mfenced>
  39                         </mml:mrow>
  40                         <mml:mrow>
  41                             <mml:mi mathvariant="italic">v</mml:mi>
  42                             <mml:mo>⁡</mml:mo>
  43                             <mml:mfenced open="[" close="]">
  44                                 <mml:mn>1</mml:mn>
  45                             </mml:mfenced>
  46                         </mml:mrow>
  47                         <mml:mrow>
  48                             <mml:mi mathvariant="italic">v</mml:mi>
  49                             <mml:mo>⁡</mml:mo>
  50                             <mml:mfenced open="[" close="]">
  51                                 <mml:mn>2</mml:mn>
  52                             </mml:mfenced>
  53                         </mml:mrow>
  54                         <mml:mrow>
  55                             <mml:mi mathvariant="italic">v</mml:mi>
  56                             <mml:mo>⁡</mml:mo>
  57                             <mml:mfenced open="[" close="]">
  58                                 <mml:mn>3</mml:mn>
  59                             </mml:mfenced>
  60                         </mml:mrow>
  61                     </mml:mfenced>
  62                 </mml:mrow>
  63             </mml:math>,
  64             then the current transformation is
  65             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
  66
  67                 <mml:mrow>
  68                     <mml:mi mathvariant="italic">C</mml:mi>
  69                     <mml:mo>×</mml:mo>
  70                     <mml:mi mathvariant="italic">v</mml:mi>
  71                 </mml:mrow>
  72             </mml:math>,
  73             or
  74         </p><p>
  75             </p><div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
  76
  77                 <mml:mrow>
  78                     <mml:mfenced open="(" close=")">
  79                         <mml:mtable>
  80                             <mml:mtr>
  81                                 <mml:mtd>
  82                                     <mml:mrow>
  83                                         <mml:mi mathvariant="italic">c</mml:mi>
  84                                         <mml:mo>⁡</mml:mo>
  85                                         <mml:mfenced open="[" close="]">
  86                                             <mml:mn>0</mml:mn>
  87                                         </mml:mfenced>
  88                                     </mml:mrow>
  89                                 </mml:mtd>
  90                                 <mml:mtd>
  91                                     <mml:mrow>
  92                                         <mml:mi mathvariant="italic">c</mml:mi>
  93                                         <mml:mo>⁡</mml:mo>
  94                                         <mml:mfenced open="[" close="]">
  95                                             <mml:mn>4</mml:mn>
  96                                         </mml:mfenced>
  97                                     </mml:mrow>
  98                                 </mml:mtd>
  99                                 <mml:mtd>
 100                                     <mml:mrow>
 101                                         <mml:mi mathvariant="italic">c</mml:mi>
 102                                         <mml:mo>⁡</mml:mo>
 103                                         <mml:mfenced open="[" close="]">
 104                                             <mml:mn>8</mml:mn>
 105                                         </mml:mfenced>
 106                                     </mml:mrow>
 107                                 </mml:mtd>
 108                                 <mml:mtd>
 109                                     <mml:mrow>
 110                                         <mml:mi mathvariant="italic">c</mml:mi>
 111                                         <mml:mo>⁡</mml:mo>
 112                                         <mml:mfenced open="[" close="]">
 113                                             <mml:mn>12</mml:mn>
 114                                         </mml:mfenced>
 115                                     </mml:mrow>
 116                                 </mml:mtd>
 117                             </mml:mtr>
 118                             <mml:mtr>
 119                                 <mml:mtd>
 120                                     <mml:mrow>
 121                                         <mml:mi mathvariant="italic">c</mml:mi>
 122                                         <mml:mo>⁡</mml:mo>
 123                                         <mml:mfenced open="[" close="]">
 124                                             <mml:mn>1</mml:mn>
 125                                         </mml:mfenced>
 126                                     </mml:mrow>
 127                                 </mml:mtd>
 128                                 <mml:mtd>
 129                                     <mml:mrow>
 130                                         <mml:mi mathvariant="italic">c</mml:mi>
 131                                         <mml:mo>⁡</mml:mo>
 132                                         <mml:mfenced open="[" close="]">
 133                                             <mml:mn>5</mml:mn>
 134                                         </mml:mfenced>
 135                                     </mml:mrow>
 136                                 </mml:mtd>
 137                                 <mml:mtd>
 138                                     <mml:mrow>
 139                                         <mml:mi mathvariant="italic">c</mml:mi>
 140                                         <mml:mo>⁡</mml:mo>
 141                                         <mml:mfenced open="[" close="]">
 142                                             <mml:mn>9</mml:mn>
 143                                         </mml:mfenced>
 144                                     </mml:mrow>
 145                                 </mml:mtd>
 146                                 <mml:mtd>
 147                                     <mml:mrow>
 148                                         <mml:mi mathvariant="italic">c</mml:mi>
 149                                         <mml:mo>⁡</mml:mo>
 150                                         <mml:mfenced open="[" close="]">
 151                                             <mml:mn>13</mml:mn>
 152                                         </mml:mfenced>
 153                                     </mml:mrow>
 154                                 </mml:mtd>
 155                             </mml:mtr>
 156                             <mml:mtr>
 157                                 <mml:mtd>
 158                                     <mml:mrow>
 159                                         <mml:mi mathvariant="italic">c</mml:mi>
 160                                         <mml:mo>⁡</mml:mo>
 161                                         <mml:mfenced open="[" close="]">
 162                                             <mml:mn>2</mml:mn>
 163                                         </mml:mfenced>
 164                                     </mml:mrow>
 165                                 </mml:mtd>
 166                                 <mml:mtd>
 167                                     <mml:mrow>
 168                                         <mml:mi mathvariant="italic">c</mml:mi>
 169                                         <mml:mo>⁡</mml:mo>
 170                                         <mml:mfenced open="[" close="]">
 171                                             <mml:mn>6</mml:mn>
 172                                         </mml:mfenced>
 173                                     </mml:mrow>
 174                                 </mml:mtd>
 175                                 <mml:mtd>
 176                                     <mml:mrow>
 177                                         <mml:mi mathvariant="italic">c</mml:mi>
 178                                         <mml:mo>⁡</mml:mo>
 179                                         <mml:mfenced open="[" close="]">
 180                                             <mml:mn>10</mml:mn>
 181                                         </mml:mfenced>
 182                                     </mml:mrow>
 183                                 </mml:mtd>
 184                                 <mml:mtd>
 185                                     <mml:mrow>
 186                                         <mml:mi mathvariant="italic">c</mml:mi>
 187                                         <mml:mo>⁡</mml:mo>
 188                                         <mml:mfenced open="[" close="]">
 189                                             <mml:mn>14</mml:mn>
 190                                         </mml:mfenced>
 191                                     </mml:mrow>
 192                                 </mml:mtd>
 193                             </mml:mtr>
 194                             <mml:mtr>
 195                                 <mml:mtd>
 196                                     <mml:mrow>
 197                                         <mml:mi mathvariant="italic">c</mml:mi>
 198                                         <mml:mo>⁡</mml:mo>
 199                                         <mml:mfenced open="[" close="]">
 200                                             <mml:mn>3</mml:mn>
 201                                         </mml:mfenced>
 202                                     </mml:mrow>
 203                                 </mml:mtd>
 204                                 <mml:mtd>
 205                                     <mml:mrow>
 206                                         <mml:mi mathvariant="italic">c</mml:mi>
 207                                         <mml:mo>⁡</mml:mo>
 208                                         <mml:mfenced open="[" close="]">
 209                                             <mml:mn>7</mml:mn>
 210                                         </mml:mfenced>
 211                                     </mml:mrow>
 212                                 </mml:mtd>
 213                                 <mml:mtd>
 214                                     <mml:mrow>
 215                                         <mml:mi mathvariant="italic">c</mml:mi>
 216                                         <mml:mo>⁡</mml:mo>
 217                                         <mml:mfenced open="[" close="]">
 218                                             <mml:mn>11</mml:mn>
 219                                         </mml:mfenced>
 220                                     </mml:mrow>
 221                                 </mml:mtd>
 222                                 <mml:mtd>
 223                                     <mml:mrow>
 224                                         <mml:mi mathvariant="italic">c</mml:mi>
 225                                         <mml:mo>⁡</mml:mo>
 226                                         <mml:mfenced open="[" close="]">
 227                                             <mml:mn>15</mml:mn>
 228                                         </mml:mfenced>
 229                                     </mml:mrow>
 230                                 </mml:mtd>
 231                             </mml:mtr>
 232                         </mml:mtable>
 233                     </mml:mfenced>
 234                     <mml:mo>×</mml:mo>
 235                     <mml:mfenced open="(" close=")">
 236                         <mml:mtable>
 237                             <mml:mtr>
 238                                 <mml:mtd>
 239                                     <mml:mrow>
 240                                         <mml:mi mathvariant="italic">v</mml:mi>
 241                                         <mml:mo>⁡</mml:mo>
 242                                         <mml:mfenced open="[" close="]">
 243                                             <mml:mn>0</mml:mn>
 244                                         </mml:mfenced>
 245                                     </mml:mrow>
 246                                 </mml:mtd>
 247                             </mml:mtr>
 248                             <mml:mtr>
 249                                 <mml:mtd>
 250                                     <mml:mrow>
 251                                         <mml:mi mathvariant="italic">v</mml:mi>
 252                                         <mml:mo>⁡</mml:mo>
 253                                         <mml:mfenced open="[" close="]">
 254                                             <mml:mn>1</mml:mn>
 255                                         </mml:mfenced>
 256                                     </mml:mrow>
 257                                 </mml:mtd>
 258                             </mml:mtr>
 259                             <mml:mtr>
 260                                 <mml:mtd>
 261                                     <mml:mrow>
 262                                         <mml:mi mathvariant="italic">v</mml:mi>
 263                                         <mml:mo>⁡</mml:mo>
 264                                         <mml:mfenced open="[" close="]">
 265                                             <mml:mn>2</mml:mn>
 266                                         </mml:mfenced>
 267                                     </mml:mrow>
 268                                 </mml:mtd>
 269                             </mml:mtr>
 270                             <mml:mtr>
 271                                 <mml:mtd>
 272                                     <mml:mrow>
 273                                         <mml:mi mathvariant="italic">v</mml:mi>
 274                                         <mml:mo>⁡</mml:mo>
 275                                         <mml:mfenced open="[" close="]">
 276                                             <mml:mn>3</mml:mn>
 277                                         </mml:mfenced>
 278                                     </mml:mrow>
 279                                 </mml:mtd>
 280                             </mml:mtr>
 281                         </mml:mtable>
 282                     </mml:mfenced>
 283                 </mml:mrow>
 284             </mml:math></div><p>
 285         </p><p>
 286         </p><p>
 287             Calling <code class="function">glMultMatrix</code> with an argument of
 288             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 289
 290                 <mml:mrow>
 291                     <mml:mi mathvariant="italic">m</mml:mi>
 292                     <mml:mo>=</mml:mo>
 293                     <mml:mfenced open="{" close="}">
 294                         <mml:mrow>
 295                             <mml:mi mathvariant="italic">m</mml:mi>
 296                             <mml:mo>⁡</mml:mo>
 297                             <mml:mfenced open="[" close="]">
 298                                 <mml:mn>0</mml:mn>
 299                             </mml:mfenced>
 300                         </mml:mrow>
 301                         <mml:mrow>
 302                             <mml:mi mathvariant="italic">m</mml:mi>
 303                             <mml:mo>⁡</mml:mo>
 304                             <mml:mfenced open="[" close="]">
 305                                 <mml:mn>1</mml:mn>
 306                             </mml:mfenced>
 307                         </mml:mrow>
 308                         <mml:mi mathvariant="italic">...</mml:mi>
 309                         <mml:mrow>
 310                             <mml:mi mathvariant="italic">m</mml:mi>
 311                             <mml:mo>⁡</mml:mo>
 312                             <mml:mfenced open="[" close="]">
 313                                 <mml:mn>15</mml:mn>
 314                             </mml:mfenced>
 315                         </mml:mrow>
 316                     </mml:mfenced>
 317                 </mml:mrow>
 318             </mml:math>
 319             replaces the current transformation with
 320             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 321
 322                 <mml:mrow>
 323                     <mml:mfenced open="(" close=")">
 324                         <mml:mrow>
 325                             <mml:mi mathvariant="italic">C</mml:mi>
 326                             <mml:mo>×</mml:mo>
 327                             <mml:mi mathvariant="italic">M</mml:mi>
 328                         </mml:mrow>
 329                     </mml:mfenced>
 330                     <mml:mo>×</mml:mo>
 331                     <mml:mi mathvariant="italic">v</mml:mi>
 332                 </mml:mrow>
 333             </mml:math>,
 334             or
 335         </p><p>
 336             </p><div class="informalequation"><mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 337
 338                 <mml:mrow>
 339                     <mml:mfenced open="(" close=")">
 340                         <mml:mtable>
 341                             <mml:mtr>
 342                                 <mml:mtd>
 343                                     <mml:mrow>
 344                                         <mml:mi mathvariant="italic">c</mml:mi>
 345                                         <mml:mo>⁡</mml:mo>
 346                                         <mml:mfenced open="[" close="]">
 347                                             <mml:mn>0</mml:mn>
 348                                         </mml:mfenced>
 349                                     </mml:mrow>
 350                                 </mml:mtd>
 351                                 <mml:mtd>
 352                                     <mml:mrow>
 353                                         <mml:mi mathvariant="italic">c</mml:mi>
 354                                         <mml:mo>⁡</mml:mo>
 355                                         <mml:mfenced open="[" close="]">
 356                                             <mml:mn>4</mml:mn>
 357                                         </mml:mfenced>
 358                                     </mml:mrow>
 359                                 </mml:mtd>
 360                                 <mml:mtd>
 361                                     <mml:mrow>
 362                                         <mml:mi mathvariant="italic">c</mml:mi>
 363                                         <mml:mo>⁡</mml:mo>
 364                                         <mml:mfenced open="[" close="]">
 365                                             <mml:mn>8</mml:mn>
 366                                         </mml:mfenced>
 367                                     </mml:mrow>
 368                                 </mml:mtd>
 369                                 <mml:mtd>
 370                                     <mml:mrow>
 371                                         <mml:mi mathvariant="italic">c</mml:mi>
 372                                         <mml:mo>⁡</mml:mo>
 373                                         <mml:mfenced open="[" close="]">
 374                                             <mml:mn>12</mml:mn>
 375                                         </mml:mfenced>
 376                                     </mml:mrow>
 377                                 </mml:mtd>
 378                             </mml:mtr>
 379                             <mml:mtr>
 380                                 <mml:mtd>
 381                                     <mml:mrow>
 382                                         <mml:mi mathvariant="italic">c</mml:mi>
 383                                         <mml:mo>⁡</mml:mo>
 384                                         <mml:mfenced open="[" close="]">
 385                                             <mml:mn>1</mml:mn>
 386                                         </mml:mfenced>
 387                                     </mml:mrow>
 388                                 </mml:mtd>
 389                                 <mml:mtd>
 390                                     <mml:mrow>
 391                                         <mml:mi mathvariant="italic">c</mml:mi>
 392                                         <mml:mo>⁡</mml:mo>
 393                                         <mml:mfenced open="[" close="]">
 394                                             <mml:mn>5</mml:mn>
 395                                         </mml:mfenced>
 396                                     </mml:mrow>
 397                                 </mml:mtd>
 398                                 <mml:mtd>
 399                                     <mml:mrow>
 400                                         <mml:mi mathvariant="italic">c</mml:mi>
 401                                         <mml:mo>⁡</mml:mo>
 402                                         <mml:mfenced open="[" close="]">
 403                                             <mml:mn>9</mml:mn>
 404                                         </mml:mfenced>
 405                                     </mml:mrow>
 406                                 </mml:mtd>
 407                                 <mml:mtd>
 408                                     <mml:mrow>
 409                                         <mml:mi mathvariant="italic">c</mml:mi>
 410                                         <mml:mo>⁡</mml:mo>
 411                                         <mml:mfenced open="[" close="]">
 412                                             <mml:mn>13</mml:mn>
 413                                         </mml:mfenced>
 414                                     </mml:mrow>
 415                                 </mml:mtd>
 416                             </mml:mtr>
 417                             <mml:mtr>
 418                                 <mml:mtd>
 419                                     <mml:mrow>
 420                                         <mml:mi mathvariant="italic">c</mml:mi>
 421                                         <mml:mo>⁡</mml:mo>
 422                                         <mml:mfenced open="[" close="]">
 423                                             <mml:mn>2</mml:mn>
 424                                         </mml:mfenced>
 425                                     </mml:mrow>
 426                                 </mml:mtd>
 427                                 <mml:mtd>
 428                                     <mml:mrow>
 429                                         <mml:mi mathvariant="italic">c</mml:mi>
 430                                         <mml:mo>⁡</mml:mo>
 431                                         <mml:mfenced open="[" close="]">
 432                                             <mml:mn>6</mml:mn>
 433                                         </mml:mfenced>
 434                                     </mml:mrow>
 435                                 </mml:mtd>
 436                                 <mml:mtd>
 437                                     <mml:mrow>
 438                                         <mml:mi mathvariant="italic">c</mml:mi>
 439                                         <mml:mo>⁡</mml:mo>
 440                                         <mml:mfenced open="[" close="]">
 441                                             <mml:mn>10</mml:mn>
 442                                         </mml:mfenced>
 443                                     </mml:mrow>
 444                                 </mml:mtd>
 445                                 <mml:mtd>
 446                                     <mml:mrow>
 447                                         <mml:mi mathvariant="italic">c</mml:mi>
 448                                         <mml:mo>⁡</mml:mo>
 449                                         <mml:mfenced open="[" close="]">
 450                                             <mml:mn>14</mml:mn>
 451                                         </mml:mfenced>
 452                                     </mml:mrow>
 453                                 </mml:mtd>
 454                             </mml:mtr>
 455                             <mml:mtr>
 456                                 <mml:mtd>
 457                                     <mml:mrow>
 458                                         <mml:mi mathvariant="italic">c</mml:mi>
 459                                         <mml:mo>⁡</mml:mo>
 460                                         <mml:mfenced open="[" close="]">
 461                                             <mml:mn>3</mml:mn>
 462                                         </mml:mfenced>
 463                                     </mml:mrow>
 464                                 </mml:mtd>
 465                                 <mml:mtd>
 466                                     <mml:mrow>
 467                                         <mml:mi mathvariant="italic">c</mml:mi>
 468                                         <mml:mo>⁡</mml:mo>
 469                                         <mml:mfenced open="[" close="]">
 470                                             <mml:mn>7</mml:mn>
 471                                         </mml:mfenced>
 472                                     </mml:mrow>
 473                                 </mml:mtd>
 474                                 <mml:mtd>
 475                                     <mml:mrow>
 476                                         <mml:mi mathvariant="italic">c</mml:mi>
 477                                         <mml:mo>⁡</mml:mo>
 478                                         <mml:mfenced open="[" close="]">
 479                                             <mml:mn>11</mml:mn>
 480                                         </mml:mfenced>
 481                                     </mml:mrow>
 482                                 </mml:mtd>
 483                                 <mml:mtd>
 484                                     <mml:mrow>
 485                                         <mml:mi mathvariant="italic">c</mml:mi>
 486                                         <mml:mo>⁡</mml:mo>
 487                                         <mml:mfenced open="[" close="]">
 488                                             <mml:mn>15</mml:mn>
 489                                         </mml:mfenced>
 490                                     </mml:mrow>
 491                                 </mml:mtd>
 492                             </mml:mtr>
 493                         </mml:mtable>
 494                     </mml:mfenced>
 495                     <mml:mo>×</mml:mo>
 496                     <mml:mfenced open="(" close=")">
 497                         <mml:mtable>
 498                             <mml:mtr>
 499                                 <mml:mtd>
 500                                     <mml:mrow>
 501                                         <mml:mi mathvariant="italic">m</mml:mi>
 502                                         <mml:mo>⁡</mml:mo>
 503                                         <mml:mfenced open="[" close="]">
 504                                             <mml:mn>0</mml:mn>
 505                                         </mml:mfenced>
 506                                     </mml:mrow>
 507                                 </mml:mtd>
 508                                 <mml:mtd>
 509                                     <mml:mrow>
 510                                         <mml:mi mathvariant="italic">m</mml:mi>
 511                                         <mml:mo>⁡</mml:mo>
 512                                         <mml:mfenced open="[" close="]">
 513                                             <mml:mn>4</mml:mn>
 514                                         </mml:mfenced>
 515                                     </mml:mrow>
 516                                 </mml:mtd>
 517                                 <mml:mtd>
 518                                     <mml:mrow>
 519                                         <mml:mi mathvariant="italic">m</mml:mi>
 520                                         <mml:mo>⁡</mml:mo>
 521                                         <mml:mfenced open="[" close="]">
 522                                             <mml:mn>8</mml:mn>
 523                                         </mml:mfenced>
 524                                     </mml:mrow>
 525                                 </mml:mtd>
 526                                 <mml:mtd>
 527                                     <mml:mrow>
 528                                         <mml:mi mathvariant="italic">m</mml:mi>
 529                                         <mml:mo>⁡</mml:mo>
 530                                         <mml:mfenced open="[" close="]">
 531                                             <mml:mn>12</mml:mn>
 532                                         </mml:mfenced>
 533                                     </mml:mrow>
 534                                 </mml:mtd>
 535                             </mml:mtr>
 536                             <mml:mtr>
 537                                 <mml:mtd>
 538                                     <mml:mrow>
 539                                         <mml:mi mathvariant="italic">m</mml:mi>
 540                                         <mml:mo>⁡</mml:mo>
 541                                         <mml:mfenced open="[" close="]">
 542                                             <mml:mn>1</mml:mn>
 543                                         </mml:mfenced>
 544                                     </mml:mrow>
 545                                 </mml:mtd>
 546                                 <mml:mtd>
 547                                     <mml:mrow>
 548                                         <mml:mi mathvariant="italic">m</mml:mi>
 549                                         <mml:mo>⁡</mml:mo>
 550                                         <mml:mfenced open="[" close="]">
 551                                             <mml:mn>5</mml:mn>
 552                                         </mml:mfenced>
 553                                     </mml:mrow>
 554                                 </mml:mtd>
 555                                 <mml:mtd>
 556                                     <mml:mrow>
 557                                         <mml:mi mathvariant="italic">m</mml:mi>
 558                                         <mml:mo>⁡</mml:mo>
 559                                         <mml:mfenced open="[" close="]">
 560                                             <mml:mn>9</mml:mn>
 561                                         </mml:mfenced>
 562                                     </mml:mrow>
 563                                 </mml:mtd>
 564                                 <mml:mtd>
 565                                     <mml:mrow>
 566                                         <mml:mi mathvariant="italic">m</mml:mi>
 567                                         <mml:mo>⁡</mml:mo>
 568                                         <mml:mfenced open="[" close="]">
 569                                             <mml:mn>13</mml:mn>
 570                                         </mml:mfenced>
 571                                     </mml:mrow>
 572                                 </mml:mtd>
 573                             </mml:mtr>
 574                             <mml:mtr>
 575                                 <mml:mtd>
 576                                     <mml:mrow>
 577                                         <mml:mi mathvariant="italic">m</mml:mi>
 578                                         <mml:mo>⁡</mml:mo>
 579                                         <mml:mfenced open="[" close="]">
 580                                             <mml:mn>2</mml:mn>
 581                                         </mml:mfenced>
 582                                     </mml:mrow>
 583                                 </mml:mtd>
 584                                 <mml:mtd>
 585                                     <mml:mrow>
 586                                         <mml:mi mathvariant="italic">m</mml:mi>
 587                                         <mml:mo>⁡</mml:mo>
 588                                         <mml:mfenced open="[" close="]">
 589                                             <mml:mn>6</mml:mn>
 590                                         </mml:mfenced>
 591                                     </mml:mrow>
 592                                 </mml:mtd>
 593                                 <mml:mtd>
 594                                     <mml:mrow>
 595                                         <mml:mi mathvariant="italic">m</mml:mi>
 596                                         <mml:mo>⁡</mml:mo>
 597                                         <mml:mfenced open="[" close="]">
 598                                             <mml:mn>10</mml:mn>
 599                                         </mml:mfenced>
 600                                     </mml:mrow>
 601                                 </mml:mtd>
 602                                 <mml:mtd>
 603                                     <mml:mrow>
 604                                         <mml:mi mathvariant="italic">m</mml:mi>
 605                                         <mml:mo>⁡</mml:mo>
 606                                         <mml:mfenced open="[" close="]">
 607                                             <mml:mn>14</mml:mn>
 608                                         </mml:mfenced>
 609                                     </mml:mrow>
 610                                 </mml:mtd>
 611                             </mml:mtr>
 612                             <mml:mtr>
 613                                 <mml:mtd>
 614                                     <mml:mrow>
 615                                         <mml:mi mathvariant="italic">m</mml:mi>
 616                                         <mml:mo>⁡</mml:mo>
 617                                         <mml:mfenced open="[" close="]">
 618                                             <mml:mn>3</mml:mn>
 619                                         </mml:mfenced>
 620                                     </mml:mrow>
 621                                 </mml:mtd>
 622                                 <mml:mtd>
 623                                     <mml:mrow>
 624                                         <mml:mi mathvariant="italic">m</mml:mi>
 625                                         <mml:mo>⁡</mml:mo>
 626                                         <mml:mfenced open="[" close="]">
 627                                             <mml:mn>7</mml:mn>
 628                                         </mml:mfenced>
 629                                     </mml:mrow>
 630                                 </mml:mtd>
 631                                 <mml:mtd>
 632                                     <mml:mrow>
 633                                         <mml:mi mathvariant="italic">m</mml:mi>
 634                                         <mml:mo>⁡</mml:mo>
 635                                         <mml:mfenced open="[" close="]">
 636                                             <mml:mn>11</mml:mn>
 637                                         </mml:mfenced>
 638                                     </mml:mrow>
 639                                 </mml:mtd>
 640                                 <mml:mtd>
 641                                     <mml:mrow>
 642                                         <mml:mi mathvariant="italic">m</mml:mi>
 643                                         <mml:mo>⁡</mml:mo>
 644                                         <mml:mfenced open="[" close="]">
 645                                             <mml:mn>15</mml:mn>
 646                                         </mml:mfenced>
 647                                     </mml:mrow>
 648                                 </mml:mtd>
 649                             </mml:mtr>
 650                         </mml:mtable>
 651                     </mml:mfenced>
 652                     <mml:mo>×</mml:mo>
 653                     <mml:mfenced open="(" close=")">
 654                         <mml:mtable>
 655                             <mml:mtr>
 656                                 <mml:mtd>
 657                                     <mml:mrow>
 658                                         <mml:mi mathvariant="italic">v</mml:mi>
 659                                         <mml:mo>⁡</mml:mo>
 660                                         <mml:mfenced open="[" close="]">
 661                                             <mml:mn>0</mml:mn>
 662                                         </mml:mfenced>
 663                                     </mml:mrow>
 664                                 </mml:mtd>
 665                             </mml:mtr>
 666                             <mml:mtr>
 667                                 <mml:mtd>
 668                                     <mml:mrow>
 669                                         <mml:mi mathvariant="italic">v</mml:mi>
 670                                         <mml:mo>⁡</mml:mo>
 671                                         <mml:mfenced open="[" close="]">
 672                                             <mml:mn>1</mml:mn>
 673                                         </mml:mfenced>
 674                                     </mml:mrow>
 675                                 </mml:mtd>
 676                             </mml:mtr>
 677                             <mml:mtr>
 678                                 <mml:mtd>
 679                                     <mml:mrow>
 680                                         <mml:mi mathvariant="italic">v</mml:mi>
 681                                         <mml:mo>⁡</mml:mo>
 682                                         <mml:mfenced open="[" close="]">
 683                                             <mml:mn>2</mml:mn>
 684                                         </mml:mfenced>
 685                                     </mml:mrow>
 686                                 </mml:mtd>
 687                             </mml:mtr>
 688                             <mml:mtr>
 689                                 <mml:mtd>
 690                                     <mml:mrow>
 691                                         <mml:mi mathvariant="italic">v</mml:mi>
 692                                         <mml:mo>⁡</mml:mo>
 693                                         <mml:mfenced open="[" close="]">
 694                                             <mml:mn>3</mml:mn>
 695                                         </mml:mfenced>
 696                                     </mml:mrow>
 697                                 </mml:mtd>
 698                             </mml:mtr>
 699                         </mml:mtable>
 700                     </mml:mfenced>
 701                 </mml:mrow>
 702             </mml:math></div><p>
 703         </p><p>
 704         </p><p>
 705             Where
 706             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll"><mml:mi mathvariant="italic">v</mml:mi></mml:math>
 707             is represented as a
 708             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 709
 710                 <mml:mrow>
 711                     <mml:mn>4</mml:mn>
 712                     <mml:mo>×</mml:mo>
 713                     <mml:mn>1</mml:mn>
 714                 </mml:mrow>
 715             </mml:math>
 716             matrix.
 717         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
 718             While the elements of the matrix may be specified with
 719             single or double precision, the GL may store or operate on these
 720             values in less-than-single precision.
 721         </p><p>
 722             In many computer languages,
 723             <mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
 724
 725                 <mml:mrow>
 726                     <mml:mn>4</mml:mn>
 727                     <mml:mo>×</mml:mo>
 728                     <mml:mn>4</mml:mn>
 729                 </mml:mrow>
 730             </mml:math>
 731             arrays are represented
 732             in row-major order. The transformations just described
 733             represent these matrices in column-major order.
 734             The order of the multiplication is important. For example, if the current
 735             transformation is a rotation, and <code class="function">glMultMatrix</code> is called with a translation matrix,
 736             the translation is done directly on the coordinates to be transformed,
 737             while the rotation is done on the results of that translation.
 738         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
 739             <code class="constant">GL_INVALID_OPERATION</code> is generated if <code class="function">glMultMatrix</code>
 740             is executed between the execution of <a class="citerefentry" href="glBegin.xml"><span class="citerefentry"><span class="refentrytitle">glBegin</span></span></a>
 741             and the corresponding execution of <a class="citerefentry" href="glEnd.xml"><span class="citerefentry"><span class="refentrytitle">glEnd</span></span></a>.
 742         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
 743             <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_MATRIX_MODE</code>
 744         </p><p>
 745             <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_COLOR_MATRIX</code>
 746         </p><p>
 747             <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_MODELVIEW_MATRIX</code>
 748         </p><p>
 749             <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_PROJECTION_MATRIX</code>
 750         </p><p>
 751             <a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_TEXTURE_MATRIX</code>
 752         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
 753             <a class="citerefentry" href="glLoadIdentity.xml"><span class="citerefentry"><span class="refentrytitle">glLoadIdentity</span></span></a>,
 754             <a class="citerefentry" href="glLoadMatrix.xml"><span class="citerefentry"><span class="refentrytitle">glLoadMatrix</span></span></a>,
 755             <a class="citerefentry" href="glLoadTransposeMatrix.xml"><span class="citerefentry"><span class="refentrytitle">glLoadTransposeMatrix</span></span></a>,
 756             <a class="citerefentry" href="glMatrixMode.xml"><span class="citerefentry"><span class="refentrytitle">glMatrixMode</span></span></a>,
 757             <a class="citerefentry" href="glMultTransposeMatrix.xml"><span class="citerefentry"><span class="refentrytitle">glMultTransposeMatrix</span></span></a>,
 758             <a class="citerefentry" href="glPushMatrix.xml"><span class="citerefentry"><span class="refentrytitle">glPushMatrix</span></span></a>
 759         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
 760             Copyright <span class="trademark"></span>© 1991-2006
 761             Silicon Graphics, Inc. This document is licensed under the SGI
 762             Free Software B License. For details, see
 763             <a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
 764         </p></div></div></body></html>