From 44292bf77fd20f988d2c69c11e01ef9623ae1b22 Mon Sep 17 00:00:00 2001 From: Chris Bradfield Date: Tue, 3 Oct 2017 12:30:32 -0700 Subject: [DOCS] Update ParticlesMaterial, Particles class ref --- doc/classes/ParticlesMaterial.xml | 68 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) (limited to 'doc/classes/ParticlesMaterial.xml') diff --git a/doc/classes/ParticlesMaterial.xml b/doc/classes/ParticlesMaterial.xml index 1767a19a9f..bebdc44b69 100644 --- a/doc/classes/ParticlesMaterial.xml +++ b/doc/classes/ParticlesMaterial.xml @@ -1,8 +1,11 @@ + Particle properties for [Particles] and [Particles2D] nodes. + ParticlesMaterial defines particle properties and behavior. It is used in the [code]process_material[/code] of [Particles] and [Particles2D] emitter nodes. + Some of this material's properties are applied to each particle when emitted, while others can have a [CurveTexture] applied to vary values over the lifetime of the particle. @@ -294,152 +297,217 @@ + Initial rotation applied to each particle. + Each particle's rotation will be animated along this [CurveTexture]. + Rotation randomness ratio. Default value: [code]0[/code]. + Initial angular velocity applied to each particle. + Each particle's angular velocity will vary along this [CurveTexture]. + Angular velocity randomness ratio. Default value: [code]0[/code]. + If [code]true[/code] animation will loop. Default value: [code]false[/code]. + Particle animation offset. + Each particle's animation offset will vary along this [CurveTexture]. + Animation offset randomness ratio. Default value: [code]0[/code]. + Particle animation speed. + Each particle's animation speed will vary along this [CurveTexture]. + Animation speed randomness ratio. Default value: [code]0[/code]. + Each particle's initial color. If the [Particle2D]'s [code]texture[/code] is defined, it will be multiplied by this color. + Each particle's color will vary along this [GradientTexture]. + The rate at which particles lose velocity. + Damping will vary along this [CurveTexture]. + Damping randomness ratio. Default value: [code]0[/code]. + The box's extents if [code]emission_shape[/code] is set to [code]EMISSION_SHAPE_BOX[/code]. + The number of emission points if [code]emission_shape[/code] is set to [code]EMISSION_SHAPE_POINTS[/code] or [code]EMISSION_SHAPE_DIRECTED_POINTS[/code]. + Particles will be emitted inside this region. Use [code]EMISSION_SHAPE_*[/code] constants for values. Default value: [code]EMISSION_SHAPE_POINT[/code]. + The sphere's radius if [code]emission_shape[/code] is set to [code]EMISSION_SHAPE_SPHERE[/code]. + If [code]true[/code] particles will not move on the z axis. Default value: [code]true[/code] for [Particles2D], [code]false[/code] for [Particles]. + Gravity applied to every particle. Default value: [code](0, 98, 0)[/code]. + Initial hue variation applied to each particle. + Each particle's hue will vary along this [CurveTexture]. + Hue variation randomness ratio. Default value: [code]0[/code]. + Initial velocity for each particle. + Initial velocity randomness ratio. Default value: [code]0[/code]. + Linear acceleration applied to each particle. + Each particle's linear acceleration will vary along this [CurveTexture]. + Linear acceleration randomness ratio. Default value: [code]0[/code]. + Orbital velocity applied to each particle. + Each particle's orbital velocity will vary along this [CurveTexture]. + Orbital velocity randomness ratio. Default value: [code]0[/code]. + Linear acceleration applied to each particle. + Each particle's radial acceleration will vary along this [CurveTexture]. + Radial acceleration randomness ratio. Default value: [code]0[/code]. + Initial scale applied to each particle. + Each particle's scale will vary along this [CurveTexture]. + Scale randomness ratio. Default value: [code]0[/code]. + Each particle's initial direction range from [code]+spread[/code] to [code]-spread[/code] degrees. Default value: [code]45[/code]. + Tangential acceleration applied to each particle. Tangential acceleration is perpendicular to the particle's velocity. + Each particle's tangential acceleration will vary along this [CurveTexture]. + Tangential acceleration randomness ratio. Default value: [code]0[/code]. + Trail particles' color will vary along this [GradientTexture]. + Emitter will emit [code]amount[/code] divided by [code]trail_divisor[/code] particles. The remaining particles will be used as trail(s). + Trail particles' size will vary along this [CurveTexture]. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set initial velocity properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set angular velocity properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set orbital_velocity properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set linear acceleration properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set radial acceleration properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set tangential acceleration properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set damping properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set angle properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set scale properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set hue_variation properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set animation speed properties. + Use with [method set_param], [method set_param_randomness], and [method set_param_texture] to set animation offset properties. + Use with [method set_flag] to set [member flag_align_y]. + Use with [method set_flag] to set [member flag_rotate_y] + All particles will be emitted from a single point. + Particles will be emitted in the volume of a sphere. + Particles will be emitted in the volume of a box. -- cgit v1.2.3