aboutsummaryrefslogtreecommitdiff
path: root/docs/doxygen/nel/track_bezier_h-source.html
blob: e1f509abe2fe64c9c507d8fc38829a2c18ff5752 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
<!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
	<TITLE>nevrax.org : docs</TITLE>
	<LINK REL=stylesheet TYPE="text/css" HREF="/inc/css/nevrax.css">
	<link href="doxygen.css" rel="stylesheet" type="text/css">
</HEAD>
<BODY MARGINHEIGHT="0" MARGINWIDTH="0">

<!-- uplinks -->
<TABLE CELLSPACING=0 CELLPADDING=0  BORDER=0>
 <TR>
        <TD WIDTH=16><IMG  SRC="/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
        <TD WIDTH=140 BGCOLOR=#dddddd><IMG  SRC="/inc/img/pixel.gif" WIDTH="140" HEIGHT="16" BORDER=0 ALT=""></TD>
        <TD WIDTH=16><IMG  SRC="/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
        <TD><IMG width=6 height=14 SRC="/inc/img/reddots.gif" ALT="#" VSPACE=2 HSPACE=2 BORDER=0 ></TD><TD VALIGN=middle>&nbsp;<A CLASS=uplinks HREF='/'><b>Home</B></FONT></A>&nbsp;&nbsp;&nbsp;</TD>
        <TD><IMG  width=6 height=14  SRC="/inc/img/reddots.gif" ALT="#" VSPACE=2 HSPACE=2 BORDER=0 ></TD><TD VALIGN=middle>&nbsp;<A CLASS=uplinks HREF='/'><b>nevrax.com</B></FONT></A>&nbsp;&nbsp;&nbsp;</TD>
 </TR>
</TABLE> 

<!-- banner Nevrax -->
<TABLE CELLSPACING=0 CELLPADDING=0  BORDER=0 WIDTH=100%>
 <TR><TD  BGCOLOR="#000000" BACKGROUND="/inc/img/black_banner.jpg"><A HREF=""><IMG  SRC="/inc/img/nevrax.gif" WIDTH="170" HEIGHT="45" BORDER=0 ALT="Nevrax" ></A></TD></TR>
</TABLE>

<!-- main table -->
<TABLE CELLSPACING=0 CELLPADDING=0  BORDER=0 height=100%>
 <TR>
	<TD WIDTH=16><IMG  SRC="/inc/img/pixel.gif" WIDTH="16" HEIGHT="10" BORDER=0 ALT=""></TD>
	<TD WIDTH=140   BGCOLOR=#dddddd VALIGN=TOP ALIGN=middle><IMG  SRC="/inc/img/pixel.gif" WIDTH="140" HEIGHT="10" BORDER=0 ALT="">

		<!------ Begin Box ------>
		<TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=black><TR><TD><TABLE border=0  cellspacing=2 cellpadding=0 width=120><tr><TD ALIGN=middle bgcolor=black>
		<FONT COLOR=white FACE="sans-serif"><B>Nevrax.org</B></FONT></TD></TR><tr><td  colspan=2 bgcolor=#FFFFFF>
		<TABLE cellspacing=0 cellpadding=1 border=0>
			<tr><td ALIGN=middle><a  class='linkbox' href="/news/" TITLE="Rubrique news"><img width=13 height=15  hspace=5 border=0 src=/inc/img/picto-news.gif ALT=#></A></td><td><a  class='linkbox' href="/news/" TITLE="News">News</a></td></tr>
			<tr><td ALIGN=middle><a  class='linkbox' href="/mail/" TITLE="Rubrique mail"><img width=15 height=11  hspace=5 border=0 src=/inc/img/picto-mail.gif ALT=#></A></td><td><a  class='linkbox' href="/mail/" TITLE="Mailing list archive">Mailing-list</a></td></tr>
			<tr><td ALIGN=middle><a  class='linkbox' href="/docs/" TITLE="Rubrique docs"><img width=14 height=16  hspace=5 border=0 src=/inc/img/picto-docs.gif ALT=#></A></td><td><a  class='linkbox' href="/docs/" TITLE="Documentation">Documentation</a></td></tr>
			<tr><td ALIGN=middle><a  class='linkbox' href="/cvs/" TITLE="Rubrique cvs"><img width=13 height=17  hspace=5 border=0 src=/inc/img/picto-cvs.gif ALT=#></A></td><td><a  class='linkbox' href="/cvs/" TITLE="CVS Web">CVS</a></td></tr>
			<tr><td ALIGN=middle><a  class='linkbox' href="/bugs/" TITLE="Rubrique bugs"><img width=20 height=16  hspace=5 border=0 src=/inc/img/picto-bugs.gif ALT=#></A></td><td><a  class='linkbox' href="/bugs/" TITLE="Bugtracking">Bugs</a></td></tr>
			<tr><td ALIGN=middle><a  class='linkbox' href="/GPL.php3" TITLE="Rubrique license"><img  width=18 height=12   hspace=5 border=0 src=/inc/img/picto-gpl.gif ALT=#></A></td><td><a  class='linkbox' href="/GPL.php3" TITLE="License">License</a></td></tr>
		</TABLE>
		</TD></TR></TABLE></TD></TR></TABLE>
		<!------ End Box  ------>

	</TD>
	<TD WIDTH=15><IMG  SRC="/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
	<TD ALIGN=left valign=top><IMG  SRC="/inc/img/pixel.gif" WIDTH="140" HEIGHT="10" BORDER=0 ALT="">

