1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../../css/manpage.css" type="text/css" />
7<title>CalculateMatricesReal</title>
8  </head>
9  <body>
10<h1><CODE>nn::ulcd::CTR::StereoCamera::CalculateMatricesReal</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/ulcd.h&gt;
14
15void CalculateMatricesReal(
16     <a href="../../../../nn/math/MTX44/Overview.html">nn::math::Matrix44</a> * projL,
17     <a href="../../../../nn/math/MTX34/Overview.html">nn::math::Matrix34</a> * viewL,
18     <a href="../../../../nn/math/MTX44/Overview.html">nn::math::Matrix44</a> * projR,
19     <a href="../../../../nn/math/MTX34/Overview.html">nn::math::Matrix34</a> * viewR,
20     const f32 depthLevel,
21     const f32 factor,
22     const <a href="../../../../nn/math/PivotDirection.html">nn::math::PivotDirection</a> pivot = nn::math::PIVOT_UPSIDE_TO_TOP
23);
24</pre>
25    </div>
26<h2>Arguments</h2>
27    <div class="section">
28      <table class="arguments">
29        <thead>
30          <tr>
31            <td width="15" />
32<th>Name</th>
33<td>Description</td>
34          </tr>
35        </thead>
36        <tr>
37<td>out</td>
38<th>projL</th>
39<td>Location where the calculated results for the left projection matrix are stored.</td>
40        </tr>
41        <tr>
42<td>out</td>
43<th>viewL</th>
44<td>Location where the calculated results for the left view matrix are stored.</td>
45        </tr>
46        <tr>
47<td>out</td>
48<th>projR</th>
49<td>Location where the calculated results for the right projection matrix are stored.</td>
50        </tr>
51        <tr>
52<td>out</td>
53<th>viewR</th>
54<td>Location where the calculated results for the right view matrix are stored.</td>
55        </tr>
56        <tr>
57<td>in</td>
58<th>depthLevel</th>
59<td>Distance (in virtual space) from the camera to the desired location on the LCD surface.</td>
60        </tr>
61        <tr>
62<td>in</td>
63<th>factor</th>
64<td>Depth adjustment factor. (A value of <CODE>0</CODE> indicates no parallax. A value of <CODE>1</CODE> indicates standard parallax.）</td>
65        </tr>
66        <tr>
67<td>in</td>
68<th>pivot</th>
69<td>Upward direction of the camera within the frame of the upper screen (used for rotation).</td>
70        </tr> </table>
71    </div>
72<h2>Return Values</h2>
73    <div class="section">
74None.
75               </div>
76<h2>Description</h2>
77    <div class="section">
78<p>Calculates the view matrices and projection matrices for the left and right cameras, using the realism priority method.</p><!-- write here --><P>This method assumes the distance between the surface of the CTR's LCD and the user, and it calculates matrices by applying that assumed relationship to virtual space. This method, therefore, automatically adjusts the position of the base camera specified by the application. This makes it possible to achieve effects that give the impression that objects located at the specified <SPAN class="argument">depthLevel</SPAN> are actually on the surface of the LCD.
79</P><P>Once the projection matrix has been calculated and output, the upward direction of the camera will be the direction specified for the <SPAN class="argument">pivot</SPAN> argument. If <SPAN class="argument">pivot</SPAN> is set to <CODE>nn::math::PIVOT_NONE</CODE>, no rotation is applied. If an invalid value is specified for the <SPAN class="argument">pivot</SPAN> argument, the function halts on an assertion. The value <CODE>nn::math::PIVOT_UPSIDE_TO_TOP</CODE> is specified by default.
80</P><P>This function stops at an assertion if it is called before the <CODE>Initialize</CODE> function has been called on an instance of the <CODE>StereoCamera</CODE> class.
81            </P></div>
82<h2>Revision History</h2>
83    <div class="section">
84      <dl class="history">
85        <dt>2010/09/13</dt>
86<dd>Noted that execution stops at an assertion prior to initialization.
87        </dd>
88        <dt>2010/04/02</dt>
89<dd>Initial version.<br />
90        </dd>
91      </dl>
92    </div>
93  <hr><p>CONFIDENTIAL</p></body>
94</html>