Frictional Game Wiki

<h2>cMatrixf</h2> <div class="level2"> </div> <h3>Constructors</h3> <div class="level3"> <span class='np_break'> </span> <div class="table"><table class="inline"> <thead> <tr class="row0"> <th class="col0">Constructor </th><th class="col1">Description </th> </tr> </thead> <tr class="row1"> <td class="col0">cMatrixf() </td><td class="col1">Creates a matrix with default values. </td> </tr> <tr class="row2"> <td class="col0">cMatrixf(cVector4f, cVector4f, cVector4f, cVector4f) </td><td class="col1">Creates a matrix using the given vectors as column data. </td> </tr> <tr class="row3"> <td class="col0">cMatrixf(float, float, float, float, float, float, float, float, float, float, float, float, float, float, float, float) </td><td class="leftalign">Creates a matrix using the given values as cell data. <b>(Warning: This constructor is bugged.)</b> </td> </tr> </table> <span class='np_break'> </span> </div> </div> <h3>Fields</h3> <div class="level3"> <p> cMatrixf has no public fields. </p> </div> <h3>Functions</h3> <div class="level3"> <span class='np_break'> </span> <div class="table"><table class="inline"> <thead> <tr class="row0"> <th class="col0">Return Type </th><th class="col1">Function Name </th><th class="col2">Parameters </th><th class="col3">Description </th> </tr> </thead> <tr class="row1"> <td class="col0">float </td><td class="col1">GetElement </td><td class="col2">uint64, <br/> uint64, <br/> const </td><td class="leftalign"> </td> </tr> <tr class="row2"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetRight </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row3"> <td class="col0">void </td><td class="col1">SetRight </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avVec </td><td class="leftalign"> </td> </tr> <tr class="row4"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetUp </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row5"> <td class="col0">void </td><td class="col1">SetUp </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avVec </td><td class="leftalign"> </td> </tr> <tr class="row6"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetForward </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row7"> <td class="col0">void </td><td class="col1">SetForward </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avVec </td><td class="leftalign"> </td> </tr> <tr class="row8"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetTranslation </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row9"> <td class="col0">void </td><td class="col1">SetTranslation </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avTrans </td><td class="leftalign"> </td> </tr> <tr class="row10"> <td class="col0">void </td><td class="col1">SetRotation </td><td class="col2">float afXX, <br/> float afXY, <br/> float afXZ, <br/> float afYX, <br/> float afYY, <br/> float afYZ, <br/> float afZX, <br/> float afZY, <br/> float afZZ </td><td class="leftalign"> </td> </tr> <tr class="row11"> <td class="col0">void </td><td class="col1">SetRotation </td><td class="col2">const <span class="curid"><a href="/doku.php?id=hpl3:community:scripting:classes:cmatrixf" class="wikilink1" title="hpl3:community:scripting:classes:cmatrixf">cMatrixf</a></span> &in a_mtxRot </td><td class="leftalign"> </td> </tr> <tr class="row12"> <td class="col0"><span class="curid"><a href="/doku.php?id=hpl3:community:scripting:classes:cmatrixf" class="wikilink1" title="hpl3:community:scripting:classes:cmatrixf">cMatrixf</a></span> </td><td class="col1">GetRotation </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row13"> <td class="col0"><span class="curid"><a href="/doku.php?id=hpl3:community:scripting:classes:cmatrixf" class="wikilink1" title="hpl3:community:scripting:classes:cmatrixf">cMatrixf</a></span> </td><td class="col1">GetTranspose </td><td class="col2">const </td><td class="leftalign"> </td> </tr> </table> <span class='np_break'> </span> </div> <p> <br/> </p> </div> <h3>Constructors</h3> <div class="level3"> <span class='np_break'> </span> <div class="table"><table class="inline"> <thead> <tr class="row0"> <th class="col0">Constructor </th><th class="col1">Description </th> </tr> </thead> <tr class="row1"> <td class="col0">cMatrixf() </td><td class="col1">Creates a matrix with default values. </td> </tr> <tr class="row2"> <td class="col0">cMatrixf(cVector4f, cVector4f, cVector4f, cVector4f) </td><td class="col1">Creates a matrix using the given vectors as column data. </td> </tr> <tr class="row3"> <td class="col0">cMatrixf(float, float, float, float, float, float, float, float, float, float, float, float, float, float, float, float) </td><td class="col1">Creates a matrix using the given values as cell data. </td> </tr> </table> <span class='np_break'> </span> </div> </div> <h3>Fields</h3> <div class="level3"> <p> cMatrixf has no public fields. </p> </div> <h3>Functions</h3> <div class="level3"> <span class='np_break'> </span> <div class="table"><table class="inline"> <thead> <tr class="row0"> <th class="col0">Return Type </th><th class="col1">Function Name </th><th class="col2">Parameters </th><th class="col3">Description </th> </tr> </thead> <tr class="row1"> <td class="col0">float </td><td class="col1">GetElement </td><td class="col2">uint64, <br/> uint64, <br/> const </td><td class="leftalign"> </td> </tr> <tr class="row2"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetRight </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row3"> <td class="col0">void </td><td class="col1">SetRight </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avVec </td><td class="leftalign"> </td> </tr> <tr class="row4"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetUp </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row5"> <td class="col0">void </td><td class="col1">SetUp </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avVec </td><td class="leftalign"> </td> </tr> <tr class="row6"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetForward </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row7"> <td class="col0">void </td><td class="col1">SetForward </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avVec </td><td class="leftalign"> </td> </tr> <tr class="row8"> <td class="col0"><a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> </td><td class="col1">GetTranslation </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row9"> <td class="col0">void </td><td class="col1">SetTranslation </td><td class="col2">const <a href="/doku.php?id=hpl3:community:scripting:classes:cvector3f" class="wikilink1" title="hpl3:community:scripting:classes:cvector3f">cVector3f</a> &in avTrans </td><td class="leftalign"> </td> </tr> <tr class="row10"> <td class="col0">void </td><td class="col1">SetRotation </td><td class="col2">float afXX, <br/> float afXY, <br/> float afXZ, <br/> float afYX, <br/> float afYY, <br/> float afYZ, <br/> float afZX, <br/> float afZY, <br/> float afZZ </td><td class="leftalign"> </td> </tr> <tr class="row11"> <td class="col0">void </td><td class="col1">SetRotation </td><td class="col2">const <span class="curid"><a href="/doku.php?id=hpl3:community:scripting:classes:cmatrixf" class="wikilink1" title="hpl3:community:scripting:classes:cmatrixf">cMatrixf</a></span> &in a_mtxRot </td><td class="leftalign"> </td> </tr> <tr class="row12"> <td class="col0"><span class="curid"><a href="/doku.php?id=hpl3:community:scripting:classes:cmatrixf" class="wikilink1" title="hpl3:community:scripting:classes:cmatrixf">cMatrixf</a></span> </td><td class="col1">GetRotation </td><td class="col2">const </td><td class="leftalign"> </td> </tr> <tr class="row13"> <td class="col0"><span class="curid"><a href="/doku.php?id=hpl3:community:scripting:classes:cmatrixf" class="wikilink1" title="hpl3:community:scripting:classes:cmatrixf">cMatrixf</a></span> </td><td class="col1">GetTranspose </td><td class="col2">const </td><td class="leftalign"> </td> </tr> </table> <span class='np_break'> </span> </div> </div> <h3>Remarks</h3> <div class="level3"> <p> To retrieve a value from a matrix, use the GetElement function above. The parameters for the GetElement function use the format GetElement(columnIndex, rowIndex). </p> <pre class="code =c++">cMatrixf m1<span class="br0">(</span>cVector4f<span class="br0">(</span><span class="nu0">0</span><span class="sy0">,</span> <span class="nu0">1</span><span class="sy0">,</span> <span class="nu0">2</span><span class="sy0">,</span> <span class="nu0">3</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">4</span><span class="sy0">,</span> <span class="nu0">5</span><span class="sy0">,</span> <span class="nu0">6</span><span class="sy0">,</span> <span class="nu0">7</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">8</span><span class="sy0">,</span> <span class="nu0">9</span><span class="sy0">,</span> <span class="nu0">10</span><span class="sy0">,</span> <span class="nu0">11</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">12</span><span class="sy0">,</span> <span class="nu0">13</span><span class="sy0">,</span> <span class="nu0">14</span><span class="sy0">,</span> <span class="nu0">15</span><span class="br0">)</span><span class="br0">)</span><span class="sy0">;</span>   <span class="kw4">float</span> f <span class="sy0">=</span> m1.<span class="me1">GetElement</span><span class="br0">(</span><span class="nu0">1</span><span class="sy0">,</span> <span class="nu0">2</span><span class="br0">)</span><span class="sy0">;</span>   <span class="co1">// value of f: 9 </span> </pre><p> </p> <p> To do matrix computations, use the <a href="/doku.php?id=hpl3:game:scripting:function_reference:hps_api#cmath_matrixslerp" class="wikilink1" title="hpl3:game:scripting:function_reference:hps_api">cMath_MatrixXXX</a> family of functions. </p> <pre class="code =c++">cMatrixf m1<span class="br0">(</span>cVector4f<span class="br0">(</span><span class="nu0">1</span><span class="sy0">,</span> <span class="nu0">1</span><span class="sy0">,</span> <span class="nu0">1</span><span class="sy0">,</span> <span class="nu0">1</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">2</span><span class="sy0">,</span> <span class="nu0">2</span><span class="sy0">,</span> <span class="nu0">2</span><span class="sy0">,</span> <span class="nu0">2</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">3</span><span class="sy0">,</span> <span class="nu0">3</span><span class="sy0">,</span> <span class="nu0">3</span><span class="sy0">,</span> <span class="nu0">3</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">4</span><span class="sy0">,</span> <span class="nu0">4</span><span class="sy0">,</span> <span class="nu0">4</span><span class="sy0">,</span> <span class="nu0">4</span><span class="br0">)</span><span class="br0">)</span><span class="sy0">;</span>   cMatrixf m2<span class="br0">(</span>cVector4f<span class="br0">(</span><span class="nu0">5</span><span class="sy0">,</span> <span class="nu0">5</span><span class="sy0">,</span> <span class="nu0">5</span><span class="sy0">,</span> <span class="nu0">5</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">6</span><span class="sy0">,</span> <span class="nu0">6</span><span class="sy0">,</span> <span class="nu0">6</span><span class="sy0">,</span> <span class="nu0">6</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">7</span><span class="sy0">,</span> <span class="nu0">7</span><span class="sy0">,</span> <span class="nu0">7</span><span class="sy0">,</span> <span class="nu0">7</span><span class="br0">)</span><span class="sy0">,</span> cVector4f<span class="br0">(</span><span class="nu0">8</span><span class="sy0">,</span> <span class="nu0">8</span><span class="sy0">,</span> <span class="nu0">8</span><span class="sy0">,</span> <span class="nu0">8</span><span class="br0">)</span><span class="br0">)</span><span class="sy0">;</span>   cMatrixf m3 <span class="sy0">=</span> cMath_MatrixMul<span class="br0">(</span>m1<span class="sy0">,</span> m2<span class="br0">)</span><span class="sy0">;</span>   <span class="co1">// value of m3: { 26, 26, 26, 26,</span> <span class="co1">// 52, 52, 52, 52,</span> <span class="co1">// 78, 78, 78, 78,</span> <span class="co1">// 104, 104, 104, 104 } </span> </pre><p> </p> </div>