00001 /* 00002 ----------------------------------------------------------------------------- 00003 This source file is part of OGRE 00004 (Object-oriented Graphics Rendering Engine) 00005 For the latest info, see http://www.ogre3d.org/ 00006 00007 Copyright (c) 2000-2006 Torus Knot Software Ltd 00008 Also see acknowledgements in Readme.html 00009 00010 This program is free software; you can redistribute it and/or modify it under 00011 the terms of the GNU Lesser General Public License as published by the Free Software 00012 Foundation; either version 2 of the License, or (at your option) any later 00013 version. 00014 00015 This program is distributed in the hope that it will be useful, but WITHOUT 00016 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 00017 FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. 00018 00019 You should have received a copy of the GNU Lesser General Public License along with 00020 this program; if not, write to the Free Software Foundation, Inc., 59 Temple 00021 Place - Suite 330, Boston, MA 02111-1307, USA, or go to 00022 http://www.gnu.org/copyleft/lesser.txt. 00023 00024 You may alternatively use this source under the terms of a specific version of 00025 the OGRE Unrestricted License provided you have obtained such a license from 00026 Torus Knot Software Ltd. 00027 ----------------------------------------------------------------------------- 00028 */ 00029 00030 #ifndef __RibbonTrail_H__ 00031 #define __RibbonTrail_H__ 00032 00033 #include "OgrePrerequisites.h" 00034 00035 #include "OgreBillboardChain.h" 00036 #include "OgreNode.h" 00037 #include "OgreIteratorWrappers.h" 00038 #include "OgreFrameListener.h" 00039 #include "OgreControllerManager.h" 00040 00041 namespace Ogre { 00042 00065 class _OgreExport RibbonTrail : public BillboardChain, public Node::Listener 00066 { 00067 public: 00077 RibbonTrail(const String& name, size_t maxElements = 20, size_t numberOfChains = 1, 00078 bool useTextureCoords = true, bool useColours = true); 00080 virtual ~RibbonTrail(); 00081 00082 typedef std::vector<Node*> NodeList; 00083 typedef ConstVectorIterator<NodeList> NodeIterator; 00084 00088 virtual void addNode(Node* n); 00090 virtual void removeNode(Node* n); 00092 virtual NodeIterator getNodeIterator(void) const; 00093 00100 virtual void setTrailLength(Real len); 00102 virtual Real getTrailLength(void) const { return mTrailLength; } 00103 00105 void setMaxChainElements(size_t maxElements); 00107 void setNumberOfChains(size_t numChains); 00109 void clearChain(size_t chainIndex); 00110 00117 virtual void setInitialColour(size_t chainIndex, const ColourValue& col); 00124 virtual void setInitialColour(size_t chainIndex, Real r, Real g, Real b, Real a = 1.0); 00126 virtual const ColourValue& getInitialColour(size_t chainIndex) const; 00127 00132 virtual void setColourChange(size_t chainIndex, const ColourValue& valuePerSecond); 00133 00138 virtual void setInitialWidth(size_t chainIndex, Real width); 00140 virtual Real getInitialWidth(size_t chainIndex) const; 00141 00146 virtual void setWidthChange(size_t chainIndex, Real widthDeltaPerSecond); 00148 virtual Real getWidthChange(size_t chainIndex) const; 00149 00154 virtual void setColourChange(size_t chainIndex, Real r, Real g, Real b, Real a); 00155 00157 virtual const ColourValue& getColourChange(size_t chainIndex) const; 00158 00160 void nodeUpdated(const Node* node); 00162 void nodeDestroyed(const Node* node); 00163 00165 virtual void _timeUpdate(Real time); 00166 00168 const String& getMovableType(void) const; 00169 00170 protected: 00172 NodeList mNodeList; 00174 Real mTrailLength; 00176 Real mElemLength; 00178 Real mSquaredElemLength; 00179 typedef std::vector<ColourValue> ColourValueList; 00180 typedef std::vector<Real> RealList; 00182 ColourValueList mInitialColour; 00184 ColourValueList mDeltaColour; 00186 RealList mInitialWidth; 00188 RealList mDeltaWidth; 00190 Controller<Real>* mFadeController; 00192 ControllerValueRealPtr mTimeControllerValue; 00193 00195 virtual void manageController(void); 00197 virtual void updateTrail(size_t index, const Node* node); 00199 virtual void resetTrail(size_t index, const Node* node); 00201 virtual void resetAllTrails(void); 00202 00203 }; 00204 00205 00207 class _OgreExport RibbonTrailFactory : public MovableObjectFactory 00208 { 00209 protected: 00210 MovableObject* createInstanceImpl( const String& name, const NameValuePairList* params); 00211 public: 00212 RibbonTrailFactory() {} 00213 ~RibbonTrailFactory() {} 00214 00215 static String FACTORY_TYPE_NAME; 00216 00217 const String& getType(void) const; 00218 void destroyInstance( MovableObject* obj); 00219 00220 }; 00221 00222 } 00223 00224 #endif
Copyright © 2000-2005 by The OGRE Team
This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.
Last modified Mon Aug 20 13:50:47 2007