ParticleSettings(ID)

base classes — bpy_struct, ID

class bpy.types.ParticleSettings(ID)

Particle settings, reusable by multiple particle systems

active_dupliweight
Type:ParticleDupliWeight, (readonly)
active_dupliweight_index
Type:int in [0, inf], default 0
active_texture

Active texture slot being displayed

Type:Texture
active_texture_index

Index of active texture slot

Type:int in [0, 17], default 0
adaptive_angle

How many degrees path has to curve to make another render segment

Type:int in [0, 45], default 0
adaptive_pixel

How many pixels path has to cover to make another render segment

Type:int in [0, 50], default 0
angular_velocity_factor

Angular velocity amount (in radians per second)

Type:float in [-200, 200], default 0.0
angular_velocity_mode

What axis is used to change particle rotation with time

Type:enum in [‘NONE’, ‘VELOCITY’, ‘HORIZONTAL’, ‘VERTICAL’, ‘GLOBAL_X’, ‘GLOBAL_Y’, ‘GLOBAL_Z’, ‘RAND’], default ‘NONE’
animation_data

Animation data for this data-block

Type:AnimData, (readonly)
apply_effector_to_children

Apply effectors to children

Type:boolean, default False
apply_guide_to_children
Type:boolean, default False
bending_random

Random stiffness of hairs

Type:float in [0, 1], default 0.0
billboard_align

In respect to what the billboards are aligned

Type:enum in [‘X’, ‘Y’, ‘Z’, ‘VIEW’, ‘VEL’], default ‘X’
billboard_animation

How to animate billboard textures

Type:enum in [‘NONE’, ‘AGE’, ‘FRAME’, ‘ANGLE’], default ‘NONE’
billboard_object

Billboards face this object (default is active camera)

Type:Object
billboard_offset
Type:float array of 2 items in [-100, 100], default (0.0, 0.0)
billboard_offset_split

How to offset billboard textures

Type:enum in [‘NONE’, ‘LINEAR’, ‘RANDOM’], default ‘NONE’
billboard_size

Scale billboards relative to particle size

Type:float array of 2 items in [0.001, 10], default (0.0, 0.0)
billboard_tilt

Tilt of the billboards

Type:float in [-1, 1], default 0.0
billboard_tilt_random

Random tilt of the billboards

Type:float in [0, 1], default 0.0
billboard_uv_split

Number of rows/columns to split UV coordinates for billboards

Type:int in [1, 100], default 0
billboard_velocity_head

Scale billboards by velocity

Type:float in [0, 10], default 0.0
billboard_velocity_tail

Scale billboards by velocity

Type:float in [0, 10], default 0.0
boids
Type:BoidSettings, (readonly)
branch_threshold

Threshold of branching

Type:float in [0, 1], default 0.0
brownian_factor

Amount of random, erratic particle movement

Type:float in [0, 200], default 0.0
child_length

Length of child paths

Type:float in [0, 1], default 0.0
child_length_threshold

Amount of particles left untouched by child path length

Type:float in [0, 1], default 0.0
child_nbr

Number of children/parent

Type:int in [0, 100000], default 0
child_parting_factor

Create parting in the children based on parent strands

Type:float in [0, 1], default 0.0
child_parting_max

Maximum root to tip angle (tip distance/root distance for long hair)

Type:float in [0, 180], default 0.0
child_parting_min

Minimum root to tip angle (tip distance/root distance for long hair)

Type:float in [0, 180], default 0.0
child_radius

Radius of children around parent

Type:float in [0, 10], default 0.0
child_roundness

Roundness of children around parent

Type:float in [0, 1], default 0.0
child_size

A multiplier for the child particle size

Type:float in [0.001, 100000], default 0.0
child_size_random

Random variation to the size of the child particles

Type:float in [0, 1], default 0.0
child_type

Create child particles

Type:enum in [‘NONE’, ‘SIMPLE’, ‘INTERPOLATED’], default ‘NONE’
clump_curve

Curve defining clump tapering

Type:CurveMapping, (readonly)
clump_factor

Amount of clumping

Type:float in [-1, 1], default 0.0
clump_noise_size

Size of clump noise

Type:float in [1e-05, 100000], default 0.0
clump_shape

Shape of clumping

Type:float in [-0.999, 0.999], default 0.0
collision_group

Limit colliders to this Group

Type:Group
color_maximum

Maximum length of the particle color vector

