remove python2.x support
[blender.git] / source / gameengine / Ketsji / KX_CameraActuator.cpp
1 /**
2  * KX_CameraActuator.cpp
3  *
4  * $Id$
5  *
6  * ***** BEGIN GPL LICENSE BLOCK *****
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software Foundation,
20  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
21  *
22  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
23  * All rights reserved.
24  *
25  * The Original Code is: all of this file.
26  *
27  * Contributor(s): none yet.
28  *
29  * ***** END GPL LICENSE BLOCK *****
30  *
31  */
32
33 #include "KX_CameraActuator.h"
34 #include <iostream>
35 #include <math.h>
36 #include <float.h>
37 #include "KX_GameObject.h"
38
39 #include "PyObjectPlus.h" 
40
41 STR_String KX_CameraActuator::X_AXIS_STRING = "x";
42 STR_String KX_CameraActuator::Y_AXIS_STRING = "y";
43
44 #ifdef HAVE_CONFIG_H
45 #include <config.h>
46 #endif
47
48
49 /* ------------------------------------------------------------------------- */
50 /* Native functions                                                          */
51 /* ------------------------------------------------------------------------- */
52
53 KX_CameraActuator::KX_CameraActuator(
54         SCA_IObject* gameobj, 
55         SCA_IObject *obj,
56         float hght,
57         float minhght,
58         float maxhght,
59         bool  xytog
60 ): 
61         SCA_IActuator(gameobj),
62         m_ob (obj),
63         m_height (hght),
64         m_minHeight (minhght),
65         m_maxHeight (maxhght),
66         m_x (xytog)
67 {
68         if (m_ob)
69                 m_ob->RegisterActuator(this);
70 }
71
72 KX_CameraActuator::~KX_CameraActuator()
73 {
74         if (m_ob)
75                 m_ob->UnregisterActuator(this);
76 }
77
78         CValue* 
79 KX_CameraActuator::
80 GetReplica(
81 ) {
82         KX_CameraActuator* replica = new KX_CameraActuator(*this);
83         replica->ProcessReplica();
84         return replica;
85 };
86
87 void KX_CameraActuator::ProcessReplica()
88 {
89         if (m_ob)
90                 m_ob->RegisterActuator(this);
91         SCA_IActuator::ProcessReplica();
92 }
93
94 bool KX_CameraActuator::UnlinkObject(SCA_IObject* clientobj)
95 {
96         if (clientobj == m_ob)
97         {
98                 // this object is being deleted, we cannot continue to track it.
99                 m_ob = NULL;
100                 return true;
101         }
102         return false;
103 }
104
105
106 void KX_CameraActuator::Relink(GEN_Map<GEN_HashedPtr, void*> *obj_map)
107 {
108         void **h_obj = (*obj_map)[m_ob];
109         if (h_obj) {
110                 if (m_ob)
111                         m_ob->UnregisterActuator(this);
112                 m_ob = (SCA_IObject*)(*h_obj);
113                 m_ob->RegisterActuator(this);
114         }
115 }
116
117 /* three functions copied from blender arith... don't know if there's an equivalent */
118
119 static float Kx_Normalize(float *n)
120 {
121         float d;
122         
123         d= n[0]*n[0]+n[1]*n[1]+n[2]*n[2];
124         /* FLT_EPSILON is too large! A larger value causes normalize errors in a scaled down utah teapot */
125         if(d>0.0000000000001) {
126                 d= sqrt(d);
127
128                 n[0]/=d; 
129                 n[1]/=d; 
130                 n[2]/=d;
131         } else {
132                 n[0]=n[1]=n[2]= 0.0;
133                 d= 0.0;
134         }
135         return d;
136 }
137
138 static void Kx_Crossf(float *c, float *a, float *b)
139 {
140         c[0] = a[1] * b[2] - a[2] * b[1];
141         c[1] = a[2] * b[0] - a[0] * b[2];
142         c[2] = a[0] * b[1] - a[1] * b[0];
143 }
144
145
146 static void Kx_VecUpMat3(float *vec, float mat[][3], short axis)
147 {
148
149         // Construct a camera matrix s.t. the specified axis
150
151         // maps to the given vector (*vec). Also defines the rotation
152
153         // about this axis by mapping one of the other axis to the y-axis.
154
155
156         float inp;
157         short cox = 0, coy = 0, coz = 0;
158         
159         /* up varieeren heeft geen zin, is eigenlijk helemaal geen up!
160          * zie VecUpMat3old
161          */
162
163         if(axis==0) {
164                 cox= 0; coy= 1; coz= 2;         /* Y up Z tr */
165         }
166         if(axis==1) {
167                 cox= 1; coy= 2; coz= 0;         /* Z up X tr */
168         }
169         if(axis==2) {
170                 cox= 2; coy= 0; coz= 1;         /* X up Y tr */
171         }
172         if(axis==3) {
173                 cox= 0; coy= 1; coz= 2;         /* Y op -Z tr */
174                 vec[0]= -vec[0];
175                 vec[1]= -vec[1];
176                 vec[2]= -vec[2];
177         }
178         if(axis==4) {
179                 cox= 1; coy= 0; coz= 2;         /*  */
180         }
181         if(axis==5) {
182                 cox= 2; coy= 1; coz= 0;         /* Y up X tr */
183         }
184
185         mat[coz][0]= vec[0];
186         mat[coz][1]= vec[1];
187         mat[coz][2]= vec[2];
188         if (Kx_Normalize((float *)mat[coz]) == 0.f) {
189                 /* this is a very abnormal situation: the camera has reach the object center exactly
190                    We will choose a completely arbitrary direction */
191                 mat[coz][0] = 1.0f;
192                 mat[coz][1] = 0.0f;
193                 mat[coz][2] = 0.0f;
194         }
195         
196         inp= mat[coz][2];
197         mat[coy][0]= - inp*mat[coz][0];
198         mat[coy][1]= - inp*mat[coz][1];
199         mat[coy][2]= 1.0 - inp*mat[coz][2];
200
201         if (Kx_Normalize((float *)mat[coy]) == 0.f) {
202                 /* the camera is vertical, chose the y axis arbitrary */
203                 mat[coy][0] = 0.f;
204                 mat[coy][1] = 1.f;
205                 mat[coy][2] = 0.f;
206         }
207         
208         Kx_Crossf(mat[cox], mat[coy], mat[coz]);
209         
210 }
211
212 bool KX_CameraActuator::Update(double curtime, bool frame)
213 {
214         /* wondering... is it really neccesary/desirable to suppress negative    */
215         /* events here?                                                          */
216         bool bNegativeEvent = IsNegativeEvent();
217         RemoveAllEvents();
218
219         if (bNegativeEvent || !m_ob) 
220                 return false;
221         
222         KX_GameObject *obj = (KX_GameObject*) GetParent();
223         MT_Point3 from = obj->NodeGetWorldPosition();
224         MT_Matrix3x3 frommat = obj->NodeGetWorldOrientation();
225         /* These casts are _very_ dangerous!!! */
226         MT_Point3 lookat = ((KX_GameObject*)m_ob)->NodeGetWorldPosition();
227         MT_Matrix3x3 actormat = ((KX_GameObject*)m_ob)->NodeGetWorldOrientation();
228
229         float fp1[3], fp2[3], rc[3];
230         float inp, fac; //, factor = 0.0; /* some factor...                                    */
231         float mindistsq, maxdistsq, distsq;
232         float mat[3][3];
233         
234         /* The rules:                                                            */
235         /* CONSTRAINT 1: not implemented */
236         /* CONSTRAINT 2: can camera see actor?              */
237         /* CONSTRAINT 3: fixed height relative to floor below actor.             */
238         /* CONSTRAINT 4: camera rotates behind actor                              */
239         /* CONSTRAINT 5: minimum / maximum distance                             */
240         /* CONSTRAINT 6: again: fixed height relative to floor below actor        */
241         /* CONSTRAINT 7: track to floor below actor                               */
242         /* CONSTRAINT 8: look a little bit left or right, depending on how the
243
244            character is looking (horizontal x)
245  */
246
247         /* ...and then set the camera position. Since we assume the parent of    */
248         /* this actuator is always a camera, just set the parent position and    */
249         /* rotation. We do not check whether we really have a camera as parent.  */
250         /* It may be better to turn this into a general tracking actuator later  */
251         /* on, since lots of plausible relations can be filled in here.          */
252
253         /* ... set up some parameters ...                                        */
254         /* missing here: the 'floorloc' of the actor's shadow */
255
256         mindistsq= m_minHeight*m_minHeight;
257         maxdistsq= m_maxHeight*m_maxHeight;
258
259         /* C1: not checked... is a future option                                 */
260
261         /* C2: blender test_visibility function. Can this be a ray-test?         */
262
263         /* C3: fixed height  */
264         from[2] = (15.0*from[2] + lookat[2] + m_height)/16.0;
265
266
267         /* C4: camera behind actor   */
268         if (m_x) {
269                 fp1[0] = actormat[0][0];
270                 fp1[1] = actormat[1][0];
271                 fp1[2] = actormat[2][0];
272
273                 fp2[0] = frommat[0][0];
274                 fp2[1] = frommat[1][0];
275                 fp2[2] = frommat[2][0];
276         } 
277         else {
278                 fp1[0] = actormat[0][1];
279                 fp1[1] = actormat[1][1];
280                 fp1[2] = actormat[2][1];
281
282                 fp2[0] = frommat[0][1];
283                 fp2[1] = frommat[1][1];
284                 fp2[2] = frommat[2][1];
285         }
286         
287         inp= fp1[0]*fp2[0] + fp1[1]*fp2[1] + fp1[2]*fp2[2];
288         fac= (-1.0 + inp)/32.0;
289
290         from[0]+= fac*fp1[0];
291         from[1]+= fac*fp1[1];
292         from[2]+= fac*fp1[2];
293         
294         /* alleen alstie ervoor ligt: cross testen en loodrechte bijtellen */
295         if(inp<0.0) {
296                 if(fp1[0]*fp2[1] - fp1[1]*fp2[0] > 0.0) {
297                         from[0]-= fac*fp1[1];
298                         from[1]+= fac*fp1[0];
299                 }
300                 else {
301                         from[0]+= fac*fp1[1];
302                         from[1]-= fac*fp1[0];
303                 }
304         }
305
306         /* CONSTRAINT 5: minimum / maximum afstand */
307
308         rc[0]= (lookat[0]-from[0]);
309         rc[1]= (lookat[1]-from[1]);
310         rc[2]= (lookat[2]-from[2]);
311         distsq= rc[0]*rc[0] + rc[1]*rc[1] + rc[2]*rc[2];
312
313         if(distsq > maxdistsq) {
314                 distsq = 0.15*(distsq-maxdistsq)/distsq;
315                 
316                 from[0] += distsq*rc[0];
317                 from[1] += distsq*rc[1];
318                 from[2] += distsq*rc[2];
319         }
320         else if(distsq < mindistsq) {
321                 distsq = 0.15*(mindistsq-distsq)/mindistsq;
322                 
323                 from[0] -= distsq*rc[0];
324                 from[1] -= distsq*rc[1];
325                 from[2] -= distsq*rc[2];
326         }
327
328
329         /* CONSTRAINT 7: track to schaduw */
330         rc[0]= (lookat[0]-from[0]);
331         rc[1]= (lookat[1]-from[1]);
332         rc[2]= (lookat[2]-from[2]);
333         Kx_VecUpMat3(rc, mat, 3);       /* y up Track -z */
334         
335
336
337
338         /* now set the camera position and rotation */
339         
340         obj->NodeSetLocalPosition(from);
341         
342         actormat[0][0]= mat[0][0]; actormat[0][1]= mat[1][0]; actormat[0][2]= mat[2][0];
343         actormat[1][0]= mat[0][1]; actormat[1][1]= mat[1][1]; actormat[1][2]= mat[2][1];
344         actormat[2][0]= mat[0][2]; actormat[2][1]= mat[1][2]; actormat[2][2]= mat[2][2];
345         obj->NodeSetLocalOrientation(actormat);
346
347         return true;
348 }
349
350 CValue *KX_CameraActuator::findObject(char *obName) 
351 {
352         /* hook to object system */
353         return NULL;
354 }
355
356 bool KX_CameraActuator::string2axischoice(const char *axisString) 
357 {
358         bool res = true;
359
360         res = !(axisString == Y_AXIS_STRING);
361
362         return res;
363 }
364
365 /* ------------------------------------------------------------------------- */
366 /* Python functions                                                          */
367 /* ------------------------------------------------------------------------- */
368
369 /* Integration hooks ------------------------------------------------------- */
370 PyTypeObject KX_CameraActuator::Type = {
371         PyVarObject_HEAD_INIT(NULL, 0)
372         "KX_CameraActuator",
373         sizeof(PyObjectPlus_Proxy),
374         0,
375         py_base_dealloc,
376         0,
377         0,
378         0,
379         0,
380         py_base_repr,
381         0,0,0,0,0,0,0,0,0,
382         Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
383         0,0,0,0,0,0,0,
384         Methods,
385         0,
386         0,
387         &SCA_IActuator::Type,
388         0,0,0,0,0,0,
389         py_base_new
390 };
391
392 PyMethodDef KX_CameraActuator::Methods[] = {
393         // ---> deprecated (all)
394         {"setObject",(PyCFunction) KX_CameraActuator::sPySetObject, METH_O,                     (const char *)SetObject_doc},
395         {"getObject",(PyCFunction) KX_CameraActuator::sPyGetObject, METH_VARARGS,       (const char *)GetObject_doc},
396         {"setMin"       ,(PyCFunction) KX_CameraActuator::sPySetMin,    METH_VARARGS,   (const char *)SetMin_doc},
397         {"getMin"       ,(PyCFunction) KX_CameraActuator::sPyGetMin,    METH_NOARGS,    (const char *)GetMin_doc},
398         {"setMax"       ,(PyCFunction) KX_CameraActuator::sPySetMax,    METH_VARARGS,   (const char *)SetMax_doc},
399         {"getMax"       ,(PyCFunction) KX_CameraActuator::sPyGetMax,    METH_NOARGS,    (const char *)GetMax_doc},
400         {"setHeight",(PyCFunction) KX_CameraActuator::sPySetHeight,     METH_VARARGS,   (const char *)SetHeight_doc},
401         {"getHeight",(PyCFunction) KX_CameraActuator::sPyGetHeight,     METH_NOARGS,    (const char *)GetHeight_doc},
402         {"setXY"        ,(PyCFunction) KX_CameraActuator::sPySetXY,             METH_VARARGS,   (const char *)SetXY_doc},
403         {"getXY"        ,(PyCFunction) KX_CameraActuator::sPyGetXY,             METH_NOARGS,    (const char *)GetXY_doc},
404         {NULL,NULL,NULL,NULL} //Sentinel
405 };
406
407 PyAttributeDef KX_CameraActuator::Attributes[] = {
408         KX_PYATTRIBUTE_FLOAT_RW("min",-FLT_MAX,FLT_MAX,KX_CameraActuator,m_minHeight),
409         KX_PYATTRIBUTE_FLOAT_RW("max",-FLT_MAX,FLT_MAX,KX_CameraActuator,m_maxHeight),
410         KX_PYATTRIBUTE_FLOAT_RW("height",-FLT_MAX,FLT_MAX,KX_CameraActuator,m_height),
411         KX_PYATTRIBUTE_BOOL_RW("useXY",KX_CameraActuator,m_x),
412         KX_PYATTRIBUTE_RW_FUNCTION("object", KX_CameraActuator, pyattr_get_object,      pyattr_set_object),
413         {NULL}
414 };
415
416 /* get obj  ---------------------------------------------------------- */
417 const char KX_CameraActuator::GetObject_doc[] = 
418 "getObject(name_only = 1)\n"
419 "name_only - optional arg, when true will return the KX_GameObject rather then its name\n"
420 "\tReturns the object this sensor reacts to.\n";
421 PyObject* KX_CameraActuator::PyGetObject(PyObject* args)
422 {
423         int ret_name_only = 1;
424         
425         ShowDeprecationWarning("getObject()", "the object property");
426         
427         if (!PyArg_ParseTuple(args, "|i:getObject", &ret_name_only))
428                 return NULL;
429         
430         if (!m_ob)
431                 Py_RETURN_NONE;
432         
433         if (ret_name_only)
434                 return PyUnicode_FromString(m_ob->GetName().ReadPtr());
435         else
436                 return m_ob->GetProxy();
437 }
438 /* set obj  ---------------------------------------------------------- */
439 const char KX_CameraActuator::SetObject_doc[] = 
440 "setObject(object)\n"
441 "\t- object: KX_GameObject, string or None\n"
442 "\tSets the object this sensor reacts to.\n";
443 PyObject* KX_CameraActuator::PySetObject(PyObject* value)
444 {
445         KX_GameObject *gameobj;
446         
447         ShowDeprecationWarning("setObject()", "the object property");
448         
449         if (!ConvertPythonToGameObject(value, &gameobj, true, "actuator.setObject(value): KX_CameraActuator"))
450                 return NULL; // ConvertPythonToGameObject sets the error
451         
452         if (m_ob != NULL)
453                 m_ob->UnregisterActuator(this); 
454
455         m_ob = (SCA_IObject*)gameobj;
456         if (m_ob)
457                 m_ob->RegisterActuator(this);
458         
459         Py_RETURN_NONE;
460 }
461
462 /* get min  ---------------------------------------------------------- */
463 const char KX_CameraActuator::GetMin_doc[] = 
464 "getMin\n"
465 "\tReturns the minimum value set in the Min: field.\n";
466 PyObject* KX_CameraActuator::PyGetMin()
467 {
468         ShowDeprecationWarning("getMin()", "the min property");
469         return PyFloat_FromDouble(m_minHeight);
470 }
471 /* set min  ---------------------------------------------------------- */
472 const char KX_CameraActuator::SetMin_doc[] = 
473 "setMin\n"
474 "\tSets the minimum value.\n";
475 PyObject* KX_CameraActuator::PySetMin(PyObject* args)
476 {
477         ShowDeprecationWarning("setMin()", "the min property");
478         float min;
479         if(PyArg_ParseTuple(args,"f:setMin", &min))
480         {
481                 m_minHeight = min;
482                 Py_RETURN_NONE;
483         }
484         return NULL;
485 }
486 /* get min  ---------------------------------------------------------- */
487 const char KX_CameraActuator::GetMax_doc[] = 
488 "getMax\n"
489 "\tReturns the maximum value set in the Max: field.\n";
490 PyObject* KX_CameraActuator::PyGetMax()
491 {
492         ShowDeprecationWarning("getMax()", "the max property");
493         return PyFloat_FromDouble(m_maxHeight);
494 }
495 /* set min  ---------------------------------------------------------- */
496 const char KX_CameraActuator::SetMax_doc[] = 
497 "setMax\n"
498 "\tSets the maximum value.\n";
499 PyObject* KX_CameraActuator::PySetMax(PyObject* args)
500 {
501         ShowDeprecationWarning("getMax()", "the max property");
502         float max;
503         if(PyArg_ParseTuple(args,"f:setMax", &max))
504         {
505                 m_maxHeight = max;
506                 Py_RETURN_NONE;
507         }
508         return NULL;
509 }
510 /* get height  ---------------------------------------------------------- */
511 const char KX_CameraActuator::GetHeight_doc[] = 
512 "getHeight\n"
513 "\tReturns the height value set in the height: field.\n";
514 PyObject* KX_CameraActuator::PyGetHeight()
515 {
516         ShowDeprecationWarning("getHeight()", "the height property");
517         return PyFloat_FromDouble(m_height);
518 }
519 /* set height  ---------------------------------------------------------- */
520 const char KX_CameraActuator::SetHeight_doc[] = 
521 "setHeight\n"
522 "\tSets the height value.\n";
523 PyObject* KX_CameraActuator::PySetHeight(PyObject* args)
524 {
525         ShowDeprecationWarning("getHeight()", "the height property");
526         float height;
527         if(PyArg_ParseTuple(args,"f:setHeight", &height))
528         {
529                 m_height = height;
530                 Py_RETURN_NONE;
531         }
532         return NULL;
533 }
534 /* set XY  ---------------------------------------------------------- */
535 const char KX_CameraActuator::SetXY_doc[] = 
536 "setXY\n"
537 "\tSets axis the camera tries to get behind.\n"
538 "\t1=x, 0=y\n";
539 PyObject* KX_CameraActuator::PySetXY(PyObject* args)
540 {
541         ShowDeprecationWarning("setXY()", "the useXY property");
542         int value;
543         if(PyArg_ParseTuple(args,"i:setXY", &value))
544         {
545                 m_x = value != 0;
546                 Py_RETURN_NONE;
547         }
548         return NULL;
549 }
550
551 /* get XY -------------------------------------------------------------*/
552 const char KX_CameraActuator::GetXY_doc[] =
553 "getXY\n"
554 "\tGets the axis the camera tries to get behind.\n"
555 "\tTrue = X, False = Y\n";
556 PyObject* KX_CameraActuator::PyGetXY()
557 {
558         ShowDeprecationWarning("getXY()", "the xy property");
559         return PyLong_FromSsize_t(m_x);
560 }
561
562 PyObject* KX_CameraActuator::pyattr_get_object(void *self_v, const KX_PYATTRIBUTE_DEF *attrdef)
563 {
564         KX_CameraActuator* self= static_cast<KX_CameraActuator*>(self_v);
565         if (self->m_ob==NULL)
566                 Py_RETURN_NONE;
567         else
568                 return self->m_ob->GetProxy();
569 }
570
571 int KX_CameraActuator::pyattr_set_object(void *self_v, const KX_PYATTRIBUTE_DEF *attrdef, PyObject *value)
572 {
573         KX_CameraActuator* self= static_cast<KX_CameraActuator*>(self_v);
574         KX_GameObject *gameobj;
575         
576         if (!ConvertPythonToGameObject(value, &gameobj, true, "actuator.object = value: KX_CameraActuator"))
577                 return PY_SET_ATTR_FAIL; // ConvertPythonToGameObject sets the error
578         
579         if (self->m_ob)
580                 self->m_ob->UnregisterActuator(self);   
581
582         if ((self->m_ob = (SCA_IObject*)gameobj))
583                 self->m_ob->RegisterActuator(self);
584         
585         return PY_SET_ATTR_SUCCESS;
586 }
587
588 /* eof */