particles_storage.cpp 75 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935
  1. /*************************************************************************/
  2. /* particles_storage.cpp */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
  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 "particles_storage.h"
  31. #include "servers/rendering/renderer_rd/renderer_compositor_rd.h"
  32. #include "servers/rendering/rendering_server_globals.h"
  33. #include "texture_storage.h"
  34. using namespace RendererRD;
  35. ParticlesStorage *ParticlesStorage::singleton = nullptr;
  36. ParticlesStorage *ParticlesStorage::get_singleton() {
  37. return singleton;
  38. }
  39. ParticlesStorage::ParticlesStorage() {
  40. singleton = this;
  41. MaterialStorage *material_storage = MaterialStorage::get_singleton();
  42. /* Particles */
  43. {
  44. // Initialize particles
  45. Vector<String> particles_modes;
  46. particles_modes.push_back("");
  47. particles_shader.shader.initialize(particles_modes, String());
  48. }
  49. MaterialStorage::get_singleton()->shader_set_data_request_function(MaterialStorage::SHADER_TYPE_PARTICLES, _create_particles_shader_funcs);
  50. MaterialStorage::get_singleton()->material_set_data_request_function(MaterialStorage::SHADER_TYPE_PARTICLES, _create_particles_material_funcs);
  51. {
  52. ShaderCompiler::DefaultIdentifierActions actions;
  53. actions.renames["COLOR"] = "PARTICLE.color";
  54. actions.renames["VELOCITY"] = "PARTICLE.velocity";
  55. //actions.renames["MASS"] = "mass"; ?
  56. actions.renames["ACTIVE"] = "particle_active";
  57. actions.renames["RESTART"] = "restart";
  58. actions.renames["CUSTOM"] = "PARTICLE.custom";
  59. for (int i = 0; i < ParticlesShader::MAX_USERDATAS; i++) {
  60. String udname = "USERDATA" + itos(i + 1);
  61. actions.renames[udname] = "PARTICLE.userdata" + itos(i + 1);
  62. actions.usage_defines[udname] = "#define USERDATA" + itos(i + 1) + "_USED\n";
  63. }
  64. actions.renames["TRANSFORM"] = "PARTICLE.xform";
  65. actions.renames["TIME"] = "frame_history.data[0].time";
  66. actions.renames["PI"] = _MKSTR(Math_PI);
  67. actions.renames["TAU"] = _MKSTR(Math_TAU);
  68. actions.renames["E"] = _MKSTR(Math_E);
  69. actions.renames["LIFETIME"] = "params.lifetime";
  70. actions.renames["DELTA"] = "local_delta";
  71. actions.renames["NUMBER"] = "particle_number";
  72. actions.renames["INDEX"] = "index";
  73. //actions.renames["GRAVITY"] = "current_gravity";
  74. actions.renames["EMISSION_TRANSFORM"] = "FRAME.emission_transform";
  75. actions.renames["RANDOM_SEED"] = "FRAME.random_seed";
  76. actions.renames["FLAG_EMIT_POSITION"] = "EMISSION_FLAG_HAS_POSITION";
  77. actions.renames["FLAG_EMIT_ROT_SCALE"] = "EMISSION_FLAG_HAS_ROTATION_SCALE";
  78. actions.renames["FLAG_EMIT_VELOCITY"] = "EMISSION_FLAG_HAS_VELOCITY";
  79. actions.renames["FLAG_EMIT_COLOR"] = "EMISSION_FLAG_HAS_COLOR";
  80. actions.renames["FLAG_EMIT_CUSTOM"] = "EMISSION_FLAG_HAS_CUSTOM";
  81. actions.renames["RESTART_POSITION"] = "restart_position";
  82. actions.renames["RESTART_ROT_SCALE"] = "restart_rotation_scale";
  83. actions.renames["RESTART_VELOCITY"] = "restart_velocity";
  84. actions.renames["RESTART_COLOR"] = "restart_color";
  85. actions.renames["RESTART_CUSTOM"] = "restart_custom";
  86. actions.renames["emit_subparticle"] = "emit_subparticle";
  87. actions.renames["COLLIDED"] = "collided";
  88. actions.renames["COLLISION_NORMAL"] = "collision_normal";
  89. actions.renames["COLLISION_DEPTH"] = "collision_depth";
  90. actions.renames["ATTRACTOR_FORCE"] = "attractor_force";
  91. actions.render_mode_defines["disable_force"] = "#define DISABLE_FORCE\n";
  92. actions.render_mode_defines["disable_velocity"] = "#define DISABLE_VELOCITY\n";
  93. actions.render_mode_defines["keep_data"] = "#define ENABLE_KEEP_DATA\n";
  94. actions.render_mode_defines["collision_use_scale"] = "#define USE_COLLISION_SCALE\n";
  95. actions.sampler_array_name = "material_samplers";
  96. actions.base_texture_binding_index = 1;
  97. actions.texture_layout_set = 3;
  98. actions.base_uniform_string = "material.";
  99. actions.base_varying_index = 10;
  100. actions.default_filter = ShaderLanguage::FILTER_LINEAR_MIPMAP;
  101. actions.default_repeat = ShaderLanguage::REPEAT_ENABLE;
  102. actions.global_buffer_array_variable = "global_shader_uniforms.data";
  103. particles_shader.compiler.initialize(actions);
  104. }
  105. {
  106. // default material and shader for particles shader
  107. particles_shader.default_shader = material_storage->shader_allocate();
  108. material_storage->shader_initialize(particles_shader.default_shader);
  109. material_storage->shader_set_code(particles_shader.default_shader, R"(
  110. // Default particles shader.
  111. shader_type particles;
  112. void process() {
  113. COLOR = vec4(1.0);
  114. }
  115. )");
  116. particles_shader.default_material = material_storage->material_allocate();
  117. material_storage->material_initialize(particles_shader.default_material);
  118. material_storage->material_set_shader(particles_shader.default_material, particles_shader.default_shader);
  119. ParticleProcessMaterialData *md = static_cast<ParticleProcessMaterialData *>(material_storage->material_get_data(particles_shader.default_material, MaterialStorage::SHADER_TYPE_PARTICLES));
  120. particles_shader.default_shader_rd = particles_shader.shader.version_get_shader(md->shader_data->version, 0);
  121. Vector<RD::Uniform> uniforms;
  122. {
  123. Vector<RID> ids;
  124. ids.resize(12);
  125. RID *ids_ptr = ids.ptrw();
  126. ids_ptr[0] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_NEAREST, RS::CANVAS_ITEM_TEXTURE_REPEAT_DISABLED);
  127. ids_ptr[1] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_LINEAR, RS::CANVAS_ITEM_TEXTURE_REPEAT_DISABLED);
  128. ids_ptr[2] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_NEAREST_WITH_MIPMAPS, RS::CANVAS_ITEM_TEXTURE_REPEAT_DISABLED);
  129. ids_ptr[3] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_LINEAR_WITH_MIPMAPS, RS::CANVAS_ITEM_TEXTURE_REPEAT_DISABLED);
  130. ids_ptr[4] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_NEAREST_WITH_MIPMAPS_ANISOTROPIC, RS::CANVAS_ITEM_TEXTURE_REPEAT_DISABLED);
  131. ids_ptr[5] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_LINEAR_WITH_MIPMAPS_ANISOTROPIC, RS::CANVAS_ITEM_TEXTURE_REPEAT_DISABLED);
  132. ids_ptr[6] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_NEAREST, RS::CANVAS_ITEM_TEXTURE_REPEAT_ENABLED);
  133. ids_ptr[7] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_LINEAR, RS::CANVAS_ITEM_TEXTURE_REPEAT_ENABLED);
  134. ids_ptr[8] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_NEAREST_WITH_MIPMAPS, RS::CANVAS_ITEM_TEXTURE_REPEAT_ENABLED);
  135. ids_ptr[9] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_LINEAR_WITH_MIPMAPS, RS::CANVAS_ITEM_TEXTURE_REPEAT_ENABLED);
  136. ids_ptr[10] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_NEAREST_WITH_MIPMAPS_ANISOTROPIC, RS::CANVAS_ITEM_TEXTURE_REPEAT_ENABLED);
  137. ids_ptr[11] = material_storage->sampler_rd_get_default(RS::CANVAS_ITEM_TEXTURE_FILTER_LINEAR_WITH_MIPMAPS_ANISOTROPIC, RS::CANVAS_ITEM_TEXTURE_REPEAT_ENABLED);
  138. RD::Uniform u(RD::UNIFORM_TYPE_SAMPLER, 1, ids);
  139. uniforms.push_back(u);
  140. }
  141. {
  142. RD::Uniform u;
  143. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  144. u.binding = 2;
  145. u.append_id(material_storage->global_shader_uniforms_get_storage_buffer());
  146. uniforms.push_back(u);
  147. }
  148. particles_shader.base_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.default_shader_rd, 0);
  149. }
  150. {
  151. Vector<String> copy_modes;
  152. for (int i = 0; i <= ParticlesShader::MAX_USERDATAS; i++) {
  153. if (i == 0) {
  154. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n");
  155. copy_modes.push_back("\n#define MODE_FILL_SORT_BUFFER\n#define USE_SORT_BUFFER\n");
  156. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n#define USE_SORT_BUFFER\n");
  157. } else {
  158. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n#define USERDATA_COUNT " + itos(i) + "\n");
  159. copy_modes.push_back("\n#define MODE_FILL_SORT_BUFFER\n#define USE_SORT_BUFFER\n#define USERDATA_COUNT " + itos(i) + "\n");
  160. copy_modes.push_back("\n#define MODE_FILL_INSTANCES\n#define USE_SORT_BUFFER\n#define USERDATA_COUNT " + itos(i) + "\n");
  161. }
  162. }
  163. particles_shader.copy_shader.initialize(copy_modes);
  164. particles_shader.copy_shader_version = particles_shader.copy_shader.version_create();
  165. for (int i = 0; i <= ParticlesShader::MAX_USERDATAS; i++) {
  166. for (int j = 0; j < ParticlesShader::COPY_MODE_MAX; j++) {
  167. particles_shader.copy_pipelines[i * ParticlesShader::COPY_MODE_MAX + j] = RD::get_singleton()->compute_pipeline_create(particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, i * ParticlesShader::COPY_MODE_MAX + j));
  168. }
  169. }
  170. }
  171. }
  172. ParticlesStorage::~ParticlesStorage() {
  173. MaterialStorage *material_storage = MaterialStorage::get_singleton();
  174. particles_shader.copy_shader.version_free(particles_shader.copy_shader_version);
  175. material_storage->material_free(particles_shader.default_material);
  176. material_storage->shader_free(particles_shader.default_shader);
  177. singleton = nullptr;
  178. }
  179. bool ParticlesStorage::free(RID p_rid) {
  180. if (owns_particles(p_rid)) {
  181. particles_free(p_rid);
  182. return true;
  183. } else if (owns_particles_collision(p_rid)) {
  184. particles_collision_free(p_rid);
  185. return true;
  186. } else if (owns_particles_collision_instance(p_rid)) {
  187. particles_collision_instance_free(p_rid);
  188. return true;
  189. }
  190. return false;
  191. }
  192. /* PARTICLES */
  193. RID ParticlesStorage::particles_allocate() {
  194. return particles_owner.allocate_rid();
  195. }
  196. void ParticlesStorage::particles_initialize(RID p_rid) {
  197. particles_owner.initialize_rid(p_rid, Particles());
  198. }
  199. void ParticlesStorage::particles_free(RID p_rid) {
  200. update_particles();
  201. Particles *particles = particles_owner.get_or_null(p_rid);
  202. particles->dependency.deleted_notify(p_rid);
  203. _particles_free_data(particles);
  204. particles_owner.free(p_rid);
  205. }
  206. void ParticlesStorage::particles_set_mode(RID p_particles, RS::ParticlesMode p_mode) {
  207. Particles *particles = particles_owner.get_or_null(p_particles);
  208. ERR_FAIL_COND(!particles);
  209. if (particles->mode == p_mode) {
  210. return;
  211. }
  212. _particles_free_data(particles);
  213. particles->mode = p_mode;
  214. }
  215. void ParticlesStorage::particles_set_emitting(RID p_particles, bool p_emitting) {
  216. Particles *particles = particles_owner.get_or_null(p_particles);
  217. ERR_FAIL_COND(!particles);
  218. particles->emitting = p_emitting;
  219. }
  220. bool ParticlesStorage::particles_get_emitting(RID p_particles) {
  221. ERR_FAIL_COND_V_MSG(RSG::threaded, false, "This function should never be used with threaded rendering, as it stalls the renderer.");
  222. Particles *particles = particles_owner.get_or_null(p_particles);
  223. ERR_FAIL_COND_V(!particles, false);
  224. return particles->emitting;
  225. }
  226. void ParticlesStorage::_particles_free_data(Particles *particles) {
  227. if (particles->particle_buffer.is_valid()) {
  228. RD::get_singleton()->free(particles->particle_buffer);
  229. particles->particle_buffer = RID();
  230. RD::get_singleton()->free(particles->particle_instance_buffer);
  231. particles->particle_instance_buffer = RID();
  232. }
  233. particles->userdata_count = 0;
  234. if (particles->frame_params_buffer.is_valid()) {
  235. RD::get_singleton()->free(particles->frame_params_buffer);
  236. particles->frame_params_buffer = RID();
  237. }
  238. particles->particles_transforms_buffer_uniform_set = RID();
  239. if (RD::get_singleton()->uniform_set_is_valid(particles->trail_bind_pose_uniform_set)) {
  240. RD::get_singleton()->free(particles->trail_bind_pose_uniform_set);
  241. }
  242. particles->trail_bind_pose_uniform_set = RID();
  243. if (particles->trail_bind_pose_buffer.is_valid()) {
  244. RD::get_singleton()->free(particles->trail_bind_pose_buffer);
  245. particles->trail_bind_pose_buffer = RID();
  246. }
  247. if (RD::get_singleton()->uniform_set_is_valid(particles->collision_textures_uniform_set)) {
  248. RD::get_singleton()->free(particles->collision_textures_uniform_set);
  249. }
  250. particles->collision_textures_uniform_set = RID();
  251. if (particles->particles_sort_buffer.is_valid()) {
  252. RD::get_singleton()->free(particles->particles_sort_buffer);
  253. particles->particles_sort_buffer = RID();
  254. particles->particles_sort_uniform_set = RID();
  255. }
  256. if (particles->emission_buffer != nullptr) {
  257. particles->emission_buffer = nullptr;
  258. particles->emission_buffer_data.clear();
  259. RD::get_singleton()->free(particles->emission_storage_buffer);
  260. particles->emission_storage_buffer = RID();
  261. }
  262. if (RD::get_singleton()->uniform_set_is_valid(particles->particles_material_uniform_set)) {
  263. //will need to be re-created
  264. RD::get_singleton()->free(particles->particles_material_uniform_set);
  265. }
  266. particles->particles_material_uniform_set = RID();
  267. }
  268. void ParticlesStorage::particles_set_amount(RID p_particles, int p_amount) {
  269. Particles *particles = particles_owner.get_or_null(p_particles);
  270. ERR_FAIL_COND(!particles);
  271. if (particles->amount == p_amount) {
  272. return;
  273. }
  274. _particles_free_data(particles);
  275. particles->amount = p_amount;
  276. particles->prev_ticks = 0;
  277. particles->phase = 0;
  278. particles->prev_phase = 0;
  279. particles->clear = true;
  280. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  281. }
  282. void ParticlesStorage::particles_set_lifetime(RID p_particles, double p_lifetime) {
  283. Particles *particles = particles_owner.get_or_null(p_particles);
  284. ERR_FAIL_COND(!particles);
  285. particles->lifetime = p_lifetime;
  286. }
  287. void ParticlesStorage::particles_set_one_shot(RID p_particles, bool p_one_shot) {
  288. Particles *particles = particles_owner.get_or_null(p_particles);
  289. ERR_FAIL_COND(!particles);
  290. particles->one_shot = p_one_shot;
  291. }
  292. void ParticlesStorage::particles_set_pre_process_time(RID p_particles, double p_time) {
  293. Particles *particles = particles_owner.get_or_null(p_particles);
  294. ERR_FAIL_COND(!particles);
  295. particles->pre_process_time = p_time;
  296. }
  297. void ParticlesStorage::particles_set_explosiveness_ratio(RID p_particles, real_t p_ratio) {
  298. Particles *particles = particles_owner.get_or_null(p_particles);
  299. ERR_FAIL_COND(!particles);
  300. particles->explosiveness = p_ratio;
  301. }
  302. void ParticlesStorage::particles_set_randomness_ratio(RID p_particles, real_t p_ratio) {
  303. Particles *particles = particles_owner.get_or_null(p_particles);
  304. ERR_FAIL_COND(!particles);
  305. particles->randomness = p_ratio;
  306. }
  307. void ParticlesStorage::particles_set_custom_aabb(RID p_particles, const AABB &p_aabb) {
  308. Particles *particles = particles_owner.get_or_null(p_particles);
  309. ERR_FAIL_COND(!particles);
  310. particles->custom_aabb = p_aabb;
  311. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  312. }
  313. void ParticlesStorage::particles_set_speed_scale(RID p_particles, double p_scale) {
  314. Particles *particles = particles_owner.get_or_null(p_particles);
  315. ERR_FAIL_COND(!particles);
  316. particles->speed_scale = p_scale;
  317. }
  318. void ParticlesStorage::particles_set_use_local_coordinates(RID p_particles, bool p_enable) {
  319. Particles *particles = particles_owner.get_or_null(p_particles);
  320. ERR_FAIL_COND(!particles);
  321. particles->use_local_coords = p_enable;
  322. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  323. }
  324. void ParticlesStorage::particles_set_fixed_fps(RID p_particles, int p_fps) {
  325. Particles *particles = particles_owner.get_or_null(p_particles);
  326. ERR_FAIL_COND(!particles);
  327. particles->fixed_fps = p_fps;
  328. _particles_free_data(particles);
  329. particles->prev_ticks = 0;
  330. particles->phase = 0;
  331. particles->prev_phase = 0;
  332. particles->clear = true;
  333. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  334. }
  335. void ParticlesStorage::particles_set_interpolate(RID p_particles, bool p_enable) {
  336. Particles *particles = particles_owner.get_or_null(p_particles);
  337. ERR_FAIL_COND(!particles);
  338. particles->interpolate = p_enable;
  339. }
  340. void ParticlesStorage::particles_set_fractional_delta(RID p_particles, bool p_enable) {
  341. Particles *particles = particles_owner.get_or_null(p_particles);
  342. ERR_FAIL_COND(!particles);
  343. particles->fractional_delta = p_enable;
  344. }
  345. void ParticlesStorage::particles_set_trails(RID p_particles, bool p_enable, double p_length) {
  346. Particles *particles = particles_owner.get_or_null(p_particles);
  347. ERR_FAIL_COND(!particles);
  348. ERR_FAIL_COND(p_length < 0.1);
  349. p_length = MIN(10.0, p_length);
  350. particles->trails_enabled = p_enable;
  351. particles->trail_length = p_length;
  352. _particles_free_data(particles);
  353. particles->prev_ticks = 0;
  354. particles->phase = 0;
  355. particles->prev_phase = 0;
  356. particles->clear = true;
  357. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  358. }
  359. void ParticlesStorage::particles_set_trail_bind_poses(RID p_particles, const Vector<Transform3D> &p_bind_poses) {
  360. Particles *particles = particles_owner.get_or_null(p_particles);
  361. ERR_FAIL_COND(!particles);
  362. if (particles->trail_bind_pose_buffer.is_valid() && particles->trail_bind_poses.size() != p_bind_poses.size()) {
  363. _particles_free_data(particles);
  364. particles->prev_ticks = 0;
  365. particles->phase = 0;
  366. particles->prev_phase = 0;
  367. particles->clear = true;
  368. }
  369. particles->trail_bind_poses = p_bind_poses;
  370. particles->trail_bind_poses_dirty = true;
  371. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES);
  372. }
  373. void ParticlesStorage::particles_set_collision_base_size(RID p_particles, real_t p_size) {
  374. Particles *particles = particles_owner.get_or_null(p_particles);
  375. ERR_FAIL_COND(!particles);
  376. particles->collision_base_size = p_size;
  377. }
  378. void ParticlesStorage::particles_set_transform_align(RID p_particles, RS::ParticlesTransformAlign p_transform_align) {
  379. Particles *particles = particles_owner.get_or_null(p_particles);
  380. ERR_FAIL_COND(!particles);
  381. particles->transform_align = p_transform_align;
  382. }
  383. void ParticlesStorage::particles_set_process_material(RID p_particles, RID p_material) {
  384. Particles *particles = particles_owner.get_or_null(p_particles);
  385. ERR_FAIL_COND(!particles);
  386. particles->process_material = p_material;
  387. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_PARTICLES); //the instance buffer may have changed
  388. }
  389. RID ParticlesStorage::particles_get_process_material(RID p_particles) const {
  390. Particles *particles = particles_owner.get_or_null(p_particles);
  391. ERR_FAIL_COND_V(!particles, RID());
  392. return particles->process_material;
  393. }
  394. void ParticlesStorage::particles_set_draw_order(RID p_particles, RS::ParticlesDrawOrder p_order) {
  395. Particles *particles = particles_owner.get_or_null(p_particles);
  396. ERR_FAIL_COND(!particles);
  397. particles->draw_order = p_order;
  398. }
  399. void ParticlesStorage::particles_set_draw_passes(RID p_particles, int p_passes) {
  400. Particles *particles = particles_owner.get_or_null(p_particles);
  401. ERR_FAIL_COND(!particles);
  402. particles->draw_passes.resize(p_passes);
  403. }
  404. void ParticlesStorage::particles_set_draw_pass_mesh(RID p_particles, int p_pass, RID p_mesh) {
  405. Particles *particles = particles_owner.get_or_null(p_particles);
  406. ERR_FAIL_COND(!particles);
  407. ERR_FAIL_INDEX(p_pass, particles->draw_passes.size());
  408. particles->draw_passes.write[p_pass] = p_mesh;
  409. }
  410. void ParticlesStorage::particles_restart(RID p_particles) {
  411. Particles *particles = particles_owner.get_or_null(p_particles);
  412. ERR_FAIL_COND(!particles);
  413. particles->restart_request = true;
  414. }
  415. void ParticlesStorage::_particles_allocate_emission_buffer(Particles *particles) {
  416. ERR_FAIL_COND(particles->emission_buffer != nullptr);
  417. particles->emission_buffer_data.resize(sizeof(ParticleEmissionBuffer::Data) * particles->amount + sizeof(uint32_t) * 4);
  418. memset(particles->emission_buffer_data.ptrw(), 0, particles->emission_buffer_data.size());
  419. particles->emission_buffer = reinterpret_cast<ParticleEmissionBuffer *>(particles->emission_buffer_data.ptrw());
  420. particles->emission_buffer->particle_max = particles->amount;
  421. particles->emission_storage_buffer = RD::get_singleton()->storage_buffer_create(particles->emission_buffer_data.size(), particles->emission_buffer_data);
  422. if (RD::get_singleton()->uniform_set_is_valid(particles->particles_material_uniform_set)) {
  423. //will need to be re-created
  424. RD::get_singleton()->free(particles->particles_material_uniform_set);
  425. particles->particles_material_uniform_set = RID();
  426. }
  427. }
  428. void ParticlesStorage::particles_set_subemitter(RID p_particles, RID p_subemitter_particles) {
  429. Particles *particles = particles_owner.get_or_null(p_particles);
  430. ERR_FAIL_COND(!particles);
  431. ERR_FAIL_COND(p_particles == p_subemitter_particles);
  432. particles->sub_emitter = p_subemitter_particles;
  433. if (RD::get_singleton()->uniform_set_is_valid(particles->particles_material_uniform_set)) {
  434. RD::get_singleton()->free(particles->particles_material_uniform_set);
  435. particles->particles_material_uniform_set = RID(); //clear and force to re create sub emitting
  436. }
  437. }
  438. void ParticlesStorage::particles_emit(RID p_particles, const Transform3D &p_transform, const Vector3 &p_velocity, const Color &p_color, const Color &p_custom, uint32_t p_emit_flags) {
  439. Particles *particles = particles_owner.get_or_null(p_particles);
  440. ERR_FAIL_COND(!particles);
  441. ERR_FAIL_COND(particles->amount == 0);
  442. if (particles->emitting) {
  443. particles->clear = true;
  444. particles->emitting = false;
  445. }
  446. if (particles->emission_buffer == nullptr) {
  447. _particles_allocate_emission_buffer(particles);
  448. }
  449. particles->inactive = false;
  450. particles->inactive_time = 0;
  451. int32_t idx = particles->emission_buffer->particle_count;
  452. if (idx < particles->emission_buffer->particle_max) {
  453. RendererRD::MaterialStorage::store_transform(p_transform, particles->emission_buffer->data[idx].xform);
  454. particles->emission_buffer->data[idx].velocity[0] = p_velocity.x;
  455. particles->emission_buffer->data[idx].velocity[1] = p_velocity.y;
  456. particles->emission_buffer->data[idx].velocity[2] = p_velocity.z;
  457. particles->emission_buffer->data[idx].custom[0] = p_custom.r;
  458. particles->emission_buffer->data[idx].custom[1] = p_custom.g;
  459. particles->emission_buffer->data[idx].custom[2] = p_custom.b;
  460. particles->emission_buffer->data[idx].custom[3] = p_custom.a;
  461. particles->emission_buffer->data[idx].color[0] = p_color.r;
  462. particles->emission_buffer->data[idx].color[1] = p_color.g;
  463. particles->emission_buffer->data[idx].color[2] = p_color.b;
  464. particles->emission_buffer->data[idx].color[3] = p_color.a;
  465. particles->emission_buffer->data[idx].flags = p_emit_flags;
  466. particles->emission_buffer->particle_count++;
  467. }
  468. }
  469. void ParticlesStorage::particles_request_process(RID p_particles) {
  470. Particles *particles = particles_owner.get_or_null(p_particles);
  471. ERR_FAIL_COND(!particles);
  472. if (!particles->dirty) {
  473. particles->dirty = true;
  474. particles->update_list = particle_update_list;
  475. particle_update_list = particles;
  476. }
  477. }
  478. AABB ParticlesStorage::particles_get_current_aabb(RID p_particles) {
  479. if (RSG::threaded) {
  480. WARN_PRINT_ONCE("Calling this function with threaded rendering enabled stalls the renderer, use with care.");
  481. }
  482. const Particles *particles = particles_owner.get_or_null(p_particles);
  483. ERR_FAIL_COND_V(!particles, AABB());
  484. int total_amount = particles->amount;
  485. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  486. total_amount *= particles->trail_bind_poses.size();
  487. }
  488. Vector<uint8_t> buffer = RD::get_singleton()->buffer_get_data(particles->particle_buffer);
  489. ERR_FAIL_COND_V(buffer.size() != (int)(total_amount * sizeof(ParticleData)), AABB());
  490. Transform3D inv = particles->emission_transform.affine_inverse();
  491. AABB aabb;
  492. if (buffer.size()) {
  493. bool first = true;
  494. const uint8_t *data_ptr = (const uint8_t *)buffer.ptr();
  495. uint32_t particle_data_size = sizeof(ParticleData) + sizeof(float) * particles->userdata_count;
  496. for (int i = 0; i < total_amount; i++) {
  497. const ParticleData &particle_data = *(const ParticleData *)&data_ptr[particle_data_size * i];
  498. if (particle_data.active) {
  499. Vector3 pos = Vector3(particle_data.xform[12], particle_data.xform[13], particle_data.xform[14]);
  500. if (!particles->use_local_coords) {
  501. pos = inv.xform(pos);
  502. }
  503. if (first) {
  504. aabb.position = pos;
  505. first = false;
  506. } else {
  507. aabb.expand_to(pos);
  508. }
  509. }
  510. }
  511. }
  512. float longest_axis_size = 0;
  513. for (int i = 0; i < particles->draw_passes.size(); i++) {
  514. if (particles->draw_passes[i].is_valid()) {
  515. AABB maabb = MeshStorage::get_singleton()->mesh_get_aabb(particles->draw_passes[i], RID());
  516. longest_axis_size = MAX(maabb.get_longest_axis_size(), longest_axis_size);
  517. }
  518. }
  519. aabb.grow_by(longest_axis_size);
  520. return aabb;
  521. }
  522. AABB ParticlesStorage::particles_get_aabb(RID p_particles) const {
  523. const Particles *particles = particles_owner.get_or_null(p_particles);
  524. ERR_FAIL_COND_V(!particles, AABB());
  525. return particles->custom_aabb;
  526. }
  527. void ParticlesStorage::particles_set_emission_transform(RID p_particles, const Transform3D &p_transform) {
  528. Particles *particles = particles_owner.get_or_null(p_particles);
  529. ERR_FAIL_COND(!particles);
  530. particles->emission_transform = p_transform;
  531. }
  532. int ParticlesStorage::particles_get_draw_passes(RID p_particles) const {
  533. const Particles *particles = particles_owner.get_or_null(p_particles);
  534. ERR_FAIL_COND_V(!particles, 0);
  535. return particles->draw_passes.size();
  536. }
  537. RID ParticlesStorage::particles_get_draw_pass_mesh(RID p_particles, int p_pass) const {
  538. const Particles *particles = particles_owner.get_or_null(p_particles);
  539. ERR_FAIL_COND_V(!particles, RID());
  540. ERR_FAIL_INDEX_V(p_pass, particles->draw_passes.size(), RID());
  541. return particles->draw_passes[p_pass];
  542. }
  543. void ParticlesStorage::particles_add_collision(RID p_particles, RID p_particles_collision_instance) {
  544. Particles *particles = particles_owner.get_or_null(p_particles);
  545. ERR_FAIL_COND(!particles);
  546. particles->collisions.insert(p_particles_collision_instance);
  547. }
  548. void ParticlesStorage::particles_remove_collision(RID p_particles, RID p_particles_collision_instance) {
  549. Particles *particles = particles_owner.get_or_null(p_particles);
  550. ERR_FAIL_COND(!particles);
  551. particles->collisions.erase(p_particles_collision_instance);
  552. }
  553. void ParticlesStorage::particles_set_canvas_sdf_collision(RID p_particles, bool p_enable, const Transform2D &p_xform, const Rect2 &p_to_screen, RID p_texture) {
  554. Particles *particles = particles_owner.get_or_null(p_particles);
  555. ERR_FAIL_COND(!particles);
  556. particles->has_sdf_collision = p_enable;
  557. particles->sdf_collision_transform = p_xform;
  558. particles->sdf_collision_to_screen = p_to_screen;
  559. particles->sdf_collision_texture = p_texture;
  560. }
  561. void ParticlesStorage::_particles_process(Particles *p_particles, double p_delta) {
  562. TextureStorage *texture_storage = TextureStorage::get_singleton();
  563. MaterialStorage *material_storage = MaterialStorage::get_singleton();
  564. if (p_particles->particles_material_uniform_set.is_null() || !RD::get_singleton()->uniform_set_is_valid(p_particles->particles_material_uniform_set)) {
  565. Vector<RD::Uniform> uniforms;
  566. {
  567. RD::Uniform u;
  568. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  569. u.binding = 0;
  570. u.append_id(p_particles->frame_params_buffer);
  571. uniforms.push_back(u);
  572. }
  573. {
  574. RD::Uniform u;
  575. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  576. u.binding = 1;
  577. u.append_id(p_particles->particle_buffer);
  578. uniforms.push_back(u);
  579. }
  580. {
  581. RD::Uniform u;
  582. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  583. u.binding = 2;
  584. if (p_particles->emission_storage_buffer.is_valid()) {
  585. u.append_id(p_particles->emission_storage_buffer);
  586. } else {
  587. u.append_id(MeshStorage::get_singleton()->get_default_rd_storage_buffer());
  588. }
  589. uniforms.push_back(u);
  590. }
  591. {
  592. RD::Uniform u;
  593. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  594. u.binding = 3;
  595. Particles *sub_emitter = particles_owner.get_or_null(p_particles->sub_emitter);
  596. if (sub_emitter) {
  597. if (sub_emitter->emission_buffer == nullptr) { //no emission buffer, allocate emission buffer
  598. _particles_allocate_emission_buffer(sub_emitter);
  599. }
  600. u.append_id(sub_emitter->emission_storage_buffer);
  601. } else {
  602. u.append_id(MeshStorage::get_singleton()->get_default_rd_storage_buffer());
  603. }
  604. uniforms.push_back(u);
  605. }
  606. p_particles->particles_material_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.default_shader_rd, 1);
  607. }
  608. double new_phase = Math::fmod((double)p_particles->phase + (p_delta / p_particles->lifetime) * p_particles->speed_scale, 1.0);
  609. //move back history (if there is any)
  610. for (uint32_t i = p_particles->frame_history.size() - 1; i > 0; i--) {
  611. p_particles->frame_history[i] = p_particles->frame_history[i - 1];
  612. }
  613. //update current frame
  614. ParticlesFrameParams &frame_params = p_particles->frame_history[0];
  615. if (p_particles->clear) {
  616. p_particles->cycle_number = 0;
  617. p_particles->random_seed = Math::rand();
  618. } else if (new_phase < p_particles->phase) {
  619. if (p_particles->one_shot) {
  620. p_particles->emitting = false;
  621. }
  622. p_particles->cycle_number++;
  623. }
  624. frame_params.emitting = p_particles->emitting;
  625. frame_params.system_phase = new_phase;
  626. frame_params.prev_system_phase = p_particles->phase;
  627. p_particles->phase = new_phase;
  628. frame_params.time = RendererCompositorRD::singleton->get_total_time();
  629. frame_params.delta = p_delta * p_particles->speed_scale;
  630. frame_params.random_seed = p_particles->random_seed;
  631. frame_params.explosiveness = p_particles->explosiveness;
  632. frame_params.randomness = p_particles->randomness;
  633. if (p_particles->use_local_coords) {
  634. RendererRD::MaterialStorage::store_transform(Transform3D(), frame_params.emission_transform);
  635. } else {
  636. RendererRD::MaterialStorage::store_transform(p_particles->emission_transform, frame_params.emission_transform);
  637. }
  638. frame_params.cycle = p_particles->cycle_number;
  639. frame_params.frame = p_particles->frame_counter++;
  640. frame_params.pad0 = 0;
  641. frame_params.pad1 = 0;
  642. frame_params.pad2 = 0;
  643. { //collision and attractors
  644. frame_params.collider_count = 0;
  645. frame_params.attractor_count = 0;
  646. frame_params.particle_size = p_particles->collision_base_size;
  647. RID collision_3d_textures[ParticlesFrameParams::MAX_3D_TEXTURES];
  648. RID collision_heightmap_texture;
  649. Transform3D to_particles;
  650. if (p_particles->use_local_coords) {
  651. to_particles = p_particles->emission_transform.affine_inverse();
  652. }
  653. if (p_particles->has_sdf_collision && RD::get_singleton()->texture_is_valid(p_particles->sdf_collision_texture)) {
  654. //2D collision
  655. Transform2D xform = p_particles->sdf_collision_transform; //will use dotproduct manually so invert beforehand
  656. Transform2D revert = xform.affine_inverse();
  657. frame_params.collider_count = 1;
  658. frame_params.colliders[0].transform[0] = xform.columns[0][0];
  659. frame_params.colliders[0].transform[1] = xform.columns[0][1];
  660. frame_params.colliders[0].transform[2] = 0;
  661. frame_params.colliders[0].transform[3] = xform.columns[2][0];
  662. frame_params.colliders[0].transform[4] = xform.columns[1][0];
  663. frame_params.colliders[0].transform[5] = xform.columns[1][1];
  664. frame_params.colliders[0].transform[6] = 0;
  665. frame_params.colliders[0].transform[7] = xform.columns[2][1];
  666. frame_params.colliders[0].transform[8] = revert.columns[0][0];
  667. frame_params.colliders[0].transform[9] = revert.columns[0][1];
  668. frame_params.colliders[0].transform[10] = 0;
  669. frame_params.colliders[0].transform[11] = revert.columns[2][0];
  670. frame_params.colliders[0].transform[12] = revert.columns[1][0];
  671. frame_params.colliders[0].transform[13] = revert.columns[1][1];
  672. frame_params.colliders[0].transform[14] = 0;
  673. frame_params.colliders[0].transform[15] = revert.columns[2][1];
  674. frame_params.colliders[0].extents[0] = p_particles->sdf_collision_to_screen.size.x;
  675. frame_params.colliders[0].extents[1] = p_particles->sdf_collision_to_screen.size.y;
  676. frame_params.colliders[0].extents[2] = p_particles->sdf_collision_to_screen.position.x;
  677. frame_params.colliders[0].scale = p_particles->sdf_collision_to_screen.position.y;
  678. frame_params.colliders[0].texture_index = 0;
  679. frame_params.colliders[0].type = ParticlesFrameParams::COLLISION_TYPE_2D_SDF;
  680. collision_heightmap_texture = p_particles->sdf_collision_texture;
  681. //replace in all other history frames where used because parameters are no longer valid if screen moves
  682. for (uint32_t i = 1; i < p_particles->frame_history.size(); i++) {
  683. if (p_particles->frame_history[i].collider_count > 0 && p_particles->frame_history[i].colliders[0].type == ParticlesFrameParams::COLLISION_TYPE_2D_SDF) {
  684. p_particles->frame_history[i].colliders[0] = frame_params.colliders[0];
  685. }
  686. }
  687. }
  688. uint32_t collision_3d_textures_used = 0;
  689. for (const RID &E : p_particles->collisions) {
  690. ParticlesCollisionInstance *pci = particles_collision_instance_owner.get_or_null(E);
  691. if (!pci || !pci->active) {
  692. continue;
  693. }
  694. ParticlesCollision *pc = particles_collision_owner.get_or_null(pci->collision);
  695. ERR_CONTINUE(!pc);
  696. Transform3D to_collider = pci->transform;
  697. if (p_particles->use_local_coords) {
  698. to_collider = to_particles * to_collider;
  699. }
  700. Vector3 scale = to_collider.basis.get_scale();
  701. to_collider.basis.orthonormalize();
  702. if (pc->type <= RS::PARTICLES_COLLISION_TYPE_VECTOR_FIELD_ATTRACT) {
  703. //attractor
  704. if (frame_params.attractor_count >= ParticlesFrameParams::MAX_ATTRACTORS) {
  705. continue;
  706. }
  707. ParticlesFrameParams::Attractor &attr = frame_params.attractors[frame_params.attractor_count];
  708. RendererRD::MaterialStorage::store_transform(to_collider, attr.transform);
  709. attr.strength = pc->attractor_strength;
  710. attr.attenuation = pc->attractor_attenuation;
  711. attr.directionality = pc->attractor_directionality;
  712. switch (pc->type) {
  713. case RS::PARTICLES_COLLISION_TYPE_SPHERE_ATTRACT: {
  714. attr.type = ParticlesFrameParams::ATTRACTOR_TYPE_SPHERE;
  715. float radius = pc->radius;
  716. radius *= (scale.x + scale.y + scale.z) / 3.0;
  717. attr.extents[0] = radius;
  718. attr.extents[1] = radius;
  719. attr.extents[2] = radius;
  720. } break;
  721. case RS::PARTICLES_COLLISION_TYPE_BOX_ATTRACT: {
  722. attr.type = ParticlesFrameParams::ATTRACTOR_TYPE_BOX;
  723. Vector3 extents = pc->extents * scale;
  724. attr.extents[0] = extents.x;
  725. attr.extents[1] = extents.y;
  726. attr.extents[2] = extents.z;
  727. } break;
  728. case RS::PARTICLES_COLLISION_TYPE_VECTOR_FIELD_ATTRACT: {
  729. if (collision_3d_textures_used >= ParticlesFrameParams::MAX_3D_TEXTURES) {
  730. continue;
  731. }
  732. attr.type = ParticlesFrameParams::ATTRACTOR_TYPE_VECTOR_FIELD;
  733. Vector3 extents = pc->extents * scale;
  734. attr.extents[0] = extents.x;
  735. attr.extents[1] = extents.y;
  736. attr.extents[2] = extents.z;
  737. attr.texture_index = collision_3d_textures_used;
  738. collision_3d_textures[collision_3d_textures_used] = pc->field_texture;
  739. collision_3d_textures_used++;
  740. } break;
  741. default: {
  742. }
  743. }
  744. frame_params.attractor_count++;
  745. } else {
  746. //collider
  747. if (frame_params.collider_count >= ParticlesFrameParams::MAX_COLLIDERS) {
  748. continue;
  749. }
  750. ParticlesFrameParams::Collider &col = frame_params.colliders[frame_params.collider_count];
  751. RendererRD::MaterialStorage::store_transform(to_collider, col.transform);
  752. switch (pc->type) {
  753. case RS::PARTICLES_COLLISION_TYPE_SPHERE_COLLIDE: {
  754. col.type = ParticlesFrameParams::COLLISION_TYPE_SPHERE;
  755. float radius = pc->radius;
  756. radius *= (scale.x + scale.y + scale.z) / 3.0;
  757. col.extents[0] = radius;
  758. col.extents[1] = radius;
  759. col.extents[2] = radius;
  760. } break;
  761. case RS::PARTICLES_COLLISION_TYPE_BOX_COLLIDE: {
  762. col.type = ParticlesFrameParams::COLLISION_TYPE_BOX;
  763. Vector3 extents = pc->extents * scale;
  764. col.extents[0] = extents.x;
  765. col.extents[1] = extents.y;
  766. col.extents[2] = extents.z;
  767. } break;
  768. case RS::PARTICLES_COLLISION_TYPE_SDF_COLLIDE: {
  769. if (collision_3d_textures_used >= ParticlesFrameParams::MAX_3D_TEXTURES) {
  770. continue;
  771. }
  772. col.type = ParticlesFrameParams::COLLISION_TYPE_SDF;
  773. Vector3 extents = pc->extents * scale;
  774. col.extents[0] = extents.x;
  775. col.extents[1] = extents.y;
  776. col.extents[2] = extents.z;
  777. col.texture_index = collision_3d_textures_used;
  778. col.scale = (scale.x + scale.y + scale.z) * 0.333333333333; //non uniform scale non supported
  779. collision_3d_textures[collision_3d_textures_used] = pc->field_texture;
  780. collision_3d_textures_used++;
  781. } break;
  782. case RS::PARTICLES_COLLISION_TYPE_HEIGHTFIELD_COLLIDE: {
  783. if (collision_heightmap_texture != RID()) { //already taken
  784. continue;
  785. }
  786. col.type = ParticlesFrameParams::COLLISION_TYPE_HEIGHT_FIELD;
  787. Vector3 extents = pc->extents * scale;
  788. col.extents[0] = extents.x;
  789. col.extents[1] = extents.y;
  790. col.extents[2] = extents.z;
  791. collision_heightmap_texture = pc->heightfield_texture;
  792. } break;
  793. default: {
  794. }
  795. }
  796. frame_params.collider_count++;
  797. }
  798. }
  799. bool different = false;
  800. if (collision_3d_textures_used == p_particles->collision_3d_textures_used) {
  801. for (int i = 0; i < ParticlesFrameParams::MAX_3D_TEXTURES; i++) {
  802. if (p_particles->collision_3d_textures[i] != collision_3d_textures[i]) {
  803. different = true;
  804. break;
  805. }
  806. }
  807. }
  808. if (collision_heightmap_texture != p_particles->collision_heightmap_texture) {
  809. different = true;
  810. }
  811. bool uniform_set_valid = RD::get_singleton()->uniform_set_is_valid(p_particles->collision_textures_uniform_set);
  812. if (different || !uniform_set_valid) {
  813. if (uniform_set_valid) {
  814. RD::get_singleton()->free(p_particles->collision_textures_uniform_set);
  815. }
  816. Vector<RD::Uniform> uniforms;
  817. {
  818. RD::Uniform u;
  819. u.uniform_type = RD::UNIFORM_TYPE_TEXTURE;
  820. u.binding = 0;
  821. for (uint32_t i = 0; i < ParticlesFrameParams::MAX_3D_TEXTURES; i++) {
  822. RID rd_tex;
  823. if (i < collision_3d_textures_used) {
  824. if (TextureStorage::get_singleton()->texture_get_type(collision_3d_textures[i]) == TextureStorage::TYPE_3D) {
  825. rd_tex = TextureStorage::get_singleton()->texture_get_rd_texture(collision_3d_textures[i]);
  826. }
  827. }
  828. if (rd_tex == RID()) {
  829. rd_tex = texture_storage->texture_rd_get_default(TextureStorage::DEFAULT_RD_TEXTURE_3D_WHITE);
  830. }
  831. u.append_id(rd_tex);
  832. }
  833. uniforms.push_back(u);
  834. }
  835. {
  836. RD::Uniform u;
  837. u.uniform_type = RD::UNIFORM_TYPE_TEXTURE;
  838. u.binding = 1;
  839. if (collision_heightmap_texture.is_valid()) {
  840. u.append_id(collision_heightmap_texture);
  841. } else {
  842. u.append_id(texture_storage->texture_rd_get_default(TextureStorage::DEFAULT_RD_TEXTURE_BLACK));
  843. }
  844. uniforms.push_back(u);
  845. }
  846. p_particles->collision_textures_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.default_shader_rd, 2);
  847. }
  848. }
  849. ParticlesShader::PushConstant push_constant;
  850. int process_amount = p_particles->amount;
  851. if (p_particles->trails_enabled && p_particles->trail_bind_poses.size() > 1) {
  852. process_amount *= p_particles->trail_bind_poses.size();
  853. }
  854. push_constant.clear = p_particles->clear;
  855. push_constant.total_particles = p_particles->amount;
  856. push_constant.lifetime = p_particles->lifetime;
  857. push_constant.trail_size = p_particles->trail_params.size();
  858. push_constant.use_fractional_delta = p_particles->fractional_delta;
  859. push_constant.sub_emitter_mode = !p_particles->emitting && p_particles->emission_buffer && (p_particles->emission_buffer->particle_count > 0 || p_particles->force_sub_emit);
  860. push_constant.trail_pass = false;
  861. p_particles->force_sub_emit = false; //reset
  862. Particles *sub_emitter = particles_owner.get_or_null(p_particles->sub_emitter);
  863. if (sub_emitter && sub_emitter->emission_storage_buffer.is_valid()) {
  864. // print_line("updating subemitter buffer");
  865. int32_t zero[4] = { 0, sub_emitter->amount, 0, 0 };
  866. RD::get_singleton()->buffer_update(sub_emitter->emission_storage_buffer, 0, sizeof(uint32_t) * 4, zero);
  867. push_constant.can_emit = true;
  868. if (sub_emitter->emitting) {
  869. sub_emitter->emitting = false;
  870. sub_emitter->clear = true; //will need to clear if it was emitting, sorry
  871. }
  872. //make sure the sub emitter processes particles too
  873. sub_emitter->inactive = false;
  874. sub_emitter->inactive_time = 0;
  875. sub_emitter->force_sub_emit = true;
  876. } else {
  877. push_constant.can_emit = false;
  878. }
  879. if (p_particles->emission_buffer && p_particles->emission_buffer->particle_count) {
  880. RD::get_singleton()->buffer_update(p_particles->emission_storage_buffer, 0, sizeof(uint32_t) * 4 + sizeof(ParticleEmissionBuffer::Data) * p_particles->emission_buffer->particle_count, p_particles->emission_buffer);
  881. p_particles->emission_buffer->particle_count = 0;
  882. }
  883. p_particles->clear = false;
  884. if (p_particles->trail_params.size() > 1) {
  885. //fill the trail params
  886. for (uint32_t i = 0; i < p_particles->trail_params.size(); i++) {
  887. uint32_t src_idx = i * p_particles->frame_history.size() / p_particles->trail_params.size();
  888. p_particles->trail_params[i] = p_particles->frame_history[src_idx];
  889. }
  890. } else {
  891. p_particles->trail_params[0] = p_particles->frame_history[0];
  892. }
  893. RD::get_singleton()->buffer_update(p_particles->frame_params_buffer, 0, sizeof(ParticlesFrameParams) * p_particles->trail_params.size(), p_particles->trail_params.ptr());
  894. ParticleProcessMaterialData *m = static_cast<ParticleProcessMaterialData *>(material_storage->material_get_data(p_particles->process_material, MaterialStorage::SHADER_TYPE_PARTICLES));
  895. if (!m) {
  896. m = static_cast<ParticleProcessMaterialData *>(material_storage->material_get_data(particles_shader.default_material, MaterialStorage::SHADER_TYPE_PARTICLES));
  897. }
  898. ERR_FAIL_COND(!m);
  899. p_particles->has_collision_cache = m->shader_data->uses_collision;
  900. //todo should maybe compute all particle systems together?
  901. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  902. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, m->shader_data->pipeline);
  903. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles_shader.base_uniform_set, 0);
  904. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, p_particles->particles_material_uniform_set, 1);
  905. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, p_particles->collision_textures_uniform_set, 2);
  906. if (m->uniform_set.is_valid() && RD::get_singleton()->uniform_set_is_valid(m->uniform_set)) {
  907. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, m->uniform_set, 3);
  908. }
  909. RD::get_singleton()->compute_list_set_push_constant(compute_list, &push_constant, sizeof(ParticlesShader::PushConstant));
  910. if (p_particles->trails_enabled && p_particles->trail_bind_poses.size() > 1) {
  911. //trails requires two passes in order to catch particle starts
  912. RD::get_singleton()->compute_list_dispatch_threads(compute_list, process_amount / p_particles->trail_bind_poses.size(), 1, 1);
  913. RD::get_singleton()->compute_list_add_barrier(compute_list);
  914. push_constant.trail_pass = true;
  915. RD::get_singleton()->compute_list_set_push_constant(compute_list, &push_constant, sizeof(ParticlesShader::PushConstant));
  916. RD::get_singleton()->compute_list_dispatch_threads(compute_list, process_amount - p_particles->amount, 1, 1);
  917. } else {
  918. RD::get_singleton()->compute_list_dispatch_threads(compute_list, process_amount, 1, 1);
  919. }
  920. RD::get_singleton()->compute_list_end();
  921. }
  922. void ParticlesStorage::particles_set_view_axis(RID p_particles, const Vector3 &p_axis, const Vector3 &p_up_axis) {
  923. Particles *particles = particles_owner.get_or_null(p_particles);
  924. ERR_FAIL_COND(!particles);
  925. if (particles->draw_order != RS::PARTICLES_DRAW_ORDER_VIEW_DEPTH && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD_Y_TO_VELOCITY) {
  926. return;
  927. }
  928. if (particles->particle_buffer.is_null()) {
  929. return; //particles have not processed yet
  930. }
  931. bool do_sort = particles->draw_order == RS::PARTICLES_DRAW_ORDER_VIEW_DEPTH;
  932. //copy to sort buffer
  933. if (do_sort && particles->particles_sort_buffer == RID()) {
  934. uint32_t size = particles->amount;
  935. if (size & 1) {
  936. size++; //make multiple of 16
  937. }
  938. size *= sizeof(float) * 2;
  939. particles->particles_sort_buffer = RD::get_singleton()->storage_buffer_create(size);
  940. {
  941. Vector<RD::Uniform> uniforms;
  942. {
  943. RD::Uniform u;
  944. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  945. u.binding = 0;
  946. u.append_id(particles->particles_sort_buffer);
  947. uniforms.push_back(u);
  948. }
  949. particles->particles_sort_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, ParticlesShader::COPY_MODE_FILL_SORT_BUFFER), 1);
  950. }
  951. }
  952. ParticlesShader::CopyPushConstant copy_push_constant;
  953. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  954. int fixed_fps = 60.0;
  955. if (particles->fixed_fps > 0) {
  956. fixed_fps = particles->fixed_fps;
  957. }
  958. copy_push_constant.trail_size = particles->trail_bind_poses.size();
  959. copy_push_constant.trail_total = particles->frame_history.size();
  960. copy_push_constant.frame_delta = 1.0 / fixed_fps;
  961. } else {
  962. copy_push_constant.trail_size = 1;
  963. copy_push_constant.trail_total = 1;
  964. copy_push_constant.frame_delta = 0.0;
  965. }
  966. copy_push_constant.order_by_lifetime = (particles->draw_order == RS::PARTICLES_DRAW_ORDER_LIFETIME || particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME);
  967. copy_push_constant.lifetime_split = MIN(particles->amount * particles->phase, particles->amount - 1);
  968. copy_push_constant.lifetime_reverse = particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME;
  969. copy_push_constant.frame_remainder = particles->interpolate ? particles->frame_remainder : 0.0;
  970. copy_push_constant.total_particles = particles->amount;
  971. copy_push_constant.copy_mode_2d = false;
  972. Vector3 axis = -p_axis; // cameras look to z negative
  973. if (particles->use_local_coords) {
  974. axis = particles->emission_transform.basis.xform_inv(axis).normalized();
  975. }
  976. copy_push_constant.sort_direction[0] = axis.x;
  977. copy_push_constant.sort_direction[1] = axis.y;
  978. copy_push_constant.sort_direction[2] = axis.z;
  979. copy_push_constant.align_up[0] = p_up_axis.x;
  980. copy_push_constant.align_up[1] = p_up_axis.y;
  981. copy_push_constant.align_up[2] = p_up_axis.z;
  982. copy_push_constant.align_mode = particles->transform_align;
  983. if (do_sort) {
  984. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  985. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, particles_shader.copy_pipelines[ParticlesShader::COPY_MODE_FILL_SORT_BUFFER + particles->userdata_count * ParticlesShader::COPY_MODE_MAX]);
  986. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_copy_uniform_set, 0);
  987. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_sort_uniform_set, 1);
  988. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->trail_bind_pose_uniform_set, 2);
  989. RD::get_singleton()->compute_list_set_push_constant(compute_list, &copy_push_constant, sizeof(ParticlesShader::CopyPushConstant));
  990. RD::get_singleton()->compute_list_dispatch_threads(compute_list, particles->amount, 1, 1);
  991. RD::get_singleton()->compute_list_end();
  992. RendererCompositorRD::singleton->get_effects()->sort_buffer(particles->particles_sort_uniform_set, particles->amount);
  993. }
  994. copy_push_constant.total_particles *= copy_push_constant.total_particles;
  995. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  996. uint32_t copy_pipeline = do_sort ? ParticlesShader::COPY_MODE_FILL_INSTANCES_WITH_SORT_BUFFER : ParticlesShader::COPY_MODE_FILL_INSTANCES;
  997. copy_pipeline += particles->userdata_count * ParticlesShader::COPY_MODE_MAX;
  998. copy_push_constant.copy_mode_2d = particles->mode == RS::PARTICLES_MODE_2D ? 1 : 0;
  999. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, particles_shader.copy_pipelines[copy_pipeline]);
  1000. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_copy_uniform_set, 0);
  1001. if (do_sort) {
  1002. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_sort_uniform_set, 1);
  1003. }
  1004. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->trail_bind_pose_uniform_set, 2);
  1005. RD::get_singleton()->compute_list_set_push_constant(compute_list, &copy_push_constant, sizeof(ParticlesShader::CopyPushConstant));
  1006. RD::get_singleton()->compute_list_dispatch_threads(compute_list, copy_push_constant.total_particles, 1, 1);
  1007. RD::get_singleton()->compute_list_end();
  1008. }
  1009. void ParticlesStorage::_particles_update_buffers(Particles *particles) {
  1010. uint32_t userdata_count = 0;
  1011. MaterialStorage::ShaderData *shader_data = MaterialStorage::get_singleton()->material_get_shader_data(particles->process_material);
  1012. if (shader_data) {
  1013. const ParticlesShaderData *particle_shader_data = static_cast<const ParticlesShaderData *>(shader_data);
  1014. userdata_count = particle_shader_data->userdata_count;
  1015. }
  1016. if (userdata_count != particles->userdata_count) {
  1017. // Mismatch userdata, re-create buffers.
  1018. _particles_free_data(particles);
  1019. }
  1020. if (particles->amount > 0 && particles->particle_buffer.is_null()) {
  1021. int total_amount = particles->amount;
  1022. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1023. total_amount *= particles->trail_bind_poses.size();
  1024. }
  1025. uint32_t xform_size = particles->mode == RS::PARTICLES_MODE_2D ? 2 : 3;
  1026. particles->particle_buffer = RD::get_singleton()->storage_buffer_create((sizeof(ParticleData) + userdata_count * sizeof(float) * 4) * total_amount);
  1027. particles->userdata_count = userdata_count;
  1028. particles->particle_instance_buffer = RD::get_singleton()->storage_buffer_create(sizeof(float) * 4 * (xform_size + 1 + 1) * total_amount);
  1029. //needs to clear it
  1030. {
  1031. Vector<RD::Uniform> uniforms;
  1032. {
  1033. RD::Uniform u;
  1034. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  1035. u.binding = 1;
  1036. u.append_id(particles->particle_buffer);
  1037. uniforms.push_back(u);
  1038. }
  1039. {
  1040. RD::Uniform u;
  1041. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  1042. u.binding = 2;
  1043. u.append_id(particles->particle_instance_buffer);
  1044. uniforms.push_back(u);
  1045. }
  1046. particles->particles_copy_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, 0), 0);
  1047. }
  1048. }
  1049. }
  1050. void ParticlesStorage::update_particles() {
  1051. while (particle_update_list) {
  1052. //use transform feedback to process particles
  1053. Particles *particles = particle_update_list;
  1054. //take and remove
  1055. particle_update_list = particles->update_list;
  1056. particles->update_list = nullptr;
  1057. particles->dirty = false;
  1058. _particles_update_buffers(particles);
  1059. if (particles->restart_request) {
  1060. particles->prev_ticks = 0;
  1061. particles->phase = 0;
  1062. particles->prev_phase = 0;
  1063. particles->clear = true;
  1064. particles->restart_request = false;
  1065. }
  1066. if (particles->inactive && !particles->emitting) {
  1067. //go next
  1068. continue;
  1069. }
  1070. if (particles->emitting) {
  1071. if (particles->inactive) {
  1072. //restart system from scratch
  1073. particles->prev_ticks = 0;
  1074. particles->phase = 0;
  1075. particles->prev_phase = 0;
  1076. particles->clear = true;
  1077. }
  1078. particles->inactive = false;
  1079. particles->inactive_time = 0;
  1080. } else {
  1081. particles->inactive_time += particles->speed_scale * RendererCompositorRD::singleton->get_frame_delta_time();
  1082. if (particles->inactive_time > particles->lifetime * 1.2) {
  1083. particles->inactive = true;
  1084. continue;
  1085. }
  1086. }
  1087. #ifndef _MSC_VER
  1088. #warning Should use display refresh rate for all this
  1089. #endif
  1090. float screen_hz = 60;
  1091. int fixed_fps = 0;
  1092. if (particles->fixed_fps > 0) {
  1093. fixed_fps = particles->fixed_fps;
  1094. } else if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1095. fixed_fps = screen_hz;
  1096. }
  1097. {
  1098. //update trails
  1099. int history_size = 1;
  1100. int trail_steps = 1;
  1101. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1102. history_size = MAX(1, int(particles->trail_length * fixed_fps));
  1103. trail_steps = particles->trail_bind_poses.size();
  1104. }
  1105. if (uint32_t(history_size) != particles->frame_history.size()) {
  1106. particles->frame_history.resize(history_size);
  1107. memset(particles->frame_history.ptr(), 0, sizeof(ParticlesFrameParams) * history_size);
  1108. }
  1109. if (uint32_t(trail_steps) != particles->trail_params.size() || particles->frame_params_buffer.is_null()) {
  1110. particles->trail_params.resize(trail_steps);
  1111. if (particles->frame_params_buffer.is_valid()) {
  1112. RD::get_singleton()->free(particles->frame_params_buffer);
  1113. }
  1114. particles->frame_params_buffer = RD::get_singleton()->storage_buffer_create(sizeof(ParticlesFrameParams) * trail_steps);
  1115. }
  1116. if (particles->trail_bind_poses.size() > 1 && particles->trail_bind_pose_buffer.is_null()) {
  1117. particles->trail_bind_pose_buffer = RD::get_singleton()->storage_buffer_create(sizeof(float) * 16 * particles->trail_bind_poses.size());
  1118. particles->trail_bind_poses_dirty = true;
  1119. }
  1120. if (particles->trail_bind_pose_uniform_set.is_null()) {
  1121. Vector<RD::Uniform> uniforms;
  1122. {
  1123. RD::Uniform u;
  1124. u.uniform_type = RD::UNIFORM_TYPE_STORAGE_BUFFER;
  1125. u.binding = 0;
  1126. if (particles->trail_bind_pose_buffer.is_valid()) {
  1127. u.append_id(particles->trail_bind_pose_buffer);
  1128. } else {
  1129. u.append_id(MeshStorage::get_singleton()->get_default_rd_storage_buffer());
  1130. }
  1131. uniforms.push_back(u);
  1132. }
  1133. particles->trail_bind_pose_uniform_set = RD::get_singleton()->uniform_set_create(uniforms, particles_shader.copy_shader.version_get_shader(particles_shader.copy_shader_version, 0), 2);
  1134. }
  1135. if (particles->trail_bind_pose_buffer.is_valid() && particles->trail_bind_poses_dirty) {
  1136. if (particles_shader.pose_update_buffer.size() < uint32_t(particles->trail_bind_poses.size()) * 16) {
  1137. particles_shader.pose_update_buffer.resize(particles->trail_bind_poses.size() * 16);
  1138. }
  1139. for (int i = 0; i < particles->trail_bind_poses.size(); i++) {
  1140. RendererRD::MaterialStorage::store_transform(particles->trail_bind_poses[i], &particles_shader.pose_update_buffer[i * 16]);
  1141. }
  1142. RD::get_singleton()->buffer_update(particles->trail_bind_pose_buffer, 0, particles->trail_bind_poses.size() * 16 * sizeof(float), particles_shader.pose_update_buffer.ptr());
  1143. }
  1144. }
  1145. bool zero_time_scale = Engine::get_singleton()->get_time_scale() <= 0.0;
  1146. if (particles->clear && particles->pre_process_time > 0.0) {
  1147. double frame_time;
  1148. if (fixed_fps > 0) {
  1149. frame_time = 1.0 / fixed_fps;
  1150. } else {
  1151. frame_time = 1.0 / 30.0;
  1152. }
  1153. double todo = particles->pre_process_time;
  1154. while (todo >= 0) {
  1155. _particles_process(particles, frame_time);
  1156. todo -= frame_time;
  1157. }
  1158. }
  1159. if (fixed_fps > 0) {
  1160. double frame_time;
  1161. double decr;
  1162. if (zero_time_scale) {
  1163. frame_time = 0.0;
  1164. decr = 1.0 / fixed_fps;
  1165. } else {
  1166. frame_time = 1.0 / fixed_fps;
  1167. decr = frame_time;
  1168. }
  1169. double delta = RendererCompositorRD::singleton->get_frame_delta_time();
  1170. if (delta > 0.1) { //avoid recursive stalls if fps goes below 10
  1171. delta = 0.1;
  1172. } else if (delta <= 0.0) { //unlikely but..
  1173. delta = 0.001;
  1174. }
  1175. double todo = particles->frame_remainder + delta;
  1176. while (todo >= frame_time) {
  1177. _particles_process(particles, frame_time);
  1178. todo -= decr;
  1179. }
  1180. particles->frame_remainder = todo;
  1181. } else {
  1182. if (zero_time_scale) {
  1183. _particles_process(particles, 0.0);
  1184. } else {
  1185. _particles_process(particles, RendererCompositorRD::singleton->get_frame_delta_time());
  1186. }
  1187. }
  1188. //copy particles to instance buffer
  1189. if (particles->draw_order != RS::PARTICLES_DRAW_ORDER_VIEW_DEPTH && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD && particles->transform_align != RS::PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD_Y_TO_VELOCITY) {
  1190. //does not need view dependent operation, do copy here
  1191. ParticlesShader::CopyPushConstant copy_push_constant;
  1192. int total_amount = particles->amount;
  1193. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1194. total_amount *= particles->trail_bind_poses.size();
  1195. }
  1196. // Affect 2D only.
  1197. if (particles->use_local_coords) {
  1198. // In local mode, particle positions are calculated locally (relative to the node position)
  1199. // and they're also drawn locally.
  1200. // It works as expected, so we just pass an identity transform.
  1201. RendererRD::MaterialStorage::store_transform(Transform3D(), copy_push_constant.inv_emission_transform);
  1202. } else {
  1203. // In global mode, particle positions are calculated globally (relative to the canvas origin)
  1204. // but they're drawn locally.
  1205. // So, we need to pass the inverse of the emission transform to bring the
  1206. // particles to local coordinates before drawing.
  1207. Transform3D inv = particles->emission_transform.affine_inverse();
  1208. RendererRD::MaterialStorage::store_transform(inv, copy_push_constant.inv_emission_transform);
  1209. }
  1210. copy_push_constant.total_particles = total_amount;
  1211. copy_push_constant.frame_remainder = particles->interpolate ? particles->frame_remainder : 0.0;
  1212. copy_push_constant.align_mode = particles->transform_align;
  1213. copy_push_constant.align_up[0] = 0;
  1214. copy_push_constant.align_up[1] = 0;
  1215. copy_push_constant.align_up[2] = 0;
  1216. if (particles->trails_enabled && particles->trail_bind_poses.size() > 1) {
  1217. copy_push_constant.trail_size = particles->trail_bind_poses.size();
  1218. copy_push_constant.trail_total = particles->frame_history.size();
  1219. copy_push_constant.frame_delta = 1.0 / fixed_fps;
  1220. } else {
  1221. copy_push_constant.trail_size = 1;
  1222. copy_push_constant.trail_total = 1;
  1223. copy_push_constant.frame_delta = 0.0;
  1224. }
  1225. copy_push_constant.order_by_lifetime = (particles->draw_order == RS::PARTICLES_DRAW_ORDER_LIFETIME || particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME);
  1226. copy_push_constant.lifetime_split = MIN(particles->amount * particles->phase, particles->amount - 1);
  1227. copy_push_constant.lifetime_reverse = particles->draw_order == RS::PARTICLES_DRAW_ORDER_REVERSE_LIFETIME;
  1228. RD::ComputeListID compute_list = RD::get_singleton()->compute_list_begin();
  1229. copy_push_constant.copy_mode_2d = particles->mode == RS::PARTICLES_MODE_2D ? 1 : 0;
  1230. RD::get_singleton()->compute_list_bind_compute_pipeline(compute_list, particles_shader.copy_pipelines[ParticlesShader::COPY_MODE_FILL_INSTANCES + particles->userdata_count * ParticlesShader::COPY_MODE_MAX]);
  1231. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->particles_copy_uniform_set, 0);
  1232. RD::get_singleton()->compute_list_bind_uniform_set(compute_list, particles->trail_bind_pose_uniform_set, 2);
  1233. RD::get_singleton()->compute_list_set_push_constant(compute_list, &copy_push_constant, sizeof(ParticlesShader::CopyPushConstant));
  1234. RD::get_singleton()->compute_list_dispatch_threads(compute_list, total_amount, 1, 1);
  1235. RD::get_singleton()->compute_list_end();
  1236. }
  1237. particles->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1238. }
  1239. }
  1240. Dependency *ParticlesStorage::particles_get_dependency(RID p_particles) const {
  1241. Particles *particles = particles_owner.get_or_null(p_particles);
  1242. ERR_FAIL_NULL_V(particles, nullptr);
  1243. return &particles->dependency;
  1244. }
  1245. bool ParticlesStorage::particles_is_inactive(RID p_particles) const {
  1246. ERR_FAIL_COND_V_MSG(RSG::threaded, false, "This function should never be used with threaded rendering, as it stalls the renderer.");
  1247. const Particles *particles = particles_owner.get_or_null(p_particles);
  1248. ERR_FAIL_COND_V(!particles, false);
  1249. return !particles->emitting && particles->inactive;
  1250. }
  1251. /* Particles SHADER */
  1252. void ParticlesStorage::ParticlesShaderData::set_path_hint(const String &p_path) {
  1253. path = p_path;
  1254. }
  1255. void ParticlesStorage::ParticlesShaderData::set_code(const String &p_code) {
  1256. ParticlesStorage *particles_storage = ParticlesStorage::get_singleton();
  1257. //compile
  1258. code = p_code;
  1259. valid = false;
  1260. ubo_size = 0;
  1261. uniforms.clear();
  1262. uses_collision = false;
  1263. if (code.is_empty()) {
  1264. return; //just invalid, but no error
  1265. }
  1266. ShaderCompiler::GeneratedCode gen_code;
  1267. ShaderCompiler::IdentifierActions actions;
  1268. actions.entry_point_stages["start"] = ShaderCompiler::STAGE_COMPUTE;
  1269. actions.entry_point_stages["process"] = ShaderCompiler::STAGE_COMPUTE;
  1270. /*
  1271. uses_time = false;
  1272. actions.render_mode_flags["use_half_res_pass"] = &uses_half_res;
  1273. actions.render_mode_flags["use_quarter_res_pass"] = &uses_quarter_res;
  1274. actions.usage_flag_pointers["TIME"] = &uses_time;
  1275. */
  1276. actions.usage_flag_pointers["COLLIDED"] = &uses_collision;
  1277. userdata_count = 0;
  1278. for (uint32_t i = 0; i < ParticlesShader::MAX_USERDATAS; i++) {
  1279. userdatas_used[i] = false;
  1280. actions.usage_flag_pointers["USERDATA" + itos(i + 1)] = &userdatas_used[i];
  1281. }
  1282. actions.uniforms = &uniforms;
  1283. Error err = particles_storage->particles_shader.compiler.compile(RS::SHADER_PARTICLES, code, &actions, path, gen_code);
  1284. ERR_FAIL_COND_MSG(err != OK, "Shader compilation failed.");
  1285. if (version.is_null()) {
  1286. version = particles_storage->particles_shader.shader.version_create();
  1287. }
  1288. for (uint32_t i = 0; i < ParticlesShader::MAX_USERDATAS; i++) {
  1289. if (userdatas_used[i]) {
  1290. userdata_count++;
  1291. }
  1292. }
  1293. particles_storage->particles_shader.shader.version_set_compute_code(version, gen_code.code, gen_code.uniforms, gen_code.stage_globals[ShaderCompiler::STAGE_COMPUTE], gen_code.defines);
  1294. ERR_FAIL_COND(!particles_storage->particles_shader.shader.version_is_valid(version));
  1295. ubo_size = gen_code.uniform_total_size;
  1296. ubo_offsets = gen_code.uniform_offsets;
  1297. texture_uniforms = gen_code.texture_uniforms;
  1298. //update pipelines
  1299. pipeline = RD::get_singleton()->compute_pipeline_create(particles_storage->particles_shader.shader.version_get_shader(version, 0));
  1300. valid = true;
  1301. }
  1302. void ParticlesStorage::ParticlesShaderData::set_default_texture_parameter(const StringName &p_name, RID p_texture, int p_index) {
  1303. if (!p_texture.is_valid()) {
  1304. if (default_texture_params.has(p_name) && default_texture_params[p_name].has(p_index)) {
  1305. default_texture_params[p_name].erase(p_index);
  1306. if (default_texture_params[p_name].is_empty()) {
  1307. default_texture_params.erase(p_name);
  1308. }
  1309. }
  1310. } else {
  1311. if (!default_texture_params.has(p_name)) {
  1312. default_texture_params[p_name] = HashMap<int, RID>();
  1313. }
  1314. default_texture_params[p_name][p_index] = p_texture;
  1315. }
  1316. }
  1317. void ParticlesStorage::ParticlesShaderData::get_shader_uniform_list(List<PropertyInfo> *p_param_list) const {
  1318. HashMap<int, StringName> order;
  1319. for (const KeyValue<StringName, ShaderLanguage::ShaderNode::Uniform> &E : uniforms) {
  1320. if (E.value.scope == ShaderLanguage::ShaderNode::Uniform::SCOPE_GLOBAL || E.value.scope == ShaderLanguage::ShaderNode::Uniform::SCOPE_INSTANCE) {
  1321. continue;
  1322. }
  1323. if (E.value.texture_order >= 0) {
  1324. order[E.value.texture_order + 100000] = E.key;
  1325. } else {
  1326. order[E.value.order] = E.key;
  1327. }
  1328. }
  1329. String last_group;
  1330. for (const KeyValue<int, StringName> &E : order) {
  1331. String group = uniforms[E.value].group;
  1332. if (!uniforms[E.value].subgroup.is_empty()) {
  1333. group += "::" + uniforms[E.value].subgroup;
  1334. }
  1335. if (group != last_group) {
  1336. PropertyInfo pi;
  1337. pi.usage = PROPERTY_USAGE_GROUP;
  1338. pi.name = group;
  1339. p_param_list->push_back(pi);
  1340. last_group = group;
  1341. }
  1342. PropertyInfo pi = ShaderLanguage::uniform_to_property_info(uniforms[E.value]);
  1343. pi.name = E.value;
  1344. p_param_list->push_back(pi);
  1345. }
  1346. }
  1347. void ParticlesStorage::ParticlesShaderData::get_instance_param_list(List<RendererMaterialStorage::InstanceShaderParam> *p_param_list) const {
  1348. for (const KeyValue<StringName, ShaderLanguage::ShaderNode::Uniform> &E : uniforms) {
  1349. if (E.value.scope != ShaderLanguage::ShaderNode::Uniform::SCOPE_INSTANCE) {
  1350. continue;
  1351. }
  1352. RendererMaterialStorage::InstanceShaderParam p;
  1353. p.info = ShaderLanguage::uniform_to_property_info(E.value);
  1354. p.info.name = E.key; //supply name
  1355. p.index = E.value.instance_index;
  1356. p.default_value = ShaderLanguage::constant_value_to_variant(E.value.default_value, E.value.type, E.value.array_size, E.value.hint);
  1357. p_param_list->push_back(p);
  1358. }
  1359. }
  1360. bool ParticlesStorage::ParticlesShaderData::is_parameter_texture(const StringName &p_param) const {
  1361. if (!uniforms.has(p_param)) {
  1362. return false;
  1363. }
  1364. return uniforms[p_param].texture_order >= 0;
  1365. }
  1366. bool ParticlesStorage::ParticlesShaderData::is_animated() const {
  1367. return false;
  1368. }
  1369. bool ParticlesStorage::ParticlesShaderData::casts_shadows() const {
  1370. return false;
  1371. }
  1372. Variant ParticlesStorage::ParticlesShaderData::get_default_parameter(const StringName &p_parameter) const {
  1373. if (uniforms.has(p_parameter)) {
  1374. ShaderLanguage::ShaderNode::Uniform uniform = uniforms[p_parameter];
  1375. Vector<ShaderLanguage::ConstantNode::Value> default_value = uniform.default_value;
  1376. return ShaderLanguage::constant_value_to_variant(default_value, uniform.type, uniform.array_size, uniform.hint);
  1377. }
  1378. return Variant();
  1379. }
  1380. RS::ShaderNativeSourceCode ParticlesStorage::ParticlesShaderData::get_native_source_code() const {
  1381. return ParticlesStorage::get_singleton()->particles_shader.shader.version_get_native_source_code(version);
  1382. }
  1383. ParticlesStorage::ParticlesShaderData::~ParticlesShaderData() {
  1384. //pipeline variants will clear themselves if shader is gone
  1385. if (version.is_valid()) {
  1386. ParticlesStorage::get_singleton()->particles_shader.shader.version_free(version);
  1387. }
  1388. }
  1389. MaterialStorage::ShaderData *ParticlesStorage::_create_particles_shader_func() {
  1390. ParticlesShaderData *shader_data = memnew(ParticlesShaderData);
  1391. return shader_data;
  1392. }
  1393. bool ParticlesStorage::ParticleProcessMaterialData::update_parameters(const HashMap<StringName, Variant> &p_parameters, bool p_uniform_dirty, bool p_textures_dirty) {
  1394. return update_parameters_uniform_set(p_parameters, p_uniform_dirty, p_textures_dirty, shader_data->uniforms, shader_data->ubo_offsets.ptr(), shader_data->texture_uniforms, shader_data->default_texture_params, shader_data->ubo_size, uniform_set, ParticlesStorage::get_singleton()->particles_shader.shader.version_get_shader(shader_data->version, 0), 3);
  1395. }
  1396. ParticlesStorage::ParticleProcessMaterialData::~ParticleProcessMaterialData() {
  1397. free_parameters_uniform_set(uniform_set);
  1398. }
  1399. MaterialStorage::MaterialData *ParticlesStorage::_create_particles_material_func(ParticlesShaderData *p_shader) {
  1400. ParticleProcessMaterialData *material_data = memnew(ParticleProcessMaterialData);
  1401. material_data->shader_data = p_shader;
  1402. //update will happen later anyway so do nothing.
  1403. return material_data;
  1404. }
  1405. ////////
  1406. /* PARTICLES COLLISION API */
  1407. RID ParticlesStorage::particles_collision_allocate() {
  1408. return particles_collision_owner.allocate_rid();
  1409. }
  1410. void ParticlesStorage::particles_collision_initialize(RID p_rid) {
  1411. particles_collision_owner.initialize_rid(p_rid, ParticlesCollision());
  1412. }
  1413. void ParticlesStorage::particles_collision_free(RID p_rid) {
  1414. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_rid);
  1415. if (particles_collision->heightfield_texture.is_valid()) {
  1416. RD::get_singleton()->free(particles_collision->heightfield_texture);
  1417. }
  1418. particles_collision->dependency.deleted_notify(p_rid);
  1419. particles_collision_owner.free(p_rid);
  1420. }
  1421. RID ParticlesStorage::particles_collision_get_heightfield_framebuffer(RID p_particles_collision) const {
  1422. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1423. ERR_FAIL_COND_V(!particles_collision, RID());
  1424. ERR_FAIL_COND_V(particles_collision->type != RS::PARTICLES_COLLISION_TYPE_HEIGHTFIELD_COLLIDE, RID());
  1425. if (particles_collision->heightfield_texture == RID()) {
  1426. //create
  1427. const int resolutions[RS::PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_MAX] = { 256, 512, 1024, 2048, 4096, 8192 };
  1428. Size2i size;
  1429. if (particles_collision->extents.x > particles_collision->extents.z) {
  1430. size.x = resolutions[particles_collision->heightfield_resolution];
  1431. size.y = int32_t(particles_collision->extents.z / particles_collision->extents.x * size.x);
  1432. } else {
  1433. size.y = resolutions[particles_collision->heightfield_resolution];
  1434. size.x = int32_t(particles_collision->extents.x / particles_collision->extents.z * size.y);
  1435. }
  1436. RD::TextureFormat tf;
  1437. tf.format = RD::DATA_FORMAT_D32_SFLOAT;
  1438. tf.width = size.x;
  1439. tf.height = size.y;
  1440. tf.texture_type = RD::TEXTURE_TYPE_2D;
  1441. tf.usage_bits = RD::TEXTURE_USAGE_SAMPLING_BIT | RD::TEXTURE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT;
  1442. particles_collision->heightfield_texture = RD::get_singleton()->texture_create(tf, RD::TextureView());
  1443. Vector<RID> fb_tex;
  1444. fb_tex.push_back(particles_collision->heightfield_texture);
  1445. particles_collision->heightfield_fb = RD::get_singleton()->framebuffer_create(fb_tex);
  1446. particles_collision->heightfield_fb_size = size;
  1447. }
  1448. return particles_collision->heightfield_fb;
  1449. }
  1450. void ParticlesStorage::particles_collision_set_collision_type(RID p_particles_collision, RS::ParticlesCollisionType p_type) {
  1451. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1452. ERR_FAIL_COND(!particles_collision);
  1453. if (p_type == particles_collision->type) {
  1454. return;
  1455. }
  1456. if (particles_collision->heightfield_texture.is_valid()) {
  1457. RD::get_singleton()->free(particles_collision->heightfield_texture);
  1458. particles_collision->heightfield_texture = RID();
  1459. }
  1460. particles_collision->type = p_type;
  1461. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1462. }
  1463. void ParticlesStorage::particles_collision_set_cull_mask(RID p_particles_collision, uint32_t p_cull_mask) {
  1464. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1465. ERR_FAIL_COND(!particles_collision);
  1466. particles_collision->cull_mask = p_cull_mask;
  1467. }
  1468. void ParticlesStorage::particles_collision_set_sphere_radius(RID p_particles_collision, real_t p_radius) {
  1469. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1470. ERR_FAIL_COND(!particles_collision);
  1471. particles_collision->radius = p_radius;
  1472. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1473. }
  1474. void ParticlesStorage::particles_collision_set_box_extents(RID p_particles_collision, const Vector3 &p_extents) {
  1475. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1476. ERR_FAIL_COND(!particles_collision);
  1477. particles_collision->extents = p_extents;
  1478. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1479. }
  1480. void ParticlesStorage::particles_collision_set_attractor_strength(RID p_particles_collision, real_t p_strength) {
  1481. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1482. ERR_FAIL_COND(!particles_collision);
  1483. particles_collision->attractor_strength = p_strength;
  1484. }
  1485. void ParticlesStorage::particles_collision_set_attractor_directionality(RID p_particles_collision, real_t p_directionality) {
  1486. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1487. ERR_FAIL_COND(!particles_collision);
  1488. particles_collision->attractor_directionality = p_directionality;
  1489. }
  1490. void ParticlesStorage::particles_collision_set_attractor_attenuation(RID p_particles_collision, real_t p_curve) {
  1491. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1492. ERR_FAIL_COND(!particles_collision);
  1493. particles_collision->attractor_attenuation = p_curve;
  1494. }
  1495. void ParticlesStorage::particles_collision_set_field_texture(RID p_particles_collision, RID p_texture) {
  1496. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1497. ERR_FAIL_COND(!particles_collision);
  1498. particles_collision->field_texture = p_texture;
  1499. }
  1500. void ParticlesStorage::particles_collision_height_field_update(RID p_particles_collision) {
  1501. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1502. ERR_FAIL_COND(!particles_collision);
  1503. particles_collision->dependency.changed_notify(Dependency::DEPENDENCY_CHANGED_AABB);
  1504. }
  1505. void ParticlesStorage::particles_collision_set_height_field_resolution(RID p_particles_collision, RS::ParticlesCollisionHeightfieldResolution p_resolution) {
  1506. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1507. ERR_FAIL_COND(!particles_collision);
  1508. ERR_FAIL_INDEX(p_resolution, RS::PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_MAX);
  1509. if (particles_collision->heightfield_resolution == p_resolution) {
  1510. return;
  1511. }
  1512. particles_collision->heightfield_resolution = p_resolution;
  1513. if (particles_collision->heightfield_texture.is_valid()) {
  1514. RD::get_singleton()->free(particles_collision->heightfield_texture);
  1515. particles_collision->heightfield_texture = RID();
  1516. }
  1517. }
  1518. AABB ParticlesStorage::particles_collision_get_aabb(RID p_particles_collision) const {
  1519. ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1520. ERR_FAIL_COND_V(!particles_collision, AABB());
  1521. switch (particles_collision->type) {
  1522. case RS::PARTICLES_COLLISION_TYPE_SPHERE_ATTRACT:
  1523. case RS::PARTICLES_COLLISION_TYPE_SPHERE_COLLIDE: {
  1524. AABB aabb;
  1525. aabb.position = -Vector3(1, 1, 1) * particles_collision->radius;
  1526. aabb.size = Vector3(2, 2, 2) * particles_collision->radius;
  1527. return aabb;
  1528. }
  1529. default: {
  1530. AABB aabb;
  1531. aabb.position = -particles_collision->extents;
  1532. aabb.size = particles_collision->extents * 2;
  1533. return aabb;
  1534. }
  1535. }
  1536. }
  1537. Vector3 ParticlesStorage::particles_collision_get_extents(RID p_particles_collision) const {
  1538. const ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1539. ERR_FAIL_COND_V(!particles_collision, Vector3());
  1540. return particles_collision->extents;
  1541. }
  1542. bool ParticlesStorage::particles_collision_is_heightfield(RID p_particles_collision) const {
  1543. const ParticlesCollision *particles_collision = particles_collision_owner.get_or_null(p_particles_collision);
  1544. ERR_FAIL_COND_V(!particles_collision, false);
  1545. return particles_collision->type == RS::PARTICLES_COLLISION_TYPE_HEIGHTFIELD_COLLIDE;
  1546. }
  1547. Dependency *ParticlesStorage::particles_collision_get_dependency(RID p_particles_collision) const {
  1548. ParticlesCollision *pc = particles_collision_owner.get_or_null(p_particles_collision);
  1549. ERR_FAIL_NULL_V(pc, nullptr);
  1550. return &pc->dependency;
  1551. }
  1552. /* Particles collision instance */
  1553. RID ParticlesStorage::particles_collision_instance_create(RID p_collision) {
  1554. ParticlesCollisionInstance pci;
  1555. pci.collision = p_collision;
  1556. return particles_collision_instance_owner.make_rid(pci);
  1557. }
  1558. void ParticlesStorage::particles_collision_instance_free(RID p_rid) {
  1559. particles_collision_instance_owner.free(p_rid);
  1560. }
  1561. void ParticlesStorage::particles_collision_instance_set_transform(RID p_collision_instance, const Transform3D &p_transform) {
  1562. ParticlesCollisionInstance *pci = particles_collision_instance_owner.get_or_null(p_collision_instance);
  1563. ERR_FAIL_COND(!pci);
  1564. pci->transform = p_transform;
  1565. }
  1566. void ParticlesStorage::particles_collision_instance_set_active(RID p_collision_instance, bool p_active) {
  1567. ParticlesCollisionInstance *pci = particles_collision_instance_owner.get_or_null(p_collision_instance);
  1568. ERR_FAIL_COND(!pci);
  1569. pci->active = p_active;
  1570. }