Type:float in [0.01, 100], default 0.0
count

Total number of particles

Type:int in [0, 10000000], default 0
courant_target

The relative distance a particle can move before requiring more subframes (target Courant number); 0.01-0.3 is the recommended range

Type:float in [0.0001, 10], default 0.1
create_long_hair_children

Calculate children that suit long hair well

Type:boolean, default False
cycles

Cycles hair settings

Type:CyclesCurveSettings, (readonly)
damping

Amount of damping

Type:float in [0, 1], default 0.0
distribution

How to distribute particles on selected element

Type:enum in [‘JIT’, ‘RAND’, ‘GRID’], default ‘JIT’
drag_factor

Amount of air-drag

Type:float in [0, 1], default 0.0
draw_color

Draw additional particle data as a color

Type:enum in [‘NONE’, ‘MATERIAL’, ‘VELOCITY’, ‘ACCELERATION’], default ‘NONE’
draw_method

How particles are drawn in viewport

Type:enum in [‘NONE’, ‘RENDER’, ‘DOT’, ‘CIRC’, ‘CROSS’, ‘AXIS’], default ‘NONE’
draw_percentage

Percentage of particles to display in 3D view

Type:int in [0, 100], default 0
draw_size

Size of particles on viewport in pixels (0=default)

Type:int in [0, 1000], default 0
draw_step

How many steps paths are drawn with (power of 2)

Type:int in [0, 10], default 0
dupli_group

Show Objects in this Group in place of particles

Type:Group
dupli_object

Show this Object in place of particles

Type:Object
dupli_weights

Weights for all of the objects in the dupli group

Type:bpy_prop_collection of ParticleDupliWeight, (readonly)
effect_hair

Hair stiffness for effectors

Type:float in [0, 1], default 0.0
effector_amount

How many particles are effectors (0 is all particles)

Type:int in [0, 10000], default 0
effector_weights
Type:EffectorWeights, (readonly)
emit_from

Where to emit particles from

Type:enum in [‘VERT’, ‘FACE’, ‘VOLUME’], default ‘VERT’
factor_random

Give the starting velocity a random variation

Type:float in [0, 200], default 0.0
fluid
Type:SPHFluidSettings, (readonly)
force_field_1
Type:FieldSettings, (readonly)
force_field_2
Type:FieldSettings, (readonly)
frame_end

Frame number to stop emitting particles

Type:float in [-500000, 500000], default 0.0
frame_start

Frame number to start emitting particles

Type:float in [-500000, 500000], default 0.0
grid_random

Add random offset to the grid locations

Type:float in [0, 1], default 0.0
grid_resolution

The resolution of the particle grid

Type:int in [1, 250], default 0
hair_length

Length of the hair

Type:float in [0, 1000], default 0.0
hair_step

Number of hair segments

Type:int in [2, 50], default 0
hexagonal_grid

Create the grid in a hexagonal pattern

Type:boolean, default False
integrator

Algorithm used to calculate physics, from the fastest to the most stable/accurate: Midpoint, Euler, Verlet, RK4 (Old)

Type:enum in [‘EULER’, ‘VERLET’, ‘MIDPOINT’, ‘RK4’], default ‘EULER’
invert_grid

Invert what is considered object and what is not

Type:boolean, default False
is_fluid

Particles were created by a fluid simulation

Type:boolean, default False, (readonly)
jitter_factor

Amount of jitter applied to the sampling

Type:float in [0, 2], default 0.0
keyed_loops

Number of times the keys are looped

Type:int in [1, 10000], default 0
keys_step
Type:int in [0, 32767], default 0
kink

Type of periodic offset on the path

Type:enum in [‘NO’, ‘CURL’, ‘RADIAL’, ‘WAVE’, ‘BRAID’, ‘SPIRAL’], default ‘NO’
kink_amplitude

The amplitude of the offset

Type:float in [-100000, 100000], default 0.0
kink_amplitude_clump

How much clump affects kink amplitude

Type:float in [0, 1], default 0.0
kink_amplitude_random

Random variation of the amplitude

Type:float in [0, 1], default 0.0
kink_axis

Which axis to use for offset

Type:enum in [‘X’, ‘Y’, ‘Z’], default ‘X’
kink_axis_random

Random variation of the orientation

Type:float in [0, 1], default 0.0
kink_extra_steps

Extra steps for resolution of special kink features

