class_cpuparticles2d.rst 78 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/4.2/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/4.2/doc/classes/CPUParticles2D.xml.
  6. .. _class_CPUParticles2D:
  7. CPUParticles2D
  8. ==============
  9. **Inherits:** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. A CPU-based 2D particle emitter.
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. CPU-based 2D particle node used to create a variety of particle systems and effects.
  15. See also :ref:`GPUParticles2D<class_GPUParticles2D>`, which provides the same functionality with hardware acceleration, but may not run on older devices.
  16. .. rst-class:: classref-introduction-group
  17. Tutorials
  18. ---------
  19. - :doc:`Particle systems (2D) <../tutorials/2d/particle_systems_2d>`
  20. .. rst-class:: classref-reftable-group
  21. Properties
  22. ----------
  23. .. table::
  24. :widths: auto
  25. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  26. | :ref:`int<class_int>` | :ref:`amount<class_CPUParticles2D_property_amount>` | ``8`` |
  27. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  28. | :ref:`Curve<class_Curve>` | :ref:`angle_curve<class_CPUParticles2D_property_angle_curve>` | |
  29. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  30. | :ref:`float<class_float>` | :ref:`angle_max<class_CPUParticles2D_property_angle_max>` | ``0.0`` |
  31. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  32. | :ref:`float<class_float>` | :ref:`angle_min<class_CPUParticles2D_property_angle_min>` | ``0.0`` |
  33. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  34. | :ref:`Curve<class_Curve>` | :ref:`angular_velocity_curve<class_CPUParticles2D_property_angular_velocity_curve>` | |
  35. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  36. | :ref:`float<class_float>` | :ref:`angular_velocity_max<class_CPUParticles2D_property_angular_velocity_max>` | ``0.0`` |
  37. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  38. | :ref:`float<class_float>` | :ref:`angular_velocity_min<class_CPUParticles2D_property_angular_velocity_min>` | ``0.0`` |
  39. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  40. | :ref:`Curve<class_Curve>` | :ref:`anim_offset_curve<class_CPUParticles2D_property_anim_offset_curve>` | |
  41. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  42. | :ref:`float<class_float>` | :ref:`anim_offset_max<class_CPUParticles2D_property_anim_offset_max>` | ``0.0`` |
  43. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  44. | :ref:`float<class_float>` | :ref:`anim_offset_min<class_CPUParticles2D_property_anim_offset_min>` | ``0.0`` |
  45. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  46. | :ref:`Curve<class_Curve>` | :ref:`anim_speed_curve<class_CPUParticles2D_property_anim_speed_curve>` | |
  47. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  48. | :ref:`float<class_float>` | :ref:`anim_speed_max<class_CPUParticles2D_property_anim_speed_max>` | ``0.0`` |
  49. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  50. | :ref:`float<class_float>` | :ref:`anim_speed_min<class_CPUParticles2D_property_anim_speed_min>` | ``0.0`` |
  51. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  52. | :ref:`Color<class_Color>` | :ref:`color<class_CPUParticles2D_property_color>` | ``Color(1, 1, 1, 1)`` |
  53. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  54. | :ref:`Gradient<class_Gradient>` | :ref:`color_initial_ramp<class_CPUParticles2D_property_color_initial_ramp>` | |
  55. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  56. | :ref:`Gradient<class_Gradient>` | :ref:`color_ramp<class_CPUParticles2D_property_color_ramp>` | |
  57. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  58. | :ref:`Curve<class_Curve>` | :ref:`damping_curve<class_CPUParticles2D_property_damping_curve>` | |
  59. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  60. | :ref:`float<class_float>` | :ref:`damping_max<class_CPUParticles2D_property_damping_max>` | ``0.0`` |
  61. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  62. | :ref:`float<class_float>` | :ref:`damping_min<class_CPUParticles2D_property_damping_min>` | ``0.0`` |
  63. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  64. | :ref:`Vector2<class_Vector2>` | :ref:`direction<class_CPUParticles2D_property_direction>` | ``Vector2(1, 0)`` |
  65. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  66. | :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` | :ref:`draw_order<class_CPUParticles2D_property_draw_order>` | ``0`` |
  67. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  68. | :ref:`PackedColorArray<class_PackedColorArray>` | :ref:`emission_colors<class_CPUParticles2D_property_emission_colors>` | |
  69. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  70. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`emission_normals<class_CPUParticles2D_property_emission_normals>` | |
  71. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  72. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`emission_points<class_CPUParticles2D_property_emission_points>` | |
  73. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  74. | :ref:`Vector2<class_Vector2>` | :ref:`emission_rect_extents<class_CPUParticles2D_property_emission_rect_extents>` | |
  75. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  76. | :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` | :ref:`emission_shape<class_CPUParticles2D_property_emission_shape>` | ``0`` |
  77. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  78. | :ref:`float<class_float>` | :ref:`emission_sphere_radius<class_CPUParticles2D_property_emission_sphere_radius>` | |
  79. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  80. | :ref:`bool<class_bool>` | :ref:`emitting<class_CPUParticles2D_property_emitting>` | ``true`` |
  81. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  82. | :ref:`float<class_float>` | :ref:`explosiveness<class_CPUParticles2D_property_explosiveness>` | ``0.0`` |
  83. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  84. | :ref:`int<class_int>` | :ref:`fixed_fps<class_CPUParticles2D_property_fixed_fps>` | ``0`` |
  85. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  86. | :ref:`bool<class_bool>` | :ref:`fract_delta<class_CPUParticles2D_property_fract_delta>` | ``true`` |
  87. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  88. | :ref:`Vector2<class_Vector2>` | :ref:`gravity<class_CPUParticles2D_property_gravity>` | ``Vector2(0, 980)`` |
  89. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  90. | :ref:`Curve<class_Curve>` | :ref:`hue_variation_curve<class_CPUParticles2D_property_hue_variation_curve>` | |
  91. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  92. | :ref:`float<class_float>` | :ref:`hue_variation_max<class_CPUParticles2D_property_hue_variation_max>` | ``0.0`` |
  93. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  94. | :ref:`float<class_float>` | :ref:`hue_variation_min<class_CPUParticles2D_property_hue_variation_min>` | ``0.0`` |
  95. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  96. | :ref:`float<class_float>` | :ref:`initial_velocity_max<class_CPUParticles2D_property_initial_velocity_max>` | ``0.0`` |
  97. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  98. | :ref:`float<class_float>` | :ref:`initial_velocity_min<class_CPUParticles2D_property_initial_velocity_min>` | ``0.0`` |
  99. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  100. | :ref:`float<class_float>` | :ref:`lifetime<class_CPUParticles2D_property_lifetime>` | ``1.0`` |
  101. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  102. | :ref:`float<class_float>` | :ref:`lifetime_randomness<class_CPUParticles2D_property_lifetime_randomness>` | ``0.0`` |
  103. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  104. | :ref:`Curve<class_Curve>` | :ref:`linear_accel_curve<class_CPUParticles2D_property_linear_accel_curve>` | |
  105. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  106. | :ref:`float<class_float>` | :ref:`linear_accel_max<class_CPUParticles2D_property_linear_accel_max>` | ``0.0`` |
  107. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  108. | :ref:`float<class_float>` | :ref:`linear_accel_min<class_CPUParticles2D_property_linear_accel_min>` | ``0.0`` |
  109. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  110. | :ref:`bool<class_bool>` | :ref:`local_coords<class_CPUParticles2D_property_local_coords>` | ``false`` |
  111. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  112. | :ref:`bool<class_bool>` | :ref:`one_shot<class_CPUParticles2D_property_one_shot>` | ``false`` |
  113. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  114. | :ref:`Curve<class_Curve>` | :ref:`orbit_velocity_curve<class_CPUParticles2D_property_orbit_velocity_curve>` | |
  115. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  116. | :ref:`float<class_float>` | :ref:`orbit_velocity_max<class_CPUParticles2D_property_orbit_velocity_max>` | ``0.0`` |
  117. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  118. | :ref:`float<class_float>` | :ref:`orbit_velocity_min<class_CPUParticles2D_property_orbit_velocity_min>` | ``0.0`` |
  119. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  120. | :ref:`bool<class_bool>` | :ref:`particle_flag_align_y<class_CPUParticles2D_property_particle_flag_align_y>` | ``false`` |
  121. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  122. | :ref:`float<class_float>` | :ref:`preprocess<class_CPUParticles2D_property_preprocess>` | ``0.0`` |
  123. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  124. | :ref:`Curve<class_Curve>` | :ref:`radial_accel_curve<class_CPUParticles2D_property_radial_accel_curve>` | |
  125. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  126. | :ref:`float<class_float>` | :ref:`radial_accel_max<class_CPUParticles2D_property_radial_accel_max>` | ``0.0`` |
  127. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  128. | :ref:`float<class_float>` | :ref:`radial_accel_min<class_CPUParticles2D_property_radial_accel_min>` | ``0.0`` |
  129. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  130. | :ref:`float<class_float>` | :ref:`randomness<class_CPUParticles2D_property_randomness>` | ``0.0`` |
  131. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  132. | :ref:`Curve<class_Curve>` | :ref:`scale_amount_curve<class_CPUParticles2D_property_scale_amount_curve>` | |
  133. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  134. | :ref:`float<class_float>` | :ref:`scale_amount_max<class_CPUParticles2D_property_scale_amount_max>` | ``1.0`` |
  135. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  136. | :ref:`float<class_float>` | :ref:`scale_amount_min<class_CPUParticles2D_property_scale_amount_min>` | ``1.0`` |
  137. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  138. | :ref:`Curve<class_Curve>` | :ref:`scale_curve_x<class_CPUParticles2D_property_scale_curve_x>` | |
  139. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  140. | :ref:`Curve<class_Curve>` | :ref:`scale_curve_y<class_CPUParticles2D_property_scale_curve_y>` | |
  141. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  142. | :ref:`float<class_float>` | :ref:`speed_scale<class_CPUParticles2D_property_speed_scale>` | ``1.0`` |
  143. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  144. | :ref:`bool<class_bool>` | :ref:`split_scale<class_CPUParticles2D_property_split_scale>` | ``false`` |
  145. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  146. | :ref:`float<class_float>` | :ref:`spread<class_CPUParticles2D_property_spread>` | ``45.0`` |
  147. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  148. | :ref:`Curve<class_Curve>` | :ref:`tangential_accel_curve<class_CPUParticles2D_property_tangential_accel_curve>` | |
  149. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  150. | :ref:`float<class_float>` | :ref:`tangential_accel_max<class_CPUParticles2D_property_tangential_accel_max>` | ``0.0`` |
  151. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  152. | :ref:`float<class_float>` | :ref:`tangential_accel_min<class_CPUParticles2D_property_tangential_accel_min>` | ``0.0`` |
  153. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  154. | :ref:`Texture2D<class_Texture2D>` | :ref:`texture<class_CPUParticles2D_property_texture>` | |
  155. +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  156. .. rst-class:: classref-reftable-group
  157. Methods
  158. -------
  159. .. table::
  160. :widths: auto
  161. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  162. | void | :ref:`convert_from_particles<class_CPUParticles2D_method_convert_from_particles>` **(** :ref:`Node<class_Node>` particles **)** |
  163. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  164. | :ref:`Curve<class_Curve>` | :ref:`get_param_curve<class_CPUParticles2D_method_get_param_curve>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const| |
  165. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  166. | :ref:`float<class_float>` | :ref:`get_param_max<class_CPUParticles2D_method_get_param_max>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const| |
  167. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  168. | :ref:`float<class_float>` | :ref:`get_param_min<class_CPUParticles2D_method_get_param_min>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const| |
  169. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  170. | :ref:`bool<class_bool>` | :ref:`get_particle_flag<class_CPUParticles2D_method_get_particle_flag>` **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const| |
  171. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  172. | void | :ref:`restart<class_CPUParticles2D_method_restart>` **(** **)** |
  173. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  174. | void | :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)** |
  175. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  176. | void | :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)** |
  177. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  178. | void | :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)** |
  179. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  180. | void | :ref:`set_particle_flag<class_CPUParticles2D_method_set_particle_flag>` **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)** |
  181. +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  182. .. rst-class:: classref-section-separator
  183. ----
  184. .. rst-class:: classref-descriptions-group
  185. Signals
  186. -------
  187. .. _class_CPUParticles2D_signal_finished:
  188. .. rst-class:: classref-signal
  189. **finished** **(** **)**
  190. Emitted when all active particles have finished processing. When :ref:`one_shot<class_CPUParticles2D_property_one_shot>` is disabled, particles will process continuously, so this is never emitted.
  191. .. rst-class:: classref-section-separator
  192. ----
  193. .. rst-class:: classref-descriptions-group
  194. Enumerations
  195. ------------
  196. .. _enum_CPUParticles2D_DrawOrder:
  197. .. rst-class:: classref-enumeration
  198. enum **DrawOrder**:
  199. .. _class_CPUParticles2D_constant_DRAW_ORDER_INDEX:
  200. .. rst-class:: classref-enumeration-constant
  201. :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **DRAW_ORDER_INDEX** = ``0``
  202. Particles are drawn in the order emitted.
  203. .. _class_CPUParticles2D_constant_DRAW_ORDER_LIFETIME:
  204. .. rst-class:: classref-enumeration-constant
  205. :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **DRAW_ORDER_LIFETIME** = ``1``
  206. Particles are drawn in order of remaining lifetime. In other words, the particle with the highest lifetime is drawn at the front.
  207. .. rst-class:: classref-item-separator
  208. ----
  209. .. _enum_CPUParticles2D_Parameter:
  210. .. rst-class:: classref-enumeration
  211. enum **Parameter**:
  212. .. _class_CPUParticles2D_constant_PARAM_INITIAL_LINEAR_VELOCITY:
  213. .. rst-class:: classref-enumeration-constant
  214. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_INITIAL_LINEAR_VELOCITY** = ``0``
  215. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set initial velocity properties.
  216. .. _class_CPUParticles2D_constant_PARAM_ANGULAR_VELOCITY:
  217. .. rst-class:: classref-enumeration-constant
  218. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANGULAR_VELOCITY** = ``1``
  219. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set angular velocity properties.
  220. .. _class_CPUParticles2D_constant_PARAM_ORBIT_VELOCITY:
  221. .. rst-class:: classref-enumeration-constant
  222. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ORBIT_VELOCITY** = ``2``
  223. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set orbital velocity properties.
  224. .. _class_CPUParticles2D_constant_PARAM_LINEAR_ACCEL:
  225. .. rst-class:: classref-enumeration-constant
  226. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_LINEAR_ACCEL** = ``3``
  227. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set linear acceleration properties.
  228. .. _class_CPUParticles2D_constant_PARAM_RADIAL_ACCEL:
  229. .. rst-class:: classref-enumeration-constant
  230. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_RADIAL_ACCEL** = ``4``
  231. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set radial acceleration properties.
  232. .. _class_CPUParticles2D_constant_PARAM_TANGENTIAL_ACCEL:
  233. .. rst-class:: classref-enumeration-constant
  234. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_TANGENTIAL_ACCEL** = ``5``
  235. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set tangential acceleration properties.
  236. .. _class_CPUParticles2D_constant_PARAM_DAMPING:
  237. .. rst-class:: classref-enumeration-constant
  238. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_DAMPING** = ``6``
  239. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set damping properties.
  240. .. _class_CPUParticles2D_constant_PARAM_ANGLE:
  241. .. rst-class:: classref-enumeration-constant
  242. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANGLE** = ``7``
  243. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set angle properties.
  244. .. _class_CPUParticles2D_constant_PARAM_SCALE:
  245. .. rst-class:: classref-enumeration-constant
  246. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_SCALE** = ``8``
  247. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set scale properties.
  248. .. _class_CPUParticles2D_constant_PARAM_HUE_VARIATION:
  249. .. rst-class:: classref-enumeration-constant
  250. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_HUE_VARIATION** = ``9``
  251. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set hue variation properties.
  252. .. _class_CPUParticles2D_constant_PARAM_ANIM_SPEED:
  253. .. rst-class:: classref-enumeration-constant
  254. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANIM_SPEED** = ``10``
  255. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set animation speed properties.
  256. .. _class_CPUParticles2D_constant_PARAM_ANIM_OFFSET:
  257. .. rst-class:: classref-enumeration-constant
  258. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANIM_OFFSET** = ``11``
  259. Use with :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>`, :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>`, and :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` to set animation offset properties.
  260. .. _class_CPUParticles2D_constant_PARAM_MAX:
  261. .. rst-class:: classref-enumeration-constant
  262. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_MAX** = ``12``
  263. Represents the size of the :ref:`Parameter<enum_CPUParticles2D_Parameter>` enum.
  264. .. rst-class:: classref-item-separator
  265. ----
  266. .. _enum_CPUParticles2D_ParticleFlags:
  267. .. rst-class:: classref-enumeration
  268. enum **ParticleFlags**:
  269. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY:
  270. .. rst-class:: classref-enumeration-constant
  271. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY** = ``0``
  272. Use with :ref:`set_particle_flag<class_CPUParticles2D_method_set_particle_flag>` to set :ref:`particle_flag_align_y<class_CPUParticles2D_property_particle_flag_align_y>`.
  273. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_ROTATE_Y:
  274. .. rst-class:: classref-enumeration-constant
  275. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_ROTATE_Y** = ``1``
  276. Present for consistency with 3D particle nodes, not used in 2D.
  277. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_DISABLE_Z:
  278. .. rst-class:: classref-enumeration-constant
  279. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_DISABLE_Z** = ``2``
  280. Present for consistency with 3D particle nodes, not used in 2D.
  281. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_MAX:
  282. .. rst-class:: classref-enumeration-constant
  283. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_MAX** = ``3``
  284. Represents the size of the :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` enum.
  285. .. rst-class:: classref-item-separator
  286. ----
  287. .. _enum_CPUParticles2D_EmissionShape:
  288. .. rst-class:: classref-enumeration
  289. enum **EmissionShape**:
  290. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_POINT:
  291. .. rst-class:: classref-enumeration-constant
  292. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_POINT** = ``0``
  293. All particles will be emitted from a single point.
  294. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_SPHERE:
  295. .. rst-class:: classref-enumeration-constant
  296. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_SPHERE** = ``1``
  297. Particles will be emitted in the volume of a sphere flattened to two dimensions.
  298. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_SPHERE_SURFACE:
  299. .. rst-class:: classref-enumeration-constant
  300. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_SPHERE_SURFACE** = ``2``
  301. Particles will be emitted on the surface of a sphere flattened to two dimensions.
  302. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_RECTANGLE:
  303. .. rst-class:: classref-enumeration-constant
  304. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_RECTANGLE** = ``3``
  305. Particles will be emitted in the area of a rectangle.
  306. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_POINTS:
  307. .. rst-class:: classref-enumeration-constant
  308. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_POINTS** = ``4``
  309. Particles will be emitted at a position chosen randomly among :ref:`emission_points<class_CPUParticles2D_property_emission_points>`. Particle color will be modulated by :ref:`emission_colors<class_CPUParticles2D_property_emission_colors>`.
  310. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS:
  311. .. rst-class:: classref-enumeration-constant
  312. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_DIRECTED_POINTS** = ``5``
  313. Particles will be emitted at a position chosen randomly among :ref:`emission_points<class_CPUParticles2D_property_emission_points>`. Particle velocity and rotation will be set based on :ref:`emission_normals<class_CPUParticles2D_property_emission_normals>`. Particle color will be modulated by :ref:`emission_colors<class_CPUParticles2D_property_emission_colors>`.
  314. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_MAX:
  315. .. rst-class:: classref-enumeration-constant
  316. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_MAX** = ``6``
  317. Represents the size of the :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` enum.
  318. .. rst-class:: classref-section-separator
  319. ----
  320. .. rst-class:: classref-descriptions-group
  321. Property Descriptions
  322. ---------------------
  323. .. _class_CPUParticles2D_property_amount:
  324. .. rst-class:: classref-property
  325. :ref:`int<class_int>` **amount** = ``8``
  326. .. rst-class:: classref-property-setget
  327. - void **set_amount** **(** :ref:`int<class_int>` value **)**
  328. - :ref:`int<class_int>` **get_amount** **(** **)**
  329. Number of particles emitted in one emission cycle.
  330. .. rst-class:: classref-item-separator
  331. ----
  332. .. _class_CPUParticles2D_property_angle_curve:
  333. .. rst-class:: classref-property
  334. :ref:`Curve<class_Curve>` **angle_curve**
  335. .. rst-class:: classref-property-setget
  336. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  337. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  338. Each particle's rotation will be animated along this :ref:`Curve<class_Curve>`.
  339. .. rst-class:: classref-item-separator
  340. ----
  341. .. _class_CPUParticles2D_property_angle_max:
  342. .. rst-class:: classref-property
  343. :ref:`float<class_float>` **angle_max** = ``0.0``
  344. .. rst-class:: classref-property-setget
  345. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  346. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  347. Maximum initial rotation applied to each particle, in degrees.
  348. .. rst-class:: classref-item-separator
  349. ----
  350. .. _class_CPUParticles2D_property_angle_min:
  351. .. rst-class:: classref-property
  352. :ref:`float<class_float>` **angle_min** = ``0.0``
  353. .. rst-class:: classref-property-setget
  354. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  355. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  356. Minimum equivalent of :ref:`angle_max<class_CPUParticles2D_property_angle_max>`.
  357. .. rst-class:: classref-item-separator
  358. ----
  359. .. _class_CPUParticles2D_property_angular_velocity_curve:
  360. .. rst-class:: classref-property
  361. :ref:`Curve<class_Curve>` **angular_velocity_curve**
  362. .. rst-class:: classref-property-setget
  363. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  364. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  365. Each particle's angular velocity will vary along this :ref:`Curve<class_Curve>`.
  366. .. rst-class:: classref-item-separator
  367. ----
  368. .. _class_CPUParticles2D_property_angular_velocity_max:
  369. .. rst-class:: classref-property
  370. :ref:`float<class_float>` **angular_velocity_max** = ``0.0``
  371. .. rst-class:: classref-property-setget
  372. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  373. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  374. Maximum initial angular velocity (rotation speed) applied to each particle in *degrees* per second.
  375. .. rst-class:: classref-item-separator
  376. ----
  377. .. _class_CPUParticles2D_property_angular_velocity_min:
  378. .. rst-class:: classref-property
  379. :ref:`float<class_float>` **angular_velocity_min** = ``0.0``
  380. .. rst-class:: classref-property-setget
  381. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  382. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  383. Minimum equivalent of :ref:`angular_velocity_max<class_CPUParticles2D_property_angular_velocity_max>`.
  384. .. rst-class:: classref-item-separator
  385. ----
  386. .. _class_CPUParticles2D_property_anim_offset_curve:
  387. .. rst-class:: classref-property
  388. :ref:`Curve<class_Curve>` **anim_offset_curve**
  389. .. rst-class:: classref-property-setget
  390. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  391. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  392. Each particle's animation offset will vary along this :ref:`Curve<class_Curve>`.
  393. .. rst-class:: classref-item-separator
  394. ----
  395. .. _class_CPUParticles2D_property_anim_offset_max:
  396. .. rst-class:: classref-property
  397. :ref:`float<class_float>` **anim_offset_max** = ``0.0``
  398. .. rst-class:: classref-property-setget
  399. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  400. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  401. Maximum animation offset that corresponds to frame index in the texture. ``0`` is the first frame, ``1`` is the last one. See :ref:`CanvasItemMaterial.particles_animation<class_CanvasItemMaterial_property_particles_animation>`.
  402. .. rst-class:: classref-item-separator
  403. ----
  404. .. _class_CPUParticles2D_property_anim_offset_min:
  405. .. rst-class:: classref-property
  406. :ref:`float<class_float>` **anim_offset_min** = ``0.0``
  407. .. rst-class:: classref-property-setget
  408. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  409. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  410. Minimum equivalent of :ref:`anim_offset_max<class_CPUParticles2D_property_anim_offset_max>`.
  411. .. rst-class:: classref-item-separator
  412. ----
  413. .. _class_CPUParticles2D_property_anim_speed_curve:
  414. .. rst-class:: classref-property
  415. :ref:`Curve<class_Curve>` **anim_speed_curve**
  416. .. rst-class:: classref-property-setget
  417. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  418. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  419. Each particle's animation speed will vary along this :ref:`Curve<class_Curve>`.
  420. .. rst-class:: classref-item-separator
  421. ----
  422. .. _class_CPUParticles2D_property_anim_speed_max:
  423. .. rst-class:: classref-property
  424. :ref:`float<class_float>` **anim_speed_max** = ``0.0``
  425. .. rst-class:: classref-property-setget
  426. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  427. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  428. Maximum particle animation speed. Animation speed of ``1`` means that the particles will make full ``0`` to ``1`` offset cycle during lifetime, ``2`` means ``2`` cycles etc.
  429. With animation speed greater than ``1``, remember to enable :ref:`CanvasItemMaterial.particles_anim_loop<class_CanvasItemMaterial_property_particles_anim_loop>` property if you want the animation to repeat.
  430. .. rst-class:: classref-item-separator
  431. ----
  432. .. _class_CPUParticles2D_property_anim_speed_min:
  433. .. rst-class:: classref-property
  434. :ref:`float<class_float>` **anim_speed_min** = ``0.0``
  435. .. rst-class:: classref-property-setget
  436. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  437. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  438. Minimum equivalent of :ref:`anim_speed_max<class_CPUParticles2D_property_anim_speed_max>`.
  439. .. rst-class:: classref-item-separator
  440. ----
  441. .. _class_CPUParticles2D_property_color:
  442. .. rst-class:: classref-property
  443. :ref:`Color<class_Color>` **color** = ``Color(1, 1, 1, 1)``
  444. .. rst-class:: classref-property-setget
  445. - void **set_color** **(** :ref:`Color<class_Color>` value **)**
  446. - :ref:`Color<class_Color>` **get_color** **(** **)**
  447. Each particle's initial color. If :ref:`texture<class_CPUParticles2D_property_texture>` is defined, it will be multiplied by this color.
  448. .. rst-class:: classref-item-separator
  449. ----
  450. .. _class_CPUParticles2D_property_color_initial_ramp:
  451. .. rst-class:: classref-property
  452. :ref:`Gradient<class_Gradient>` **color_initial_ramp**
  453. .. rst-class:: classref-property-setget
  454. - void **set_color_initial_ramp** **(** :ref:`Gradient<class_Gradient>` value **)**
  455. - :ref:`Gradient<class_Gradient>` **get_color_initial_ramp** **(** **)**
  456. Each particle's initial color will vary along this :ref:`GradientTexture1D<class_GradientTexture1D>` (multiplied with :ref:`color<class_CPUParticles2D_property_color>`).
  457. .. rst-class:: classref-item-separator
  458. ----
  459. .. _class_CPUParticles2D_property_color_ramp:
  460. .. rst-class:: classref-property
  461. :ref:`Gradient<class_Gradient>` **color_ramp**
  462. .. rst-class:: classref-property-setget
  463. - void **set_color_ramp** **(** :ref:`Gradient<class_Gradient>` value **)**
  464. - :ref:`Gradient<class_Gradient>` **get_color_ramp** **(** **)**
  465. Each particle's color will vary along this :ref:`Gradient<class_Gradient>` (multiplied with :ref:`color<class_CPUParticles2D_property_color>`).
  466. .. rst-class:: classref-item-separator
  467. ----
  468. .. _class_CPUParticles2D_property_damping_curve:
  469. .. rst-class:: classref-property
  470. :ref:`Curve<class_Curve>` **damping_curve**
  471. .. rst-class:: classref-property-setget
  472. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  473. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  474. Damping will vary along this :ref:`Curve<class_Curve>`.
  475. .. rst-class:: classref-item-separator
  476. ----
  477. .. _class_CPUParticles2D_property_damping_max:
  478. .. rst-class:: classref-property
  479. :ref:`float<class_float>` **damping_max** = ``0.0``
  480. .. rst-class:: classref-property-setget
  481. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  482. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  483. The maximum rate at which particles lose velocity. For example value of ``100`` means that the particle will go from ``100`` velocity to ``0`` in ``1`` second.
  484. .. rst-class:: classref-item-separator
  485. ----
  486. .. _class_CPUParticles2D_property_damping_min:
  487. .. rst-class:: classref-property
  488. :ref:`float<class_float>` **damping_min** = ``0.0``
  489. .. rst-class:: classref-property-setget
  490. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  491. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  492. Minimum equivalent of :ref:`damping_max<class_CPUParticles2D_property_damping_max>`.
  493. .. rst-class:: classref-item-separator
  494. ----
  495. .. _class_CPUParticles2D_property_direction:
  496. .. rst-class:: classref-property
  497. :ref:`Vector2<class_Vector2>` **direction** = ``Vector2(1, 0)``
  498. .. rst-class:: classref-property-setget
  499. - void **set_direction** **(** :ref:`Vector2<class_Vector2>` value **)**
  500. - :ref:`Vector2<class_Vector2>` **get_direction** **(** **)**
  501. Unit vector specifying the particles' emission direction.
  502. .. rst-class:: classref-item-separator
  503. ----
  504. .. _class_CPUParticles2D_property_draw_order:
  505. .. rst-class:: classref-property
  506. :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **draw_order** = ``0``
  507. .. rst-class:: classref-property-setget
  508. - void **set_draw_order** **(** :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` value **)**
  509. - :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **get_draw_order** **(** **)**
  510. Particle draw order. Uses :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` values.
  511. .. rst-class:: classref-item-separator
  512. ----
  513. .. _class_CPUParticles2D_property_emission_colors:
  514. .. rst-class:: classref-property
  515. :ref:`PackedColorArray<class_PackedColorArray>` **emission_colors**
  516. .. rst-class:: classref-property-setget
  517. - void **set_emission_colors** **(** :ref:`PackedColorArray<class_PackedColorArray>` value **)**
  518. - :ref:`PackedColorArray<class_PackedColorArray>` **get_emission_colors** **(** **)**
  519. Sets the :ref:`Color<class_Color>`\ s to modulate particles by when using :ref:`EMISSION_SHAPE_POINTS<class_CPUParticles2D_constant_EMISSION_SHAPE_POINTS>` or :ref:`EMISSION_SHAPE_DIRECTED_POINTS<class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS>`.
  520. .. rst-class:: classref-item-separator
  521. ----
  522. .. _class_CPUParticles2D_property_emission_normals:
  523. .. rst-class:: classref-property
  524. :ref:`PackedVector2Array<class_PackedVector2Array>` **emission_normals**
  525. .. rst-class:: classref-property-setget
  526. - void **set_emission_normals** **(** :ref:`PackedVector2Array<class_PackedVector2Array>` value **)**
  527. - :ref:`PackedVector2Array<class_PackedVector2Array>` **get_emission_normals** **(** **)**
  528. Sets the direction the particles will be emitted in when using :ref:`EMISSION_SHAPE_DIRECTED_POINTS<class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS>`.
  529. .. rst-class:: classref-item-separator
  530. ----
  531. .. _class_CPUParticles2D_property_emission_points:
  532. .. rst-class:: classref-property
  533. :ref:`PackedVector2Array<class_PackedVector2Array>` **emission_points**
  534. .. rst-class:: classref-property-setget
  535. - void **set_emission_points** **(** :ref:`PackedVector2Array<class_PackedVector2Array>` value **)**
  536. - :ref:`PackedVector2Array<class_PackedVector2Array>` **get_emission_points** **(** **)**
  537. Sets the initial positions to spawn particles when using :ref:`EMISSION_SHAPE_POINTS<class_CPUParticles2D_constant_EMISSION_SHAPE_POINTS>` or :ref:`EMISSION_SHAPE_DIRECTED_POINTS<class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS>`.
  538. .. rst-class:: classref-item-separator
  539. ----
  540. .. _class_CPUParticles2D_property_emission_rect_extents:
  541. .. rst-class:: classref-property
  542. :ref:`Vector2<class_Vector2>` **emission_rect_extents**
  543. .. rst-class:: classref-property-setget
  544. - void **set_emission_rect_extents** **(** :ref:`Vector2<class_Vector2>` value **)**
  545. - :ref:`Vector2<class_Vector2>` **get_emission_rect_extents** **(** **)**
  546. The rectangle's extents if :ref:`emission_shape<class_CPUParticles2D_property_emission_shape>` is set to :ref:`EMISSION_SHAPE_RECTANGLE<class_CPUParticles2D_constant_EMISSION_SHAPE_RECTANGLE>`.
  547. .. rst-class:: classref-item-separator
  548. ----
  549. .. _class_CPUParticles2D_property_emission_shape:
  550. .. rst-class:: classref-property
  551. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **emission_shape** = ``0``
  552. .. rst-class:: classref-property-setget
  553. - void **set_emission_shape** **(** :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` value **)**
  554. - :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **get_emission_shape** **(** **)**
  555. Particles will be emitted inside this region. See :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` for possible values.
  556. .. rst-class:: classref-item-separator
  557. ----
  558. .. _class_CPUParticles2D_property_emission_sphere_radius:
  559. .. rst-class:: classref-property
  560. :ref:`float<class_float>` **emission_sphere_radius**
  561. .. rst-class:: classref-property-setget
  562. - void **set_emission_sphere_radius** **(** :ref:`float<class_float>` value **)**
  563. - :ref:`float<class_float>` **get_emission_sphere_radius** **(** **)**
  564. The sphere's radius if :ref:`emission_shape<class_CPUParticles2D_property_emission_shape>` is set to :ref:`EMISSION_SHAPE_SPHERE<class_CPUParticles2D_constant_EMISSION_SHAPE_SPHERE>`.
  565. .. rst-class:: classref-item-separator
  566. ----
  567. .. _class_CPUParticles2D_property_emitting:
  568. .. rst-class:: classref-property
  569. :ref:`bool<class_bool>` **emitting** = ``true``
  570. .. rst-class:: classref-property-setget
  571. - void **set_emitting** **(** :ref:`bool<class_bool>` value **)**
  572. - :ref:`bool<class_bool>` **is_emitting** **(** **)**
  573. If ``true``, particles are being emitted. :ref:`emitting<class_CPUParticles2D_property_emitting>` can be used to start and stop particles from emitting. However, if :ref:`one_shot<class_CPUParticles2D_property_one_shot>` is ``true`` setting :ref:`emitting<class_CPUParticles2D_property_emitting>` to ``true`` will not restart the emission cycle until after all active particles finish processing. You can use the :ref:`finished<class_CPUParticles2D_signal_finished>` signal to be notified once all active particles finish processing.
  574. .. rst-class:: classref-item-separator
  575. ----
  576. .. _class_CPUParticles2D_property_explosiveness:
  577. .. rst-class:: classref-property
  578. :ref:`float<class_float>` **explosiveness** = ``0.0``
  579. .. rst-class:: classref-property-setget
  580. - void **set_explosiveness_ratio** **(** :ref:`float<class_float>` value **)**
  581. - :ref:`float<class_float>` **get_explosiveness_ratio** **(** **)**
  582. How rapidly particles in an emission cycle are emitted. If greater than ``0``, there will be a gap in emissions before the next cycle begins.
  583. .. rst-class:: classref-item-separator
  584. ----
  585. .. _class_CPUParticles2D_property_fixed_fps:
  586. .. rst-class:: classref-property
  587. :ref:`int<class_int>` **fixed_fps** = ``0``
  588. .. rst-class:: classref-property-setget
  589. - void **set_fixed_fps** **(** :ref:`int<class_int>` value **)**
  590. - :ref:`int<class_int>` **get_fixed_fps** **(** **)**
  591. The particle system's frame rate is fixed to a value. For example, changing the value to 2 will make the particles render at 2 frames per second. Note this does not slow down the simulation of the particle system itself.
  592. .. rst-class:: classref-item-separator
  593. ----
  594. .. _class_CPUParticles2D_property_fract_delta:
  595. .. rst-class:: classref-property
  596. :ref:`bool<class_bool>` **fract_delta** = ``true``
  597. .. rst-class:: classref-property-setget
  598. - void **set_fractional_delta** **(** :ref:`bool<class_bool>` value **)**
  599. - :ref:`bool<class_bool>` **get_fractional_delta** **(** **)**
  600. If ``true``, results in fractional delta calculation which has a smoother particles display effect.
  601. .. rst-class:: classref-item-separator
  602. ----
  603. .. _class_CPUParticles2D_property_gravity:
  604. .. rst-class:: classref-property
  605. :ref:`Vector2<class_Vector2>` **gravity** = ``Vector2(0, 980)``
  606. .. rst-class:: classref-property-setget
  607. - void **set_gravity** **(** :ref:`Vector2<class_Vector2>` value **)**
  608. - :ref:`Vector2<class_Vector2>` **get_gravity** **(** **)**
  609. Gravity applied to every particle.
  610. .. rst-class:: classref-item-separator
  611. ----
  612. .. _class_CPUParticles2D_property_hue_variation_curve:
  613. .. rst-class:: classref-property
  614. :ref:`Curve<class_Curve>` **hue_variation_curve**
  615. .. rst-class:: classref-property-setget
  616. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  617. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  618. Each particle's hue will vary along this :ref:`Curve<class_Curve>`.
  619. .. rst-class:: classref-item-separator
  620. ----
  621. .. _class_CPUParticles2D_property_hue_variation_max:
  622. .. rst-class:: classref-property
  623. :ref:`float<class_float>` **hue_variation_max** = ``0.0``
  624. .. rst-class:: classref-property-setget
  625. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  626. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  627. Maximum initial hue variation applied to each particle. It will shift the particle color's hue.
  628. .. rst-class:: classref-item-separator
  629. ----
  630. .. _class_CPUParticles2D_property_hue_variation_min:
  631. .. rst-class:: classref-property
  632. :ref:`float<class_float>` **hue_variation_min** = ``0.0``
  633. .. rst-class:: classref-property-setget
  634. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  635. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  636. Minimum equivalent of :ref:`hue_variation_max<class_CPUParticles2D_property_hue_variation_max>`.
  637. .. rst-class:: classref-item-separator
  638. ----
  639. .. _class_CPUParticles2D_property_initial_velocity_max:
  640. .. rst-class:: classref-property
  641. :ref:`float<class_float>` **initial_velocity_max** = ``0.0``
  642. .. rst-class:: classref-property-setget
  643. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  644. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  645. Maximum initial velocity magnitude for each particle. Direction comes from :ref:`direction<class_CPUParticles2D_property_direction>` and :ref:`spread<class_CPUParticles2D_property_spread>`.
  646. .. rst-class:: classref-item-separator
  647. ----
  648. .. _class_CPUParticles2D_property_initial_velocity_min:
  649. .. rst-class:: classref-property
  650. :ref:`float<class_float>` **initial_velocity_min** = ``0.0``
  651. .. rst-class:: classref-property-setget
  652. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  653. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  654. Minimum equivalent of :ref:`initial_velocity_max<class_CPUParticles2D_property_initial_velocity_max>`.
  655. .. rst-class:: classref-item-separator
  656. ----
  657. .. _class_CPUParticles2D_property_lifetime:
  658. .. rst-class:: classref-property
  659. :ref:`float<class_float>` **lifetime** = ``1.0``
  660. .. rst-class:: classref-property-setget
  661. - void **set_lifetime** **(** :ref:`float<class_float>` value **)**
  662. - :ref:`float<class_float>` **get_lifetime** **(** **)**
  663. Amount of time each particle will exist.
  664. .. rst-class:: classref-item-separator
  665. ----
  666. .. _class_CPUParticles2D_property_lifetime_randomness:
  667. .. rst-class:: classref-property
  668. :ref:`float<class_float>` **lifetime_randomness** = ``0.0``
  669. .. rst-class:: classref-property-setget
  670. - void **set_lifetime_randomness** **(** :ref:`float<class_float>` value **)**
  671. - :ref:`float<class_float>` **get_lifetime_randomness** **(** **)**
  672. Particle lifetime randomness ratio.
  673. .. rst-class:: classref-item-separator
  674. ----
  675. .. _class_CPUParticles2D_property_linear_accel_curve:
  676. .. rst-class:: classref-property
  677. :ref:`Curve<class_Curve>` **linear_accel_curve**
  678. .. rst-class:: classref-property-setget
  679. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  680. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  681. Each particle's linear acceleration will vary along this :ref:`Curve<class_Curve>`.
  682. .. rst-class:: classref-item-separator
  683. ----
  684. .. _class_CPUParticles2D_property_linear_accel_max:
  685. .. rst-class:: classref-property
  686. :ref:`float<class_float>` **linear_accel_max** = ``0.0``
  687. .. rst-class:: classref-property-setget
  688. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  689. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  690. Maximum linear acceleration applied to each particle in the direction of motion.
  691. .. rst-class:: classref-item-separator
  692. ----
  693. .. _class_CPUParticles2D_property_linear_accel_min:
  694. .. rst-class:: classref-property
  695. :ref:`float<class_float>` **linear_accel_min** = ``0.0``
  696. .. rst-class:: classref-property-setget
  697. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  698. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  699. Minimum equivalent of :ref:`linear_accel_max<class_CPUParticles2D_property_linear_accel_max>`.
  700. .. rst-class:: classref-item-separator
  701. ----
  702. .. _class_CPUParticles2D_property_local_coords:
  703. .. rst-class:: classref-property
  704. :ref:`bool<class_bool>` **local_coords** = ``false``
  705. .. rst-class:: classref-property-setget
  706. - void **set_use_local_coordinates** **(** :ref:`bool<class_bool>` value **)**
  707. - :ref:`bool<class_bool>` **get_use_local_coordinates** **(** **)**
  708. If ``true``, particles use the parent node's coordinate space (known as local coordinates). This will cause particles to move and rotate along the **CPUParticles2D** node (and its parents) when it is moved or rotated. If ``false``, particles use global coordinates; they will not move or rotate along the **CPUParticles2D** node (and its parents) when it is moved or rotated.
  709. .. rst-class:: classref-item-separator
  710. ----
  711. .. _class_CPUParticles2D_property_one_shot:
  712. .. rst-class:: classref-property
  713. :ref:`bool<class_bool>` **one_shot** = ``false``
  714. .. rst-class:: classref-property-setget
  715. - void **set_one_shot** **(** :ref:`bool<class_bool>` value **)**
  716. - :ref:`bool<class_bool>` **get_one_shot** **(** **)**
  717. If ``true``, only one emission cycle occurs. If set ``true`` during a cycle, emission will stop at the cycle's end.
  718. .. rst-class:: classref-item-separator
  719. ----
  720. .. _class_CPUParticles2D_property_orbit_velocity_curve:
  721. .. rst-class:: classref-property
  722. :ref:`Curve<class_Curve>` **orbit_velocity_curve**
  723. .. rst-class:: classref-property-setget
  724. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  725. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  726. Each particle's orbital velocity will vary along this :ref:`Curve<class_Curve>`.
  727. .. rst-class:: classref-item-separator
  728. ----
  729. .. _class_CPUParticles2D_property_orbit_velocity_max:
  730. .. rst-class:: classref-property
  731. :ref:`float<class_float>` **orbit_velocity_max** = ``0.0``
  732. .. rst-class:: classref-property-setget
  733. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  734. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  735. Maximum orbital velocity applied to each particle. Makes the particles circle around origin. Specified in number of full rotations around origin per second.
  736. .. rst-class:: classref-item-separator
  737. ----
  738. .. _class_CPUParticles2D_property_orbit_velocity_min:
  739. .. rst-class:: classref-property
  740. :ref:`float<class_float>` **orbit_velocity_min** = ``0.0``
  741. .. rst-class:: classref-property-setget
  742. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  743. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  744. Minimum equivalent of :ref:`orbit_velocity_max<class_CPUParticles2D_property_orbit_velocity_max>`.
  745. .. rst-class:: classref-item-separator
  746. ----
  747. .. _class_CPUParticles2D_property_particle_flag_align_y:
  748. .. rst-class:: classref-property
  749. :ref:`bool<class_bool>` **particle_flag_align_y** = ``false``
  750. .. rst-class:: classref-property-setget
  751. - void **set_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)**
  752. - :ref:`bool<class_bool>` **get_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const|
  753. Align Y axis of particle with the direction of its velocity.
  754. .. rst-class:: classref-item-separator
  755. ----
  756. .. _class_CPUParticles2D_property_preprocess:
  757. .. rst-class:: classref-property
  758. :ref:`float<class_float>` **preprocess** = ``0.0``
  759. .. rst-class:: classref-property-setget
  760. - void **set_pre_process_time** **(** :ref:`float<class_float>` value **)**
  761. - :ref:`float<class_float>` **get_pre_process_time** **(** **)**
  762. Particle system starts as if it had already run for this many seconds.
  763. .. rst-class:: classref-item-separator
  764. ----
  765. .. _class_CPUParticles2D_property_radial_accel_curve:
  766. .. rst-class:: classref-property
  767. :ref:`Curve<class_Curve>` **radial_accel_curve**
  768. .. rst-class:: classref-property-setget
  769. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  770. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  771. Each particle's radial acceleration will vary along this :ref:`Curve<class_Curve>`.
  772. .. rst-class:: classref-item-separator
  773. ----
  774. .. _class_CPUParticles2D_property_radial_accel_max:
  775. .. rst-class:: classref-property
  776. :ref:`float<class_float>` **radial_accel_max** = ``0.0``
  777. .. rst-class:: classref-property-setget
  778. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  779. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  780. Maximum radial acceleration applied to each particle. Makes particle accelerate away from the origin or towards it if negative.
  781. .. rst-class:: classref-item-separator
  782. ----
  783. .. _class_CPUParticles2D_property_radial_accel_min:
  784. .. rst-class:: classref-property
  785. :ref:`float<class_float>` **radial_accel_min** = ``0.0``
  786. .. rst-class:: classref-property-setget
  787. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  788. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  789. Minimum equivalent of :ref:`radial_accel_max<class_CPUParticles2D_property_radial_accel_max>`.
  790. .. rst-class:: classref-item-separator
  791. ----
  792. .. _class_CPUParticles2D_property_randomness:
  793. .. rst-class:: classref-property
  794. :ref:`float<class_float>` **randomness** = ``0.0``
  795. .. rst-class:: classref-property-setget
  796. - void **set_randomness_ratio** **(** :ref:`float<class_float>` value **)**
  797. - :ref:`float<class_float>` **get_randomness_ratio** **(** **)**
  798. Emission lifetime randomness ratio.
  799. .. rst-class:: classref-item-separator
  800. ----
  801. .. _class_CPUParticles2D_property_scale_amount_curve:
  802. .. rst-class:: classref-property
  803. :ref:`Curve<class_Curve>` **scale_amount_curve**
  804. .. rst-class:: classref-property-setget
  805. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  806. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  807. Each particle's scale will vary along this :ref:`Curve<class_Curve>`.
  808. .. rst-class:: classref-item-separator
  809. ----
  810. .. _class_CPUParticles2D_property_scale_amount_max:
  811. .. rst-class:: classref-property
  812. :ref:`float<class_float>` **scale_amount_max** = ``1.0``
  813. .. rst-class:: classref-property-setget
  814. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  815. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  816. Maximum initial scale applied to each particle.
  817. .. rst-class:: classref-item-separator
  818. ----
  819. .. _class_CPUParticles2D_property_scale_amount_min:
  820. .. rst-class:: classref-property
  821. :ref:`float<class_float>` **scale_amount_min** = ``1.0``
  822. .. rst-class:: classref-property-setget
  823. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  824. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  825. Minimum equivalent of :ref:`scale_amount_max<class_CPUParticles2D_property_scale_amount_max>`.
  826. .. rst-class:: classref-item-separator
  827. ----
  828. .. _class_CPUParticles2D_property_scale_curve_x:
  829. .. rst-class:: classref-property
  830. :ref:`Curve<class_Curve>` **scale_curve_x**
  831. .. rst-class:: classref-property-setget
  832. - void **set_scale_curve_x** **(** :ref:`Curve<class_Curve>` value **)**
  833. - :ref:`Curve<class_Curve>` **get_scale_curve_x** **(** **)**
  834. Each particle's horizontal scale will vary along this :ref:`Curve<class_Curve>`.
  835. \ :ref:`split_scale<class_CPUParticles2D_property_split_scale>` must be enabled.
  836. .. rst-class:: classref-item-separator
  837. ----
  838. .. _class_CPUParticles2D_property_scale_curve_y:
  839. .. rst-class:: classref-property
  840. :ref:`Curve<class_Curve>` **scale_curve_y**
  841. .. rst-class:: classref-property-setget
  842. - void **set_scale_curve_y** **(** :ref:`Curve<class_Curve>` value **)**
  843. - :ref:`Curve<class_Curve>` **get_scale_curve_y** **(** **)**
  844. Each particle's vertical scale will vary along this :ref:`Curve<class_Curve>`.
  845. \ :ref:`split_scale<class_CPUParticles2D_property_split_scale>` must be enabled.
  846. .. rst-class:: classref-item-separator
  847. ----
  848. .. _class_CPUParticles2D_property_speed_scale:
  849. .. rst-class:: classref-property
  850. :ref:`float<class_float>` **speed_scale** = ``1.0``
  851. .. rst-class:: classref-property-setget
  852. - void **set_speed_scale** **(** :ref:`float<class_float>` value **)**
  853. - :ref:`float<class_float>` **get_speed_scale** **(** **)**
  854. Particle system's running speed scaling ratio. A value of ``0`` can be used to pause the particles.
  855. .. rst-class:: classref-item-separator
  856. ----
  857. .. _class_CPUParticles2D_property_split_scale:
  858. .. rst-class:: classref-property
  859. :ref:`bool<class_bool>` **split_scale** = ``false``
  860. .. rst-class:: classref-property-setget
  861. - void **set_split_scale** **(** :ref:`bool<class_bool>` value **)**
  862. - :ref:`bool<class_bool>` **get_split_scale** **(** **)**
  863. If ``true``, the scale curve will be split into x and y components. See :ref:`scale_curve_x<class_CPUParticles2D_property_scale_curve_x>` and :ref:`scale_curve_y<class_CPUParticles2D_property_scale_curve_y>`.
  864. .. rst-class:: classref-item-separator
  865. ----
  866. .. _class_CPUParticles2D_property_spread:
  867. .. rst-class:: classref-property
  868. :ref:`float<class_float>` **spread** = ``45.0``
  869. .. rst-class:: classref-property-setget
  870. - void **set_spread** **(** :ref:`float<class_float>` value **)**
  871. - :ref:`float<class_float>` **get_spread** **(** **)**
  872. Each particle's initial direction range from ``+spread`` to ``-spread`` degrees.
  873. .. rst-class:: classref-item-separator
  874. ----
  875. .. _class_CPUParticles2D_property_tangential_accel_curve:
  876. .. rst-class:: classref-property
  877. :ref:`Curve<class_Curve>` **tangential_accel_curve**
  878. .. rst-class:: classref-property-setget
  879. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  880. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  881. Each particle's tangential acceleration will vary along this :ref:`Curve<class_Curve>`.
  882. .. rst-class:: classref-item-separator
  883. ----
  884. .. _class_CPUParticles2D_property_tangential_accel_max:
  885. .. rst-class:: classref-property
  886. :ref:`float<class_float>` **tangential_accel_max** = ``0.0``
  887. .. rst-class:: classref-property-setget
  888. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  889. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  890. Maximum tangential acceleration applied to each particle. Tangential acceleration is perpendicular to the particle's velocity giving the particles a swirling motion.
  891. .. rst-class:: classref-item-separator
  892. ----
  893. .. _class_CPUParticles2D_property_tangential_accel_min:
  894. .. rst-class:: classref-property
  895. :ref:`float<class_float>` **tangential_accel_min** = ``0.0``
  896. .. rst-class:: classref-property-setget
  897. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  898. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  899. Minimum equivalent of :ref:`tangential_accel_max<class_CPUParticles2D_property_tangential_accel_max>`.
  900. .. rst-class:: classref-item-separator
  901. ----
  902. .. _class_CPUParticles2D_property_texture:
  903. .. rst-class:: classref-property
  904. :ref:`Texture2D<class_Texture2D>` **texture**
  905. .. rst-class:: classref-property-setget
  906. - void **set_texture** **(** :ref:`Texture2D<class_Texture2D>` value **)**
  907. - :ref:`Texture2D<class_Texture2D>` **get_texture** **(** **)**
  908. Particle texture. If ``null``, particles will be squares.
  909. .. rst-class:: classref-section-separator
  910. ----
  911. .. rst-class:: classref-descriptions-group
  912. Method Descriptions
  913. -------------------
  914. .. _class_CPUParticles2D_method_convert_from_particles:
  915. .. rst-class:: classref-method
  916. void **convert_from_particles** **(** :ref:`Node<class_Node>` particles **)**
  917. Sets this node's properties to match a given :ref:`GPUParticles2D<class_GPUParticles2D>` node with an assigned :ref:`ParticleProcessMaterial<class_ParticleProcessMaterial>`.
  918. .. rst-class:: classref-item-separator
  919. ----
  920. .. _class_CPUParticles2D_method_get_param_curve:
  921. .. rst-class:: classref-method
  922. :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  923. Returns the :ref:`Curve<class_Curve>` of the parameter specified by :ref:`Parameter<enum_CPUParticles2D_Parameter>`.
  924. .. rst-class:: classref-item-separator
  925. ----
  926. .. _class_CPUParticles2D_method_get_param_max:
  927. .. rst-class:: classref-method
  928. :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  929. Returns the maximum value range for the given parameter.
  930. .. rst-class:: classref-item-separator
  931. ----
  932. .. _class_CPUParticles2D_method_get_param_min:
  933. .. rst-class:: classref-method
  934. :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  935. Returns the minimum value range for the given parameter.
  936. .. rst-class:: classref-item-separator
  937. ----
  938. .. _class_CPUParticles2D_method_get_particle_flag:
  939. .. rst-class:: classref-method
  940. :ref:`bool<class_bool>` **get_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const|
  941. Returns the enabled state of the given flag (see :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` for options).
  942. .. rst-class:: classref-item-separator
  943. ----
  944. .. _class_CPUParticles2D_method_restart:
  945. .. rst-class:: classref-method
  946. void **restart** **(** **)**
  947. Restarts the particle emitter.
  948. .. rst-class:: classref-item-separator
  949. ----
  950. .. _class_CPUParticles2D_method_set_param_curve:
  951. .. rst-class:: classref-method
  952. void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  953. Sets the :ref:`Curve<class_Curve>` of the parameter specified by :ref:`Parameter<enum_CPUParticles2D_Parameter>`.
  954. .. rst-class:: classref-item-separator
  955. ----
  956. .. _class_CPUParticles2D_method_set_param_max:
  957. .. rst-class:: classref-method
  958. void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  959. Sets the maximum value for the given parameter.
  960. .. rst-class:: classref-item-separator
  961. ----
  962. .. _class_CPUParticles2D_method_set_param_min:
  963. .. rst-class:: classref-method
  964. void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  965. Sets the minimum value for the given parameter.
  966. .. rst-class:: classref-item-separator
  967. ----
  968. .. _class_CPUParticles2D_method_set_particle_flag:
  969. .. rst-class:: classref-method
  970. void **set_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)**
  971. Enables or disables the given flag (see :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` for options).
  972. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  973. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  974. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  975. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  976. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  977. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  978. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`