2002-10-12 11:37:38 +00:00
|
|
|
/**
|
|
|
|
* @mainpage SG_ParentRelation
|
|
|
|
|
|
|
|
* @section
|
|
|
|
*
|
|
|
|
* This is an abstract interface class to the Scene Graph library.
|
|
|
|
* It allows you to specify how child nodes react to parent nodes.
|
|
|
|
* Normally a child will use it's parent's transforms to compute
|
|
|
|
* it's own global transforms. How this is performed depends on
|
|
|
|
* the type of relation. For example if the parent is a vertex
|
|
|
|
* parent to this child then the child should not inherit any
|
|
|
|
* rotation information from the parent. Or if the parent is a
|
|
|
|
* 'slow parent' to this child then the child should react
|
|
|
|
* slowly to changes in the parent's position. The exact relation
|
|
|
|
* is left for you to implement by filling out this interface
|
|
|
|
* with concrete examples.
|
|
|
|
*
|
|
|
|
* There is exactly one SG_ParentRelation per SG_Node. Subclasses
|
|
|
|
* should not be value types and should be allocated on the heap.
|
|
|
|
*
|
|
|
|
* $Id$
|
|
|
|
*
|
2008-04-16 22:40:48 +00:00
|
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
* 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
|
2008-04-16 22:40:48 +00:00
|
|
|
* of the License, or (at your option) any later version.
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
* 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.
|
|
|
|
*
|
2008-04-16 22:40:48 +00:00
|
|
|
* ***** END GPL LICENSE BLOCK *****
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __SG_ParentRelation_h
|
|
|
|
#define __SG_ParentRelation_h
|
|
|
|
|
|
|
|
class SG_Spatial;
|
|
|
|
|
|
|
|
class SG_ParentRelation {
|
|
|
|
|
|
|
|
public :
|
|
|
|
/**
|
|
|
|
* Update the childs local and global coordinates
|
|
|
|
* based upon the parents global coordinates.
|
|
|
|
* You must also handle the case when this node has no
|
|
|
|
* parent (parent == NULL). Usually you should just
|
|
|
|
* copy the local coordinates of the child to the
|
|
|
|
* world coordinates.
|
|
|
|
*/
|
|
|
|
|
|
|
|
virtual
|
2004-05-26 12:06:41 +00:00
|
|
|
bool
|
2002-10-12 11:37:38 +00:00
|
|
|
UpdateChildCoordinates(
|
|
|
|
SG_Spatial * child,
|
2009-04-20 15:06:46 +00:00
|
|
|
const SG_Spatial * parent,
|
|
|
|
bool& parentUpdated
|
2002-10-12 11:37:38 +00:00
|
|
|
) = 0;
|
|
|
|
|
|
|
|
virtual
|
|
|
|
~SG_ParentRelation(
|
|
|
|
){
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* You must provide a way of duplicating an
|
|
|
|
* instance of an SG_ParentRelation. This should
|
|
|
|
* return a pointer to a new duplicate allocated
|
|
|
|
* on the heap. Responsibilty for deleting the
|
|
|
|
* duplicate resides with the caller of this method.
|
|
|
|
*/
|
|
|
|
|
|
|
|
virtual
|
|
|
|
SG_ParentRelation *
|
|
|
|
NewCopy(
|
|
|
|
) = 0;
|
|
|
|
|
2008-05-14 20:22:57 +00:00
|
|
|
/**
|
|
|
|
* Vertex Parent Relation are special: they don't propagate rotation
|
|
|
|
*/
|
|
|
|
virtual
|
|
|
|
bool
|
|
|
|
IsVertexRelation(
|
|
|
|
) {
|
|
|
|
return false;
|
|
|
|
}
|
2008-06-14 17:12:49 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Need this to see if we are able to adjust time-offset from the python api
|
|
|
|
*/
|
|
|
|
virtual
|
|
|
|
bool
|
|
|
|
IsSlowRelation(
|
|
|
|
) {
|
|
|
|
return false;
|
|
|
|
}
|
2002-10-12 11:37:38 +00:00
|
|
|
protected :
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Protected constructors
|
|
|
|
* this class is not meant to be instantiated.
|
|
|
|
*/
|
|
|
|
|
|
|
|
SG_ParentRelation(
|
|
|
|
) {
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Copy construction should not be implemented
|
|
|
|
*/
|
|
|
|
|
|
|
|
SG_ParentRelation(
|
|
|
|
const SG_ParentRelation &
|
|
|
|
);
|
2009-08-18 15:37:31 +00:00
|
|
|
|
|
|
|
|
|
|
|
#ifdef WITH_CXX_GUARDEDALLOC
|
|
|
|
public:
|
|
|
|
void *operator new( unsigned int num_bytes) { return MEM_mallocN(num_bytes, "GE:SG_ParentRelation"); }
|
|
|
|
void operator delete( void *mem ) { MEM_freeN(mem); }
|
|
|
|
#endif
|
2002-10-12 11:37:38 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|
2002-10-30 02:07:20 +00:00
|
|
|
|