blender/source/gameengine/Ketsji/KX_IPO_SGController.h
Benoit Bolsee 3444d6612a Delta Loc/Rot/Scale Ipo curve are now supporting in the BGE with the following limitations:
1. All Ipo channels are now independent. 
In Blender 2.45, all 3 Loc Ipo channels were automatically set
together. For example, having just a LocX Ipo channel was sufficient
to fix the X, Y and Z coordinates, with the Y and Z value taken
from the object original Y and Z location in Blender. The same
was true for the 3 Rot and the 3 Scale Ipo channels: the missing
channels were assumed to have constant value taken from the object
original orientation/scale in Blender.
With this patch, all Ipo channels are now independent. 
THIS WILL CREATE BACKWARD COMPATIBILITY PROBLEM if you omit to
define the 3 channels of a same type together in your Blend file:
the undefined Loc, Rot, Scale coordinates of the object will
be influenced by the parent/spawner Loc/Rot/Scale in case the
object is a child or dynamically created.

2. Delta Loc, Rot, Scale are now supported with the following
limitations:
- The delta Loc/Rot Ipo modify the object global (NOT local)
location/orientation
- The delta Scale change the object local scale
- The delta Ipo curves are relative to the object starting
Loc/Rot/Scale when the Ipo was first activated; after that, the
delta Ipo becomes global. This means that the object will return
to this initial Loc/Rot/Scale when you later restart the Ipo
curve, even if you had changed the object Loc/Rot/Scale in the
meantime. Of course this applies only to the specific Loc/Rot/Scale
coordinate that are defined in the Ipo channels as the channels
are now independent.

3. When the objects are converted from Blender to the BGE, the
delta Loc/Rot/Scale that might result from initial non-zero values
in delta Ipo Curves will be ignored. However, as soon as the
delta Ipo curve is activated, the non-zero values will be taken
into account and the object will jump to the same Loc/Rot/Scale
situation as in Blender. Note that delta Ipo curves with initial
non-zero values is bad practice; logically, a delta Ipo curver
should always start from 0.

4. If you define both a global and delta channel of the same
type (LocX and DLocX), the result will be a global channel equivalent
to the sum of the two channels (LocX+DLocX).
2008-03-12 21:33:24 +00:00

118 lines
3.2 KiB
C++

/**
* $Id$
*
* ***** BEGIN GPL/BL DUAL LICENSE BLOCK *****
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version. The Blender
* Foundation also sells licenses for use in proprietary software under
* the Blender License. See http://www.blender.org/BL/ for information
* about this.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software Foundation,
* Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*
* The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
* All rights reserved.
*
* The Original Code is: all of this file.
*
* Contributor(s): none yet.
*
* ***** END GPL/BL DUAL LICENSE BLOCK *****
*/
#ifndef __IPO_SGCONTROLLER_H
#define __IPO_SGCONTROLLER_H
#include "SG_Controller.h"
#include "SG_Spatial.h"
#include "KX_IPOTransform.h"
#include "KX_IInterpolator.h"
#define KX_MAX_IPO_CHANNELS 19 //note- [0] is not used
class KX_IpoSGController : public SG_Controller
{
KX_IPOTransform m_ipo_xform;
T_InterpolatorList m_interpolators;
/** Flag for each IPO channel that can be applied to a game object */
bool m_ipo_channels_active[KX_MAX_IPO_CHANNELS];
/** Interpret the ipo as a force rather than a displacement? */
bool m_ipo_as_force;
/** Ipo-as-force acts in local rather than in global coordinates? */
bool m_force_ipo_acts_local;
/** Were settings altered since the last update? */
bool m_modified;
/** Local time of this ipo.*/
double m_ipotime;
/** Location of the object when the IPO is first fired (for local transformations) */
class MT_Point3 m_ipo_start_point;
/** Orientation of the object when the IPO is first fired (for local transformations) */
class MT_Matrix3x3 m_ipo_start_orient;
/** Scale of the object when the IPO is first fired (for local transformations) */
class MT_Vector3 m_ipo_start_scale;
/** if IPO initial position has been set for local normal IPO */
bool m_ipo_start_initialized;
/** A reference to the original game object. */
class KX_GameObject* m_game_object;
public:
KX_IpoSGController();
virtual ~KX_IpoSGController();
virtual SG_Controller* GetReplica(class SG_Node* destnode);
void
SetOption(
int option,
int value
);
/** Set sumo data. */
void UpdateSumoReference();
/** Set reference to the corresponding game object. */
void SetGameObject(class KX_GameObject*);
void SetIPOChannelActive(int index, bool value) {
//indexes found in makesdna\DNA_ipo_types.h
m_ipo_channels_active[index] = value;
}
KX_IPOTransform& GetIPOTransform()
{
return m_ipo_xform;
}
void AddInterpolator(KX_IInterpolator* interp);
virtual bool Update(double time);
virtual void SetSimulatedTime(double time)
{
m_ipotime = time;
m_modified = true;
}
};
#endif //__IPO_SGCONTROLLER_H