12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703 |
- :github_url: hide
- .. DO NOT EDIT THIS FILE!!!
- .. Generated automatically from Godot engine sources.
- .. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py.
- .. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/CPUParticles2D.xml.
- .. _class_CPUParticles2D:
- CPUParticles2D
- ==============
- **Inherits:** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
- CPU-based 2D particle emitter.
- .. rst-class:: classref-introduction-group
- Description
- -----------
- CPU-based 2D particle node used to create a variety of particle systems and effects.
- See also :ref:`GPUParticles2D<class_GPUParticles2D>`, which provides the same functionality with hardware acceleration, but may not run on older devices.
- .. rst-class:: classref-introduction-group
- Tutorials
- ---------
- - :doc:`Particle systems (2D) <../tutorials/2d/particle_systems_2d>`
- .. rst-class:: classref-reftable-group
- Properties
- ----------
- .. table::
- :widths: auto
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`int<class_int>` | :ref:`amount<class_CPUParticles2D_property_amount>` | ``8`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`angle_curve<class_CPUParticles2D_property_angle_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`angle_max<class_CPUParticles2D_property_angle_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`angle_min<class_CPUParticles2D_property_angle_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`angular_velocity_curve<class_CPUParticles2D_property_angular_velocity_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`angular_velocity_max<class_CPUParticles2D_property_angular_velocity_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`angular_velocity_min<class_CPUParticles2D_property_angular_velocity_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`anim_offset_curve<class_CPUParticles2D_property_anim_offset_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`anim_offset_max<class_CPUParticles2D_property_anim_offset_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`anim_offset_min<class_CPUParticles2D_property_anim_offset_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`anim_speed_curve<class_CPUParticles2D_property_anim_speed_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`anim_speed_max<class_CPUParticles2D_property_anim_speed_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`anim_speed_min<class_CPUParticles2D_property_anim_speed_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Color<class_Color>` | :ref:`color<class_CPUParticles2D_property_color>` | ``Color(1, 1, 1, 1)`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Gradient<class_Gradient>` | :ref:`color_initial_ramp<class_CPUParticles2D_property_color_initial_ramp>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Gradient<class_Gradient>` | :ref:`color_ramp<class_CPUParticles2D_property_color_ramp>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`damping_curve<class_CPUParticles2D_property_damping_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`damping_max<class_CPUParticles2D_property_damping_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`damping_min<class_CPUParticles2D_property_damping_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Vector2<class_Vector2>` | :ref:`direction<class_CPUParticles2D_property_direction>` | ``Vector2(1, 0)`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` | :ref:`draw_order<class_CPUParticles2D_property_draw_order>` | ``0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`PackedColorArray<class_PackedColorArray>` | :ref:`emission_colors<class_CPUParticles2D_property_emission_colors>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`emission_normals<class_CPUParticles2D_property_emission_normals>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`emission_points<class_CPUParticles2D_property_emission_points>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Vector2<class_Vector2>` | :ref:`emission_rect_extents<class_CPUParticles2D_property_emission_rect_extents>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` | :ref:`emission_shape<class_CPUParticles2D_property_emission_shape>` | ``0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`emission_sphere_radius<class_CPUParticles2D_property_emission_sphere_radius>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`bool<class_bool>` | :ref:`emitting<class_CPUParticles2D_property_emitting>` | ``true`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`explosiveness<class_CPUParticles2D_property_explosiveness>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`int<class_int>` | :ref:`fixed_fps<class_CPUParticles2D_property_fixed_fps>` | ``0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`bool<class_bool>` | :ref:`fract_delta<class_CPUParticles2D_property_fract_delta>` | ``true`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Vector2<class_Vector2>` | :ref:`gravity<class_CPUParticles2D_property_gravity>` | ``Vector2(0, 980)`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`hue_variation_curve<class_CPUParticles2D_property_hue_variation_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`hue_variation_max<class_CPUParticles2D_property_hue_variation_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`hue_variation_min<class_CPUParticles2D_property_hue_variation_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`initial_velocity_max<class_CPUParticles2D_property_initial_velocity_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`initial_velocity_min<class_CPUParticles2D_property_initial_velocity_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`lifetime<class_CPUParticles2D_property_lifetime>` | ``1.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`lifetime_randomness<class_CPUParticles2D_property_lifetime_randomness>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`linear_accel_curve<class_CPUParticles2D_property_linear_accel_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`linear_accel_max<class_CPUParticles2D_property_linear_accel_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`linear_accel_min<class_CPUParticles2D_property_linear_accel_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`bool<class_bool>` | :ref:`local_coords<class_CPUParticles2D_property_local_coords>` | ``false`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`bool<class_bool>` | :ref:`one_shot<class_CPUParticles2D_property_one_shot>` | ``false`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`orbit_velocity_curve<class_CPUParticles2D_property_orbit_velocity_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`orbit_velocity_max<class_CPUParticles2D_property_orbit_velocity_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`orbit_velocity_min<class_CPUParticles2D_property_orbit_velocity_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`bool<class_bool>` | :ref:`particle_flag_align_y<class_CPUParticles2D_property_particle_flag_align_y>` | ``false`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`preprocess<class_CPUParticles2D_property_preprocess>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`radial_accel_curve<class_CPUParticles2D_property_radial_accel_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`radial_accel_max<class_CPUParticles2D_property_radial_accel_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`radial_accel_min<class_CPUParticles2D_property_radial_accel_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`randomness<class_CPUParticles2D_property_randomness>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`scale_amount_curve<class_CPUParticles2D_property_scale_amount_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`scale_amount_max<class_CPUParticles2D_property_scale_amount_max>` | ``1.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`scale_amount_min<class_CPUParticles2D_property_scale_amount_min>` | ``1.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`scale_curve_x<class_CPUParticles2D_property_scale_curve_x>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`scale_curve_y<class_CPUParticles2D_property_scale_curve_y>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`speed_scale<class_CPUParticles2D_property_speed_scale>` | ``1.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`bool<class_bool>` | :ref:`split_scale<class_CPUParticles2D_property_split_scale>` | ``false`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`spread<class_CPUParticles2D_property_spread>` | ``45.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Curve<class_Curve>` | :ref:`tangential_accel_curve<class_CPUParticles2D_property_tangential_accel_curve>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`tangential_accel_max<class_CPUParticles2D_property_tangential_accel_max>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`float<class_float>` | :ref:`tangential_accel_min<class_CPUParticles2D_property_tangential_accel_min>` | ``0.0`` |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- | :ref:`Texture2D<class_Texture2D>` | :ref:`texture<class_CPUParticles2D_property_texture>` | |
- +---------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
- .. rst-class:: classref-reftable-group
- Methods
- -------
- .. table::
- :widths: auto
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`convert_from_particles<class_CPUParticles2D_method_convert_from_particles>` **(** :ref:`Node<class_Node>` particles **)** |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Curve<class_Curve>` | :ref:`get_param_curve<class_CPUParticles2D_method_get_param_curve>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const| |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`float<class_float>` | :ref:`get_param_max<class_CPUParticles2D_method_get_param_max>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const| |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`float<class_float>` | :ref:`get_param_min<class_CPUParticles2D_method_get_param_min>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const| |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`get_particle_flag<class_CPUParticles2D_method_get_particle_flag>` **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const| |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`restart<class_CPUParticles2D_method_restart>` **(** **)** |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`set_param_curve<class_CPUParticles2D_method_set_param_curve>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)** |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`set_param_max<class_CPUParticles2D_method_set_param_max>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)** |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`set_param_min<class_CPUParticles2D_method_set_param_min>` **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)** |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | void | :ref:`set_particle_flag<class_CPUParticles2D_method_set_particle_flag>` **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)** |
- +---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Enumerations
- ------------
- .. _enum_CPUParticles2D_DrawOrder:
- .. rst-class:: classref-enumeration
- enum **DrawOrder**:
- .. _class_CPUParticles2D_constant_DRAW_ORDER_INDEX:
- .. rst-class:: classref-enumeration-constant
- :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **DRAW_ORDER_INDEX** = ``0``
- Particles are drawn in the order emitted.
- .. _class_CPUParticles2D_constant_DRAW_ORDER_LIFETIME:
- .. rst-class:: classref-enumeration-constant
- :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **DRAW_ORDER_LIFETIME** = ``1``
- Particles are drawn in order of remaining lifetime.
- .. rst-class:: classref-item-separator
- ----
- .. _enum_CPUParticles2D_Parameter:
- .. rst-class:: classref-enumeration
- enum **Parameter**:
- .. _class_CPUParticles2D_constant_PARAM_INITIAL_LINEAR_VELOCITY:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_INITIAL_LINEAR_VELOCITY** = ``0``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_ANGULAR_VELOCITY:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANGULAR_VELOCITY** = ``1``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_ORBIT_VELOCITY:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ORBIT_VELOCITY** = ``2``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_LINEAR_ACCEL:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_LINEAR_ACCEL** = ``3``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_RADIAL_ACCEL:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_RADIAL_ACCEL** = ``4``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_TANGENTIAL_ACCEL:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_TANGENTIAL_ACCEL** = ``5``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_DAMPING:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_DAMPING** = ``6``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_ANGLE:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANGLE** = ``7``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_SCALE:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_SCALE** = ``8``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_HUE_VARIATION:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_HUE_VARIATION** = ``9``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_ANIM_SPEED:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANIM_SPEED** = ``10``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_ANIM_OFFSET:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_ANIM_OFFSET** = ``11``
- 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.
- .. _class_CPUParticles2D_constant_PARAM_MAX:
- .. rst-class:: classref-enumeration-constant
- :ref:`Parameter<enum_CPUParticles2D_Parameter>` **PARAM_MAX** = ``12``
- Represents the size of the :ref:`Parameter<enum_CPUParticles2D_Parameter>` enum.
- .. rst-class:: classref-item-separator
- ----
- .. _enum_CPUParticles2D_ParticleFlags:
- .. rst-class:: classref-enumeration
- enum **ParticleFlags**:
- .. _class_CPUParticles2D_constant_PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY:
- .. rst-class:: classref-enumeration-constant
- :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_ALIGN_Y_TO_VELOCITY** = ``0``
- 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>`.
- .. _class_CPUParticles2D_constant_PARTICLE_FLAG_ROTATE_Y:
- .. rst-class:: classref-enumeration-constant
- :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_ROTATE_Y** = ``1``
- Present for consistency with 3D particle nodes, not used in 2D.
- .. _class_CPUParticles2D_constant_PARTICLE_FLAG_DISABLE_Z:
- .. rst-class:: classref-enumeration-constant
- :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_DISABLE_Z** = ``2``
- Present for consistency with 3D particle nodes, not used in 2D.
- .. _class_CPUParticles2D_constant_PARTICLE_FLAG_MAX:
- .. rst-class:: classref-enumeration-constant
- :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` **PARTICLE_FLAG_MAX** = ``3``
- Represents the size of the :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` enum.
- .. rst-class:: classref-item-separator
- ----
- .. _enum_CPUParticles2D_EmissionShape:
- .. rst-class:: classref-enumeration
- enum **EmissionShape**:
- .. _class_CPUParticles2D_constant_EMISSION_SHAPE_POINT:
- .. rst-class:: classref-enumeration-constant
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_POINT** = ``0``
- All particles will be emitted from a single point.
- .. _class_CPUParticles2D_constant_EMISSION_SHAPE_SPHERE:
- .. rst-class:: classref-enumeration-constant
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_SPHERE** = ``1``
- Particles will be emitted in the volume of a sphere flattened to two dimensions.
- .. _class_CPUParticles2D_constant_EMISSION_SHAPE_SPHERE_SURFACE:
- .. rst-class:: classref-enumeration-constant
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_SPHERE_SURFACE** = ``2``
- Particles will be emitted on the surface of a sphere flattened to two dimensions.
- .. _class_CPUParticles2D_constant_EMISSION_SHAPE_RECTANGLE:
- .. rst-class:: classref-enumeration-constant
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_RECTANGLE** = ``3``
- Particles will be emitted in the area of a rectangle.
- .. _class_CPUParticles2D_constant_EMISSION_SHAPE_POINTS:
- .. rst-class:: classref-enumeration-constant
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_POINTS** = ``4``
- 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>`.
- .. _class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS:
- .. rst-class:: classref-enumeration-constant
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_DIRECTED_POINTS** = ``5``
- 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>`.
- .. _class_CPUParticles2D_constant_EMISSION_SHAPE_MAX:
- .. rst-class:: classref-enumeration-constant
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **EMISSION_SHAPE_MAX** = ``6``
- Represents the size of the :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` enum.
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Property Descriptions
- ---------------------
- .. _class_CPUParticles2D_property_amount:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **amount** = ``8``
- .. rst-class:: classref-property-setget
- - void **set_amount** **(** :ref:`int<class_int>` value **)**
- - :ref:`int<class_int>` **get_amount** **(** **)**
- Number of particles emitted in one emission cycle.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_angle_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **angle_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's rotation will be animated along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_angle_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **angle_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum initial rotation applied to each particle, in degrees.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_angle_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **angle_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`angle_max<class_CPUParticles2D_property_angle_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_angular_velocity_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **angular_velocity_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's angular velocity will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_angular_velocity_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **angular_velocity_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum initial angular velocity (rotation speed) applied to each particle in *degrees* per second.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_angular_velocity_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **angular_velocity_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`angular_velocity_max<class_CPUParticles2D_property_angular_velocity_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_anim_offset_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **anim_offset_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's animation offset will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_anim_offset_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **anim_offset_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_anim_offset_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **anim_offset_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`anim_offset_max<class_CPUParticles2D_property_anim_offset_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_anim_speed_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **anim_speed_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's animation speed will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_anim_speed_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **anim_speed_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- 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.
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_anim_speed_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **anim_speed_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`anim_speed_max<class_CPUParticles2D_property_anim_speed_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_color:
- .. rst-class:: classref-property
- :ref:`Color<class_Color>` **color** = ``Color(1, 1, 1, 1)``
- .. rst-class:: classref-property-setget
- - void **set_color** **(** :ref:`Color<class_Color>` value **)**
- - :ref:`Color<class_Color>` **get_color** **(** **)**
- Each particle's initial color. If :ref:`texture<class_CPUParticles2D_property_texture>` is defined, it will be multiplied by this color.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_color_initial_ramp:
- .. rst-class:: classref-property
- :ref:`Gradient<class_Gradient>` **color_initial_ramp**
- .. rst-class:: classref-property-setget
- - void **set_color_initial_ramp** **(** :ref:`Gradient<class_Gradient>` value **)**
- - :ref:`Gradient<class_Gradient>` **get_color_initial_ramp** **(** **)**
- Each particle's initial color will vary along this :ref:`GradientTexture1D<class_GradientTexture1D>` (multiplied with :ref:`color<class_CPUParticles2D_property_color>`).
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_color_ramp:
- .. rst-class:: classref-property
- :ref:`Gradient<class_Gradient>` **color_ramp**
- .. rst-class:: classref-property-setget
- - void **set_color_ramp** **(** :ref:`Gradient<class_Gradient>` value **)**
- - :ref:`Gradient<class_Gradient>` **get_color_ramp** **(** **)**
- Each particle's color will vary along this :ref:`Gradient<class_Gradient>` (multiplied with :ref:`color<class_CPUParticles2D_property_color>`).
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_damping_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **damping_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Damping will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_damping_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **damping_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_damping_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **damping_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`damping_max<class_CPUParticles2D_property_damping_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_direction:
- .. rst-class:: classref-property
- :ref:`Vector2<class_Vector2>` **direction** = ``Vector2(1, 0)``
- .. rst-class:: classref-property-setget
- - void **set_direction** **(** :ref:`Vector2<class_Vector2>` value **)**
- - :ref:`Vector2<class_Vector2>` **get_direction** **(** **)**
- Unit vector specifying the particles' emission direction.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_draw_order:
- .. rst-class:: classref-property
- :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **draw_order** = ``0``
- .. rst-class:: classref-property-setget
- - void **set_draw_order** **(** :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` value **)**
- - :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` **get_draw_order** **(** **)**
- Particle draw order. Uses :ref:`DrawOrder<enum_CPUParticles2D_DrawOrder>` values.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_emission_colors:
- .. rst-class:: classref-property
- :ref:`PackedColorArray<class_PackedColorArray>` **emission_colors**
- .. rst-class:: classref-property-setget
- - void **set_emission_colors** **(** :ref:`PackedColorArray<class_PackedColorArray>` value **)**
- - :ref:`PackedColorArray<class_PackedColorArray>` **get_emission_colors** **(** **)**
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_emission_normals:
- .. rst-class:: classref-property
- :ref:`PackedVector2Array<class_PackedVector2Array>` **emission_normals**
- .. rst-class:: classref-property-setget
- - void **set_emission_normals** **(** :ref:`PackedVector2Array<class_PackedVector2Array>` value **)**
- - :ref:`PackedVector2Array<class_PackedVector2Array>` **get_emission_normals** **(** **)**
- Sets the direction the particles will be emitted in when using :ref:`EMISSION_SHAPE_DIRECTED_POINTS<class_CPUParticles2D_constant_EMISSION_SHAPE_DIRECTED_POINTS>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_emission_points:
- .. rst-class:: classref-property
- :ref:`PackedVector2Array<class_PackedVector2Array>` **emission_points**
- .. rst-class:: classref-property-setget
- - void **set_emission_points** **(** :ref:`PackedVector2Array<class_PackedVector2Array>` value **)**
- - :ref:`PackedVector2Array<class_PackedVector2Array>` **get_emission_points** **(** **)**
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_emission_rect_extents:
- .. rst-class:: classref-property
- :ref:`Vector2<class_Vector2>` **emission_rect_extents**
- .. rst-class:: classref-property-setget
- - void **set_emission_rect_extents** **(** :ref:`Vector2<class_Vector2>` value **)**
- - :ref:`Vector2<class_Vector2>` **get_emission_rect_extents** **(** **)**
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_emission_shape:
- .. rst-class:: classref-property
- :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **emission_shape** = ``0``
- .. rst-class:: classref-property-setget
- - void **set_emission_shape** **(** :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` value **)**
- - :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` **get_emission_shape** **(** **)**
- Particles will be emitted inside this region. See :ref:`EmissionShape<enum_CPUParticles2D_EmissionShape>` for possible values.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_emission_sphere_radius:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **emission_sphere_radius**
- .. rst-class:: classref-property-setget
- - void **set_emission_sphere_radius** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_emission_sphere_radius** **(** **)**
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_emitting:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **emitting** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_emitting** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **is_emitting** **(** **)**
- If ``true``, particles are being emitted.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_explosiveness:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **explosiveness** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_explosiveness_ratio** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_explosiveness_ratio** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_fixed_fps:
- .. rst-class:: classref-property
- :ref:`int<class_int>` **fixed_fps** = ``0``
- .. rst-class:: classref-property-setget
- - void **set_fixed_fps** **(** :ref:`int<class_int>` value **)**
- - :ref:`int<class_int>` **get_fixed_fps** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_fract_delta:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **fract_delta** = ``true``
- .. rst-class:: classref-property-setget
- - void **set_fractional_delta** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **get_fractional_delta** **(** **)**
- If ``true``, results in fractional delta calculation which has a smoother particles display effect.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_gravity:
- .. rst-class:: classref-property
- :ref:`Vector2<class_Vector2>` **gravity** = ``Vector2(0, 980)``
- .. rst-class:: classref-property-setget
- - void **set_gravity** **(** :ref:`Vector2<class_Vector2>` value **)**
- - :ref:`Vector2<class_Vector2>` **get_gravity** **(** **)**
- Gravity applied to every particle.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_hue_variation_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **hue_variation_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's hue will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_hue_variation_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **hue_variation_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum initial hue variation applied to each particle. It will shift the particle color's hue.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_hue_variation_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **hue_variation_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`hue_variation_max<class_CPUParticles2D_property_hue_variation_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_initial_velocity_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **initial_velocity_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum initial velocity magnitude for each particle. Direction comes from :ref:`direction<class_CPUParticles2D_property_direction>` and :ref:`spread<class_CPUParticles2D_property_spread>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_initial_velocity_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **initial_velocity_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`initial_velocity_max<class_CPUParticles2D_property_initial_velocity_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_lifetime:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **lifetime** = ``1.0``
- .. rst-class:: classref-property-setget
- - void **set_lifetime** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_lifetime** **(** **)**
- Amount of time each particle will exist.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_lifetime_randomness:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **lifetime_randomness** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_lifetime_randomness** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_lifetime_randomness** **(** **)**
- Particle lifetime randomness ratio.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_linear_accel_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **linear_accel_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's linear acceleration will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_linear_accel_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **linear_accel_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum linear acceleration applied to each particle in the direction of motion.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_linear_accel_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **linear_accel_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`linear_accel_max<class_CPUParticles2D_property_linear_accel_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_local_coords:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **local_coords** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_use_local_coordinates** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **get_use_local_coordinates** **(** **)**
- 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.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_one_shot:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **one_shot** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_one_shot** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **get_one_shot** **(** **)**
- If ``true``, only one emission cycle occurs. If set ``true`` during a cycle, emission will stop at the cycle's end.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_orbit_velocity_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **orbit_velocity_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's orbital velocity will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_orbit_velocity_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **orbit_velocity_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum orbital velocity applied to each particle. Makes the particles circle around origin. Specified in number of full rotations around origin per second.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_orbit_velocity_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **orbit_velocity_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`orbit_velocity_max<class_CPUParticles2D_property_orbit_velocity_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_particle_flag_align_y:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **particle_flag_align_y** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)**
- - :ref:`bool<class_bool>` **get_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const|
- Align Y axis of particle with the direction of its velocity.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_preprocess:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **preprocess** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_pre_process_time** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_pre_process_time** **(** **)**
- Particle system starts as if it had already run for this many seconds.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_radial_accel_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **radial_accel_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's radial acceleration will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_radial_accel_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **radial_accel_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum radial acceleration applied to each particle. Makes particle accelerate away from the origin or towards it if negative.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_radial_accel_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **radial_accel_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`radial_accel_max<class_CPUParticles2D_property_radial_accel_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_randomness:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **randomness** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_randomness_ratio** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_randomness_ratio** **(** **)**
- Emission lifetime randomness ratio.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_scale_amount_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **scale_amount_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's scale will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_scale_amount_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **scale_amount_max** = ``1.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum initial scale applied to each particle.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_scale_amount_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **scale_amount_min** = ``1.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`scale_amount_max<class_CPUParticles2D_property_scale_amount_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_scale_curve_x:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **scale_curve_x**
- .. rst-class:: classref-property-setget
- - void **set_scale_curve_x** **(** :ref:`Curve<class_Curve>` value **)**
- - :ref:`Curve<class_Curve>` **get_scale_curve_x** **(** **)**
- Each particle's horizontal scale will vary along this :ref:`Curve<class_Curve>`.
- \ :ref:`split_scale<class_CPUParticles2D_property_split_scale>` must be enabled.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_scale_curve_y:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **scale_curve_y**
- .. rst-class:: classref-property-setget
- - void **set_scale_curve_y** **(** :ref:`Curve<class_Curve>` value **)**
- - :ref:`Curve<class_Curve>` **get_scale_curve_y** **(** **)**
- Each particle's vertical scale will vary along this :ref:`Curve<class_Curve>`.
- \ :ref:`split_scale<class_CPUParticles2D_property_split_scale>` must be enabled.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_speed_scale:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **speed_scale** = ``1.0``
- .. rst-class:: classref-property-setget
- - void **set_speed_scale** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_speed_scale** **(** **)**
- Particle system's running speed scaling ratio. A value of ``0`` can be used to pause the particles.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_split_scale:
- .. rst-class:: classref-property
- :ref:`bool<class_bool>` **split_scale** = ``false``
- .. rst-class:: classref-property-setget
- - void **set_split_scale** **(** :ref:`bool<class_bool>` value **)**
- - :ref:`bool<class_bool>` **get_split_scale** **(** **)**
- 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>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_spread:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **spread** = ``45.0``
- .. rst-class:: classref-property-setget
- - void **set_spread** **(** :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_spread** **(** **)**
- Each particle's initial direction range from ``+spread`` to ``-spread`` degrees.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_tangential_accel_curve:
- .. rst-class:: classref-property
- :ref:`Curve<class_Curve>` **tangential_accel_curve**
- .. rst-class:: classref-property-setget
- - void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- - :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Each particle's tangential acceleration will vary along this :ref:`Curve<class_Curve>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_tangential_accel_max:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **tangential_accel_max** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Maximum tangential acceleration applied to each particle. Tangential acceleration is perpendicular to the particle's velocity giving the particles a swirling motion.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_tangential_accel_min:
- .. rst-class:: classref-property
- :ref:`float<class_float>` **tangential_accel_min** = ``0.0``
- .. rst-class:: classref-property-setget
- - void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- - :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Minimum equivalent of :ref:`tangential_accel_max<class_CPUParticles2D_property_tangential_accel_max>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_property_texture:
- .. rst-class:: classref-property
- :ref:`Texture2D<class_Texture2D>` **texture**
- .. rst-class:: classref-property-setget
- - void **set_texture** **(** :ref:`Texture2D<class_Texture2D>` value **)**
- - :ref:`Texture2D<class_Texture2D>` **get_texture** **(** **)**
- Particle texture. If ``null``, particles will be squares.
- .. rst-class:: classref-section-separator
- ----
- .. rst-class:: classref-descriptions-group
- Method Descriptions
- -------------------
- .. _class_CPUParticles2D_method_convert_from_particles:
- .. rst-class:: classref-method
- void **convert_from_particles** **(** :ref:`Node<class_Node>` particles **)**
- Sets this node's properties to match a given :ref:`GPUParticles2D<class_GPUParticles2D>` node with an assigned :ref:`ParticleProcessMaterial<class_ParticleProcessMaterial>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_get_param_curve:
- .. rst-class:: classref-method
- :ref:`Curve<class_Curve>` **get_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Returns the :ref:`Curve<class_Curve>` of the parameter specified by :ref:`Parameter<enum_CPUParticles2D_Parameter>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_get_param_max:
- .. rst-class:: classref-method
- :ref:`float<class_float>` **get_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Returns the maximum value range for the given parameter.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_get_param_min:
- .. rst-class:: classref-method
- :ref:`float<class_float>` **get_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param **)** |const|
- Returns the minimum value range for the given parameter.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_get_particle_flag:
- .. rst-class:: classref-method
- :ref:`bool<class_bool>` **get_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag **)** |const|
- Returns the enabled state of the given flag (see :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` for options).
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_restart:
- .. rst-class:: classref-method
- void **restart** **(** **)**
- Restarts the particle emitter.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_set_param_curve:
- .. rst-class:: classref-method
- void **set_param_curve** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`Curve<class_Curve>` curve **)**
- Sets the :ref:`Curve<class_Curve>` of the parameter specified by :ref:`Parameter<enum_CPUParticles2D_Parameter>`.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_set_param_max:
- .. rst-class:: classref-method
- void **set_param_max** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- Sets the maximum value for the given parameter.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_set_param_min:
- .. rst-class:: classref-method
- void **set_param_min** **(** :ref:`Parameter<enum_CPUParticles2D_Parameter>` param, :ref:`float<class_float>` value **)**
- Sets the minimum value for the given parameter.
- .. rst-class:: classref-item-separator
- ----
- .. _class_CPUParticles2D_method_set_particle_flag:
- .. rst-class:: classref-method
- void **set_particle_flag** **(** :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` particle_flag, :ref:`bool<class_bool>` enable **)**
- Enables or disables the given flag (see :ref:`ParticleFlags<enum_CPUParticles2D_ParticleFlags>` for options).
- .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
- .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
- .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
- .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
- .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
- .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
|