ParticleEmitter.cpp 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928
  1. //
  2. // Copyright (c) 2008-2013 the Urho3D project.
  3. //
  4. // Permission is hereby granted, free of charge, to any person obtaining a copy
  5. // of this software and associated documentation files (the "Software"), to deal
  6. // in the Software without restriction, including without limitation the rights
  7. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  8. // copies of the Software, and to permit persons to whom the Software is
  9. // furnished to do so, subject to the following conditions:
  10. //
  11. // The above copyright notice and this permission notice shall be included in
  12. // all copies or substantial portions of the Software.
  13. //
  14. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20. // THE SOFTWARE.
  21. //
  22. #include "Precompiled.h"
  23. #include "Context.h"
  24. #include "Log.h"
  25. #include "Material.h"
  26. #include "ParticleEmitter.h"
  27. #include "Profiler.h"
  28. #include "ResourceCache.h"
  29. #include "ResourceEvents.h"
  30. #include "Scene.h"
  31. #include "SceneEvents.h"
  32. #include "XMLFile.h"
  33. #include "DebugNew.h"
  34. namespace Urho3D
  35. {
  36. static const char* emitterTypeNames[] =
  37. {
  38. "Sphere",
  39. "Box",
  40. 0
  41. };
  42. const char* EFFECT_CATEGORY = "Effect";
  43. static const unsigned MAX_PARTICLES_IN_FRAME = 100;
  44. static const unsigned DEFAULT_NUM_PARTICLES = 10;
  45. static const Vector2 DEFAULT_PARTICLE_SIZE(0.1f, 0.1f);
  46. static const float DEFAULT_EMISSION_RATE = 10.0f;
  47. static const float MIN_EMISSION_RATE = 0.01f;
  48. static const float DEFAULT_TIME_TO_LIVE = 1.0f;
  49. static const float DEFAULT_VELOCITY = 1.0f;
  50. static const Vector3 DEFAULT_DIRECTION_MIN(-1.0f, -1.0f, -1.0f);
  51. static const Vector3 DEFAULT_DIRECTION_MAX(1.0f, 1.0f, 1.0f);
  52. template<> EmitterType Variant::Get<EmitterType>() const
  53. {
  54. return (EmitterType)GetInt();
  55. }
  56. OBJECTTYPESTATIC(ParticleEmitter);
  57. ParticleEmitter::ParticleEmitter(Context* context) :
  58. BillboardSet(context),
  59. emitterType_(EMITTER_SPHERE),
  60. emitterSize_(Vector3::ZERO),
  61. directionMin_(DEFAULT_DIRECTION_MIN),
  62. directionMax_(DEFAULT_DIRECTION_MAX),
  63. constantForce_(Vector3::ZERO),
  64. sizeMin_(DEFAULT_PARTICLE_SIZE),
  65. sizeMax_(DEFAULT_PARTICLE_SIZE),
  66. dampingForce_(0.0f),
  67. periodTimer_(0.0f),
  68. emissionTimer_(0.0f),
  69. activeTime_(0.0f),
  70. inactiveTime_(0.0f),
  71. emissionRateMin_(DEFAULT_EMISSION_RATE),
  72. emissionRateMax_(DEFAULT_EMISSION_RATE),
  73. timeToLiveMin_(DEFAULT_TIME_TO_LIVE),
  74. timeToLiveMax_(DEFAULT_TIME_TO_LIVE),
  75. velocityMin_(DEFAULT_VELOCITY),
  76. velocityMax_(DEFAULT_VELOCITY),
  77. rotationMin_(0.0f),
  78. rotationMax_(0.0f),
  79. rotationSpeedMin_(0.0f),
  80. rotationSpeedMax_(0.0f),
  81. sizeAdd_(0.0f),
  82. sizeMul_(1.0f),
  83. emitting_(true),
  84. updateInvisible_(false),
  85. lastTimeStep_(0.0f),
  86. lastUpdateFrameNumber_(M_MAX_UNSIGNED)
  87. {
  88. SetColor(Color::WHITE);
  89. SetNumParticles(DEFAULT_NUM_PARTICLES);
  90. }
  91. ParticleEmitter::~ParticleEmitter()
  92. {
  93. }
  94. void ParticleEmitter::RegisterObject(Context* context)
  95. {
  96. context->RegisterFactory<ParticleEmitter>(EFFECT_CATEGORY);
  97. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Is Enabled", IsEnabled, SetEnabled, bool, true, AM_DEFAULT);
  98. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_RESOURCEREF, "Material", GetMaterialAttr, SetMaterialAttr, ResourceRef, ResourceRef(Material::GetTypeStatic()), AM_DEFAULT);
  99. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_INT, "Max Particles", GetNumParticles, SetNumParticles, unsigned, DEFAULT_NUM_PARTICLES, AM_DEFAULT);
  100. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Emission Rate Min", emissionRateMin_, DEFAULT_EMISSION_RATE, AM_DEFAULT);
  101. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Emission Rate Max", emissionRateMax_, DEFAULT_EMISSION_RATE, AM_DEFAULT);
  102. ENUM_ATTRIBUTE(ParticleEmitter, "Emitter Type", emitterType_, emitterTypeNames, EMITTER_SPHERE, AM_DEFAULT);
  103. ATTRIBUTE(ParticleEmitter, VAR_VECTOR3, "Emitter Size", emitterSize_, Vector3::ZERO, AM_DEFAULT);
  104. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Active Time", activeTime_, 0.0f, AM_DEFAULT);
  105. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Inactive Time", inactiveTime_, 0.0f, AM_DEFAULT);
  106. ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Is Emitting", emitting_, true, AM_DEFAULT);
  107. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Update When Invisible", GetUpdateInvisible, SetUpdateInvisible, bool, false, AM_DEFAULT);
  108. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Relative Position", IsRelative, SetRelative, bool, true, AM_DEFAULT);
  109. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Relative Scale", IsScaled, SetScaled, bool, true, AM_DEFAULT);
  110. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Sort By Distance", IsSorted, SetSorted, bool, false, AM_DEFAULT);
  111. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Time To Live Min", timeToLiveMin_, DEFAULT_TIME_TO_LIVE, AM_DEFAULT);
  112. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Time To Live Max", timeToLiveMax_, DEFAULT_TIME_TO_LIVE, AM_DEFAULT);
  113. ATTRIBUTE(ParticleEmitter, VAR_VECTOR2, "Particle Size Min", sizeMin_, DEFAULT_PARTICLE_SIZE, AM_DEFAULT);
  114. ATTRIBUTE(ParticleEmitter, VAR_VECTOR2, "Particle Size Max", sizeMax_, DEFAULT_PARTICLE_SIZE, AM_DEFAULT);
  115. ATTRIBUTE(ParticleEmitter, VAR_VECTOR3, "Direction Min", directionMin_, DEFAULT_DIRECTION_MIN, AM_DEFAULT);
  116. ATTRIBUTE(ParticleEmitter, VAR_VECTOR3, "Direction Max", directionMax_, DEFAULT_DIRECTION_MAX, AM_DEFAULT);
  117. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Velocity Min", velocityMin_, DEFAULT_VELOCITY, AM_DEFAULT);
  118. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Velocity Max", velocityMax_, DEFAULT_VELOCITY, AM_DEFAULT);
  119. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Rotation Min", rotationMin_, 0.0f, AM_DEFAULT);
  120. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Rotation Max", rotationMax_, 0.0f, AM_DEFAULT);
  121. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Rotation Speed Min", rotationSpeedMin_, 0.0f, AM_DEFAULT);
  122. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Rotation Speed Max", rotationSpeedMax_, 0.0f, AM_DEFAULT);
  123. ATTRIBUTE(ParticleEmitter, VAR_VECTOR3, "Constant Force", constantForce_, Vector3::ZERO, AM_DEFAULT);
  124. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Damping Force", dampingForce_, 0.0f, AM_DEFAULT);
  125. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Size Add", sizeAdd_, 0.0f, AM_DEFAULT);
  126. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Size Mul", sizeMul_, 1.0f, AM_DEFAULT);
  127. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_VARIANTVECTOR, "Particle Colors", GetColorsAttr, SetColorsAttr, VariantVector, Variant::emptyVariantVector, AM_DEFAULT);
  128. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_VARIANTVECTOR, "UV Animation", GetTextureFramesAttr, SetTextureFramesAttr, VariantVector, Variant::emptyVariantVector, AM_DEFAULT);
  129. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Can Be Occluded", IsOccludee, SetOccludee, bool, true, AM_DEFAULT);
  130. ATTRIBUTE(ParticleEmitter, VAR_BOOL, "Cast Shadows", castShadows_, false, AM_DEFAULT);
  131. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Draw Distance", GetDrawDistance, SetDrawDistance, float, 0.0f, AM_DEFAULT);
  132. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Shadow Distance", GetShadowDistance, SetShadowDistance, float, 0.0f, AM_DEFAULT);
  133. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Animation LOD Bias", GetAnimationLodBias, SetAnimationLodBias, float, 1.0f, AM_DEFAULT);
  134. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Period Timer", periodTimer_, 0.0f, AM_FILE);
  135. ATTRIBUTE(ParticleEmitter, VAR_FLOAT, "Emission Timer", emissionTimer_, 0.0f, AM_FILE);
  136. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_VARIANTVECTOR, "Particles", GetParticlesAttr, SetParticlesAttr, VariantVector, Variant::emptyVariantVector, AM_FILE | AM_NOEDIT);
  137. ACCESSOR_ATTRIBUTE(ParticleEmitter, VAR_VARIANTVECTOR, "Billboards", GetBillboardsAttr, SetBillboardsAttr, VariantVector, Variant::emptyVariantVector, AM_FILE | AM_NOEDIT);
  138. }
  139. void ParticleEmitter::OnSetEnabled()
  140. {
  141. BillboardSet::OnSetEnabled();
  142. Scene* scene = GetScene();
  143. if (scene)
  144. {
  145. if (IsEnabledEffective())
  146. SubscribeToEvent(scene, E_SCENEPOSTUPDATE, HANDLER(ParticleEmitter, HandleScenePostUpdate));
  147. else
  148. UnsubscribeFromEvent(scene, E_SCENEPOSTUPDATE);
  149. }
  150. }
  151. void ParticleEmitter::Update(const FrameInfo& frame)
  152. {
  153. // If there is an amount mismatch between particles and billboards, correct it
  154. if (particles_.Size() != billboards_.Size())
  155. SetNumBillboards(particles_.Size());
  156. bool needCommit = false;
  157. // Check active/inactive period switching
  158. periodTimer_ += lastTimeStep_;
  159. if (emitting_)
  160. {
  161. if (activeTime_ && periodTimer_ >= activeTime_)
  162. {
  163. emitting_ = false;
  164. periodTimer_ -= activeTime_;
  165. }
  166. }
  167. else
  168. {
  169. if (inactiveTime_ && periodTimer_ >= inactiveTime_)
  170. {
  171. emitting_ = true;
  172. periodTimer_ -= inactiveTime_;
  173. }
  174. // If emitter has an indefinite stop interval, keep period timer reset to allow restarting emission in the editor
  175. if (inactiveTime_ == 0.0f)
  176. periodTimer_ = 0.0f;
  177. }
  178. // Check for emitting new particles
  179. if (emitting_)
  180. {
  181. emissionTimer_ += lastTimeStep_;
  182. float intervalMin = 1.0f / Max(emissionRateMax_, MIN_EMISSION_RATE);
  183. float intervalMax = 1.0f / Max(emissionRateMin_, MIN_EMISSION_RATE);
  184. // If emission timer has a longer delay than max. interval, clamp it
  185. if (emissionTimer_ < -intervalMax)
  186. emissionTimer_ = -intervalMax;
  187. unsigned counter = MAX_PARTICLES_IN_FRAME;
  188. while (emissionTimer_ > 0.0f && counter)
  189. {
  190. emissionTimer_ -= Lerp(intervalMin, intervalMax, Random(1.0f));
  191. if (EmitNewParticle())
  192. {
  193. --counter;
  194. needCommit = true;
  195. }
  196. else
  197. break;
  198. }
  199. }
  200. // Update existing particles
  201. Vector3 relativeConstantForce = node_->GetWorldRotation().Inverse() * constantForce_;
  202. // If billboards are not relative, apply scaling to the position update
  203. Vector3 scaleVector = Vector3::ONE;
  204. if (scaled_ && !relative_)
  205. scaleVector = node_->GetWorldScale();
  206. for (unsigned i = 0; i < particles_.Size(); ++i)
  207. {
  208. Particle& particle = particles_[i];
  209. Billboard& billboard = billboards_[i];
  210. if (billboard.enabled_)
  211. {
  212. needCommit = true;
  213. // Time to live
  214. if (particle.timer_ >= particle.timeToLive_)
  215. {
  216. billboard.enabled_ = false;
  217. continue;
  218. }
  219. particle.timer_ += lastTimeStep_;
  220. // Velocity & position
  221. if (constantForce_ != Vector3::ZERO)
  222. {
  223. if (relative_)
  224. particle.velocity_ += lastTimeStep_ * relativeConstantForce;
  225. else
  226. particle.velocity_ += lastTimeStep_ * constantForce_;
  227. }
  228. if (dampingForce_ != 0.0f)
  229. {
  230. Vector3 force = -dampingForce_ * particle.velocity_;
  231. particle.velocity_ += lastTimeStep_ * force;
  232. }
  233. billboard.position_ += lastTimeStep_ * particle.velocity_ * scaleVector;
  234. // Rotation
  235. billboard.rotation_ += lastTimeStep_ * particle.rotationSpeed_;
  236. // Scaling
  237. if (sizeAdd_ != 0.0f || sizeMul_ != 1.0f)
  238. {
  239. particle.scale_ += lastTimeStep_ * sizeAdd_;
  240. if (sizeMul_ != 1.0f)
  241. particle.scale_ *= (lastTimeStep_ * (sizeMul_ - 1.0f)) + 1.0f;
  242. billboard.size_ = particle.size_ * particle.scale_;
  243. }
  244. // Color interpolation
  245. unsigned& index = particle.colorIndex_;
  246. if (index < colorFrames_.Size())
  247. {
  248. if (index < colorFrames_.Size() - 1)
  249. {
  250. if (particle.timer_ >= colorFrames_[index + 1].time_)
  251. ++index;
  252. }
  253. if (index < colorFrames_.Size() - 1)
  254. billboard.color_ = colorFrames_[index].Interpolate(colorFrames_[index + 1], particle.timer_);
  255. else
  256. billboard.color_ = colorFrames_[index].color_;
  257. }
  258. // Texture animation
  259. unsigned& texIndex = particle.texIndex_;
  260. if (textureFrames_.Size() && texIndex < textureFrames_.Size() - 1)
  261. {
  262. if (particle.timer_ >= textureFrames_[texIndex + 1].time_)
  263. {
  264. billboard.uv_ = textureFrames_[texIndex + 1].uv_;
  265. ++texIndex;
  266. }
  267. }
  268. }
  269. }
  270. if (needCommit)
  271. Commit();
  272. }
  273. bool ParticleEmitter::Load(XMLFile* file)
  274. {
  275. if (!file)
  276. {
  277. LOGERROR("Null particle emitter parameter file");
  278. return false;
  279. }
  280. XMLElement rootElem = file->GetRoot();
  281. if (!rootElem)
  282. {
  283. LOGERROR("Particle emitter parameter file does not have a valid root element");
  284. return false;
  285. }
  286. if (rootElem.HasChild("material"))
  287. SetMaterial(GetSubsystem<ResourceCache>()->GetResource<Material>(rootElem.GetChild("material").GetAttribute("name")));
  288. if (rootElem.HasChild("numparticles"))
  289. SetNumParticles(rootElem.GetChild("numparticles").GetInt("value"));
  290. if (rootElem.HasChild("updateinvisible"))
  291. updateInvisible_ = rootElem.GetChild("updateinvisible").GetBool("enable");
  292. if (rootElem.HasChild("relative"))
  293. relative_ = rootElem.GetChild("relative").GetBool("enable");
  294. if (rootElem.HasChild("scaled"))
  295. scaled_ = rootElem.GetChild("scaled").GetBool("enable");
  296. if (rootElem.HasChild("sorted"))
  297. sorted_ = rootElem.GetChild("sorted").GetBool("enable");
  298. if (rootElem.HasChild("animlodbias"))
  299. SetAnimationLodBias(rootElem.GetChild("relative").GetFloat("value"));
  300. if (rootElem.HasChild("emittertype"))
  301. {
  302. String type = rootElem.GetChild("emittertype").GetAttributeLower("value");
  303. if (type == "point")
  304. {
  305. // Point emitter type is deprecated, handled as zero sized sphere
  306. emitterType_ = EMITTER_SPHERE;
  307. emitterSize_ = Vector3::ZERO;
  308. }
  309. else if (type == "box")
  310. emitterType_ = EMITTER_BOX;
  311. else if (type == "sphere")
  312. emitterType_ = EMITTER_SPHERE;
  313. else
  314. LOGERROR("Unknown particle emitter type " + type);
  315. }
  316. if (rootElem.HasChild("emittersize"))
  317. emitterSize_ = rootElem.GetChild("emittersize").GetVector3("value");
  318. if (rootElem.HasChild("emitterradius"))
  319. emitterSize_.x_ = emitterSize_.y_ = emitterSize_.z_ = rootElem.GetChild("emitterradius").GetFloat("value");
  320. if (rootElem.HasChild("direction"))
  321. GetVector3MinMax(rootElem.GetChild("direction"), directionMin_, directionMax_);
  322. if (rootElem.HasChild("constantforce"))
  323. constantForce_ = rootElem.GetChild("constantforce").GetVector3("value");
  324. if (rootElem.HasChild("dampingforce"))
  325. dampingForce_ = rootElem.GetChild("dampingforce").GetFloat("value");
  326. if (rootElem.HasChild("activetime"))
  327. activeTime_ = rootElem.GetChild("activetime").GetFloat("value");
  328. if (activeTime_ < 0.0f)
  329. activeTime_ = M_INFINITY;
  330. if (rootElem.HasChild("inactivetime"))
  331. inactiveTime_ = rootElem.GetChild("inactivetime").GetFloat("value");
  332. if (inactiveTime_ < 0.0f)
  333. inactiveTime_ = M_INFINITY;
  334. if (rootElem.HasChild("emissionrate"))
  335. GetFloatMinMax(rootElem.GetChild("emissionrate"), emissionRateMin_, emissionRateMax_);
  336. if (rootElem.HasChild("interval"))
  337. {
  338. float intervalMin = 0.0f;
  339. float intervalMax = 0.0f;
  340. GetFloatMinMax(rootElem.GetChild("interval"), intervalMin, intervalMax);
  341. emissionRateMax_ = 1.0f / intervalMin;
  342. emissionRateMin_ = 1.0f / intervalMax;
  343. }
  344. if (rootElem.HasChild("particlesize"))
  345. GetVector2MinMax(rootElem.GetChild("particlesize"), sizeMin_, sizeMax_);
  346. if (rootElem.HasChild("timetolive"))
  347. GetFloatMinMax(rootElem.GetChild("timetolive"), timeToLiveMin_, timeToLiveMax_);
  348. if (rootElem.HasChild("velocity"))
  349. GetFloatMinMax(rootElem.GetChild("velocity"), velocityMin_, velocityMax_);
  350. if (rootElem.HasChild("rotation"))
  351. GetFloatMinMax(rootElem.GetChild("rotation"), rotationMin_, rotationMax_);
  352. if (rootElem.HasChild("rotationspeed"))
  353. GetFloatMinMax(rootElem.GetChild("rotationspeed"), rotationSpeedMin_, rotationSpeedMax_);
  354. if (rootElem.HasChild("sizedelta"))
  355. {
  356. XMLElement deltaElem = rootElem.GetChild("sizedelta");
  357. if (deltaElem.HasAttribute("add"))
  358. sizeAdd_ = deltaElem.GetFloat("add");
  359. if (deltaElem.HasAttribute("mul"))
  360. sizeMul_ = deltaElem.GetFloat("mul");
  361. }
  362. if (rootElem.HasChild("color"))
  363. SetColor(rootElem.GetChild("color").GetColor("value"));
  364. if (rootElem.HasChild("colorfade"))
  365. {
  366. Vector<ColorFrame> fades;
  367. XMLElement colorFadeElem = rootElem.GetChild("colorfade");
  368. while (colorFadeElem)
  369. {
  370. fades.Push(ColorFrame(colorFadeElem.GetColor("color"), colorFadeElem.GetFloat("time")));
  371. colorFadeElem = colorFadeElem.GetNext("colorfade");
  372. }
  373. SetColors(fades);
  374. }
  375. if (rootElem.HasChild("texanim"))
  376. {
  377. Vector<TextureFrame> animations;
  378. XMLElement animElem = rootElem.GetChild("texanim");
  379. while (animElem)
  380. {
  381. TextureFrame animation;
  382. animation.uv_ = animElem.GetRect("uv");
  383. animation.time_ = animElem.GetFloat("time");
  384. animations.Push(animation);
  385. animElem = animElem.GetNext("texanim");
  386. }
  387. textureFrames_ = animations;
  388. }
  389. MarkNetworkUpdate();
  390. return true;
  391. }
  392. void ParticleEmitter::SetNumParticles(unsigned num)
  393. {
  394. // Prevent negative value being assigned from the editor
  395. if (num > M_MAX_INT)
  396. num = 0;
  397. if (num > MAX_BILLBOARDS)
  398. num = MAX_BILLBOARDS;
  399. particles_.Resize(num);
  400. SetNumBillboards(num);
  401. }
  402. void ParticleEmitter::SetEmissionRate(float rate)
  403. {
  404. SetMinEmissionRate(rate);
  405. SetMaxEmissionRate(rate);
  406. }
  407. void ParticleEmitter::SetMinEmissionRate(float rate)
  408. {
  409. emissionRateMin_ = Max(rate, MIN_EMISSION_RATE);
  410. MarkNetworkUpdate();
  411. }
  412. void ParticleEmitter::SetMaxEmissionRate(float rate)
  413. {
  414. emissionRateMax_ = Max(rate, MIN_EMISSION_RATE);
  415. MarkNetworkUpdate();
  416. }
  417. void ParticleEmitter::SetEmitterType(EmitterType type)
  418. {
  419. emitterType_ = type;
  420. MarkNetworkUpdate();
  421. }
  422. void ParticleEmitter::SetEmitterSize(const Vector3& size)
  423. {
  424. emitterSize_ = size;
  425. MarkNetworkUpdate();
  426. }
  427. void ParticleEmitter::SetActiveTime(float time)
  428. {
  429. activeTime_ = time;
  430. MarkNetworkUpdate();
  431. }
  432. void ParticleEmitter::SetInactiveTime(float time)
  433. {
  434. inactiveTime_ = time;
  435. MarkNetworkUpdate();
  436. }
  437. void ParticleEmitter::SetEmitting(bool enable, bool resetPeriod)
  438. {
  439. if (enable != emitting_ || resetPeriod)
  440. {
  441. emitting_ = enable;
  442. periodTimer_ = 0.0f;
  443. MarkNetworkUpdate();
  444. }
  445. }
  446. void ParticleEmitter::SetUpdateInvisible(bool enable)
  447. {
  448. updateInvisible_ = enable;
  449. }
  450. void ParticleEmitter::SetTimeToLive(float time)
  451. {
  452. SetMinTimeToLive(time);
  453. SetMaxTimeToLive(time);
  454. }
  455. void ParticleEmitter::SetMinTimeToLive(float time)
  456. {
  457. timeToLiveMin_ = Max(time, 0.0f);
  458. MarkNetworkUpdate();
  459. }
  460. void ParticleEmitter::SetMaxTimeToLive(float time)
  461. {
  462. timeToLiveMax_ = Max(time, 0.0f);
  463. MarkNetworkUpdate();
  464. }
  465. void ParticleEmitter::SetParticleSize(const Vector2& size)
  466. {
  467. SetMinParticleSize(size);
  468. SetMaxParticleSize(size);
  469. }
  470. void ParticleEmitter::SetMinParticleSize(const Vector2& size)
  471. {
  472. sizeMin_ = size;
  473. MarkNetworkUpdate();
  474. }
  475. void ParticleEmitter::SetMaxParticleSize(const Vector2& size)
  476. {
  477. sizeMax_ = size;
  478. MarkNetworkUpdate();
  479. }
  480. void ParticleEmitter::SetMinDirection(const Vector3& direction)
  481. {
  482. directionMin_ = direction;
  483. MarkNetworkUpdate();
  484. }
  485. void ParticleEmitter::SetMaxDirection(const Vector3& direction)
  486. {
  487. directionMin_ = direction;
  488. MarkNetworkUpdate();
  489. }
  490. void ParticleEmitter::SetVelocity(float velocity)
  491. {
  492. SetMinVelocity(velocity);
  493. SetMaxVelocity(velocity);
  494. }
  495. void ParticleEmitter::SetMinVelocity(float velocity)
  496. {
  497. velocityMin_ = velocity;
  498. MarkNetworkUpdate();
  499. }
  500. void ParticleEmitter::SetMaxVelocity(float velocity)
  501. {
  502. velocityMin_ = velocity;
  503. MarkNetworkUpdate();
  504. }
  505. void ParticleEmitter::SetRotation(float rotation)
  506. {
  507. SetMinRotation(rotation);
  508. SetMaxRotation(rotation);
  509. }
  510. void ParticleEmitter::SetMinRotation(float rotation)
  511. {
  512. rotationMin_ = rotation;
  513. MarkNetworkUpdate();
  514. }
  515. void ParticleEmitter::SetMaxRotation(float rotation)
  516. {
  517. rotationMax_ = rotation;
  518. MarkNetworkUpdate();
  519. }
  520. void ParticleEmitter::SetRotationSpeed(float speed)
  521. {
  522. SetMinRotationSpeed(speed);
  523. SetMaxRotationSpeed(speed);
  524. }
  525. void ParticleEmitter::SetMinRotationSpeed(float speed)
  526. {
  527. rotationSpeedMin_ = speed;
  528. MarkNetworkUpdate();
  529. }
  530. void ParticleEmitter::SetMaxRotationSpeed(float speed)
  531. {
  532. rotationSpeedMax_ = speed;
  533. MarkNetworkUpdate();
  534. }
  535. void ParticleEmitter::SetConstantForce(const Vector3& force)
  536. {
  537. constantForce_ = force;
  538. MarkNetworkUpdate();
  539. }
  540. void ParticleEmitter::SetDampingForce(float force)
  541. {
  542. dampingForce_ = force;
  543. MarkNetworkUpdate();
  544. }
  545. void ParticleEmitter::SetSizeAdd(float sizeAdd)
  546. {
  547. sizeAdd_ = sizeAdd;
  548. MarkNetworkUpdate();
  549. }
  550. void ParticleEmitter::SetSizeMul(float sizeMul)
  551. {
  552. sizeMul_ = sizeMul;
  553. MarkNetworkUpdate();
  554. }
  555. void ParticleEmitter::SetColor(const Color& color)
  556. {
  557. colorFrames_.Clear();
  558. colorFrames_.Push(ColorFrame(color));
  559. MarkNetworkUpdate();
  560. }
  561. void ParticleEmitter::SetColors(const Vector<ColorFrame>& colors)
  562. {
  563. if (!colors.Size())
  564. return;
  565. colorFrames_ = colors;
  566. MarkNetworkUpdate();
  567. }
  568. void ParticleEmitter::SetNumColors(unsigned num)
  569. {
  570. colorFrames_.Resize(num);
  571. MarkNetworkUpdate();
  572. }
  573. void ParticleEmitter::SetTextureFrames(const Vector<TextureFrame>& animation)
  574. {
  575. textureFrames_ = animation;
  576. MarkNetworkUpdate();
  577. }
  578. void ParticleEmitter::SetNumTextureFrames(unsigned num)
  579. {
  580. textureFrames_.Resize(num);
  581. }
  582. void ParticleEmitter::SetParticlesAttr(VariantVector value)
  583. {
  584. unsigned index = 0;
  585. SetNumParticles(index < value.Size() ? value[index++].GetUInt() : 0);
  586. for (PODVector<Particle>::Iterator i = particles_.Begin(); i != particles_.End() && index < value.Size(); ++i)
  587. {
  588. i->velocity_ = value[index++].GetVector3();
  589. i->size_ = value[index++].GetVector2();
  590. i->timer_ = value[index++].GetFloat();
  591. i->timeToLive_ = value[index++].GetFloat();
  592. i->scale_ = value[index++].GetFloat();
  593. i->rotationSpeed_ = value[index++].GetFloat();
  594. i->colorIndex_ = value[index++].GetInt();
  595. i->texIndex_ = value[index++].GetInt();
  596. }
  597. }
  598. VariantVector ParticleEmitter::GetParticlesAttr() const
  599. {
  600. VariantVector ret;
  601. ret.Reserve(particles_.Size() * 8 + 1);
  602. ret.Push(particles_.Size());
  603. for (PODVector<Particle>::ConstIterator i = particles_.Begin(); i != particles_.End(); ++i)
  604. {
  605. ret.Push(i->velocity_);
  606. ret.Push(i->size_);
  607. ret.Push(i->timer_);
  608. ret.Push(i->timeToLive_);
  609. ret.Push(i->scale_);
  610. ret.Push(i->rotationSpeed_);
  611. ret.Push(i->colorIndex_);
  612. ret.Push(i->texIndex_);
  613. }
  614. return ret;
  615. }
  616. void ParticleEmitter::SetColorsAttr(VariantVector value)
  617. {
  618. unsigned index = 0;
  619. unsigned numColors = index < value.Size() ? value[index++].GetUInt() : 0;
  620. // Prevent negative value being assigned from the editor
  621. if (numColors > M_MAX_INT)
  622. numColors = 0;
  623. colorFrames_.Resize(numColors);
  624. for (Vector<ColorFrame>::Iterator i = colorFrames_.Begin(); i < colorFrames_.End() && index < value.Size(); ++i)
  625. {
  626. i->color_ = value[index++].GetColor();
  627. i->time_ = value[index++].GetFloat();
  628. }
  629. }
  630. VariantVector ParticleEmitter::GetColorsAttr() const
  631. {
  632. VariantVector ret;
  633. ret.Reserve(colorFrames_.Size() * 2 + 1);
  634. ret.Push(colorFrames_.Size());
  635. for (Vector<ColorFrame>::ConstIterator i = colorFrames_.Begin(); i < colorFrames_.End(); ++i)
  636. {
  637. ret.Push(i->color_);
  638. ret.Push(i->time_);
  639. }
  640. return ret;
  641. }
  642. void ParticleEmitter::SetTextureFramesAttr(VariantVector value)
  643. {
  644. unsigned index = 0;
  645. unsigned numFrames = index < value.Size() ? value[index++].GetUInt() : 0;
  646. // Prevent negative value being assigned from the editor
  647. if (numFrames > M_MAX_INT)
  648. numFrames = 0;
  649. textureFrames_.Resize(numFrames);
  650. for (Vector<TextureFrame>::Iterator i = textureFrames_.Begin(); i < textureFrames_.End() && index < value.Size(); ++i)
  651. {
  652. i->uv_ = value[index++].GetVector4();
  653. i->time_ = value[index++].GetFloat();
  654. }
  655. }
  656. VariantVector ParticleEmitter::GetTextureFramesAttr() const
  657. {
  658. VariantVector ret;
  659. ret.Reserve(textureFrames_.Size() * 2 + 1);
  660. ret.Push(textureFrames_.Size());
  661. for (Vector<TextureFrame>::ConstIterator i = textureFrames_.Begin(); i < textureFrames_.End(); ++i)
  662. {
  663. ret.Push(i->uv_.ToVector4());
  664. ret.Push(i->time_);
  665. }
  666. return ret;
  667. }
  668. void ParticleEmitter::OnNodeSet(Node* node)
  669. {
  670. BillboardSet::OnNodeSet(node);
  671. if (node)
  672. {
  673. Scene* scene = GetScene();
  674. if (scene && IsEnabledEffective())
  675. SubscribeToEvent(scene, E_SCENEPOSTUPDATE, HANDLER(ParticleEmitter, HandleScenePostUpdate));
  676. }
  677. }
  678. bool ParticleEmitter::EmitNewParticle()
  679. {
  680. unsigned index = GetFreeParticle();
  681. if (index == M_MAX_UNSIGNED)
  682. return false;
  683. assert(index < particles_.Size());
  684. Particle& particle = particles_[index];
  685. Billboard& billboard = billboards_[index];
  686. Vector3 startPos;
  687. Vector3 startDir;
  688. switch (emitterType_)
  689. {
  690. case EMITTER_SPHERE:
  691. {
  692. Vector3 dir(
  693. Random(2.0f) - 1.0f,
  694. Random(2.0f) - 1.0f,
  695. Random(2.0f) - 1.0f
  696. );
  697. dir.Normalize();
  698. startPos = emitterSize_ * dir * 0.5f;
  699. }
  700. break;
  701. case EMITTER_BOX:
  702. startPos = Vector3(
  703. Random(emitterSize_.x_) - emitterSize_.x_ * 0.5f,
  704. Random(emitterSize_.y_) - emitterSize_.y_ * 0.5f,
  705. Random(emitterSize_.z_) - emitterSize_.z_ * 0.5f
  706. );
  707. break;
  708. }
  709. startDir = Vector3(
  710. Lerp(directionMin_.x_, directionMax_.x_, Random(1.0f)),
  711. Lerp(directionMin_.y_, directionMax_.y_, Random(1.0f)),
  712. Lerp(directionMin_.z_, directionMax_.z_, Random(1.0f))
  713. );
  714. startDir.Normalize();
  715. if (!relative_)
  716. {
  717. startPos = node_->GetWorldTransform() * startPos;
  718. startDir = node_->GetWorldRotation() * startDir;
  719. };
  720. particle.velocity_ = Lerp(velocityMin_, velocityMax_, Random(1.0f)) * startDir;
  721. particle.size_ = sizeMin_.Lerp(sizeMax_, Random(1.0f));
  722. particle.timer_ = 0.0f;
  723. particle.timeToLive_ = Lerp(timeToLiveMin_, timeToLiveMax_, Random(1.0f));
  724. particle.scale_ = 1.0f;
  725. particle.rotationSpeed_ = Lerp(rotationSpeedMin_, rotationSpeedMax_, Random(1.0f));
  726. particle.colorIndex_ = 0;
  727. particle.texIndex_ = 0;
  728. billboard.position_ = startPos;
  729. billboard.size_ = particles_[index].size_;
  730. billboard.uv_ = textureFrames_.Size() ? textureFrames_[0].uv_ : Rect::POSITIVE;
  731. billboard.rotation_ = Lerp(rotationMin_, rotationMax_, Random(1.0f));
  732. billboard.color_ = colorFrames_[0].color_;
  733. billboard.enabled_ = true;
  734. return true;
  735. }
  736. unsigned ParticleEmitter::GetFreeParticle() const
  737. {
  738. for (unsigned i = 0; i < billboards_.Size(); ++i)
  739. {
  740. if (!billboards_[i].enabled_)
  741. return i;
  742. }
  743. return M_MAX_UNSIGNED;
  744. }
  745. void ParticleEmitter::GetFloatMinMax(const XMLElement& element, float& minValue, float& maxValue)
  746. {
  747. if (element.IsNull())
  748. return;
  749. if (element.HasAttribute("value"))
  750. minValue = maxValue = element.GetFloat("value");
  751. if (element.HasAttribute("min") && element.HasAttribute("max"))
  752. {
  753. minValue = element.GetFloat("min");
  754. maxValue = element.GetFloat("max");
  755. }
  756. }
  757. void ParticleEmitter::GetVector2MinMax(const XMLElement& element, Vector2& minValue, Vector2& maxValue)
  758. {
  759. if (element.IsNull())
  760. return;
  761. if (element.HasAttribute("value"))
  762. minValue = maxValue = element.GetVector2("value");
  763. if (element.HasAttribute("min") && element.HasAttribute("max"))
  764. {
  765. minValue = element.GetVector2("min");
  766. maxValue = element.GetVector2("max");
  767. }
  768. }
  769. void ParticleEmitter::GetVector3MinMax(const XMLElement& element, Vector3& minValue, Vector3& maxValue)
  770. {
  771. if (element.IsNull())
  772. return;
  773. if (element.HasAttribute("value"))
  774. minValue = maxValue = element.GetVector3("value");
  775. if (element.HasAttribute("min") && element.HasAttribute("max"))
  776. {
  777. minValue = element.GetVector3("min");
  778. maxValue = element.GetVector3("max");
  779. }
  780. }
  781. void ParticleEmitter::HandleScenePostUpdate(StringHash eventType, VariantMap& eventData)
  782. {
  783. // Store scene's timestep and use it instead of global timestep, as time scale may be other than 1
  784. using namespace ScenePostUpdate;
  785. lastTimeStep_ = eventData[P_TIMESTEP].GetFloat();
  786. // If no invisible update, check that the billboardset is in view (framenumber has changed)
  787. if (updateInvisible_ || viewFrameNumber_ != lastUpdateFrameNumber_)
  788. {
  789. lastUpdateFrameNumber_ = viewFrameNumber_;
  790. MarkForUpdate();
  791. }
  792. }
  793. }