Type:int in [1, inf], default 0
kink_flat

How flat the hairs are

Type:float in [0, 1], default 0.0
kink_frequency

The frequency of the offset (1/total length)

Type:float in [-100000, 100000], default 0.0
kink_shape

Adjust the offset to the beginning/end

Type:float in [-0.999, 0.999], default 0.0
length_random

Give path length a random variation

Type:float in [0, 1], default 0.0
lifetime

Life span of the particles

Type:float in [1, 500000], default 0.0
lifetime_random

Give the particle life a random variation

Type:float in [0, 1], default 0.0
line_length_head

Length of the line’s head

Type:float in [0, 100000], default 0.0
line_length_tail

Length of the line’s tail

Type:float in [0, 100000], default 0.0
lock_billboard

Lock the billboards align axis

Type:boolean, default False
lock_boids_to_surface

Constrain boids to a surface

Type:boolean, default False
mass

Mass of the particles

Type:float in [1e-08, 100000], default 0.0
material

Index of material slot used for rendering particles

Type:int in [1, 32767], default 0
material_slot

Material slot used for rendering particles

Type:enum in [‘DUMMY’], default ‘DUMMY’
normal_factor

Let the surface normal give the particle a starting velocity

Type:float in [-1000, 1000], default 0.0
object_align_factor

Let the emitter object orientation give the particle a starting velocity

Type:float array of 3 items in [-200, 200], default (0.0, 0.0, 0.0)
object_factor

Let the object give the particle a starting velocity

Type:float in [-200, 200], default 0.0
particle_factor

Let the target particle give the particle a starting velocity

Type:float in [-200, 200], default 0.0
particle_size

The size of the particles

Type:float in [0.001, 100000], default 0.0
path_end

End time of drawn path

Type:float in [-inf, inf], default 0.0
path_start

Starting time of drawn path

Type:float in [-inf, inf], default 0.0
phase_factor

Rotation around the chosen orientation axis

Type:float in [-1, 1], default 0.0
phase_factor_random

Randomize rotation around the chosen orientation axis

Type:float in [0, 2], default 0.0
physics_type

Particle physics type

Type:enum in [‘NO’, ‘NEWTON’, ‘KEYED’, ‘BOIDS’, ‘FLUID’], default ‘NO’
react_event

The event of target particles to react on

Type:enum in [‘DEATH’, ‘COLLIDE’, ‘NEAR’], default ‘DEATH’
reactor_factor

Let the vector away from the target particle’s location give the particle a starting velocity

Type:float in [-10, 10], default 0.0
regrow_hair

Regrow hair for each frame

Type:boolean, default False
render_step

How many steps paths are rendered with (power of 2)

Type:int in [0, 20], default 0
render_type

How particles are rendered

Type:enum in [‘NONE’, ‘HALO’, ‘LINE’, ‘PATH’, ‘OBJECT’, ‘GROUP’, ‘BILLBOARD’], default ‘NONE’
rendered_child_count

Number of children/parent for rendering

Type:int in [0, 100000], default 0
rotation_factor_random

Randomize particle orientation

Type:float in [0, 1], default 0.0
rotation_mode

Particle orientation axis (does not affect Explode modifier’s results)

Type:enum in [‘NONE’, ‘NOR’, ‘NOR_TAN’, ‘VEL’, ‘GLOB_X’, ‘GLOB_Y’, ‘GLOB_Z’, ‘OB_X’, ‘OB_Y’, ‘OB_Z’], default ‘NONE’
roughness_1

Amount of location dependent rough

Type:float in [0, 100000], default 0.0
roughness_1_size

Size of location dependent rough

Type:float in [0.01, 100000], default 0.0
roughness_2

Amount of random rough

Type:float in [0, 100000], default 0.0
roughness_2_size

Size of random rough

Type:float in [0.01, 100000], default 0.0
roughness_2_threshold

Amount of particles left untouched by random rough

Type:float in [0, 1], default 0.0
roughness_curve

Curve defining roughness

Type:CurveMapping, (readonly)
roughness_end_shape

Shape of end point rough

Type:float in [0, 10], default 0.0
roughness_endpoint

Amount of end point rough

Type:float in [0, 100000], default 0.0
show_guide_hairs

Show guide hairs

Type:boolean, default False
show_hair_grid

Show hair simulation grid

Type:boolean, default False
show_health

Draw boid health

Type:boolean, default False
show_number

Show particle number