<!-- title -->
<TABLE  background="/inc/img/redline.gif" CELLSPACING=0 CELLPADDING=0  BORDER=0 width=100%><tr><td>
<A HREF="/docs/"><img src="/inc/img/t_docs.gif" ALT="Docs" HEIGHT=20 BORDER=0></A>
</td><td><IMG  SRC="/inc/img/pixel.gif" WIDTH="1" HEIGHT="1" BORDER=0 ALT="">
</td></tr></table>
&nbsp;

<!-- block -->
<TABLE  bgcolor="#dddddd" CELLSPACING=0 CELLPADDING=0  BORDER=0 width=100%><tr><td width=1% valign=middle><img width=6 height=14 hspace=2 vspace=2 src="/inc/img/reddots.gif"></TD>
	<TD><B>Documentation</B></TD>
	<TD ALIGN=RIGHT>&nbsp;</td>
</tr></table>
<!-- Generated by Doxygen 1.2.2 on Thu May 31 22:01:26 2001 -->
<center>
<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="namespaces.html">Namespace List</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="namespacemembers.html">Namespace Members</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; <a class="qindex" href="pages.html">Related Pages</a> &nbsp; <a class="qindexRef" doxygen="_cgi:/cgi-bin/nel-search.cgi" href="/cgi-bin/nel-search.cgi">Search</a> &nbsp; </center>
<hr><h1>track_bezier.h</h1><a href="track_bezier_h.html">Go to the documentation of this file.</a><div class="fragment"><pre>00001 
00007 <font class="comment">/* Copyright, 2001 Nevrax Ltd.
</font>00008 <font class="comment"> *
</font>00009 <font class="comment"> * This file is part of NEVRAX NEL.
</font>00010 <font class="comment"> * NEVRAX NEL is free software; you can redistribute it and/or modify
</font>00011 <font class="comment"> * it under the terms of the GNU General Public License as published by
</font>00012 <font class="comment"> * the Free Software Foundation; either version 2, or (at your option)
</font>00013 <font class="comment"> * any later version.
</font>00014 <font class="comment">
</font>00015 <font class="comment"> * NEVRAX NEL is distributed in the hope that it will be useful, but
</font>00016 <font class="comment"> * WITHOUT ANY WARRANTY; without even the implied warranty of
</font>00017 <font class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
</font>00018 <font class="comment"> * General Public License for more details.
</font>00019 <font class="comment">
</font>00020 <font class="comment"> * You should have received a copy of the GNU General Public License
</font>00021 <font class="comment"> * along with NEVRAX NEL; see the file COPYING. If not, write to the
</font>00022 <font class="comment"> * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
</font>00023 <font class="comment"> * MA 02111-1307, USA.
</font>00024 <font class="comment"> */</font>
00025 
00026 
00027 <font class="preprocessor">#ifndef NL_TRACK_KEYFRAMER_H
</font>00028 <font class="preprocessor"></font><font class="preprocessor">#error "internal file included from track_keyframer.h"
</font>00029 <font class="preprocessor"></font><font class="preprocessor">#endif
</font>00030 <font class="preprocessor"></font>
00031 
00032 
00033 <font class="comment">// ***************************************************************************</font>
00034 <font class="comment">// ***************************************************************************</font>
00035 <font class="comment">// Bezier Keyframer.</font>
00036 <font class="comment">// ***************************************************************************</font>
00037 <font class="comment">// ***************************************************************************</font>
00038 
00039 
00040 <font class="comment">// ***************************************************************************
</font>00048 <font class="comment"></font>template&lt;class CKeyT, class T&gt;
<a name="l00049"></a><a class="code" href="class_CTrackKeyFramerBezier.html">00049</a> <font class="keyword">class </font><a class="code" href="class_CTrackKeyFramerBezier.html">CTrackKeyFramerBezier</a> : <font class="keyword">public</font> <a class="code" href="class_ITrackKeyFramer.html">ITrackKeyFramer</a>&lt;CKeyT&gt;
00050 {
00051 <font class="keyword">public</font>:
00052 
<a name="l00054"></a><a class="code" href="class_CTrackKeyFramerBezier.html#a0">00054</a>         <font class="keyword">virtual</font> <font class="keyword">const</font> IAnimatedValue&amp; <a class="code" href="class_CTrackKeyFramerBezier.html#a0">getValue</a> ()<font class="keyword"> const
</font>00055 <font class="keyword">        </font>{
00056                 <font class="keywordflow">return</font> _Value;
00057         }
00058         
00059 <font class="keyword">protected</font>:
00060 
<a name="l00061"></a><a class="code" href="class_CTrackKeyFramerBezier.html#t0">00061</a>         <font class="keyword">typedef</font> <font class="keyword">typename</font> CKeyT::TValueType              TKeyValueType;
00062 
00063 
00065         <font class="comment">// @{</font>
00066 
<a name="l00068"></a><a class="code" href="class_CTrackKeyFramerBezier.html#b0">00068</a>         <font class="keyword">virtual</font> <font class="keywordtype">void</font> <a class="code" href="class_CTrackKeyFramerBezier.html#b0">evalKey</a> (  <font class="keyword">const</font> CKeyT* previous, <font class="keyword">const</font> CKeyT* next,
00069                                                         CAnimationTime datePrevious, CAnimationTime dateNext,
00070                                                         CAnimationTime date )<font class="keyword">
</font>00071 <font class="keyword">        </font>{
00072                 <font class="keywordflow">if</font>(previous &amp;&amp; next &amp;&amp; !previous-&gt;Step)
00073                 {
00074                         <font class="comment">// lerp from previous to cur.</font>
00075                         date-= datePrevious;
00076                         date*= previous-&gt;OODeltaTime;
00077                         <a class="code" href="namespace_NLMISC.html#a177">NLMISC::clamp</a>(date, 0,1);
00078 
00079                         <font class="comment">// Bezier interpolation.</font>
00080                         <font class="keywordtype">float</font> s= date;
00081                         <font class="keywordtype">float</font> s2 = s * s;
00082                         <font class="keywordtype">float</font> s3 = s2 * s;
00083                         <font class="keywordtype">float</font> u = 1.0f - s;
00084                         <font class="keywordtype">float</font> u2 = u * u;
00085                         <font class="keywordtype">float</font> u3 = u2 * u;
00086 
00087                         <font class="comment">// compute Bezier control points from tangents.</font>
00088                         TKeyValueType   cp0, cp1;
00089 
00090                         <font class="comment">// NB: loop case: dateNext is always &gt; datePrevious....</font>
00091                         cp0 =   previous-&gt;Value + previous-&gt;OutTan * (dateNext-datePrevious) / 3.0f;
00092                         cp1 =   next-&gt;Value + next-&gt;InTan * (dateNext-datePrevious) / 3.0f;
00093                         
00094                         copyToValue(_Value.Value, previous-&gt;Value*u3 + cp0*3.0f*u2*s
00095                                 + cp1*3.0f*u*s2 + next-&gt;Value*s3);
00096                 }
00097                 <font class="keywordflow">else</font>
00098                 {
00099                         <font class="keywordflow">if</font> (previous)
00100                                 copyToValue(_Value.Value, previous-&gt;Value);
00101                         <font class="keywordflow">else</font>
00102                                 <font class="keywordflow">if</font> (next)
00103                                         copyToValue(_Value.Value, next-&gt;Value);
00104                 }
00105         }
00106 
<a name="l00108"></a><a class="code" href="class_CTrackKeyFramerBezier.html#b1">00108</a>         <font class="keyword">virtual</font> <font class="keywordtype">void</font> <a class="code" href="class_CTrackKeyFramerBezier.html#b1">compile</a>()<font class="keyword">
</font>00109 <font class="keyword">        </font>{
00110                 ITrackKeyFramer&lt;CKeyT&gt;::compile();
00111 
00112                 <font class="comment">// Nothing else to do!! Tangents are given from user.</font>
00113         }
00114 
00115         <font class="comment">// @}</font>
00116 
00117 <font class="keyword">private</font>:
<a name="l00118"></a><a class="code" href="class_CTrackKeyFramerBezier.html#o0">00118</a>         CAnimatedValueBlendable&lt;T&gt;      _Value;
00119 };
00120 
00121 
00122 
00123 <font class="comment">// ***************************************************************************
</font><a name="l00131"></a><a class="code" href="class_CTrackKeyFramerBezier_ltCKeyBezierQuat_x_CQuat_gt.html">00131</a> <font class="comment"></font><font class="keyword">class </font><a class="code" href="class_CTrackKeyFramerBezier.html">CTrackKeyFramerBezier</a>&lt;CKeyBezierQuat, CQuat&gt; : <font class="keyword">public</font> <a class="code" href="class_ITrackKeyFramer.html">ITrackKeyFramer</a>&lt;CKeyBezierQuat&gt;
00132 {
00133 <font class="keyword">public</font>:
00134 
<a name="l00136"></a><a class="code" href="class_CTrackKeyFramerBezier_ltCKeyBezierQuat_x_CQuat_gt.html#a0">00136</a>         <font class="keyword">virtual</font> <font class="keyword">const</font> IAnimatedValue&amp; getValue ()<font class="keyword"> const
</font>00137 <font class="keyword">        </font>{
00138                 <font class="keywordflow">return</font> _Value;
00139         }
00140         
00141 <font class="keyword">protected</font>:
00142 
00144         <font class="comment">// @{</font>
00145 
<a name="l00147"></a><a class="code" href="class_CTrackKeyFramerBezier_ltCKeyBezierQuat_x_CQuat_gt.html#b0">00147</a>         <font class="keyword">virtual</font> <font class="keywordtype">void</font> evalKey (  <font class="keyword">const</font> CKeyBezierQuat* previous, <font class="keyword">const</font> CKeyBezierQuat* next,
00148                                                         CAnimationTime datePrevious, CAnimationTime dateNext,
00149                                                         CAnimationTime date )<font class="keyword">
</font>00150 <font class="keyword">        </font>{
00151                 <font class="keywordflow">if</font>(previous &amp;&amp; next)
00152                 {
00153                         <font class="comment">// lerp from previous to cur.</font>
00154                         date-= datePrevious;
00155                         date*= previous-&gt;OODeltaTime;
00156                         <a class="code" href="namespace_NLMISC.html#a177">NLMISC::clamp</a>(date, 0,1);
00157 
00158                         <font class="comment">// quad slerp.</font>
00159                         _Value.Value = CQuat::squad(previous-&gt;Value, previous-&gt;A, next-&gt;A, next-&gt;Value, date);  
00160                 }
00161                 <font class="keywordflow">else</font>
00162                 {
00163                         <font class="keywordflow">if</font> (previous)
00164                                 copyToValue(_Value.Value, previous-&gt;Value);
00165                         <font class="keywordflow">else</font>
00166                                 <font class="keywordflow">if</font> (next)
00167                                         copyToValue(_Value.Value, next-&gt;Value);
00168                 }
00169         }
00170 
<a name="l00172"></a><a class="code" href="class_CTrackKeyFramerBezier_ltCKeyBezierQuat_x_CQuat_gt.html#b1">00172</a>         <font class="keyword">virtual</font> <font class="keywordtype">void</font> compile()<font class="keyword">
</font>00173 <font class="keyword">        </font>{
00174                 ITrackKeyFramer&lt;CKeyBezierQuat&gt;::compile();
00175 
00176                 <font class="comment">// makeclosest quaternions, Tangents Precompute.</font>
00177                 sint    nKeys= _MapKey.size();
00178                 <font class="keywordflow">if</font>(nKeys&lt;=1)
00179                         <font class="keywordflow">return</font>;
00180 
00181                 TMapTimeCKey::iterator  it;
00182                 TMapTimeCKey::iterator  itNext;
00183                 TMapTimeCKey::iterator  itPrev;
00184 
00185                 it= _MapKey.begin();                            <font class="comment">// first key.</font>
00186                 itNext= it;     itNext++;                               <font class="comment">// second key.</font>
00187                 itPrev= _MapKey.end();                          <font class="comment">// end key.</font>
00188 
00189                 <font class="comment">// Compute all keys.</font>
00190                 <font class="keywordflow">for</font>(;it!=_MapKey.end();)
00191                 {
00192 
00193                         CKeyBezierQuat  &amp;key= it-&gt;second;
00194                         CQuat   &amp;cur= key.Value;
00195 
00196                         <font class="keywordflow">if</font>(itPrev!= _MapKey.end())
00197                         {
00198                                 cur.makeClosest(itPrev-&gt;second.Value);
00199                         }
00200 
00201                         CQuat   prev, next;
00202 
00203                         <font class="comment">// compute prev / next.</font>
00204                         <font class="keywordflow">if</font>(itPrev!= _MapKey.end())
00205                                 prev= itPrev-&gt;second.Value;
00206                         <font class="keywordflow">else</font>
00207                                 prev= itNext-&gt;second.Value;
00208                         <font class="keywordflow">if</font>(itNext!= _MapKey.end())
00209                                 next= itNext-&gt;second.Value;
00210                         <font class="keywordflow">else</font>
00211                                 next= itPrev-&gt;second.Value;
00212 
00213                         <font class="comment">// Compute A.</font>
00214                         CQuat qm,qp,r;
00215 
00216                         qm = CQuat::lnDif(cur, prev);
00217                         qp = CQuat::lnDif(cur, next);
00218                         r = -.25f*(qm+qp);
00219                         key.A= cur*(r.exp());
00220 
00221                         <font class="comment">// Next key!!</font>
00222                         itPrev= it;
00223                         it++;
00224 
00225                         <font class="keywordflow">if</font>(itNext!= _MapKey.end())
00226                                 itNext++;
00227                 }
00228 
00229         }
00230 
00231         <font class="comment">// @}</font>
00232 
00233 <font class="keyword">private</font>:
<a name="l00234"></a><a class="code" href="class_CTrackKeyFramerBezier_ltCKeyBezierQuat_x_CQuat_gt.html#o0">00234</a>         CAnimatedValueBlendable&lt;CQuat&gt;  _Value;
00235 };
</div></pre>

<!-- footer -->
<BR><FONT Size=+5>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </FONT>
</TD>
<TD WIDTH=15><IMG  SRC=/inc/img/pixel.gif WIDTH=15 HEIGHT=15 BORDER=0 ALT=""></TD>
</TR>
</TABLE>
</BODY>
</HTML>