cpu_particles_3d.cpp 65 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707
  1. /**************************************************************************/
  2. /* cpu_particles_3d.cpp */
  3. /**************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /**************************************************************************/
  8. /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
  9. /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /**************************************************************************/
  30. #include "cpu_particles_3d.h"
  31. #include "scene/3d/camera_3d.h"
  32. #include "scene/3d/gpu_particles_3d.h"
  33. #include "scene/main/viewport.h"
  34. #include "scene/resources/particle_process_material.h"
  35. AABB CPUParticles3D::get_aabb() const {
  36. return AABB();
  37. }
  38. void CPUParticles3D::set_emitting(bool p_emitting) {
  39. if (emitting == p_emitting) {
  40. return;
  41. }
  42. emitting = p_emitting;
  43. if (emitting) {
  44. set_process_internal(true);
  45. // first update before rendering to avoid one frame delay after emitting starts
  46. if (time == 0) {
  47. _update_internal();
  48. }
  49. }
  50. }
  51. void CPUParticles3D::set_amount(int p_amount) {
  52. ERR_FAIL_COND_MSG(p_amount < 1, "Amount of particles must be greater than 0.");
  53. particles.resize(p_amount);
  54. {
  55. Particle *w = particles.ptrw();
  56. for (int i = 0; i < p_amount; i++) {
  57. w[i].active = false;
  58. w[i].custom[3] = 0.0; // Make sure w component isn't garbage data
  59. }
  60. }
  61. particle_data.resize((12 + 4 + 4) * p_amount);
  62. RS::get_singleton()->multimesh_set_visible_instances(multimesh, -1);
  63. RS::get_singleton()->multimesh_allocate_data(multimesh, p_amount, RS::MULTIMESH_TRANSFORM_3D, true, true);
  64. particle_order.resize(p_amount);
  65. }
  66. void CPUParticles3D::set_lifetime(double p_lifetime) {
  67. ERR_FAIL_COND_MSG(p_lifetime <= 0, "Particles lifetime must be greater than 0.");
  68. lifetime = p_lifetime;
  69. }
  70. void CPUParticles3D::set_one_shot(bool p_one_shot) {
  71. one_shot = p_one_shot;
  72. }
  73. void CPUParticles3D::set_pre_process_time(double p_time) {
  74. pre_process_time = p_time;
  75. }
  76. void CPUParticles3D::set_explosiveness_ratio(real_t p_ratio) {
  77. explosiveness_ratio = p_ratio;
  78. }
  79. void CPUParticles3D::set_randomness_ratio(real_t p_ratio) {
  80. randomness_ratio = p_ratio;
  81. }
  82. void CPUParticles3D::set_lifetime_randomness(double p_random) {
  83. lifetime_randomness = p_random;
  84. }
  85. void CPUParticles3D::set_use_local_coordinates(bool p_enable) {
  86. local_coords = p_enable;
  87. }
  88. void CPUParticles3D::set_speed_scale(double p_scale) {
  89. speed_scale = p_scale;
  90. }
  91. bool CPUParticles3D::is_emitting() const {
  92. return emitting;
  93. }
  94. int CPUParticles3D::get_amount() const {
  95. return particles.size();
  96. }
  97. double CPUParticles3D::get_lifetime() const {
  98. return lifetime;
  99. }
  100. bool CPUParticles3D::get_one_shot() const {
  101. return one_shot;
  102. }
  103. double CPUParticles3D::get_pre_process_time() const {
  104. return pre_process_time;
  105. }
  106. real_t CPUParticles3D::get_explosiveness_ratio() const {
  107. return explosiveness_ratio;
  108. }
  109. real_t CPUParticles3D::get_randomness_ratio() const {
  110. return randomness_ratio;
  111. }
  112. double CPUParticles3D::get_lifetime_randomness() const {
  113. return lifetime_randomness;
  114. }
  115. bool CPUParticles3D::get_use_local_coordinates() const {
  116. return local_coords;
  117. }
  118. double CPUParticles3D::get_speed_scale() const {
  119. return speed_scale;
  120. }
  121. void CPUParticles3D::set_draw_order(DrawOrder p_order) {
  122. ERR_FAIL_INDEX(p_order, DRAW_ORDER_MAX);
  123. draw_order = p_order;
  124. }
  125. CPUParticles3D::DrawOrder CPUParticles3D::get_draw_order() const {
  126. return draw_order;
  127. }
  128. void CPUParticles3D::set_mesh(const Ref<Mesh> &p_mesh) {
  129. mesh = p_mesh;
  130. if (mesh.is_valid()) {
  131. RS::get_singleton()->multimesh_set_mesh(multimesh, mesh->get_rid());
  132. } else {
  133. RS::get_singleton()->multimesh_set_mesh(multimesh, RID());
  134. }
  135. update_configuration_warnings();
  136. }
  137. Ref<Mesh> CPUParticles3D::get_mesh() const {
  138. return mesh;
  139. }
  140. void CPUParticles3D::set_fixed_fps(int p_count) {
  141. fixed_fps = p_count;
  142. }
  143. int CPUParticles3D::get_fixed_fps() const {
  144. return fixed_fps;
  145. }
  146. void CPUParticles3D::set_fractional_delta(bool p_enable) {
  147. fractional_delta = p_enable;
  148. }
  149. bool CPUParticles3D::get_fractional_delta() const {
  150. return fractional_delta;
  151. }
  152. PackedStringArray CPUParticles3D::get_configuration_warnings() const {
  153. PackedStringArray warnings = GeometryInstance3D::get_configuration_warnings();
  154. bool mesh_found = false;
  155. bool anim_material_found = false;
  156. if (get_mesh().is_valid()) {
  157. mesh_found = true;
  158. for (int j = 0; j < get_mesh()->get_surface_count(); j++) {
  159. anim_material_found = Object::cast_to<ShaderMaterial>(get_mesh()->surface_get_material(j).ptr()) != nullptr;
  160. StandardMaterial3D *spat = Object::cast_to<StandardMaterial3D>(get_mesh()->surface_get_material(j).ptr());
  161. anim_material_found = anim_material_found || (spat && spat->get_billboard_mode() == StandardMaterial3D::BILLBOARD_PARTICLES);
  162. }
  163. }
  164. anim_material_found = anim_material_found || Object::cast_to<ShaderMaterial>(get_material_override().ptr()) != nullptr;
  165. StandardMaterial3D *spat = Object::cast_to<StandardMaterial3D>(get_material_override().ptr());
  166. anim_material_found = anim_material_found || (spat && spat->get_billboard_mode() == StandardMaterial3D::BILLBOARD_PARTICLES);
  167. if (!mesh_found) {
  168. warnings.push_back(RTR("Nothing is visible because no mesh has been assigned."));
  169. }
  170. if (!anim_material_found && (get_param_max(PARAM_ANIM_SPEED) != 0.0 || get_param_max(PARAM_ANIM_OFFSET) != 0.0 || get_param_curve(PARAM_ANIM_SPEED).is_valid() || get_param_curve(PARAM_ANIM_OFFSET).is_valid())) {
  171. warnings.push_back(RTR("CPUParticles3D animation requires the usage of a StandardMaterial3D whose Billboard Mode is set to \"Particle Billboard\"."));
  172. }
  173. return warnings;
  174. }
  175. void CPUParticles3D::restart() {
  176. time = 0;
  177. inactive_time = 0;
  178. frame_remainder = 0;
  179. cycle = 0;
  180. emitting = false;
  181. {
  182. int pc = particles.size();
  183. Particle *w = particles.ptrw();
  184. for (int i = 0; i < pc; i++) {
  185. w[i].active = false;
  186. }
  187. }
  188. set_emitting(true);
  189. }
  190. void CPUParticles3D::set_direction(Vector3 p_direction) {
  191. direction = p_direction;
  192. }
  193. Vector3 CPUParticles3D::get_direction() const {
  194. return direction;
  195. }
  196. void CPUParticles3D::set_spread(real_t p_spread) {
  197. spread = p_spread;
  198. }
  199. real_t CPUParticles3D::get_spread() const {
  200. return spread;
  201. }
  202. void CPUParticles3D::set_flatness(real_t p_flatness) {
  203. flatness = p_flatness;
  204. }
  205. real_t CPUParticles3D::get_flatness() const {
  206. return flatness;
  207. }
  208. void CPUParticles3D::set_param_min(Parameter p_param, real_t p_value) {
  209. ERR_FAIL_INDEX(p_param, PARAM_MAX);
  210. parameters_min[p_param] = p_value;
  211. if (parameters_min[p_param] > parameters_max[p_param]) {
  212. set_param_max(p_param, p_value);
  213. }
  214. update_configuration_warnings();
  215. }
  216. real_t CPUParticles3D::get_param_min(Parameter p_param) const {
  217. ERR_FAIL_INDEX_V(p_param, PARAM_MAX, 0);
  218. return parameters_min[p_param];
  219. }
  220. void CPUParticles3D::set_param_max(Parameter p_param, real_t p_value) {
  221. ERR_FAIL_INDEX(p_param, PARAM_MAX);
  222. parameters_max[p_param] = p_value;
  223. if (parameters_min[p_param] > parameters_max[p_param]) {
  224. set_param_min(p_param, p_value);
  225. }
  226. update_configuration_warnings();
  227. }
  228. real_t CPUParticles3D::get_param_max(Parameter p_param) const {
  229. ERR_FAIL_INDEX_V(p_param, PARAM_MAX, 0);
  230. return parameters_max[p_param];
  231. }
  232. static void _adjust_curve_range(const Ref<Curve> &p_curve, real_t p_min, real_t p_max) {
  233. Ref<Curve> curve = p_curve;
  234. if (!curve.is_valid()) {
  235. return;
  236. }
  237. curve->ensure_default_setup(p_min, p_max);
  238. }
  239. void CPUParticles3D::set_param_curve(Parameter p_param, const Ref<Curve> &p_curve) {
  240. ERR_FAIL_INDEX(p_param, PARAM_MAX);
  241. curve_parameters[p_param] = p_curve;
  242. switch (p_param) {
  243. case PARAM_INITIAL_LINEAR_VELOCITY: {
  244. //do none for this one
  245. } break;
  246. case PARAM_ANGULAR_VELOCITY: {
  247. _adjust_curve_range(p_curve, -360, 360);
  248. } break;
  249. case PARAM_ORBIT_VELOCITY: {
  250. _adjust_curve_range(p_curve, -500, 500);
  251. } break;
  252. case PARAM_LINEAR_ACCEL: {
  253. _adjust_curve_range(p_curve, -200, 200);
  254. } break;
  255. case PARAM_RADIAL_ACCEL: {
  256. _adjust_curve_range(p_curve, -200, 200);
  257. } break;
  258. case PARAM_TANGENTIAL_ACCEL: {
  259. _adjust_curve_range(p_curve, -200, 200);
  260. } break;
  261. case PARAM_DAMPING: {
  262. _adjust_curve_range(p_curve, 0, 100);
  263. } break;
  264. case PARAM_ANGLE: {
  265. _adjust_curve_range(p_curve, -360, 360);
  266. } break;
  267. case PARAM_SCALE: {
  268. } break;
  269. case PARAM_HUE_VARIATION: {
  270. _adjust_curve_range(p_curve, -1, 1);
  271. } break;
  272. case PARAM_ANIM_SPEED: {
  273. _adjust_curve_range(p_curve, 0, 200);
  274. } break;
  275. case PARAM_ANIM_OFFSET: {
  276. } break;
  277. default: {
  278. }
  279. }
  280. update_configuration_warnings();
  281. }
  282. Ref<Curve> CPUParticles3D::get_param_curve(Parameter p_param) const {
  283. ERR_FAIL_INDEX_V(p_param, PARAM_MAX, Ref<Curve>());
  284. return curve_parameters[p_param];
  285. }
  286. void CPUParticles3D::set_color(const Color &p_color) {
  287. color = p_color;
  288. }
  289. Color CPUParticles3D::get_color() const {
  290. return color;
  291. }
  292. void CPUParticles3D::set_color_ramp(const Ref<Gradient> &p_ramp) {
  293. color_ramp = p_ramp;
  294. }
  295. Ref<Gradient> CPUParticles3D::get_color_ramp() const {
  296. return color_ramp;
  297. }
  298. void CPUParticles3D::set_color_initial_ramp(const Ref<Gradient> &p_ramp) {
  299. color_initial_ramp = p_ramp;
  300. }
  301. Ref<Gradient> CPUParticles3D::get_color_initial_ramp() const {
  302. return color_initial_ramp;
  303. }
  304. void CPUParticles3D::set_particle_flag(ParticleFlags p_particle_flag, bool p_enable) {
  305. ERR_FAIL_INDEX(p_particle_flag, PARTICLE_FLAG_MAX);
  306. particle_flags[p_particle_flag] = p_enable;
  307. if (p_particle_flag == PARTICLE_FLAG_DISABLE_Z) {
  308. notify_property_list_changed();
  309. }
  310. }
  311. bool CPUParticles3D::get_particle_flag(ParticleFlags p_particle_flag) const {
  312. ERR_FAIL_INDEX_V(p_particle_flag, PARTICLE_FLAG_MAX, false);
  313. return particle_flags[p_particle_flag];
  314. }
  315. void CPUParticles3D::set_emission_shape(EmissionShape p_shape) {
  316. ERR_FAIL_INDEX(p_shape, EMISSION_SHAPE_MAX);
  317. emission_shape = p_shape;
  318. }
  319. void CPUParticles3D::set_emission_sphere_radius(real_t p_radius) {
  320. emission_sphere_radius = p_radius;
  321. }
  322. void CPUParticles3D::set_emission_box_extents(Vector3 p_extents) {
  323. emission_box_extents = p_extents;
  324. }
  325. void CPUParticles3D::set_emission_points(const Vector<Vector3> &p_points) {
  326. emission_points = p_points;
  327. }
  328. void CPUParticles3D::set_emission_normals(const Vector<Vector3> &p_normals) {
  329. emission_normals = p_normals;
  330. }
  331. void CPUParticles3D::set_emission_colors(const Vector<Color> &p_colors) {
  332. emission_colors = p_colors;
  333. }
  334. void CPUParticles3D::set_emission_ring_axis(Vector3 p_axis) {
  335. emission_ring_axis = p_axis;
  336. }
  337. void CPUParticles3D::set_emission_ring_height(real_t p_height) {
  338. emission_ring_height = p_height;
  339. }
  340. void CPUParticles3D::set_emission_ring_radius(real_t p_radius) {
  341. emission_ring_radius = p_radius;
  342. }
  343. void CPUParticles3D::set_emission_ring_inner_radius(real_t p_radius) {
  344. emission_ring_inner_radius = p_radius;
  345. }
  346. void CPUParticles3D::set_scale_curve_x(Ref<Curve> p_scale_curve) {
  347. scale_curve_x = p_scale_curve;
  348. }
  349. void CPUParticles3D::set_scale_curve_y(Ref<Curve> p_scale_curve) {
  350. scale_curve_y = p_scale_curve;
  351. }
  352. void CPUParticles3D::set_scale_curve_z(Ref<Curve> p_scale_curve) {
  353. scale_curve_z = p_scale_curve;
  354. }
  355. void CPUParticles3D::set_split_scale(bool p_split_scale) {
  356. split_scale = p_split_scale;
  357. notify_property_list_changed();
  358. }
  359. real_t CPUParticles3D::get_emission_sphere_radius() const {
  360. return emission_sphere_radius;
  361. }
  362. Vector3 CPUParticles3D::get_emission_box_extents() const {
  363. return emission_box_extents;
  364. }
  365. Vector<Vector3> CPUParticles3D::get_emission_points() const {
  366. return emission_points;
  367. }
  368. Vector<Vector3> CPUParticles3D::get_emission_normals() const {
  369. return emission_normals;
  370. }
  371. Vector<Color> CPUParticles3D::get_emission_colors() const {
  372. return emission_colors;
  373. }
  374. Vector3 CPUParticles3D::get_emission_ring_axis() const {
  375. return emission_ring_axis;
  376. }
  377. real_t CPUParticles3D::get_emission_ring_height() const {
  378. return emission_ring_height;
  379. }
  380. real_t CPUParticles3D::get_emission_ring_radius() const {
  381. return emission_ring_radius;
  382. }
  383. real_t CPUParticles3D::get_emission_ring_inner_radius() const {
  384. return emission_ring_inner_radius;
  385. }
  386. CPUParticles3D::EmissionShape CPUParticles3D::get_emission_shape() const {
  387. return emission_shape;
  388. }
  389. void CPUParticles3D::set_gravity(const Vector3 &p_gravity) {
  390. gravity = p_gravity;
  391. }
  392. Vector3 CPUParticles3D::get_gravity() const {
  393. return gravity;
  394. }
  395. Ref<Curve> CPUParticles3D::get_scale_curve_x() const {
  396. return scale_curve_x;
  397. }
  398. Ref<Curve> CPUParticles3D::get_scale_curve_y() const {
  399. return scale_curve_y;
  400. }
  401. Ref<Curve> CPUParticles3D::get_scale_curve_z() const {
  402. return scale_curve_z;
  403. }
  404. bool CPUParticles3D::get_split_scale() {
  405. return split_scale;
  406. }
  407. void CPUParticles3D::_validate_property(PropertyInfo &p_property) const {
  408. if (p_property.name == "emission_sphere_radius" && (emission_shape != EMISSION_SHAPE_SPHERE && emission_shape != EMISSION_SHAPE_SPHERE_SURFACE)) {
  409. p_property.usage = PROPERTY_USAGE_NONE;
  410. }
  411. if (p_property.name == "emission_box_extents" && emission_shape != EMISSION_SHAPE_BOX) {
  412. p_property.usage = PROPERTY_USAGE_NONE;
  413. }
  414. if ((p_property.name == "emission_point_texture" || p_property.name == "emission_color_texture" || p_property.name == "emission_points") && (emission_shape != EMISSION_SHAPE_POINTS && (emission_shape != EMISSION_SHAPE_DIRECTED_POINTS))) {
  415. p_property.usage = PROPERTY_USAGE_NONE;
  416. }
  417. if (p_property.name == "emission_normals" && emission_shape != EMISSION_SHAPE_DIRECTED_POINTS) {
  418. p_property.usage = PROPERTY_USAGE_NONE;
  419. }
  420. if (p_property.name.begins_with("emission_ring_") && emission_shape != EMISSION_SHAPE_RING) {
  421. p_property.usage = PROPERTY_USAGE_NONE;
  422. }
  423. if (p_property.name.begins_with("orbit_") && !particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  424. p_property.usage = PROPERTY_USAGE_NONE;
  425. }
  426. if (p_property.name.begins_with("scale_curve_") && !split_scale) {
  427. p_property.usage = PROPERTY_USAGE_NONE;
  428. }
  429. }
  430. static uint32_t idhash(uint32_t x) {
  431. x = ((x >> uint32_t(16)) ^ x) * uint32_t(0x45d9f3b);
  432. x = ((x >> uint32_t(16)) ^ x) * uint32_t(0x45d9f3b);
  433. x = (x >> uint32_t(16)) ^ x;
  434. return x;
  435. }
  436. static real_t rand_from_seed(uint32_t &seed) {
  437. int k;
  438. int s = int(seed);
  439. if (s == 0) {
  440. s = 305420679;
  441. }
  442. k = s / 127773;
  443. s = 16807 * (s - k * 127773) - 2836 * k;
  444. if (s < 0) {
  445. s += 2147483647;
  446. }
  447. seed = uint32_t(s);
  448. return (seed % uint32_t(65536)) / 65535.0;
  449. }
  450. void CPUParticles3D::_update_internal() {
  451. if (particles.size() == 0 || !is_visible_in_tree()) {
  452. _set_redraw(false);
  453. return;
  454. }
  455. double delta = get_process_delta_time();
  456. if (emitting) {
  457. inactive_time = 0;
  458. } else {
  459. inactive_time += delta;
  460. if (inactive_time > lifetime * 1.2) {
  461. set_process_internal(false);
  462. _set_redraw(false);
  463. //reset variables
  464. time = 0;
  465. inactive_time = 0;
  466. frame_remainder = 0;
  467. cycle = 0;
  468. return;
  469. }
  470. }
  471. _set_redraw(true);
  472. bool processed = false;
  473. if (time == 0 && pre_process_time > 0.0) {
  474. double frame_time;
  475. if (fixed_fps > 0) {
  476. frame_time = 1.0 / fixed_fps;
  477. } else {
  478. frame_time = 1.0 / 30.0;
  479. }
  480. double todo = pre_process_time;
  481. while (todo >= 0) {
  482. _particles_process(frame_time);
  483. processed = true;
  484. todo -= frame_time;
  485. }
  486. }
  487. if (fixed_fps > 0) {
  488. double frame_time = 1.0 / fixed_fps;
  489. double decr = frame_time;
  490. double ldelta = delta;
  491. if (ldelta > 0.1) { //avoid recursive stalls if fps goes below 10
  492. ldelta = 0.1;
  493. } else if (ldelta <= 0.0) { //unlikely but..
  494. ldelta = 0.001;
  495. }
  496. double todo = frame_remainder + ldelta;
  497. while (todo >= frame_time) {
  498. _particles_process(frame_time);
  499. processed = true;
  500. todo -= decr;
  501. }
  502. frame_remainder = todo;
  503. } else {
  504. _particles_process(delta);
  505. processed = true;
  506. }
  507. if (processed) {
  508. _update_particle_data_buffer();
  509. }
  510. }
  511. void CPUParticles3D::_particles_process(double p_delta) {
  512. p_delta *= speed_scale;
  513. int pcount = particles.size();
  514. Particle *w = particles.ptrw();
  515. Particle *parray = w;
  516. double prev_time = time;
  517. time += p_delta;
  518. if (time > lifetime) {
  519. time = Math::fmod(time, lifetime);
  520. cycle++;
  521. if (one_shot && cycle > 0) {
  522. set_emitting(false);
  523. notify_property_list_changed();
  524. }
  525. }
  526. Transform3D emission_xform;
  527. Basis velocity_xform;
  528. if (!local_coords) {
  529. emission_xform = get_global_transform();
  530. velocity_xform = emission_xform.basis;
  531. }
  532. double system_phase = time / lifetime;
  533. for (int i = 0; i < pcount; i++) {
  534. Particle &p = parray[i];
  535. if (!emitting && !p.active) {
  536. continue;
  537. }
  538. double local_delta = p_delta;
  539. // The phase is a ratio between 0 (birth) and 1 (end of life) for each particle.
  540. // While we use time in tests later on, for randomness we use the phase as done in the
  541. // original shader code, and we later multiply by lifetime to get the time.
  542. double restart_phase = double(i) / double(pcount);
  543. if (randomness_ratio > 0.0) {
  544. uint32_t seed = cycle;
  545. if (restart_phase >= system_phase) {
  546. seed -= uint32_t(1);
  547. }
  548. seed *= uint32_t(pcount);
  549. seed += uint32_t(i);
  550. double random = double(idhash(seed) % uint32_t(65536)) / 65536.0;
  551. restart_phase += randomness_ratio * random * 1.0 / double(pcount);
  552. }
  553. restart_phase *= (1.0 - explosiveness_ratio);
  554. double restart_time = restart_phase * lifetime;
  555. bool restart = false;
  556. if (time > prev_time) {
  557. // restart_time >= prev_time is used so particles emit in the first frame they are processed
  558. if (restart_time >= prev_time && restart_time < time) {
  559. restart = true;
  560. if (fractional_delta) {
  561. local_delta = time - restart_time;
  562. }
  563. }
  564. } else if (local_delta > 0.0) {
  565. if (restart_time >= prev_time) {
  566. restart = true;
  567. if (fractional_delta) {
  568. local_delta = lifetime - restart_time + time;
  569. }
  570. } else if (restart_time < time) {
  571. restart = true;
  572. if (fractional_delta) {
  573. local_delta = time - restart_time;
  574. }
  575. }
  576. }
  577. if (p.time * (1.0 - explosiveness_ratio) > p.lifetime) {
  578. restart = true;
  579. }
  580. float tv = 0.0;
  581. if (restart) {
  582. if (!emitting) {
  583. p.active = false;
  584. continue;
  585. }
  586. p.active = true;
  587. /*real_t tex_linear_velocity = 0;
  588. if (curve_parameters[PARAM_INITIAL_LINEAR_VELOCITY].is_valid()) {
  589. tex_linear_velocity = curve_parameters[PARAM_INITIAL_LINEAR_VELOCITY]->sample(0);
  590. }*/
  591. real_t tex_angle = 1.0;
  592. if (curve_parameters[PARAM_ANGLE].is_valid()) {
  593. tex_angle = curve_parameters[PARAM_ANGLE]->sample(tv);
  594. }
  595. real_t tex_anim_offset = 1.0;
  596. if (curve_parameters[PARAM_ANGLE].is_valid()) {
  597. tex_anim_offset = curve_parameters[PARAM_ANGLE]->sample(tv);
  598. }
  599. p.seed = Math::rand();
  600. p.angle_rand = Math::randf();
  601. p.scale_rand = Math::randf();
  602. p.hue_rot_rand = Math::randf();
  603. p.anim_offset_rand = Math::randf();
  604. if (color_initial_ramp.is_valid()) {
  605. p.start_color_rand = color_initial_ramp->get_color_at_offset(Math::randf());
  606. } else {
  607. p.start_color_rand = Color(1, 1, 1, 1);
  608. }
  609. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  610. real_t angle1_rad = Math::atan2(direction.y, direction.x) + Math::deg_to_rad((Math::randf() * 2.0 - 1.0) * spread);
  611. Vector3 rot = Vector3(Math::cos(angle1_rad), Math::sin(angle1_rad), 0.0);
  612. p.velocity = rot * Math::lerp(parameters_min[PARAM_INITIAL_LINEAR_VELOCITY], parameters_max[PARAM_INITIAL_LINEAR_VELOCITY], (real_t)Math::randf());
  613. } else {
  614. //initiate velocity spread in 3D
  615. real_t angle1_rad = Math::deg_to_rad((Math::randf() * (real_t)2.0 - (real_t)1.0) * spread);
  616. real_t angle2_rad = Math::deg_to_rad((Math::randf() * (real_t)2.0 - (real_t)1.0) * ((real_t)1.0 - flatness) * spread);
  617. Vector3 direction_xz = Vector3(Math::sin(angle1_rad), 0, Math::cos(angle1_rad));
  618. Vector3 direction_yz = Vector3(0, Math::sin(angle2_rad), Math::cos(angle2_rad));
  619. Vector3 spread_direction = Vector3(direction_xz.x * direction_yz.z, direction_yz.y, direction_xz.z * direction_yz.z);
  620. Vector3 direction_nrm = direction;
  621. if (direction_nrm.length_squared() > 0) {
  622. direction_nrm.normalize();
  623. } else {
  624. direction_nrm = Vector3(0, 0, 1);
  625. }
  626. // rotate spread to direction
  627. Vector3 binormal = Vector3(0.0, 1.0, 0.0).cross(direction_nrm);
  628. if (binormal.length_squared() < 0.00000001) {
  629. // direction is parallel to Y. Choose Z as the binormal.
  630. binormal = Vector3(0.0, 0.0, 1.0);
  631. }
  632. binormal.normalize();
  633. Vector3 normal = binormal.cross(direction_nrm);
  634. spread_direction = binormal * spread_direction.x + normal * spread_direction.y + direction_nrm * spread_direction.z;
  635. p.velocity = spread_direction * Math::lerp(parameters_min[PARAM_INITIAL_LINEAR_VELOCITY], parameters_max[PARAM_INITIAL_LINEAR_VELOCITY], (real_t)Math::randf());
  636. }
  637. real_t base_angle = tex_angle * Math::lerp(parameters_min[PARAM_ANGLE], parameters_max[PARAM_ANGLE], p.angle_rand);
  638. p.custom[0] = Math::deg_to_rad(base_angle); //angle
  639. p.custom[1] = 0.0; //phase
  640. p.custom[2] = tex_anim_offset * Math::lerp(parameters_min[PARAM_ANIM_OFFSET], parameters_max[PARAM_ANIM_OFFSET], p.anim_offset_rand); //animation offset (0-1)
  641. p.transform = Transform3D();
  642. p.time = 0;
  643. p.lifetime = lifetime * (1.0 - Math::randf() * lifetime_randomness);
  644. p.base_color = Color(1, 1, 1, 1);
  645. switch (emission_shape) {
  646. case EMISSION_SHAPE_POINT: {
  647. //do none
  648. } break;
  649. case EMISSION_SHAPE_SPHERE: {
  650. real_t s = 2.0 * Math::randf() - 1.0;
  651. real_t t = Math_TAU * Math::randf();
  652. real_t x = Math::randf();
  653. real_t radius = emission_sphere_radius * Math::sqrt(1.0 - s * s);
  654. p.transform.origin = Vector3(0, 0, 0).lerp(Vector3(radius * Math::cos(t), radius * Math::sin(t), emission_sphere_radius * s), x);
  655. } break;
  656. case EMISSION_SHAPE_SPHERE_SURFACE: {
  657. real_t s = 2.0 * Math::randf() - 1.0;
  658. real_t t = Math_TAU * Math::randf();
  659. real_t radius = emission_sphere_radius * Math::sqrt(1.0 - s * s);
  660. p.transform.origin = Vector3(radius * Math::cos(t), radius * Math::sin(t), emission_sphere_radius * s);
  661. } break;
  662. case EMISSION_SHAPE_BOX: {
  663. p.transform.origin = Vector3(Math::randf() * 2.0 - 1.0, Math::randf() * 2.0 - 1.0, Math::randf() * 2.0 - 1.0) * emission_box_extents;
  664. } break;
  665. case EMISSION_SHAPE_POINTS:
  666. case EMISSION_SHAPE_DIRECTED_POINTS: {
  667. int pc = emission_points.size();
  668. if (pc == 0) {
  669. break;
  670. }
  671. int random_idx = Math::rand() % pc;
  672. p.transform.origin = emission_points.get(random_idx);
  673. if (emission_shape == EMISSION_SHAPE_DIRECTED_POINTS && emission_normals.size() == pc) {
  674. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  675. Vector3 normal = emission_normals.get(random_idx);
  676. Vector2 normal_2d(normal.x, normal.y);
  677. Transform2D m2;
  678. m2.columns[0] = normal_2d;
  679. m2.columns[1] = normal_2d.orthogonal();
  680. Vector2 velocity_2d(p.velocity.x, p.velocity.y);
  681. velocity_2d = m2.basis_xform(velocity_2d);
  682. p.velocity.x = velocity_2d.x;
  683. p.velocity.y = velocity_2d.y;
  684. } else {
  685. Vector3 normal = emission_normals.get(random_idx);
  686. Vector3 v0 = Math::abs(normal.z) < 0.999 ? Vector3(0.0, 0.0, 1.0) : Vector3(0, 1.0, 0.0);
  687. Vector3 tangent = v0.cross(normal).normalized();
  688. Vector3 bitangent = tangent.cross(normal).normalized();
  689. Basis m3;
  690. m3.set_column(0, tangent);
  691. m3.set_column(1, bitangent);
  692. m3.set_column(2, normal);
  693. p.velocity = m3.xform(p.velocity);
  694. }
  695. }
  696. if (emission_colors.size() == pc) {
  697. p.base_color = emission_colors.get(random_idx);
  698. }
  699. } break;
  700. case EMISSION_SHAPE_RING: {
  701. real_t ring_random_angle = Math::randf() * Math_TAU;
  702. real_t ring_random_radius = Math::randf() * (emission_ring_radius - emission_ring_inner_radius) + emission_ring_inner_radius;
  703. Vector3 axis = emission_ring_axis.normalized();
  704. Vector3 ortho_axis;
  705. if (axis == Vector3(1.0, 0.0, 0.0)) {
  706. ortho_axis = Vector3(0.0, 1.0, 0.0).cross(axis);
  707. } else {
  708. ortho_axis = Vector3(1.0, 0.0, 0.0).cross(axis);
  709. }
  710. ortho_axis = ortho_axis.normalized();
  711. ortho_axis.rotate(axis, ring_random_angle);
  712. ortho_axis = ortho_axis.normalized();
  713. p.transform.origin = ortho_axis * ring_random_radius + (Math::randf() * emission_ring_height - emission_ring_height / 2.0) * axis;
  714. } break;
  715. case EMISSION_SHAPE_MAX: { // Max value for validity check.
  716. break;
  717. }
  718. }
  719. if (!local_coords) {
  720. p.velocity = velocity_xform.xform(p.velocity);
  721. p.transform = emission_xform * p.transform;
  722. }
  723. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  724. p.velocity.z = 0.0;
  725. p.transform.origin.z = 0.0;
  726. }
  727. } else if (!p.active) {
  728. continue;
  729. } else if (p.time > p.lifetime) {
  730. p.active = false;
  731. tv = 1.0;
  732. } else {
  733. uint32_t alt_seed = p.seed;
  734. p.time += local_delta;
  735. p.custom[1] = p.time / lifetime;
  736. tv = p.time / p.lifetime;
  737. real_t tex_linear_velocity = 1.0;
  738. if (curve_parameters[PARAM_INITIAL_LINEAR_VELOCITY].is_valid()) {
  739. tex_linear_velocity = curve_parameters[PARAM_INITIAL_LINEAR_VELOCITY]->sample(tv);
  740. }
  741. real_t tex_orbit_velocity = 1.0;
  742. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  743. if (curve_parameters[PARAM_ORBIT_VELOCITY].is_valid()) {
  744. tex_orbit_velocity = curve_parameters[PARAM_ORBIT_VELOCITY]->sample(tv);
  745. }
  746. }
  747. real_t tex_angular_velocity = 1.0;
  748. if (curve_parameters[PARAM_ANGULAR_VELOCITY].is_valid()) {
  749. tex_angular_velocity = curve_parameters[PARAM_ANGULAR_VELOCITY]->sample(tv);
  750. }
  751. real_t tex_linear_accel = 1.0;
  752. if (curve_parameters[PARAM_LINEAR_ACCEL].is_valid()) {
  753. tex_linear_accel = curve_parameters[PARAM_LINEAR_ACCEL]->sample(tv);
  754. }
  755. real_t tex_tangential_accel = 1.0;
  756. if (curve_parameters[PARAM_TANGENTIAL_ACCEL].is_valid()) {
  757. tex_tangential_accel = curve_parameters[PARAM_TANGENTIAL_ACCEL]->sample(tv);
  758. }
  759. real_t tex_radial_accel = 1.0;
  760. if (curve_parameters[PARAM_RADIAL_ACCEL].is_valid()) {
  761. tex_radial_accel = curve_parameters[PARAM_RADIAL_ACCEL]->sample(tv);
  762. }
  763. real_t tex_damping = 1.0;
  764. if (curve_parameters[PARAM_DAMPING].is_valid()) {
  765. tex_damping = curve_parameters[PARAM_DAMPING]->sample(tv);
  766. }
  767. real_t tex_angle = 1.0;
  768. if (curve_parameters[PARAM_ANGLE].is_valid()) {
  769. tex_angle = curve_parameters[PARAM_ANGLE]->sample(tv);
  770. }
  771. real_t tex_anim_speed = 1.0;
  772. if (curve_parameters[PARAM_ANIM_SPEED].is_valid()) {
  773. tex_anim_speed = curve_parameters[PARAM_ANIM_SPEED]->sample(tv);
  774. }
  775. real_t tex_anim_offset = 1.0;
  776. if (curve_parameters[PARAM_ANIM_OFFSET].is_valid()) {
  777. tex_anim_offset = curve_parameters[PARAM_ANIM_OFFSET]->sample(tv);
  778. }
  779. Vector3 force = gravity;
  780. Vector3 position = p.transform.origin;
  781. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  782. position.z = 0.0;
  783. }
  784. //apply linear acceleration
  785. force += p.velocity.length() > 0.0 ? p.velocity.normalized() * tex_linear_accel * Math::lerp(parameters_min[PARAM_LINEAR_ACCEL], parameters_max[PARAM_LINEAR_ACCEL], rand_from_seed(alt_seed)) : Vector3();
  786. //apply radial acceleration
  787. Vector3 org = emission_xform.origin;
  788. Vector3 diff = position - org;
  789. force += diff.length() > 0.0 ? diff.normalized() * (tex_radial_accel)*Math::lerp(parameters_min[PARAM_RADIAL_ACCEL], parameters_max[PARAM_RADIAL_ACCEL], rand_from_seed(alt_seed)) : Vector3();
  790. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  791. Vector2 yx = Vector2(diff.y, diff.x);
  792. Vector2 yx2 = (yx * Vector2(-1.0, 1.0)).normalized();
  793. force += yx.length() > 0.0 ? Vector3(yx2.x, yx2.y, 0.0) * (tex_tangential_accel * Math::lerp(parameters_min[PARAM_TANGENTIAL_ACCEL], parameters_max[PARAM_TANGENTIAL_ACCEL], rand_from_seed(alt_seed))) : Vector3();
  794. } else {
  795. Vector3 crossDiff = diff.normalized().cross(gravity.normalized());
  796. force += crossDiff.length() > 0.0 ? crossDiff.normalized() * (tex_tangential_accel * Math::lerp(parameters_min[PARAM_TANGENTIAL_ACCEL], parameters_max[PARAM_TANGENTIAL_ACCEL], rand_from_seed(alt_seed))) : Vector3();
  797. }
  798. //apply attractor forces
  799. p.velocity += force * local_delta;
  800. //orbit velocity
  801. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  802. real_t orbit_amount = tex_orbit_velocity * Math::lerp(parameters_min[PARAM_ORBIT_VELOCITY], parameters_max[PARAM_ORBIT_VELOCITY], rand_from_seed(alt_seed));
  803. if (orbit_amount != 0.0) {
  804. real_t ang = orbit_amount * local_delta * Math_TAU;
  805. // Not sure why the ParticleProcessMaterial code uses a clockwise rotation matrix,
  806. // but we use -ang here to reproduce its behavior.
  807. Transform2D rot = Transform2D(-ang, Vector2());
  808. Vector2 rotv = rot.basis_xform(Vector2(diff.x, diff.y));
  809. p.transform.origin -= Vector3(diff.x, diff.y, 0);
  810. p.transform.origin += Vector3(rotv.x, rotv.y, 0);
  811. }
  812. }
  813. if (curve_parameters[PARAM_INITIAL_LINEAR_VELOCITY].is_valid()) {
  814. p.velocity = p.velocity.normalized() * tex_linear_velocity;
  815. }
  816. if (parameters_max[PARAM_DAMPING] + tex_damping > 0.0) {
  817. real_t v = p.velocity.length();
  818. real_t damp = tex_damping * Math::lerp(parameters_min[PARAM_DAMPING], parameters_max[PARAM_DAMPING], rand_from_seed(alt_seed));
  819. v -= damp * local_delta;
  820. if (v < 0.0) {
  821. p.velocity = Vector3();
  822. } else {
  823. p.velocity = p.velocity.normalized() * v;
  824. }
  825. }
  826. real_t base_angle = (tex_angle)*Math::lerp(parameters_min[PARAM_ANGLE], parameters_max[PARAM_ANGLE], p.angle_rand);
  827. base_angle += p.custom[1] * lifetime * tex_angular_velocity * Math::lerp(parameters_min[PARAM_ANGULAR_VELOCITY], parameters_max[PARAM_ANGULAR_VELOCITY], rand_from_seed(alt_seed));
  828. p.custom[0] = Math::deg_to_rad(base_angle); //angle
  829. p.custom[2] = tex_anim_offset * Math::lerp(parameters_min[PARAM_ANIM_OFFSET], parameters_max[PARAM_ANIM_OFFSET], p.anim_offset_rand) + tv * tex_anim_speed * Math::lerp(parameters_min[PARAM_ANIM_SPEED], parameters_max[PARAM_ANIM_SPEED], rand_from_seed(alt_seed)); //angle
  830. }
  831. //apply color
  832. //apply hue rotation
  833. Vector3 tex_scale = Vector3(1.0, 1.0, 1.0);
  834. if (split_scale) {
  835. if (scale_curve_x.is_valid()) {
  836. tex_scale.x = scale_curve_x->sample(tv);
  837. } else {
  838. tex_scale.x = 1.0;
  839. }
  840. if (scale_curve_y.is_valid()) {
  841. tex_scale.y = scale_curve_y->sample(tv);
  842. } else {
  843. tex_scale.y = 1.0;
  844. }
  845. if (scale_curve_z.is_valid()) {
  846. tex_scale.z = scale_curve_z->sample(tv);
  847. } else {
  848. tex_scale.z = 1.0;
  849. }
  850. } else {
  851. if (curve_parameters[PARAM_SCALE].is_valid()) {
  852. float tmp_scale = curve_parameters[PARAM_SCALE]->sample(tv);
  853. tex_scale.x = tmp_scale;
  854. tex_scale.y = tmp_scale;
  855. tex_scale.z = tmp_scale;
  856. }
  857. }
  858. real_t tex_hue_variation = 0.0;
  859. if (curve_parameters[PARAM_HUE_VARIATION].is_valid()) {
  860. tex_hue_variation = curve_parameters[PARAM_HUE_VARIATION]->sample(tv);
  861. }
  862. real_t hue_rot_angle = (tex_hue_variation)*Math_TAU * Math::lerp(parameters_min[PARAM_HUE_VARIATION], parameters_max[PARAM_HUE_VARIATION], p.hue_rot_rand);
  863. real_t hue_rot_c = Math::cos(hue_rot_angle);
  864. real_t hue_rot_s = Math::sin(hue_rot_angle);
  865. Basis hue_rot_mat;
  866. {
  867. Basis mat1(0.299, 0.587, 0.114, 0.299, 0.587, 0.114, 0.299, 0.587, 0.114);
  868. Basis mat2(0.701, -0.587, -0.114, -0.299, 0.413, -0.114, -0.300, -0.588, 0.886);
  869. Basis mat3(0.168, 0.330, -0.497, -0.328, 0.035, 0.292, 1.250, -1.050, -0.203);
  870. for (int j = 0; j < 3; j++) {
  871. hue_rot_mat[j] = mat1[j] + mat2[j] * hue_rot_c + mat3[j] * hue_rot_s;
  872. }
  873. }
  874. if (color_ramp.is_valid()) {
  875. p.color = color_ramp->get_color_at_offset(tv) * color;
  876. } else {
  877. p.color = color;
  878. }
  879. Vector3 color_rgb = hue_rot_mat.xform_inv(Vector3(p.color.r, p.color.g, p.color.b));
  880. p.color.r = color_rgb.x;
  881. p.color.g = color_rgb.y;
  882. p.color.b = color_rgb.z;
  883. p.color *= p.base_color * p.start_color_rand;
  884. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  885. if (particle_flags[PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY]) {
  886. if (p.velocity.length() > 0.0) {
  887. p.transform.basis.set_column(1, p.velocity.normalized());
  888. } else {
  889. p.transform.basis.set_column(1, p.transform.basis.get_column(1));
  890. }
  891. p.transform.basis.set_column(0, p.transform.basis.get_column(1).cross(p.transform.basis.get_column(2)).normalized());
  892. p.transform.basis.set_column(2, Vector3(0, 0, 1));
  893. } else {
  894. p.transform.basis.set_column(0, Vector3(Math::cos(p.custom[0]), -Math::sin(p.custom[0]), 0.0));
  895. p.transform.basis.set_column(1, Vector3(Math::sin(p.custom[0]), Math::cos(p.custom[0]), 0.0));
  896. p.transform.basis.set_column(2, Vector3(0, 0, 1));
  897. }
  898. } else {
  899. //orient particle Y towards velocity
  900. if (particle_flags[PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY]) {
  901. if (p.velocity.length() > 0.0) {
  902. p.transform.basis.set_column(1, p.velocity.normalized());
  903. } else {
  904. p.transform.basis.set_column(1, p.transform.basis.get_column(1).normalized());
  905. }
  906. if (p.transform.basis.get_column(1) == p.transform.basis.get_column(0)) {
  907. p.transform.basis.set_column(0, p.transform.basis.get_column(1).cross(p.transform.basis.get_column(2)).normalized());
  908. p.transform.basis.set_column(2, p.transform.basis.get_column(0).cross(p.transform.basis.get_column(1)).normalized());
  909. } else {
  910. p.transform.basis.set_column(2, p.transform.basis.get_column(0).cross(p.transform.basis.get_column(1)).normalized());
  911. p.transform.basis.set_column(0, p.transform.basis.get_column(1).cross(p.transform.basis.get_column(2)).normalized());
  912. }
  913. } else {
  914. p.transform.basis.orthonormalize();
  915. }
  916. //turn particle by rotation in Y
  917. if (particle_flags[PARTICLE_FLAG_ROTATE_Y]) {
  918. Basis rot_y(Vector3(0, 1, 0), p.custom[0]);
  919. p.transform.basis = p.transform.basis * rot_y;
  920. }
  921. }
  922. p.transform.basis = p.transform.basis.orthonormalized();
  923. //scale by scale
  924. Vector3 base_scale = tex_scale * Math::lerp(parameters_min[PARAM_SCALE], parameters_max[PARAM_SCALE], p.scale_rand);
  925. if (base_scale.x < CMP_EPSILON) {
  926. base_scale.x = CMP_EPSILON;
  927. }
  928. if (base_scale.y < CMP_EPSILON) {
  929. base_scale.y = CMP_EPSILON;
  930. }
  931. if (base_scale.z < CMP_EPSILON) {
  932. base_scale.z = CMP_EPSILON;
  933. }
  934. p.transform.basis.scale(base_scale);
  935. if (particle_flags[PARTICLE_FLAG_DISABLE_Z]) {
  936. p.velocity.z = 0.0;
  937. p.transform.origin.z = 0.0;
  938. }
  939. p.transform.origin += p.velocity * local_delta;
  940. }
  941. }
  942. void CPUParticles3D::_update_particle_data_buffer() {
  943. MutexLock lock(update_mutex);
  944. int pc = particles.size();
  945. int *ow;
  946. int *order = nullptr;
  947. float *w = particle_data.ptrw();
  948. const Particle *r = particles.ptr();
  949. float *ptr = w;
  950. if (draw_order != DRAW_ORDER_INDEX) {
  951. ow = particle_order.ptrw();
  952. order = ow;
  953. for (int i = 0; i < pc; i++) {
  954. order[i] = i;
  955. }
  956. if (draw_order == DRAW_ORDER_LIFETIME) {
  957. SortArray<int, SortLifetime> sorter;
  958. sorter.compare.particles = r;
  959. sorter.sort(order, pc);
  960. } else if (draw_order == DRAW_ORDER_VIEW_DEPTH) {
  961. ERR_FAIL_NULL(get_viewport());
  962. Camera3D *c = get_viewport()->get_camera_3d();
  963. if (c) {
  964. Vector3 dir = c->get_global_transform().basis.get_column(2); //far away to close
  965. if (local_coords) {
  966. // will look different from Particles in editor as this is based on the camera in the scenetree
  967. // and not the editor camera
  968. dir = inv_emission_transform.xform(dir).normalized();
  969. } else {
  970. dir = dir.normalized();
  971. }
  972. SortArray<int, SortAxis> sorter;
  973. sorter.compare.particles = r;
  974. sorter.compare.axis = dir;
  975. sorter.sort(order, pc);
  976. }
  977. }
  978. }
  979. for (int i = 0; i < pc; i++) {
  980. int idx = order ? order[i] : i;
  981. Transform3D t = r[idx].transform;
  982. if (!local_coords) {
  983. t = inv_emission_transform * t;
  984. }
  985. if (r[idx].active) {
  986. ptr[0] = t.basis.rows[0][0];
  987. ptr[1] = t.basis.rows[0][1];
  988. ptr[2] = t.basis.rows[0][2];
  989. ptr[3] = t.origin.x;
  990. ptr[4] = t.basis.rows[1][0];
  991. ptr[5] = t.basis.rows[1][1];
  992. ptr[6] = t.basis.rows[1][2];
  993. ptr[7] = t.origin.y;
  994. ptr[8] = t.basis.rows[2][0];
  995. ptr[9] = t.basis.rows[2][1];
  996. ptr[10] = t.basis.rows[2][2];
  997. ptr[11] = t.origin.z;
  998. } else {
  999. memset(ptr, 0, sizeof(float) * 12);
  1000. }
  1001. Color c = r[idx].color;
  1002. ptr[12] = c.r;
  1003. ptr[13] = c.g;
  1004. ptr[14] = c.b;
  1005. ptr[15] = c.a;
  1006. ptr[16] = r[idx].custom[0];
  1007. ptr[17] = r[idx].custom[1];
  1008. ptr[18] = r[idx].custom[2];
  1009. ptr[19] = r[idx].custom[3];
  1010. ptr += 20;
  1011. }
  1012. can_update.set();
  1013. }
  1014. void CPUParticles3D::_set_redraw(bool p_redraw) {
  1015. if (redraw == p_redraw) {
  1016. return;
  1017. }
  1018. redraw = p_redraw;
  1019. {
  1020. MutexLock lock(update_mutex);
  1021. if (redraw) {
  1022. RS::get_singleton()->connect("frame_pre_draw", callable_mp(this, &CPUParticles3D::_update_render_thread));
  1023. RS::get_singleton()->instance_geometry_set_flag(get_instance(), RS::INSTANCE_FLAG_DRAW_NEXT_FRAME_IF_VISIBLE, true);
  1024. RS::get_singleton()->multimesh_set_visible_instances(multimesh, -1);
  1025. } else {
  1026. if (RS::get_singleton()->is_connected("frame_pre_draw", callable_mp(this, &CPUParticles3D::_update_render_thread))) {
  1027. RS::get_singleton()->disconnect("frame_pre_draw", callable_mp(this, &CPUParticles3D::_update_render_thread));
  1028. }
  1029. RS::get_singleton()->instance_geometry_set_flag(get_instance(), RS::INSTANCE_FLAG_DRAW_NEXT_FRAME_IF_VISIBLE, false);
  1030. RS::get_singleton()->multimesh_set_visible_instances(multimesh, 0);
  1031. }
  1032. }
  1033. }
  1034. void CPUParticles3D::_update_render_thread() {
  1035. MutexLock lock(update_mutex);
  1036. if (can_update.is_set()) {
  1037. RS::get_singleton()->multimesh_set_buffer(multimesh, particle_data);
  1038. can_update.clear(); //wait for next time
  1039. }
  1040. }
  1041. void CPUParticles3D::_notification(int p_what) {
  1042. switch (p_what) {
  1043. case NOTIFICATION_ENTER_TREE: {
  1044. set_process_internal(emitting);
  1045. // first update before rendering to avoid one frame delay after emitting starts
  1046. if (emitting && (time == 0)) {
  1047. _update_internal();
  1048. }
  1049. } break;
  1050. case NOTIFICATION_EXIT_TREE: {
  1051. _set_redraw(false);
  1052. } break;
  1053. case NOTIFICATION_VISIBILITY_CHANGED: {
  1054. // first update before rendering to avoid one frame delay after emitting starts
  1055. if (emitting && (time == 0)) {
  1056. _update_internal();
  1057. }
  1058. } break;
  1059. case NOTIFICATION_INTERNAL_PROCESS: {
  1060. _update_internal();
  1061. } break;
  1062. case NOTIFICATION_TRANSFORM_CHANGED: {
  1063. inv_emission_transform = get_global_transform().affine_inverse();
  1064. if (!local_coords) {
  1065. int pc = particles.size();
  1066. float *w = particle_data.ptrw();
  1067. const Particle *r = particles.ptr();
  1068. float *ptr = w;
  1069. for (int i = 0; i < pc; i++) {
  1070. Transform3D t = inv_emission_transform * r[i].transform;
  1071. if (r[i].active) {
  1072. ptr[0] = t.basis.rows[0][0];
  1073. ptr[1] = t.basis.rows[0][1];
  1074. ptr[2] = t.basis.rows[0][2];
  1075. ptr[3] = t.origin.x;
  1076. ptr[4] = t.basis.rows[1][0];
  1077. ptr[5] = t.basis.rows[1][1];
  1078. ptr[6] = t.basis.rows[1][2];
  1079. ptr[7] = t.origin.y;
  1080. ptr[8] = t.basis.rows[2][0];
  1081. ptr[9] = t.basis.rows[2][1];
  1082. ptr[10] = t.basis.rows[2][2];
  1083. ptr[11] = t.origin.z;
  1084. } else {
  1085. memset(ptr, 0, sizeof(float) * 12);
  1086. }
  1087. ptr += 20;
  1088. }
  1089. can_update.set();
  1090. }
  1091. } break;
  1092. }
  1093. }
  1094. void CPUParticles3D::convert_from_particles(Node *p_particles) {
  1095. GPUParticles3D *gpu_particles = Object::cast_to<GPUParticles3D>(p_particles);
  1096. ERR_FAIL_COND_MSG(!gpu_particles, "Only GPUParticles3D nodes can be converted to CPUParticles3D.");
  1097. set_emitting(gpu_particles->is_emitting());
  1098. set_amount(gpu_particles->get_amount());
  1099. set_lifetime(gpu_particles->get_lifetime());
  1100. set_one_shot(gpu_particles->get_one_shot());
  1101. set_pre_process_time(gpu_particles->get_pre_process_time());
  1102. set_explosiveness_ratio(gpu_particles->get_explosiveness_ratio());
  1103. set_randomness_ratio(gpu_particles->get_randomness_ratio());
  1104. set_use_local_coordinates(gpu_particles->get_use_local_coordinates());
  1105. set_fixed_fps(gpu_particles->get_fixed_fps());
  1106. set_fractional_delta(gpu_particles->get_fractional_delta());
  1107. set_speed_scale(gpu_particles->get_speed_scale());
  1108. set_draw_order(DrawOrder(gpu_particles->get_draw_order()));
  1109. set_mesh(gpu_particles->get_draw_pass_mesh(0));
  1110. Ref<ParticleProcessMaterial> material = gpu_particles->get_process_material();
  1111. if (material.is_null()) {
  1112. return;
  1113. }
  1114. set_direction(material->get_direction());
  1115. set_spread(material->get_spread());
  1116. set_flatness(material->get_flatness());
  1117. set_color(material->get_color());
  1118. Ref<GradientTexture1D> gt = material->get_color_ramp();
  1119. if (gt.is_valid()) {
  1120. set_color_ramp(gt->get_gradient());
  1121. }
  1122. Ref<GradientTexture1D> gti = material->get_color_initial_ramp();
  1123. if (gti.is_valid()) {
  1124. set_color_initial_ramp(gti->get_gradient());
  1125. }
  1126. set_particle_flag(PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY, material->get_particle_flag(ParticleProcessMaterial::PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY));
  1127. set_particle_flag(PARTICLE_FLAG_ROTATE_Y, material->get_particle_flag(ParticleProcessMaterial::PARTICLE_FLAG_ROTATE_Y));
  1128. set_particle_flag(PARTICLE_FLAG_DISABLE_Z, material->get_particle_flag(ParticleProcessMaterial::PARTICLE_FLAG_DISABLE_Z));
  1129. set_emission_shape(EmissionShape(material->get_emission_shape()));
  1130. set_emission_sphere_radius(material->get_emission_sphere_radius());
  1131. set_emission_box_extents(material->get_emission_box_extents());
  1132. Ref<CurveXYZTexture> scale3D = material->get_param_texture(ParticleProcessMaterial::PARAM_SCALE);
  1133. if (scale3D.is_valid()) {
  1134. split_scale = true;
  1135. scale_curve_x = scale3D->get_curve_x();
  1136. scale_curve_y = scale3D->get_curve_y();
  1137. scale_curve_z = scale3D->get_curve_z();
  1138. }
  1139. set_gravity(material->get_gravity());
  1140. set_lifetime_randomness(material->get_lifetime_randomness());
  1141. #define CONVERT_PARAM(m_param) \
  1142. set_param_min(m_param, material->get_param_min(ParticleProcessMaterial::m_param)); \
  1143. { \
  1144. Ref<CurveTexture> ctex = material->get_param_texture(ParticleProcessMaterial::m_param); \
  1145. if (ctex.is_valid()) \
  1146. set_param_curve(m_param, ctex->get_curve()); \
  1147. } \
  1148. set_param_max(m_param, material->get_param_max(ParticleProcessMaterial::m_param));
  1149. CONVERT_PARAM(PARAM_INITIAL_LINEAR_VELOCITY);
  1150. CONVERT_PARAM(PARAM_ANGULAR_VELOCITY);
  1151. CONVERT_PARAM(PARAM_ORBIT_VELOCITY);
  1152. CONVERT_PARAM(PARAM_LINEAR_ACCEL);
  1153. CONVERT_PARAM(PARAM_RADIAL_ACCEL);
  1154. CONVERT_PARAM(PARAM_TANGENTIAL_ACCEL);
  1155. CONVERT_PARAM(PARAM_DAMPING);
  1156. CONVERT_PARAM(PARAM_ANGLE);
  1157. CONVERT_PARAM(PARAM_SCALE);
  1158. CONVERT_PARAM(PARAM_HUE_VARIATION);
  1159. CONVERT_PARAM(PARAM_ANIM_SPEED);
  1160. CONVERT_PARAM(PARAM_ANIM_OFFSET);
  1161. #undef CONVERT_PARAM
  1162. }
  1163. void CPUParticles3D::_bind_methods() {
  1164. ClassDB::bind_method(D_METHOD("set_emitting", "emitting"), &CPUParticles3D::set_emitting);
  1165. ClassDB::bind_method(D_METHOD("set_amount", "amount"), &CPUParticles3D::set_amount);
  1166. ClassDB::bind_method(D_METHOD("set_lifetime", "secs"), &CPUParticles3D::set_lifetime);
  1167. ClassDB::bind_method(D_METHOD("set_one_shot", "enable"), &CPUParticles3D::set_one_shot);
  1168. ClassDB::bind_method(D_METHOD("set_pre_process_time", "secs"), &CPUParticles3D::set_pre_process_time);
  1169. ClassDB::bind_method(D_METHOD("set_explosiveness_ratio", "ratio"), &CPUParticles3D::set_explosiveness_ratio);
  1170. ClassDB::bind_method(D_METHOD("set_randomness_ratio", "ratio"), &CPUParticles3D::set_randomness_ratio);
  1171. ClassDB::bind_method(D_METHOD("set_lifetime_randomness", "random"), &CPUParticles3D::set_lifetime_randomness);
  1172. ClassDB::bind_method(D_METHOD("set_use_local_coordinates", "enable"), &CPUParticles3D::set_use_local_coordinates);
  1173. ClassDB::bind_method(D_METHOD("set_fixed_fps", "fps"), &CPUParticles3D::set_fixed_fps);
  1174. ClassDB::bind_method(D_METHOD("set_fractional_delta", "enable"), &CPUParticles3D::set_fractional_delta);
  1175. ClassDB::bind_method(D_METHOD("set_speed_scale", "scale"), &CPUParticles3D::set_speed_scale);
  1176. ClassDB::bind_method(D_METHOD("is_emitting"), &CPUParticles3D::is_emitting);
  1177. ClassDB::bind_method(D_METHOD("get_amount"), &CPUParticles3D::get_amount);
  1178. ClassDB::bind_method(D_METHOD("get_lifetime"), &CPUParticles3D::get_lifetime);
  1179. ClassDB::bind_method(D_METHOD("get_one_shot"), &CPUParticles3D::get_one_shot);
  1180. ClassDB::bind_method(D_METHOD("get_pre_process_time"), &CPUParticles3D::get_pre_process_time);
  1181. ClassDB::bind_method(D_METHOD("get_explosiveness_ratio"), &CPUParticles3D::get_explosiveness_ratio);
  1182. ClassDB::bind_method(D_METHOD("get_randomness_ratio"), &CPUParticles3D::get_randomness_ratio);
  1183. ClassDB::bind_method(D_METHOD("get_lifetime_randomness"), &CPUParticles3D::get_lifetime_randomness);
  1184. ClassDB::bind_method(D_METHOD("get_use_local_coordinates"), &CPUParticles3D::get_use_local_coordinates);
  1185. ClassDB::bind_method(D_METHOD("get_fixed_fps"), &CPUParticles3D::get_fixed_fps);
  1186. ClassDB::bind_method(D_METHOD("get_fractional_delta"), &CPUParticles3D::get_fractional_delta);
  1187. ClassDB::bind_method(D_METHOD("get_speed_scale"), &CPUParticles3D::get_speed_scale);
  1188. ClassDB::bind_method(D_METHOD("set_draw_order", "order"), &CPUParticles3D::set_draw_order);
  1189. ClassDB::bind_method(D_METHOD("get_draw_order"), &CPUParticles3D::get_draw_order);
  1190. ClassDB::bind_method(D_METHOD("set_mesh", "mesh"), &CPUParticles3D::set_mesh);
  1191. ClassDB::bind_method(D_METHOD("get_mesh"), &CPUParticles3D::get_mesh);
  1192. ClassDB::bind_method(D_METHOD("restart"), &CPUParticles3D::restart);
  1193. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "emitting"), "set_emitting", "is_emitting");
  1194. ADD_PROPERTY(PropertyInfo(Variant::INT, "amount", PROPERTY_HINT_RANGE, "1,1000000,1,exp"), "set_amount", "get_amount");
  1195. ADD_GROUP("Time", "");
  1196. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "lifetime", PROPERTY_HINT_RANGE, "0.01,600.0,0.01,or_greater,exp,suffix:s"), "set_lifetime", "get_lifetime");
  1197. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "one_shot"), "set_one_shot", "get_one_shot");
  1198. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "preprocess", PROPERTY_HINT_RANGE, "0.00,600.0,0.01,exp,suffix:s"), "set_pre_process_time", "get_pre_process_time");
  1199. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "speed_scale", PROPERTY_HINT_RANGE, "0,64,0.01"), "set_speed_scale", "get_speed_scale");
  1200. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "explosiveness", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_explosiveness_ratio", "get_explosiveness_ratio");
  1201. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "randomness", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_randomness_ratio", "get_randomness_ratio");
  1202. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "lifetime_randomness", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_lifetime_randomness", "get_lifetime_randomness");
  1203. ADD_PROPERTY(PropertyInfo(Variant::INT, "fixed_fps", PROPERTY_HINT_RANGE, "0,1000,1,suffix:FPS"), "set_fixed_fps", "get_fixed_fps");
  1204. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "fract_delta"), "set_fractional_delta", "get_fractional_delta");
  1205. ADD_GROUP("Drawing", "");
  1206. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "local_coords"), "set_use_local_coordinates", "get_use_local_coordinates");
  1207. ADD_PROPERTY(PropertyInfo(Variant::INT, "draw_order", PROPERTY_HINT_ENUM, "Index,Lifetime,View Depth"), "set_draw_order", "get_draw_order");
  1208. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "mesh", PROPERTY_HINT_RESOURCE_TYPE, "Mesh"), "set_mesh", "get_mesh");
  1209. BIND_ENUM_CONSTANT(DRAW_ORDER_INDEX);
  1210. BIND_ENUM_CONSTANT(DRAW_ORDER_LIFETIME);
  1211. BIND_ENUM_CONSTANT(DRAW_ORDER_VIEW_DEPTH);
  1212. ////////////////////////////////
  1213. ClassDB::bind_method(D_METHOD("set_direction", "direction"), &CPUParticles3D::set_direction);
  1214. ClassDB::bind_method(D_METHOD("get_direction"), &CPUParticles3D::get_direction);
  1215. ClassDB::bind_method(D_METHOD("set_spread", "degrees"), &CPUParticles3D::set_spread);
  1216. ClassDB::bind_method(D_METHOD("get_spread"), &CPUParticles3D::get_spread);
  1217. ClassDB::bind_method(D_METHOD("set_flatness", "amount"), &CPUParticles3D::set_flatness);
  1218. ClassDB::bind_method(D_METHOD("get_flatness"), &CPUParticles3D::get_flatness);
  1219. ClassDB::bind_method(D_METHOD("set_param_min", "param", "value"), &CPUParticles3D::set_param_min);
  1220. ClassDB::bind_method(D_METHOD("get_param_min", "param"), &CPUParticles3D::get_param_min);
  1221. ClassDB::bind_method(D_METHOD("set_param_max", "param", "value"), &CPUParticles3D::set_param_max);
  1222. ClassDB::bind_method(D_METHOD("get_param_max", "param"), &CPUParticles3D::get_param_max);
  1223. ClassDB::bind_method(D_METHOD("set_param_curve", "param", "curve"), &CPUParticles3D::set_param_curve);
  1224. ClassDB::bind_method(D_METHOD("get_param_curve", "param"), &CPUParticles3D::get_param_curve);
  1225. ClassDB::bind_method(D_METHOD("set_color", "color"), &CPUParticles3D::set_color);
  1226. ClassDB::bind_method(D_METHOD("get_color"), &CPUParticles3D::get_color);
  1227. ClassDB::bind_method(D_METHOD("set_color_ramp", "ramp"), &CPUParticles3D::set_color_ramp);
  1228. ClassDB::bind_method(D_METHOD("get_color_ramp"), &CPUParticles3D::get_color_ramp);
  1229. ClassDB::bind_method(D_METHOD("set_color_initial_ramp", "ramp"), &CPUParticles3D::set_color_initial_ramp);
  1230. ClassDB::bind_method(D_METHOD("get_color_initial_ramp"), &CPUParticles3D::get_color_initial_ramp);
  1231. ClassDB::bind_method(D_METHOD("set_particle_flag", "particle_flag", "enable"), &CPUParticles3D::set_particle_flag);
  1232. ClassDB::bind_method(D_METHOD("get_particle_flag", "particle_flag"), &CPUParticles3D::get_particle_flag);
  1233. ClassDB::bind_method(D_METHOD("set_emission_shape", "shape"), &CPUParticles3D::set_emission_shape);
  1234. ClassDB::bind_method(D_METHOD("get_emission_shape"), &CPUParticles3D::get_emission_shape);
  1235. ClassDB::bind_method(D_METHOD("set_emission_sphere_radius", "radius"), &CPUParticles3D::set_emission_sphere_radius);
  1236. ClassDB::bind_method(D_METHOD("get_emission_sphere_radius"), &CPUParticles3D::get_emission_sphere_radius);
  1237. ClassDB::bind_method(D_METHOD("set_emission_box_extents", "extents"), &CPUParticles3D::set_emission_box_extents);
  1238. ClassDB::bind_method(D_METHOD("get_emission_box_extents"), &CPUParticles3D::get_emission_box_extents);
  1239. ClassDB::bind_method(D_METHOD("set_emission_points", "array"), &CPUParticles3D::set_emission_points);
  1240. ClassDB::bind_method(D_METHOD("get_emission_points"), &CPUParticles3D::get_emission_points);
  1241. ClassDB::bind_method(D_METHOD("set_emission_normals", "array"), &CPUParticles3D::set_emission_normals);
  1242. ClassDB::bind_method(D_METHOD("get_emission_normals"), &CPUParticles3D::get_emission_normals);
  1243. ClassDB::bind_method(D_METHOD("set_emission_colors", "array"), &CPUParticles3D::set_emission_colors);
  1244. ClassDB::bind_method(D_METHOD("get_emission_colors"), &CPUParticles3D::get_emission_colors);
  1245. ClassDB::bind_method(D_METHOD("set_emission_ring_axis", "axis"), &CPUParticles3D::set_emission_ring_axis);
  1246. ClassDB::bind_method(D_METHOD("get_emission_ring_axis"), &CPUParticles3D::get_emission_ring_axis);
  1247. ClassDB::bind_method(D_METHOD("set_emission_ring_height", "height"), &CPUParticles3D::set_emission_ring_height);
  1248. ClassDB::bind_method(D_METHOD("get_emission_ring_height"), &CPUParticles3D::get_emission_ring_height);
  1249. ClassDB::bind_method(D_METHOD("set_emission_ring_radius", "radius"), &CPUParticles3D::set_emission_ring_radius);
  1250. ClassDB::bind_method(D_METHOD("get_emission_ring_radius"), &CPUParticles3D::get_emission_ring_radius);
  1251. ClassDB::bind_method(D_METHOD("set_emission_ring_inner_radius", "inner_radius"), &CPUParticles3D::set_emission_ring_inner_radius);
  1252. ClassDB::bind_method(D_METHOD("get_emission_ring_inner_radius"), &CPUParticles3D::get_emission_ring_inner_radius);
  1253. ClassDB::bind_method(D_METHOD("get_gravity"), &CPUParticles3D::get_gravity);
  1254. ClassDB::bind_method(D_METHOD("set_gravity", "accel_vec"), &CPUParticles3D::set_gravity);
  1255. ClassDB::bind_method(D_METHOD("get_split_scale"), &CPUParticles3D::get_split_scale);
  1256. ClassDB::bind_method(D_METHOD("set_split_scale", "split_scale"), &CPUParticles3D::set_split_scale);
  1257. ClassDB::bind_method(D_METHOD("get_scale_curve_x"), &CPUParticles3D::get_scale_curve_x);
  1258. ClassDB::bind_method(D_METHOD("set_scale_curve_x", "scale_curve"), &CPUParticles3D::set_scale_curve_x);
  1259. ClassDB::bind_method(D_METHOD("get_scale_curve_y"), &CPUParticles3D::get_scale_curve_y);
  1260. ClassDB::bind_method(D_METHOD("set_scale_curve_y", "scale_curve"), &CPUParticles3D::set_scale_curve_y);
  1261. ClassDB::bind_method(D_METHOD("get_scale_curve_z"), &CPUParticles3D::get_scale_curve_z);
  1262. ClassDB::bind_method(D_METHOD("set_scale_curve_z", "scale_curve"), &CPUParticles3D::set_scale_curve_z);
  1263. ClassDB::bind_method(D_METHOD("convert_from_particles", "particles"), &CPUParticles3D::convert_from_particles);
  1264. ADD_GROUP("Emission Shape", "emission_");
  1265. ADD_PROPERTY(PropertyInfo(Variant::INT, "emission_shape", PROPERTY_HINT_ENUM, "Point,Sphere,Sphere Surface,Box,Points,Directed Points,Ring", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED), "set_emission_shape", "get_emission_shape");
  1266. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "emission_sphere_radius", PROPERTY_HINT_RANGE, "0.01,128,0.01"), "set_emission_sphere_radius", "get_emission_sphere_radius");
  1267. ADD_PROPERTY(PropertyInfo(Variant::VECTOR3, "emission_box_extents"), "set_emission_box_extents", "get_emission_box_extents");
  1268. ADD_PROPERTY(PropertyInfo(Variant::PACKED_VECTOR3_ARRAY, "emission_points"), "set_emission_points", "get_emission_points");
  1269. ADD_PROPERTY(PropertyInfo(Variant::PACKED_VECTOR3_ARRAY, "emission_normals"), "set_emission_normals", "get_emission_normals");
  1270. ADD_PROPERTY(PropertyInfo(Variant::PACKED_COLOR_ARRAY, "emission_colors"), "set_emission_colors", "get_emission_colors");
  1271. ADD_PROPERTY(PropertyInfo(Variant::VECTOR3, "emission_ring_axis"), "set_emission_ring_axis", "get_emission_ring_axis");
  1272. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "emission_ring_height"), "set_emission_ring_height", "get_emission_ring_height");
  1273. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "emission_ring_radius"), "set_emission_ring_radius", "get_emission_ring_radius");
  1274. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "emission_ring_inner_radius"), "set_emission_ring_inner_radius", "get_emission_ring_inner_radius");
  1275. ADD_GROUP("Particle Flags", "particle_flag_");
  1276. ADD_PROPERTYI(PropertyInfo(Variant::BOOL, "particle_flag_align_y"), "set_particle_flag", "get_particle_flag", PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY);
  1277. ADD_PROPERTYI(PropertyInfo(Variant::BOOL, "particle_flag_rotate_y"), "set_particle_flag", "get_particle_flag", PARTICLE_FLAG_ROTATE_Y);
  1278. ADD_PROPERTYI(PropertyInfo(Variant::BOOL, "particle_flag_disable_z"), "set_particle_flag", "get_particle_flag", PARTICLE_FLAG_DISABLE_Z);
  1279. ADD_GROUP("Direction", "");
  1280. ADD_PROPERTY(PropertyInfo(Variant::VECTOR3, "direction"), "set_direction", "get_direction");
  1281. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "spread", PROPERTY_HINT_RANGE, "0,180,0.01"), "set_spread", "get_spread");
  1282. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "flatness", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_flatness", "get_flatness");
  1283. ADD_GROUP("Gravity", "");
  1284. ADD_PROPERTY(PropertyInfo(Variant::VECTOR3, "gravity"), "set_gravity", "get_gravity");
  1285. ADD_GROUP("Initial Velocity", "initial_");
  1286. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "initial_velocity_min", PROPERTY_HINT_RANGE, "0,1000,0.01,or_greater"), "set_param_min", "get_param_min", PARAM_INITIAL_LINEAR_VELOCITY);
  1287. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "initial_velocity_max", PROPERTY_HINT_RANGE, "0,1000,0.01,or_greater"), "set_param_max", "get_param_max", PARAM_INITIAL_LINEAR_VELOCITY);
  1288. ADD_GROUP("Angular Velocity", "angular_");
  1289. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "angular_velocity_min", PROPERTY_HINT_RANGE, "-720,720,0.01,or_less,or_greater"), "set_param_min", "get_param_min", PARAM_ANGULAR_VELOCITY);
  1290. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "angular_velocity_max", PROPERTY_HINT_RANGE, "-720,720,0.01,or_less,or_greater"), "set_param_max", "get_param_max", PARAM_ANGULAR_VELOCITY);
  1291. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "angular_velocity_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_ANGULAR_VELOCITY);
  1292. ADD_GROUP("Orbit Velocity", "orbit_");
  1293. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "orbit_velocity_min", PROPERTY_HINT_RANGE, "-1000,1000,0.01,or_less,or_greater"), "set_param_min", "get_param_min", PARAM_ORBIT_VELOCITY);
  1294. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "orbit_velocity_max", PROPERTY_HINT_RANGE, "-1000,1000,0.01,or_less,or_greater"), "set_param_max", "get_param_max", PARAM_ORBIT_VELOCITY);
  1295. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "orbit_velocity_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_ORBIT_VELOCITY);
  1296. ADD_GROUP("Linear Accel", "linear_");
  1297. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "linear_accel_min", PROPERTY_HINT_RANGE, "-100,100,0.01,or_less,or_greater"), "set_param_min", "get_param_min", PARAM_LINEAR_ACCEL);
  1298. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "linear_accel_max", PROPERTY_HINT_RANGE, "-100,100,0.01,or_less,or_greater"), "set_param_max", "get_param_max", PARAM_LINEAR_ACCEL);
  1299. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "linear_accel_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_LINEAR_ACCEL);
  1300. ADD_GROUP("Radial Accel", "radial_");
  1301. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "radial_accel_min", PROPERTY_HINT_RANGE, "-100,100,0.01,or_less,or_greater"), "set_param_min", "get_param_min", PARAM_RADIAL_ACCEL);
  1302. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "radial_accel_max", PROPERTY_HINT_RANGE, "-100,100,0.01,or_less,or_greater"), "set_param_max", "get_param_max", PARAM_RADIAL_ACCEL);
  1303. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "radial_accel_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_RADIAL_ACCEL);
  1304. ADD_GROUP("Tangential Accel", "tangential_");
  1305. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "tangential_accel_min", PROPERTY_HINT_RANGE, "-100,100,0.01,or_less,or_greater"), "set_param_min", "get_param_min", PARAM_TANGENTIAL_ACCEL);
  1306. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "tangential_accel_max", PROPERTY_HINT_RANGE, "-100,100,0.01,or_less,or_greater"), "set_param_max", "get_param_max", PARAM_TANGENTIAL_ACCEL);
  1307. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "tangential_accel_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_TANGENTIAL_ACCEL);
  1308. ADD_GROUP("Damping", "");
  1309. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "damping_min", PROPERTY_HINT_RANGE, "0,100,0.01,or_greater"), "set_param_min", "get_param_min", PARAM_DAMPING);
  1310. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "damping_max", PROPERTY_HINT_RANGE, "0,100,0.01,or_greater"), "set_param_max", "get_param_max", PARAM_DAMPING);
  1311. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "damping_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_DAMPING);
  1312. ADD_GROUP("Angle", "");
  1313. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "angle_min", PROPERTY_HINT_RANGE, "-720,720,0.1,or_less,or_greater,degrees"), "set_param_min", "get_param_min", PARAM_ANGLE);
  1314. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "angle_max", PROPERTY_HINT_RANGE, "-720,720,0.1,or_less,or_greater,degrees"), "set_param_max", "get_param_max", PARAM_ANGLE);
  1315. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "angle_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_ANGLE);
  1316. ADD_GROUP("Scale", "");
  1317. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "scale_amount_min", PROPERTY_HINT_RANGE, "0,1000,0.01,or_greater"), "set_param_min", "get_param_min", PARAM_SCALE);
  1318. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "scale_amount_max", PROPERTY_HINT_RANGE, "0,1000,0.01,or_greater"), "set_param_max", "get_param_max", PARAM_SCALE);
  1319. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "scale_amount_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_SCALE);
  1320. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "split_scale"), "set_split_scale", "get_split_scale");
  1321. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "scale_curve_x", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_scale_curve_x", "get_scale_curve_x");
  1322. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "scale_curve_y", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_scale_curve_y", "get_scale_curve_y");
  1323. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "scale_curve_z", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_scale_curve_z", "get_scale_curve_z");
  1324. ADD_GROUP("Color", "");
  1325. ADD_PROPERTY(PropertyInfo(Variant::COLOR, "color"), "set_color", "get_color");
  1326. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "color_ramp", PROPERTY_HINT_RESOURCE_TYPE, "Gradient"), "set_color_ramp", "get_color_ramp");
  1327. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "color_initial_ramp", PROPERTY_HINT_RESOURCE_TYPE, "Gradient"), "set_color_initial_ramp", "get_color_initial_ramp");
  1328. ADD_GROUP("Hue Variation", "hue_");
  1329. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "hue_variation_min", PROPERTY_HINT_RANGE, "-1,1,0.01"), "set_param_min", "get_param_min", PARAM_HUE_VARIATION);
  1330. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "hue_variation_max", PROPERTY_HINT_RANGE, "-1,1,0.01"), "set_param_max", "get_param_max", PARAM_HUE_VARIATION);
  1331. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "hue_variation_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_HUE_VARIATION);
  1332. ADD_GROUP("Animation", "anim_");
  1333. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "anim_speed_min", PROPERTY_HINT_RANGE, "0,128,0.01,or_greater,or_less"), "set_param_min", "get_param_min", PARAM_ANIM_SPEED);
  1334. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "anim_speed_max", PROPERTY_HINT_RANGE, "0,128,0.01,or_greater,or_less"), "set_param_max", "get_param_max", PARAM_ANIM_SPEED);
  1335. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "anim_speed_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_ANIM_SPEED);
  1336. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "anim_offset_min", PROPERTY_HINT_RANGE, "0,1,0.0001"), "set_param_min", "get_param_min", PARAM_ANIM_OFFSET);
  1337. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "anim_offset_max", PROPERTY_HINT_RANGE, "0,1,0.0001"), "set_param_max", "get_param_max", PARAM_ANIM_OFFSET);
  1338. ADD_PROPERTYI(PropertyInfo(Variant::OBJECT, "anim_offset_curve", PROPERTY_HINT_RESOURCE_TYPE, "Curve"), "set_param_curve", "get_param_curve", PARAM_ANIM_OFFSET);
  1339. BIND_ENUM_CONSTANT(PARAM_INITIAL_LINEAR_VELOCITY);
  1340. BIND_ENUM_CONSTANT(PARAM_ANGULAR_VELOCITY);
  1341. BIND_ENUM_CONSTANT(PARAM_ORBIT_VELOCITY);
  1342. BIND_ENUM_CONSTANT(PARAM_LINEAR_ACCEL);
  1343. BIND_ENUM_CONSTANT(PARAM_RADIAL_ACCEL);
  1344. BIND_ENUM_CONSTANT(PARAM_TANGENTIAL_ACCEL);
  1345. BIND_ENUM_CONSTANT(PARAM_DAMPING);
  1346. BIND_ENUM_CONSTANT(PARAM_ANGLE);
  1347. BIND_ENUM_CONSTANT(PARAM_SCALE);
  1348. BIND_ENUM_CONSTANT(PARAM_HUE_VARIATION);
  1349. BIND_ENUM_CONSTANT(PARAM_ANIM_SPEED);
  1350. BIND_ENUM_CONSTANT(PARAM_ANIM_OFFSET);
  1351. BIND_ENUM_CONSTANT(PARAM_MAX);
  1352. BIND_ENUM_CONSTANT(PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY);
  1353. BIND_ENUM_CONSTANT(PARTICLE_FLAG_ROTATE_Y);
  1354. BIND_ENUM_CONSTANT(PARTICLE_FLAG_DISABLE_Z);
  1355. BIND_ENUM_CONSTANT(PARTICLE_FLAG_MAX);
  1356. BIND_ENUM_CONSTANT(EMISSION_SHAPE_POINT);
  1357. BIND_ENUM_CONSTANT(EMISSION_SHAPE_SPHERE);
  1358. BIND_ENUM_CONSTANT(EMISSION_SHAPE_SPHERE_SURFACE);
  1359. BIND_ENUM_CONSTANT(EMISSION_SHAPE_BOX);
  1360. BIND_ENUM_CONSTANT(EMISSION_SHAPE_POINTS);
  1361. BIND_ENUM_CONSTANT(EMISSION_SHAPE_DIRECTED_POINTS);
  1362. BIND_ENUM_CONSTANT(EMISSION_SHAPE_RING);
  1363. BIND_ENUM_CONSTANT(EMISSION_SHAPE_MAX);
  1364. }
  1365. CPUParticles3D::CPUParticles3D() {
  1366. set_notify_transform(true);
  1367. multimesh = RenderingServer::get_singleton()->multimesh_create();
  1368. RenderingServer::get_singleton()->multimesh_set_visible_instances(multimesh, 0);
  1369. set_base(multimesh);
  1370. set_emitting(true);
  1371. set_amount(8);
  1372. set_param_min(PARAM_INITIAL_LINEAR_VELOCITY, 0);
  1373. set_param_min(PARAM_ANGULAR_VELOCITY, 0);
  1374. set_param_min(PARAM_ORBIT_VELOCITY, 0);
  1375. set_param_min(PARAM_LINEAR_ACCEL, 0);
  1376. set_param_min(PARAM_RADIAL_ACCEL, 0);
  1377. set_param_min(PARAM_TANGENTIAL_ACCEL, 0);
  1378. set_param_min(PARAM_DAMPING, 0);
  1379. set_param_min(PARAM_ANGLE, 0);
  1380. set_param_min(PARAM_SCALE, 1);
  1381. set_param_min(PARAM_HUE_VARIATION, 0);
  1382. set_param_min(PARAM_ANIM_SPEED, 0);
  1383. set_param_min(PARAM_ANIM_OFFSET, 0);
  1384. set_param_max(PARAM_INITIAL_LINEAR_VELOCITY, 0);
  1385. set_param_max(PARAM_ANGULAR_VELOCITY, 0);
  1386. set_param_max(PARAM_ORBIT_VELOCITY, 0);
  1387. set_param_max(PARAM_LINEAR_ACCEL, 0);
  1388. set_param_max(PARAM_RADIAL_ACCEL, 0);
  1389. set_param_max(PARAM_TANGENTIAL_ACCEL, 0);
  1390. set_param_max(PARAM_DAMPING, 0);
  1391. set_param_max(PARAM_ANGLE, 0);
  1392. set_param_max(PARAM_SCALE, 1);
  1393. set_param_max(PARAM_HUE_VARIATION, 0);
  1394. set_param_max(PARAM_ANIM_SPEED, 0);
  1395. set_param_max(PARAM_ANIM_OFFSET, 0);
  1396. set_emission_shape(EMISSION_SHAPE_POINT);
  1397. set_emission_sphere_radius(1);
  1398. set_emission_box_extents(Vector3(1, 1, 1));
  1399. set_emission_ring_axis(Vector3(0, 0, 1.0));
  1400. set_emission_ring_height(1);
  1401. set_emission_ring_radius(1);
  1402. set_emission_ring_inner_radius(0);
  1403. set_gravity(Vector3(0, -9.8, 0));
  1404. for (int i = 0; i < PARTICLE_FLAG_MAX; i++) {
  1405. particle_flags[i] = false;
  1406. }
  1407. set_color(Color(1, 1, 1, 1));
  1408. }
  1409. CPUParticles3D::~CPUParticles3D() {
  1410. ERR_FAIL_NULL(RenderingServer::get_singleton());
  1411. RS::get_singleton()->free(multimesh);
  1412. }