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 datablock

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

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 speed 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 [-300000, 300000], default 0.0

frame_start

Frame number to start emitting particles

Type:float in [-300000, 300000], 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, 300000], 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 speed

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

object_align_factor

Let the emitter object orientation give the particle a starting speed

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 speed

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

particle_factor

Let the target particle give the particle a starting speed

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, 1], 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 speed

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 guide hairs

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 speed

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

bpy_struct.id_data ID.name ID.users ID.use_fake_user ID.tag

ID.is_updated ID.is_updated_data ID.is_library_indirect ID.library

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_readonly bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys

bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.property_unset bpy_struct.type_recast bpy_struct.values ID.copy ID.user_clear ID.animation_data_create ID.animation_data_clear ID.update_tag

References

bpy.context.particle_settings BlendData.particles BlendDataParticles.new

BlendDataParticles.remove ParticleSystem.settings