class_cpuparticles2d.rst 76 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703
  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.0/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/4.0/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. 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. Enumerations
  186. ------------
  187. .. _enum_CPUParticles2D_DrawOrder:
  188. .. rst-class:: classref-enumeration
  189. enum **DrawOrder**:
  190. .. _class_CPUParticles2D_constant_DRAW_ORDER_INDEX:
  191. .. rst-class:: classref-enumeration-constant
  192. :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **DRAW_ORDER_INDEX** = ``0``
  193. Particles are drawn in the order emitted.
  194. .. _class_CPUParticles2D_constant_DRAW_ORDER_LIFETIME:
  195. .. rst-class:: classref-enumeration-constant
  196. :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **DRAW_ORDER_LIFETIME** = ``1``
  197. Particles are drawn in order of remaining lifetime.
  198. .. rst-class:: classref-item-separator
  199. ----
  200. .. _enum_CPUParticles2D_Parameter:
  201. .. rst-class:: classref-enumeration
  202. enum **Parameter**:
  203. .. _class_CPUParticles2D_constant_PARAM_INITIAL_LINEAR_VELOCITY:
  204. .. rst-class:: classref-enumeration-constant
  205. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_INITIAL_LINEAR_VELOCITY** = ``0``
  206. 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.
  207. .. _class_CPUParticles2D_constant_PARAM_ANGULAR_VELOCITY:
  208. .. rst-class:: classref-enumeration-constant
  209. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANGULAR_VELOCITY** = ``1``
  210. 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.
  211. .. _class_CPUParticles2D_constant_PARAM_ORBIT_VELOCITY:
  212. .. rst-class:: classref-enumeration-constant
  213. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ORBIT_VELOCITY** = ``2``
  214. 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.
  215. .. _class_CPUParticles2D_constant_PARAM_LINEAR_ACCEL:
  216. .. rst-class:: classref-enumeration-constant
  217. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_LINEAR_ACCEL** = ``3``
  218. 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.
  219. .. _class_CPUParticles2D_constant_PARAM_RADIAL_ACCEL:
  220. .. rst-class:: classref-enumeration-constant
  221. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_RADIAL_ACCEL** = ``4``
  222. 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.
  223. .. _class_CPUParticles2D_constant_PARAM_TANGENTIAL_ACCEL:
  224. .. rst-class:: classref-enumeration-constant
  225. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_TANGENTIAL_ACCEL** = ``5``
  226. 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.
  227. .. _class_CPUParticles2D_constant_PARAM_DAMPING:
  228. .. rst-class:: classref-enumeration-constant
  229. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_DAMPING** = ``6``
  230. 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.
  231. .. _class_CPUParticles2D_constant_PARAM_ANGLE:
  232. .. rst-class:: classref-enumeration-constant
  233. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANGLE** = ``7``
  234. 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.
  235. .. _class_CPUParticles2D_constant_PARAM_SCALE:
  236. .. rst-class:: classref-enumeration-constant
  237. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_SCALE** = ``8``
  238. 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.
  239. .. _class_CPUParticles2D_constant_PARAM_HUE_VARIATION:
  240. .. rst-class:: classref-enumeration-constant
  241. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_HUE_VARIATION** = ``9``
  242. 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.
  243. .. _class_CPUParticles2D_constant_PARAM_ANIM_SPEED:
  244. .. rst-class:: classref-enumeration-constant
  245. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANIM_SPEED** = ``10``
  246. 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.
  247. .. _class_CPUParticles2D_constant_PARAM_ANIM_OFFSET:
  248. .. rst-class:: classref-enumeration-constant
  249. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANIM_OFFSET** = ``11``
  250. 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.
  251. .. _class_CPUParticles2D_constant_PARAM_MAX:
  252. .. rst-class:: classref-enumeration-constant
  253. :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_MAX** = ``12``
  254. Represents the size of the :ref:`Parameter<enum_CPUParticles2D_Parameter>` enum.
  255. .. rst-class:: classref-item-separator
  256. ----
  257. .. _enum_CPUParticles2D_ParticleFlags:
  258. .. rst-class:: classref-enumeration
  259. enum **ParticleFlags**:
  260. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY:
  261. .. rst-class:: classref-enumeration-constant
  262. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY** = ``0``
  263. 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>`.
  264. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_ROTATE_Y:
  265. .. rst-class:: classref-enumeration-constant
  266. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_ROTATE_Y** = ``1``
  267. Present for consistency with 3D particle nodes, not used in 2D.
  268. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_DISABLE_Z:
  269. .. rst-class:: classref-enumeration-constant
  270. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_DISABLE_Z** = ``2``
  271. Present for consistency with 3D particle nodes, not used in 2D.
  272. .. _class_CPUParticles2D_constant_PARTICLE_FLAG_MAX:
  273. .. rst-class:: classref-enumeration-constant
  274. :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_MAX** = ``3``
  275. Represents the size of the :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` enum.
  276. .. rst-class:: classref-item-separator
  277. ----
  278. .. _enum_CPUParticles2D_EmissionShape:
  279. .. rst-class:: classref-enumeration
  280. enum **EmissionShape**:
  281. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_POINT:
  282. .. rst-class:: classref-enumeration-constant
  283. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_POINT** = ``0``
  284. All particles will be emitted from a single point.
  285. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_SPHERE:
  286. .. rst-class:: classref-enumeration-constant
  287. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_SPHERE** = ``1``
  288. Particles will be emitted in the volume of a sphere flattened to two dimensions.
  289. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_SPHERE_SURFACE:
  290. .. rst-class:: classref-enumeration-constant
  291. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_SPHERE_SURFACE** = ``2``
  292. Particles will be emitted on the surface of a sphere flattened to two dimensions.
  293. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_RECTANGLE:
  294. .. rst-class:: classref-enumeration-constant
  295. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_RECTANGLE** = ``3``
  296. Particles will be emitted in the area of a rectangle.
  297. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_POINTS:
  298. .. rst-class:: classref-enumeration-constant
  299. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_POINTS** = ``4``
  300. 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>`.
  301. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS:
  302. .. rst-class:: classref-enumeration-constant
  303. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_DIRECTED_POINTS** = ``5``
  304. 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>`.
  305. .. _class_CPUParticles2D_constant_EMISSION_SHAPE_MAX:
  306. .. rst-class:: classref-enumeration-constant
  307. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_MAX** = ``6``
  308. Represents the size of the :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` enum.
  309. .. rst-class:: classref-section-separator
  310. ----
  311. .. rst-class:: classref-descriptions-group
  312. Property Descriptions
  313. ---------------------
  314. .. _class_CPUParticles2D_property_amount:
  315. .. rst-class:: classref-property
  316. :ref:`int<class_int>` **amount** = ``8``
  317. .. rst-class:: classref-property-setget
  318. - void **set_amount** **(** :ref:`int<class_int>` value **)**
  319. - :ref:`int<class_int>` **get_amount** **(** **)**
  320. Number of particles emitted in one emission cycle.
  321. .. rst-class:: classref-item-separator
  322. ----
  323. .. _class_CPUParticles2D_property_angle_curve:
  324. .. rst-class:: classref-property
  325. :ref:`Curve<class_Curve>` **angle_curve**
  326. .. rst-class:: classref-property-setget
  327. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  328. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  329. Each particle's rotation will be animated along this :ref:`Curve<class_Curve>`.
  330. .. rst-class:: classref-item-separator
  331. ----
  332. .. _class_CPUParticles2D_property_angle_max:
  333. .. rst-class:: classref-property
  334. :ref:`float<class_float>` **angle_max** = ``0.0``
  335. .. rst-class:: classref-property-setget
  336. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  337. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  338. Maximum initial rotation applied to each particle, in degrees.
  339. .. rst-class:: classref-item-separator
  340. ----
  341. .. _class_CPUParticles2D_property_angle_min:
  342. .. rst-class:: classref-property
  343. :ref:`float<class_float>` **angle_min** = ``0.0``
  344. .. rst-class:: classref-property-setget
  345. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  346. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  347. Minimum equivalent of :ref:`angle_max<class_CPUParticles2D_property_angle_max>`.
  348. .. rst-class:: classref-item-separator
  349. ----
  350. .. _class_CPUParticles2D_property_angular_velocity_curve:
  351. .. rst-class:: classref-property
  352. :ref:`Curve<class_Curve>` **angular_velocity_curve**
  353. .. rst-class:: classref-property-setget
  354. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  355. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  356. Each particle's angular velocity will vary along this :ref:`Curve<class_Curve>`.
  357. .. rst-class:: classref-item-separator
  358. ----
  359. .. _class_CPUParticles2D_property_angular_velocity_max:
  360. .. rst-class:: classref-property
  361. :ref:`float<class_float>` **angular_velocity_max** = ``0.0``
  362. .. rst-class:: classref-property-setget
  363. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  364. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  365. Maximum initial angular velocity (rotation speed) applied to each particle in *degrees* per second.
  366. .. rst-class:: classref-item-separator
  367. ----
  368. .. _class_CPUParticles2D_property_angular_velocity_min:
  369. .. rst-class:: classref-property
  370. :ref:`float<class_float>` **angular_velocity_min** = ``0.0``
  371. .. rst-class:: classref-property-setget
  372. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  373. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  374. Minimum equivalent of :ref:`angular_velocity_max<class_CPUParticles2D_property_angular_velocity_max>`.
  375. .. rst-class:: classref-item-separator
  376. ----
  377. .. _class_CPUParticles2D_property_anim_offset_curve:
  378. .. rst-class:: classref-property
  379. :ref:`Curve<class_Curve>` **anim_offset_curve**
  380. .. rst-class:: classref-property-setget
  381. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  382. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  383. Each particle's animation offset will vary along this :ref:`Curve<class_Curve>`.
  384. .. rst-class:: classref-item-separator
  385. ----
  386. .. _class_CPUParticles2D_property_anim_offset_max:
  387. .. rst-class:: classref-property
  388. :ref:`float<class_float>` **anim_offset_max** = ``0.0``
  389. .. rst-class:: classref-property-setget
  390. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  391. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  392. 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>`.
  393. .. rst-class:: classref-item-separator
  394. ----
  395. .. _class_CPUParticles2D_property_anim_offset_min:
  396. .. rst-class:: classref-property
  397. :ref:`float<class_float>` **anim_offset_min** = ``0.0``
  398. .. rst-class:: classref-property-setget
  399. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  400. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  401. Minimum equivalent of :ref:`anim_offset_max<class_CPUParticles2D_property_anim_offset_max>`.
  402. .. rst-class:: classref-item-separator
  403. ----
  404. .. _class_CPUParticles2D_property_anim_speed_curve:
  405. .. rst-class:: classref-property
  406. :ref:`Curve<class_Curve>` **anim_speed_curve**
  407. .. rst-class:: classref-property-setget
  408. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  409. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  410. Each particle's animation speed will vary along this :ref:`Curve<class_Curve>`.
  411. .. rst-class:: classref-item-separator
  412. ----
  413. .. _class_CPUParticles2D_property_anim_speed_max:
  414. .. rst-class:: classref-property
  415. :ref:`float<class_float>` **anim_speed_max** = ``0.0``
  416. .. rst-class:: classref-property-setget
  417. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  418. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  419. 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.
  420. 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.
  421. .. rst-class:: classref-item-separator
  422. ----
  423. .. _class_CPUParticles2D_property_anim_speed_min:
  424. .. rst-class:: classref-property
  425. :ref:`float<class_float>` **anim_speed_min** = ``0.0``
  426. .. rst-class:: classref-property-setget
  427. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  428. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  429. Minimum equivalent of :ref:`anim_speed_max<class_CPUParticles2D_property_anim_speed_max>`.
  430. .. rst-class:: classref-item-separator
  431. ----
  432. .. _class_CPUParticles2D_property_color:
  433. .. rst-class:: classref-property
  434. :ref:`Color<class_Color>` **color** = ``Color(1, 1, 1, 1)``
  435. .. rst-class:: classref-property-setget
  436. - void **set_color** **(** :ref:`Color<class_Color>` value **)**
  437. - :ref:`Color<class_Color>` **get_color** **(** **)**
  438. Each particle's initial color. If :ref:`texture<class_CPUParticles2D_property_texture>` is defined, it will be multiplied by this color.
  439. .. rst-class:: classref-item-separator
  440. ----
  441. .. _class_CPUParticles2D_property_color_initial_ramp:
  442. .. rst-class:: classref-property
  443. :ref:`Gradient<class_Gradient>` **color_initial_ramp**
  444. .. rst-class:: classref-property-setget
  445. - void **set_color_initial_ramp** **(** :ref:`Gradient<class_Gradient>` value **)**
  446. - :ref:`Gradient<class_Gradient>` **get_color_initial_ramp** **(** **)**
  447. Each particle's initial color will vary along this :ref:`GradientTexture1D<class_GradientTexture1D>` (multiplied with :ref:`color<class_CPUParticles2D_property_color>`).
  448. .. rst-class:: classref-item-separator
  449. ----
  450. .. _class_CPUParticles2D_property_color_ramp:
  451. .. rst-class:: classref-property
  452. :ref:`Gradient<class_Gradient>` **color_ramp**
  453. .. rst-class:: classref-property-setget
  454. - void **set_color_ramp** **(** :ref:`Gradient<class_Gradient>` value **)**
  455. - :ref:`Gradient<class_Gradient>` **get_color_ramp** **(** **)**
  456. Each particle's color will vary along this :ref:`Gradient<class_Gradient>` (multiplied with :ref:`color<class_CPUParticles2D_property_color>`).
  457. .. rst-class:: classref-item-separator
  458. ----
  459. .. _class_CPUParticles2D_property_damping_curve:
  460. .. rst-class:: classref-property
  461. :ref:`Curve<class_Curve>` **damping_curve**
  462. .. rst-class:: classref-property-setget
  463. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  464. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  465. Damping will vary along this :ref:`Curve<class_Curve>`.
  466. .. rst-class:: classref-item-separator
  467. ----
  468. .. _class_CPUParticles2D_property_damping_max:
  469. .. rst-class:: classref-property
  470. :ref:`float<class_float>` **damping_max** = ``0.0``
  471. .. rst-class:: classref-property-setget
  472. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  473. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  474. 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.
  475. .. rst-class:: classref-item-separator
  476. ----
  477. .. _class_CPUParticles2D_property_damping_min:
  478. .. rst-class:: classref-property
  479. :ref:`float<class_float>` **damping_min** = ``0.0``
  480. .. rst-class:: classref-property-setget
  481. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  482. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  483. Minimum equivalent of :ref:`damping_max<class_CPUParticles2D_property_damping_max>`.
  484. .. rst-class:: classref-item-separator
  485. ----
  486. .. _class_CPUParticles2D_property_direction:
  487. .. rst-class:: classref-property
  488. :ref:`Vector2<class_Vector2>` **direction** = ``Vector2(1, 0)``
  489. .. rst-class:: classref-property-setget
  490. - void **set_direction** **(** :ref:`Vector2<class_Vector2>` value **)**
  491. - :ref:`Vector2<class_Vector2>` **get_direction** **(** **)**
  492. Unit vector specifying the particles' emission direction.
  493. .. rst-class:: classref-item-separator
  494. ----
  495. .. _class_CPUParticles2D_property_draw_order:
  496. .. rst-class:: classref-property
  497. :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **draw_order** = ``0``
  498. .. rst-class:: classref-property-setget
  499. - void **set_draw_order** **(** :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` value **)**
  500. - :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **get_draw_order** **(** **)**
  501. Particle draw order. Uses :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` values.
  502. .. rst-class:: classref-item-separator
  503. ----
  504. .. _class_CPUParticles2D_property_emission_colors:
  505. .. rst-class:: classref-property
  506. :ref:`PackedColorArray<class_PackedColorArray>` **emission_colors**
  507. .. rst-class:: classref-property-setget
  508. - void **set_emission_colors** **(** :ref:`PackedColorArray<class_PackedColorArray>` value **)**
  509. - :ref:`PackedColorArray<class_PackedColorArray>` **get_emission_colors** **(** **)**
  510. 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>`.
  511. .. rst-class:: classref-item-separator
  512. ----
  513. .. _class_CPUParticles2D_property_emission_normals:
  514. .. rst-class:: classref-property
  515. :ref:`PackedVector2Array<class_PackedVector2Array>` **emission_normals**
  516. .. rst-class:: classref-property-setget
  517. - void **set_emission_normals** **(** :ref:`PackedVector2Array<class_PackedVector2Array>` value **)**
  518. - :ref:`PackedVector2Array<class_PackedVector2Array>` **get_emission_normals** **(** **)**
  519. Sets the direction the particles will be emitted in when using :ref:`EMISSION_SHAPE_DIRECTED_POINTS<class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS>`.
  520. .. rst-class:: classref-item-separator
  521. ----
  522. .. _class_CPUParticles2D_property_emission_points:
  523. .. rst-class:: classref-property
  524. :ref:`PackedVector2Array<class_PackedVector2Array>` **emission_points**
  525. .. rst-class:: classref-property-setget
  526. - void **set_emission_points** **(** :ref:`PackedVector2Array<class_PackedVector2Array>` value **)**
  527. - :ref:`PackedVector2Array<class_PackedVector2Array>` **get_emission_points** **(** **)**
  528. 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>`.
  529. .. rst-class:: classref-item-separator
  530. ----
  531. .. _class_CPUParticles2D_property_emission_rect_extents:
  532. .. rst-class:: classref-property
  533. :ref:`Vector2<class_Vector2>` **emission_rect_extents**
  534. .. rst-class:: classref-property-setget
  535. - void **set_emission_rect_extents** **(** :ref:`Vector2<class_Vector2>` value **)**
  536. - :ref:`Vector2<class_Vector2>` **get_emission_rect_extents** **(** **)**
  537. 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>`.
  538. .. rst-class:: classref-item-separator
  539. ----
  540. .. _class_CPUParticles2D_property_emission_shape:
  541. .. rst-class:: classref-property
  542. :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **emission_shape** = ``0``
  543. .. rst-class:: classref-property-setget
  544. - void **set_emission_shape** **(** :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` value **)**
  545. - :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **get_emission_shape** **(** **)**
  546. Particles will be emitted inside this region. See :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` for possible values.
  547. .. rst-class:: classref-item-separator
  548. ----
  549. .. _class_CPUParticles2D_property_emission_sphere_radius:
  550. .. rst-class:: classref-property
  551. :ref:`float<class_float>` **emission_sphere_radius**
  552. .. rst-class:: classref-property-setget
  553. - void **set_emission_sphere_radius** **(** :ref:`float<class_float>` value **)**
  554. - :ref:`float<class_float>` **get_emission_sphere_radius** **(** **)**
  555. 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>`.
  556. .. rst-class:: classref-item-separator
  557. ----
  558. .. _class_CPUParticles2D_property_emitting:
  559. .. rst-class:: classref-property
  560. :ref:`bool<class_bool>` **emitting** = ``true``
  561. .. rst-class:: classref-property-setget
  562. - void **set_emitting** **(** :ref:`bool<class_bool>` value **)**
  563. - :ref:`bool<class_bool>` **is_emitting** **(** **)**
  564. If ``true``, particles are being emitted.
  565. .. rst-class:: classref-item-separator
  566. ----
  567. .. _class_CPUParticles2D_property_explosiveness:
  568. .. rst-class:: classref-property
  569. :ref:`float<class_float>` **explosiveness** = ``0.0``
  570. .. rst-class:: classref-property-setget
  571. - void **set_explosiveness_ratio** **(** :ref:`float<class_float>` value **)**
  572. - :ref:`float<class_float>` **get_explosiveness_ratio** **(** **)**
  573. 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.
  574. .. rst-class:: classref-item-separator
  575. ----
  576. .. _class_CPUParticles2D_property_fixed_fps:
  577. .. rst-class:: classref-property
  578. :ref:`int<class_int>` **fixed_fps** = ``0``
  579. .. rst-class:: classref-property-setget
  580. - void **set_fixed_fps** **(** :ref:`int<class_int>` value **)**
  581. - :ref:`int<class_int>` **get_fixed_fps** **(** **)**
  582. 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.
  583. .. rst-class:: classref-item-separator
  584. ----
  585. .. _class_CPUParticles2D_property_fract_delta:
  586. .. rst-class:: classref-property
  587. :ref:`bool<class_bool>` **fract_delta** = ``true``
  588. .. rst-class:: classref-property-setget
  589. - void **set_fractional_delta** **(** :ref:`bool<class_bool>` value **)**
  590. - :ref:`bool<class_bool>` **get_fractional_delta** **(** **)**
  591. If ``true``, results in fractional delta calculation which has a smoother particles display effect.
  592. .. rst-class:: classref-item-separator
  593. ----
  594. .. _class_CPUParticles2D_property_gravity:
  595. .. rst-class:: classref-property
  596. :ref:`Vector2<class_Vector2>` **gravity** = ``Vector2(0, 980)``
  597. .. rst-class:: classref-property-setget
  598. - void **set_gravity** **(** :ref:`Vector2<class_Vector2>` value **)**
  599. - :ref:`Vector2<class_Vector2>` **get_gravity** **(** **)**
  600. Gravity applied to every particle.
  601. .. rst-class:: classref-item-separator
  602. ----
  603. .. _class_CPUParticles2D_property_hue_variation_curve:
  604. .. rst-class:: classref-property
  605. :ref:`Curve<class_Curve>` **hue_variation_curve**
  606. .. rst-class:: classref-property-setget
  607. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  608. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  609. Each particle's hue will vary along this :ref:`Curve<class_Curve>`.
  610. .. rst-class:: classref-item-separator
  611. ----
  612. .. _class_CPUParticles2D_property_hue_variation_max:
  613. .. rst-class:: classref-property
  614. :ref:`float<class_float>` **hue_variation_max** = ``0.0``
  615. .. rst-class:: classref-property-setget
  616. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  617. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  618. Maximum initial hue variation applied to each particle. It will shift the particle color's hue.
  619. .. rst-class:: classref-item-separator
  620. ----
  621. .. _class_CPUParticles2D_property_hue_variation_min:
  622. .. rst-class:: classref-property
  623. :ref:`float<class_float>` **hue_variation_min** = ``0.0``
  624. .. rst-class:: classref-property-setget
  625. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  626. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  627. Minimum equivalent of :ref:`hue_variation_max<class_CPUParticles2D_property_hue_variation_max>`.
  628. .. rst-class:: classref-item-separator
  629. ----
  630. .. _class_CPUParticles2D_property_initial_velocity_max:
  631. .. rst-class:: classref-property
  632. :ref:`float<class_float>` **initial_velocity_max** = ``0.0``
  633. .. rst-class:: classref-property-setget
  634. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  635. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  636. Maximum initial velocity magnitude for each particle. Direction comes from :ref:`direction<class_CPUParticles2D_property_direction>` and :ref:`spread<class_CPUParticles2D_property_spread>`.
  637. .. rst-class:: classref-item-separator
  638. ----
  639. .. _class_CPUParticles2D_property_initial_velocity_min:
  640. .. rst-class:: classref-property
  641. :ref:`float<class_float>` **initial_velocity_min** = ``0.0``
  642. .. rst-class:: classref-property-setget
  643. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  644. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  645. Minimum equivalent of :ref:`initial_velocity_max<class_CPUParticles2D_property_initial_velocity_max>`.
  646. .. rst-class:: classref-item-separator
  647. ----
  648. .. _class_CPUParticles2D_property_lifetime:
  649. .. rst-class:: classref-property
  650. :ref:`float<class_float>` **lifetime** = ``1.0``
  651. .. rst-class:: classref-property-setget
  652. - void **set_lifetime** **(** :ref:`float<class_float>` value **)**
  653. - :ref:`float<class_float>` **get_lifetime** **(** **)**
  654. Amount of time each particle will exist.
  655. .. rst-class:: classref-item-separator
  656. ----
  657. .. _class_CPUParticles2D_property_lifetime_randomness:
  658. .. rst-class:: classref-property
  659. :ref:`float<class_float>` **lifetime_randomness** = ``0.0``
  660. .. rst-class:: classref-property-setget
  661. - void **set_lifetime_randomness** **(** :ref:`float<class_float>` value **)**
  662. - :ref:`float<class_float>` **get_lifetime_randomness** **(** **)**
  663. Particle lifetime randomness ratio.
  664. .. rst-class:: classref-item-separator
  665. ----
  666. .. _class_CPUParticles2D_property_linear_accel_curve:
  667. .. rst-class:: classref-property
  668. :ref:`Curve<class_Curve>` **linear_accel_curve**
  669. .. rst-class:: classref-property-setget
  670. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  671. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  672. Each particle's linear acceleration will vary along this :ref:`Curve<class_Curve>`.
  673. .. rst-class:: classref-item-separator
  674. ----
  675. .. _class_CPUParticles2D_property_linear_accel_max:
  676. .. rst-class:: classref-property
  677. :ref:`float<class_float>` **linear_accel_max** = ``0.0``
  678. .. rst-class:: classref-property-setget
  679. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  680. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  681. Maximum linear acceleration applied to each particle in the direction of motion.
  682. .. rst-class:: classref-item-separator
  683. ----
  684. .. _class_CPUParticles2D_property_linear_accel_min:
  685. .. rst-class:: classref-property
  686. :ref:`float<class_float>` **linear_accel_min** = ``0.0``
  687. .. rst-class:: classref-property-setget
  688. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  689. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  690. Minimum equivalent of :ref:`linear_accel_max<class_CPUParticles2D_property_linear_accel_max>`.
  691. .. rst-class:: classref-item-separator
  692. ----
  693. .. _class_CPUParticles2D_property_local_coords:
  694. .. rst-class:: classref-property
  695. :ref:`bool<class_bool>` **local_coords** = ``false``
  696. .. rst-class:: classref-property-setget
  697. - void **set_use_local_coordinates** **(** :ref:`bool<class_bool>` value **)**
  698. - :ref:`bool<class_bool>` **get_use_local_coordinates** **(** **)**
  699. 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.
  700. .. rst-class:: classref-item-separator
  701. ----
  702. .. _class_CPUParticles2D_property_one_shot:
  703. .. rst-class:: classref-property
  704. :ref:`bool<class_bool>` **one_shot** = ``false``
  705. .. rst-class:: classref-property-setget
  706. - void **set_one_shot** **(** :ref:`bool<class_bool>` value **)**
  707. - :ref:`bool<class_bool>` **get_one_shot** **(** **)**
  708. If ``true``, only one emission cycle occurs. If set ``true`` during a cycle, emission will stop at the cycle's end.
  709. .. rst-class:: classref-item-separator
  710. ----
  711. .. _class_CPUParticles2D_property_orbit_velocity_curve:
  712. .. rst-class:: classref-property
  713. :ref:`Curve<class_Curve>` **orbit_velocity_curve**
  714. .. rst-class:: classref-property-setget
  715. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  716. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  717. Each particle's orbital velocity will vary along this :ref:`Curve<class_Curve>`.
  718. .. rst-class:: classref-item-separator
  719. ----
  720. .. _class_CPUParticles2D_property_orbit_velocity_max:
  721. .. rst-class:: classref-property
  722. :ref:`float<class_float>` **orbit_velocity_max** = ``0.0``
  723. .. rst-class:: classref-property-setget
  724. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  725. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  726. Maximum orbital velocity applied to each particle. Makes the particles circle around origin. Specified in number of full rotations around origin per second.
  727. .. rst-class:: classref-item-separator
  728. ----
  729. .. _class_CPUParticles2D_property_orbit_velocity_min:
  730. .. rst-class:: classref-property
  731. :ref:`float<class_float>` **orbit_velocity_min** = ``0.0``
  732. .. rst-class:: classref-property-setget
  733. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  734. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  735. Minimum equivalent of :ref:`orbit_velocity_max<class_CPUParticles2D_property_orbit_velocity_max>`.
  736. .. rst-class:: classref-item-separator
  737. ----
  738. .. _class_CPUParticles2D_property_particle_flag_align_y:
  739. .. rst-class:: classref-property
  740. :ref:`bool<class_bool>` **particle_flag_align_y** = ``false``
  741. .. rst-class:: classref-property-setget
  742. - void **set_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)**
  743. - :ref:`bool<class_bool>` **get_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const|
  744. Align Y axis of particle with the direction of its velocity.
  745. .. rst-class:: classref-item-separator
  746. ----
  747. .. _class_CPUParticles2D_property_preprocess:
  748. .. rst-class:: classref-property
  749. :ref:`float<class_float>` **preprocess** = ``0.0``
  750. .. rst-class:: classref-property-setget
  751. - void **set_pre_process_time** **(** :ref:`float<class_float>` value **)**
  752. - :ref:`float<class_float>` **get_pre_process_time** **(** **)**
  753. Particle system starts as if it had already run for this many seconds.
  754. .. rst-class:: classref-item-separator
  755. ----
  756. .. _class_CPUParticles2D_property_radial_accel_curve:
  757. .. rst-class:: classref-property
  758. :ref:`Curve<class_Curve>` **radial_accel_curve**
  759. .. rst-class:: classref-property-setget
  760. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  761. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  762. Each particle's radial acceleration will vary along this :ref:`Curve<class_Curve>`.
  763. .. rst-class:: classref-item-separator
  764. ----
  765. .. _class_CPUParticles2D_property_radial_accel_max:
  766. .. rst-class:: classref-property
  767. :ref:`float<class_float>` **radial_accel_max** = ``0.0``
  768. .. rst-class:: classref-property-setget
  769. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  770. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  771. Maximum radial acceleration applied to each particle. Makes particle accelerate away from the origin or towards it if negative.
  772. .. rst-class:: classref-item-separator
  773. ----
  774. .. _class_CPUParticles2D_property_radial_accel_min:
  775. .. rst-class:: classref-property
  776. :ref:`float<class_float>` **radial_accel_min** = ``0.0``
  777. .. rst-class:: classref-property-setget
  778. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  779. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  780. Minimum equivalent of :ref:`radial_accel_max<class_CPUParticles2D_property_radial_accel_max>`.
  781. .. rst-class:: classref-item-separator
  782. ----
  783. .. _class_CPUParticles2D_property_randomness:
  784. .. rst-class:: classref-property
  785. :ref:`float<class_float>` **randomness** = ``0.0``
  786. .. rst-class:: classref-property-setget
  787. - void **set_randomness_ratio** **(** :ref:`float<class_float>` value **)**
  788. - :ref:`float<class_float>` **get_randomness_ratio** **(** **)**
  789. Emission lifetime randomness ratio.
  790. .. rst-class:: classref-item-separator
  791. ----
  792. .. _class_CPUParticles2D_property_scale_amount_curve:
  793. .. rst-class:: classref-property
  794. :ref:`Curve<class_Curve>` **scale_amount_curve**
  795. .. rst-class:: classref-property-setget
  796. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  797. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  798. Each particle's scale will vary along this :ref:`Curve<class_Curve>`.
  799. .. rst-class:: classref-item-separator
  800. ----
  801. .. _class_CPUParticles2D_property_scale_amount_max:
  802. .. rst-class:: classref-property
  803. :ref:`float<class_float>` **scale_amount_max** = ``1.0``
  804. .. rst-class:: classref-property-setget
  805. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  806. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  807. Maximum initial scale applied to each particle.
  808. .. rst-class:: classref-item-separator
  809. ----
  810. .. _class_CPUParticles2D_property_scale_amount_min:
  811. .. rst-class:: classref-property
  812. :ref:`float<class_float>` **scale_amount_min** = ``1.0``
  813. .. rst-class:: classref-property-setget
  814. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  815. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  816. Minimum equivalent of :ref:`scale_amount_max<class_CPUParticles2D_property_scale_amount_max>`.
  817. .. rst-class:: classref-item-separator
  818. ----
  819. .. _class_CPUParticles2D_property_scale_curve_x:
  820. .. rst-class:: classref-property
  821. :ref:`Curve<class_Curve>` **scale_curve_x**
  822. .. rst-class:: classref-property-setget
  823. - void **set_scale_curve_x** **(** :ref:`Curve<class_Curve>` value **)**
  824. - :ref:`Curve<class_Curve>` **get_scale_curve_x** **(** **)**
  825. Each particle's horizontal scale will vary along this :ref:`Curve<class_Curve>`.
  826. \ :ref:`split_scale<class_CPUParticles2D_property_split_scale>` must be enabled.
  827. .. rst-class:: classref-item-separator
  828. ----
  829. .. _class_CPUParticles2D_property_scale_curve_y:
  830. .. rst-class:: classref-property
  831. :ref:`Curve<class_Curve>` **scale_curve_y**
  832. .. rst-class:: classref-property-setget
  833. - void **set_scale_curve_y** **(** :ref:`Curve<class_Curve>` value **)**
  834. - :ref:`Curve<class_Curve>` **get_scale_curve_y** **(** **)**
  835. Each particle's vertical scale will vary along this :ref:`Curve<class_Curve>`.
  836. \ :ref:`split_scale<class_CPUParticles2D_property_split_scale>` must be enabled.
  837. .. rst-class:: classref-item-separator
  838. ----
  839. .. _class_CPUParticles2D_property_speed_scale:
  840. .. rst-class:: classref-property
  841. :ref:`float<class_float>` **speed_scale** = ``1.0``
  842. .. rst-class:: classref-property-setget
  843. - void **set_speed_scale** **(** :ref:`float<class_float>` value **)**
  844. - :ref:`float<class_float>` **get_speed_scale** **(** **)**
  845. Particle system's running speed scaling ratio. A value of ``0`` can be used to pause the particles.
  846. .. rst-class:: classref-item-separator
  847. ----
  848. .. _class_CPUParticles2D_property_split_scale:
  849. .. rst-class:: classref-property
  850. :ref:`bool<class_bool>` **split_scale** = ``false``
  851. .. rst-class:: classref-property-setget
  852. - void **set_split_scale** **(** :ref:`bool<class_bool>` value **)**
  853. - :ref:`bool<class_bool>` **get_split_scale** **(** **)**
  854. 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>`.
  855. .. rst-class:: classref-item-separator
  856. ----
  857. .. _class_CPUParticles2D_property_spread:
  858. .. rst-class:: classref-property
  859. :ref:`float<class_float>` **spread** = ``45.0``
  860. .. rst-class:: classref-property-setget
  861. - void **set_spread** **(** :ref:`float<class_float>` value **)**
  862. - :ref:`float<class_float>` **get_spread** **(** **)**
  863. Each particle's initial direction range from ``+spread`` to ``-spread`` degrees.
  864. .. rst-class:: classref-item-separator
  865. ----
  866. .. _class_CPUParticles2D_property_tangential_accel_curve:
  867. .. rst-class:: classref-property
  868. :ref:`Curve<class_Curve>` **tangential_accel_curve**
  869. .. rst-class:: classref-property-setget
  870. - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  871. - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  872. Each particle's tangential acceleration will vary along this :ref:`Curve<class_Curve>`.
  873. .. rst-class:: classref-item-separator
  874. ----
  875. .. _class_CPUParticles2D_property_tangential_accel_max:
  876. .. rst-class:: classref-property
  877. :ref:`float<class_float>` **tangential_accel_max** = ``0.0``
  878. .. rst-class:: classref-property-setget
  879. - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  880. - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  881. Maximum tangential acceleration applied to each particle. Tangential acceleration is perpendicular to the particle's velocity giving the particles a swirling motion.
  882. .. rst-class:: classref-item-separator
  883. ----
  884. .. _class_CPUParticles2D_property_tangential_accel_min:
  885. .. rst-class:: classref-property
  886. :ref:`float<class_float>` **tangential_accel_min** = ``0.0``
  887. .. rst-class:: classref-property-setget
  888. - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  889. - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  890. Minimum equivalent of :ref:`tangential_accel_max<class_CPUParticles2D_property_tangential_accel_max>`.
  891. .. rst-class:: classref-item-separator
  892. ----
  893. .. _class_CPUParticles2D_property_texture:
  894. .. rst-class:: classref-property
  895. :ref:`Texture2D<class_Texture2D>` **texture**
  896. .. rst-class:: classref-property-setget
  897. - void **set_texture** **(** :ref:`Texture2D<class_Texture2D>` value **)**
  898. - :ref:`Texture2D<class_Texture2D>` **get_texture** **(** **)**
  899. Particle texture. If ``null``, particles will be squares.
  900. .. rst-class:: classref-section-separator
  901. ----
  902. .. rst-class:: classref-descriptions-group
  903. Method Descriptions
  904. -------------------
  905. .. _class_CPUParticles2D_method_convert_from_particles:
  906. .. rst-class:: classref-method
  907. void **convert_from_particles** **(** :ref:`Node<class_Node>` particles **)**
  908. Sets this node's properties to match a given :ref:`GPUParticles2D<class_GPUParticles2D>` node with an assigned :ref:`ParticleProcessMaterial<class_ParticleProcessMaterial>`.
  909. .. rst-class:: classref-item-separator
  910. ----
  911. .. _class_CPUParticles2D_method_get_param_curve:
  912. .. rst-class:: classref-method
  913. :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  914. Returns the :ref:`Curve<class_Curve>` of the parameter specified by :ref:`Parameter<enum_CPUParticles2D_Parameter>`.
  915. .. rst-class:: classref-item-separator
  916. ----
  917. .. _class_CPUParticles2D_method_get_param_max:
  918. .. rst-class:: classref-method
  919. :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  920. Returns the maximum value range for the given parameter.
  921. .. rst-class:: classref-item-separator
  922. ----
  923. .. _class_CPUParticles2D_method_get_param_min:
  924. .. rst-class:: classref-method
  925. :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
  926. Returns the minimum value range for the given parameter.
  927. .. rst-class:: classref-item-separator
  928. ----
  929. .. _class_CPUParticles2D_method_get_particle_flag:
  930. .. rst-class:: classref-method
  931. :ref:`bool<class_bool>` **get_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const|
  932. Returns the enabled state of the given flag (see :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` for options).
  933. .. rst-class:: classref-item-separator
  934. ----
  935. .. _class_CPUParticles2D_method_restart:
  936. .. rst-class:: classref-method
  937. void **restart** **(** **)**
  938. Restarts the particle emitter.
  939. .. rst-class:: classref-item-separator
  940. ----
  941. .. _class_CPUParticles2D_method_set_param_curve:
  942. .. rst-class:: classref-method
  943. void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
  944. Sets the :ref:`Curve<class_Curve>` of the parameter specified by :ref:`Parameter<enum_CPUParticles2D_Parameter>`.
  945. .. rst-class:: classref-item-separator
  946. ----
  947. .. _class_CPUParticles2D_method_set_param_max:
  948. .. rst-class:: classref-method
  949. void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  950. Sets the maximum value for the given parameter.
  951. .. rst-class:: classref-item-separator
  952. ----
  953. .. _class_CPUParticles2D_method_set_param_min:
  954. .. rst-class:: classref-method
  955. void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
  956. Sets the minimum value for the given parameter.
  957. .. rst-class:: classref-item-separator
  958. ----
  959. .. _class_CPUParticles2D_method_set_particle_flag:
  960. .. rst-class:: classref-method
  961. void **set_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)**
  962. Enables or disables the given flag (see :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` for options).
  963. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  964. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  965. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  966. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  967. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  968. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`