/* ----------------------------------------------------------------------------- This source file is part of OGRE (Object-oriented Graphics Rendering Engine) For the latest info, see http://www.ogre3d.org/ Copyright (c) 2000-2009 Torus Knot Software Ltd Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ----------------------------------------------------------------------------- */ // Original author: Tels , released as public domain #include "OgreHollowEllipsoidEmitter.h" #include "OgreParticle.h" #include "OgreException.h" #include "OgreStringConverter.h" #include "OgreMath.h" /* Implements an Emitter whose emitting points all lie inside an ellipsoid. See for mathematical details. If the lengths of two axes of an ellipsoid are the same, the figure is called a 'spheroid' (depending on whether c < a or c > a, an 'oblate spheroid' or 'prolate spheroid', respectively), and if all three are the same, it is a 'sphere' (ball). */ namespace Ogre { HollowEllipsoidEmitter::CmdInnerX HollowEllipsoidEmitter::msCmdInnerX; HollowEllipsoidEmitter::CmdInnerY HollowEllipsoidEmitter::msCmdInnerY; HollowEllipsoidEmitter::CmdInnerZ HollowEllipsoidEmitter::msCmdInnerZ; //----------------------------------------------------------------------- HollowEllipsoidEmitter::HollowEllipsoidEmitter(ParticleSystem* psys) : EllipsoidEmitter(psys) { if (initDefaults("HollowEllipsoid")) { // Add custom parameters ParamDictionary* pDict = getParamDictionary(); pDict->addParameter(ParameterDef("inner_width", "Parametric value describing the proportion of the " "shape which is hollow.", PT_REAL), &msCmdInnerX); pDict->addParameter(ParameterDef("inner_height", "Parametric value describing the proportion of the " "shape which is hollow.", PT_REAL), &msCmdInnerY); pDict->addParameter(ParameterDef("inner_depth", "Parametric value describing the proportion of the " "shape which is hollow.", PT_REAL), &msCmdInnerZ); } // default is half empty setInnerSize(0.5,0.5,0.5); } //----------------------------------------------------------------------- void HollowEllipsoidEmitter::_initParticle(Particle* pParticle) { Real a, b, c, x, y, z; // Init dimensions pParticle->resetDimensions(); // create two random angles alpha and beta // with these two angles, we are able to select any point on an // ellipsoid's surface Radian alpha ( Math::RangeRandom(0,Math::TWO_PI) ); Radian beta ( Math::RangeRandom(0,Math::PI) ); // create three random radius values that are bigger than the inner // size, but smaller/equal than/to the outer size 1.0 (inner size is // between 0 and 1) a = Math::RangeRandom(mInnerSize.x,1.0); b = Math::RangeRandom(mInnerSize.y,1.0); c = Math::RangeRandom(mInnerSize.z,1.0); // with a,b,c we have defined a random ellipsoid between the inner // ellipsoid and the outer sphere (radius 1.0) // with alpha and beta we select on point on this random ellipsoid // and calculate the 3D coordinates of this point Real sinbeta ( Math::Sin(beta) ); x = a * Math::Cos(alpha) * sinbeta; y = b * Math::Sin(alpha) * sinbeta; z = c * Math::Cos(beta); // scale the found point to the ellipsoid's size and move it // relatively to the center of the emitter point pParticle->position = mPosition + + x * mXRange + y * mYRange + z * mZRange; // Generate complex data by reference genEmissionColour(pParticle->colour); genEmissionDirection(pParticle->direction); genEmissionVelocity(pParticle->direction); // Generate simpler data pParticle->timeToLive = pParticle->totalTimeToLive = genEmissionTTL(); } //----------------------------------------------------------------------- void HollowEllipsoidEmitter::setInnerSize(Real x, Real y, Real z) { assert((x > 0) && (x < 1.0) && (y > 0) && (y < 1.0) && (z > 0) && (z < 1.0)); mInnerSize.x = x; mInnerSize.y = y; mInnerSize.z = z; } //----------------------------------------------------------------------- void HollowEllipsoidEmitter::setInnerSizeX(Real x) { assert(x > 0 && x < 1.0); mInnerSize.x = x; } //----------------------------------------------------------------------- void HollowEllipsoidEmitter::setInnerSizeY(Real y) { assert(y > 0 && y < 1.0); mInnerSize.y = y; } //----------------------------------------------------------------------- void HollowEllipsoidEmitter::setInnerSizeZ(Real z) { assert(z > 0 && z < 1.0); mInnerSize.z = z; } //----------------------------------------------------------------------- Real HollowEllipsoidEmitter::getInnerSizeX(void) const { return mInnerSize.x; } //----------------------------------------------------------------------- Real HollowEllipsoidEmitter::getInnerSizeY(void) const { return mInnerSize.y; } //----------------------------------------------------------------------- Real HollowEllipsoidEmitter::getInnerSizeZ(void) const { return mInnerSize.z; } //----------------------------------------------------------------------- //----------------------------------------------------------------------- // Command objects //----------------------------------------------------------------------- //----------------------------------------------------------------------- String HollowEllipsoidEmitter::CmdInnerX::doGet(const void* target) const { return StringConverter::toString( static_cast(target)->getInnerSizeX() ); } void HollowEllipsoidEmitter::CmdInnerX::doSet(void* target, const String& val) { static_cast(target)->setInnerSizeX(StringConverter::parseReal(val)); } //----------------------------------------------------------------------- String HollowEllipsoidEmitter::CmdInnerY::doGet(const void* target) const { return StringConverter::toString( static_cast(target)->getInnerSizeY() ); } void HollowEllipsoidEmitter::CmdInnerY::doSet(void* target, const String& val) { static_cast(target)->setInnerSizeY(StringConverter::parseReal(val)); } //----------------------------------------------------------------------- String HollowEllipsoidEmitter::CmdInnerZ::doGet(const void* target) const { return StringConverter::toString( static_cast(target)->getInnerSizeZ() ); } void HollowEllipsoidEmitter::CmdInnerZ::doSet(void* target, const String& val) { static_cast(target)->setInnerSizeZ(StringConverter::parseReal(val)); } }