Type:boolean, default False
show_size

Show particle size

Type:boolean, default False
show_unborn

Show particles before they are emitted

Type:boolean, default False
show_velocity

Show particle velocity

Type:boolean, default False
simplify_rate

Speed of simplification

Type:float in [0, 1], default 0.0
simplify_refsize

Reference size in pixels, after which simplification begins

Type:int in [1, 32767], default 0
simplify_transition

Transition period for fading out strands

Type:float in [0, 1], default 0.0
simplify_viewport

Speed of Simplification

Type:float in [0, 0.999], default 0.0
size_random

Give the particle size a random variation

Type:float in [0, 1], default 0.0
subframes

Subframes to simulate for improved stability and finer granularity simulations (dt = timestep / (subframes + 1))

Type:int in [0, 1000], default 0
tangent_factor

Let the surface tangent give the particle a starting velocity

Type:float in [-1000, 1000], default 0.0
tangent_phase

Rotate the surface tangent

Type:float in [-1, 1], default 0.0
texture_slots

Texture slots defining the mapping and influence of textures

Type:ParticleSettingsTextureSlots bpy_prop_collection of ParticleSettingsTextureSlot, (readonly)
time_tweak

A multiplier for physics timestep (1.0 means one frame = 1/25 seconds)

Type:float in [0, 100], default 0.0
timestep

The simulation timestep per frame (seconds per frame)

Type:float in [0.0001, 100], default 0.0
trail_count

Number of trail particles

Type:int in [1, 100000], default 0
type

Particle Type

Type:enum in [‘EMITTER’, ‘HAIR’], default ‘EMITTER’
use_absolute_path_time

Path timing is in absolute frames

Type:boolean, default False
use_adaptive_subframes

Automatically set the number of subframes

Type:boolean, default False
use_advanced_hair

Use full physics calculations for growing hair

Type:boolean, default False
use_clump_curve

Use a curve to define clump tapering

Type:boolean, default False
use_clump_noise

Create random clumps around the parent

Type:boolean, default False
use_dead

Show particles after they have died

Type:boolean, default False
use_die_on_collision

Particles die when they collide with a deflector object

Type:boolean, default False
use_dynamic_rotation

Particle rotations are affected by collisions and effectors

Type:boolean, default False
use_emit_random

Emit in random order of elements

Type:boolean, default False
use_even_distribution

Use even distribution from faces based on face areas or edge lengths

Type:boolean, default False
use_global_dupli

Use object’s global coordinates for duplication

Type:boolean, default False
use_group_count

Use object multiple times in the same group

Type:boolean, default False
use_group_pick_random

Pick objects from group randomly

Type:boolean, default False
use_hair_bspline

Interpolate hair using B-Splines

Type:boolean, default False
use_modifier_stack

Emit particles from mesh with modifiers applied (must use same subsurf level for viewport and render for correct results)

Type:boolean, default False
use_multiply_size_mass

Multiply mass by particle size

Type:boolean, default False
use_parent_particles

Render parent particles

Type:boolean, default False
use_react_multiple

React multiple times

Type:boolean, default False
use_react_start_end

Give birth to unreacted particles eventually

Type:boolean, default False
use_render_adaptive

Draw steps of the particle path

Type:boolean, default False
use_render_emitter

Render emitter Object also

Type:boolean, default False
use_rotation_dupli

Use object’s rotation for duplication (global x-axis is aligned particle rotation axis)

Type:boolean, default False
use_rotations

Calculate particle rotations

Type:boolean, default False
use_roughness_curve

Use a curve to define roughness

Type:boolean, default False
use_scale_dupli

Use object’s scale for duplication

Type:boolean, default False
use_self_effect

Particle effectors affect themselves

Type:boolean, default False
use_simplify

Remove child strands as the object becomes smaller on the screen

Type:boolean, default False
use_simplify_viewport
Type:boolean, default False
use_size_deflect

Use particle’s size in deflection

Type:boolean, default False
use_strand_primitive

Use the strand primitive for rendering

Type:boolean, default False
use_velocity_length

Multiply line length by particle speed

Type:boolean, default False
use_whole_group

Use whole group at once

Type:boolean, default False
userjit

Emission locations / face (0 = automatic)

Type:int in [0, 1000], default 0
virtual_parents

Relative amount of virtual parents

Type:float in [0, 1], default 0.0

Inherited Properties

Inherited Functions

References