Blizzard : GeometryClass

Constructor

blizzard ...

Note: This class is not available in 3D Studio VIZ.

Properties

Basic Parameters

<Blizzard>.Emitter_Width Float default: 0.0 -- animatable

The width of the emitter icon.

<Blizzard>.Emitter_Length Float default: 0.0 -- animatable

The width of the emitter icon.

<Blizzard>.emitterHidden Boolean default: false

When on, hides the emitter in viewports. When off, the emitter is displayed in viewports. The emitter is never rendered.

<Blizzard>.viewType Integer default: 0

Set the display icon for particles in the viewport:

0- Dots (Displays the particles as dots.)

1- Ticks (Displays the particles as crosses.)

2- Mesh (Displays the particles as mesh objects. This results in slower viewport redraws.)

3- Bbox (For instanced geometry only, this displays each instanced particle, whether a single object, a hierarchy, or a group, as a bounding box.)

<Blizzard>.viewPercent Float default: 10.0 -- percentage, alias: Percentage_Displayed

Sets the percentage of particles displayed in the viewport.

Particle Generation

<Blizzard>.quantityMethod Integer default: 0

Set the method by which the number of particles is determined over time:

0- Use Rate (Specifies a fixed number of particles emitted per frame.)

1- Use Total (Specifies a total number of particles formed over the life of the system.)

Tip: Generally, Use Rate is best for a continuous flow of particles, like a trail of pixie dust, while Use Total is better for bursts of particles over a short period of time.

<Blizzard>.Birth_Rate Integer default: 10 -- animatable

The number of particles emitted per frame.

<Blizzard>.Total_Number Integer default: 100

The total number of particles to be emitted.

<Blizzard>.speed Float default: 10.0 -- animatable

The velocity of the particle at birth, along the normal, in units traveled per frame.

<Blizzard>.Speed_Variation Float default: 0.0 -- animatable, percentage

Percentage of variation to the speed of emission for each particle.

<Blizzard>.tumble Float default: 0.0 -- animatable

Amount of random rotation of the particles.

<Blizzard>.Tumble_Rate Float default: 0.0 -- animatable

Speed at which the particles rotate.

<Blizzard>.Emitter_Start Time default: 0f

The frame at which particles begin to exist in the scene.

<Blizzard>.Emitter_Stop Time default: 30f

The last frame at which particles are emitted.

<Blizzard>.Display_Until Time default: 100f

Time at which all particles will disappear, regardless of other settings.

<Blizzard>.life Time default: 30f -- animatable

The lifespan of each particle from the time of creation.

<Blizzard>.Life_Variation Time default: 0f -- animatable

The number of frames by which the life of each particle can vary from the norm.

<Blizzard>.subsampleCreationTime Boolean default: false

When on, enables the addition of a time offset to the equations of motion that prevents puffing in time.

<Blizzard>.subsampleEmitterTranslation Boolean default: true

If the object-based emitter is moving in space, particles are created at integral times at positions along the geometry's path between renderable positions. This prevents puffing in space.

<Blizzard>.subsampleEmitterRotation Boolean default: true

If the emitter is rotating, turn this on to avoid puffing and produce smooth spiral effects.

<Blizzard>.size Float default: 1.0 -- animatable

The target size for all particles in the system.

<Blizzard>.Size_Variation Float default: 0.0 -- animatable, percentage

The percentage by which the size of each particle may vary from the norm.

<Blizzard>.Growth_Time Time default: 10f

The number of intervals over which the particle grows from being very small (0.1a system constant) to the Size value.

<Blizzard>.Fade_Time Time default: 10f

The number of intervals over which the particle will shrink to 1/10th its Size setting prior to its death.

<Blizzard>.seed Integer default: 0 -- alias: Random_Seed

By changing the Seed value, you achieve different results using otherwise identical particle settings.

Particle Type

<Blizzard>.particleType Integer default: 0

The type of particle emitted:

0- Standard Particle (Uses one of several standard particle types, such as triangle, cube, tetra, and so on.)

1- MetaParticles (Uses Metaball particles. These are particle systems in which the individual particles blend together in blobs or streams.)

2- Instanced Geometry (Generates particles that are instances of either an object, a linked hierarchy of objects, or a group.)

<Blizzard>.standardParticle Integer default: 0

standardParticle = 0 - Triangle; 1 - Cube; 2 - Special; 3 - Facing; 4 - Constant; 5 - Tetra; 6 - SixPoint; 7 - Sphere

<Blizzard>.Metaparticle_Tension Float default: 1.0 -- animatable

Determines the tightness of the particles, with regard to their tendency to blend with other particles. The higher the Tension, the harder the blobs, and the harder it is for them to merge.

<Blizzard>.Metaparticle_Tension_Variation Float default: 0.0 -- animatable, percentage

The percent of variation of the Tension effect.

<Blizzard>.metaballRenderCoarsness Float default: 0.5 -- alias: Metaparticle_Coarseness

The coarseness for metaparticles in the rendered scene.

<Blizzard>.metaballViewCoarsness Float default: 1.0

The coarseness for the viewport display.

<Blizzard>.metaballAutoCoarsness Boolean default: true

When this is on, the rendering coarseness is automatically set, based on the size of the particles, and the viewport coarseness is set to about twice that of the rendering coarseness.

<Blizzard>.Bubble_Amplitude Integer default: 0

Turns on/off One Connected Blob.

0- Off

1- On

<Blizzard>.instancingObject Node default: undefined

The object which is instanced.

<Blizzard>.instanceSubTree Boolean default: false

Turn this on when you want to include the linked children of the picked object in the particle. If the picked object is a group, all children of the group are included.

<Blizzard>.instanceKeyOffsetType Integer default: 0

Set the animation offset keying:

0- None (Each particle duplicates the timing of the original object. As a result, the animation of all particles will be identically timed.)

1- Birth (The firstborn particle is an instance of the current animation of the source object at the moment of that particle's birth. Each subsequent particle then use the same start time for the animation.)

2- Random (This option is the same as None when Frame Offset is set to 0. Otherwise, each particle is born using the same animation as the source object at the time of birth, but with a random offset of frames, based on the .instanceFrameOffset value.)

<Blizzard>.instanceFrameOffset Integer default: 0 -- alias: Animation_Offset_Amount

The property value is the UI value times the number of ticks per frame. The number of ticks per frame is accessible via the ticksPerFrame system global variable.

<Blizzard>.mappingType Integer default: 0

Specifies how a mapped material affects the particles:

0- Time (Maps particles over time.)

1- Distance (Maps particles over a distance.)

2- Emitter Fit Planar (Maps particles at birth, based on their point of emission from the rectangular Blizzard emitter icon. The UV range of the mapped material runs from 0 to 1 over the width and length of the emitter.)

<Blizzard>.Mapping_Time_Base Time default: 30f -- animatable

The number of frames from the birth of the particle that it takes to complete one mapping of the particle.

<Blizzard>.Mapping_Distance_Base Float default: 100.0 -- animatable

The distance, in units, from the birth of the particle that it takes to complete one mapping of the particle.

<Blizzard>.materialSource Integer default: 0

Updates the material carried by the particle system, using the source specified:

0- Icon (The particles use the material currently assigned to the particle system icon.)

1- Instanced Geometry (The particles use the material assigned to the instanced geometry.)

Rotation and Collision

<Blizzard>.Spin_Time Time default: 30f -- animatable

The number of frames for one rotation of a particle. If set to 0, no rotation takes place.

<Blizzard>.Spin_Time_Variation Float default: 0.0 -- animatable, percentage

The percent of variation of the Spin Time.

<Blizzard>.Spin_Phase Float default: 0.0 -- animatable, angle

The initial particle rotation, in degrees.

<Blizzard>.Spin_Phase_Variation Float default: 0.0 -- animatable, percentage

The percent of variation of the Phase.

<Blizzard>.spinAxisType Integer default: 0

The spin axis for the particles:

0- Random (The spin axis for each of the particles is random.)

1- User Defined (Uses a vector defined in the three X, Y, and Z spin vector values.)

<Blizzard>.X_Spin_Vector Float default: 1.0 -- animatable

Spin vector of the X-axis.

<Blizzard>.Y_Spin_Vector Float default: 0.0 -- animatable

Spin vector of the Y-axis.

<Blizzard>.Z_Spin_Vector Float default: 0.0 -- animatable

Spin vector of the Z-axis.

<Blizzard>.Spin_Axis_Variation Float default: 0.0 -- animatable, angle

The amount, in degrees, by which the spin axis of each particle may vary from the specified X Axis, Y Axis, and Z Axis settings.

<Blizzard>.Interparticle_Collisions_On Integer default: 0

Turn on/off interparticle collisions:

0- Off

1- On

<Blizzard>.Interparticle_Collision_Steps Integer default: 2

The number of intervals per rendering interval, during which an inter-particle collision test is conducted. The higher the value, the more accurate the simulation, but the slower the simulation will run.

<Blizzard>.Interparticle_Collision_Bounce Float default: 100.0 -- animatable, percentage

The degree to which speed is recovered after a collision.

<Blizzard>.Interparticle_Collision_Bounce_Variation Float default: 0.0 -- animatable, percentage

The percentage of random variation of the Bounce value, applied to the particles.

Object Motion Inheritance

<Blizzard>.motionInfluence Float default: 100.0 -- animatable, alias: Object_Motion_Inheritance

The percent of particles that inherit the motion of the object-based emitter at the moment of particle formation.

<Blizzard>.motionMultiplier Float default: 1.0 -- animatable, alias: Object_Motion_Multiplier

Modifies the amount by which the emitter motion affects the particle motion. This can be a positive or negative number.

<Blizzard>.motionVariation Float default: 0.0 -- animatable, percentage; alias: Object_Motion_Multiplier_Variation

Percentage of variation of the Multiplier value.

Particle Spawn

<Blizzard>.spawnType Integer default: 0

Determines what happens to particles at either collision or death:

0- None (Particles act as they normally would. That is, upon collision, they either bounce or stick, depending on Particle Bounce settings in the deflector, and on death they disappear.)

1- Die After Collision (Particles disappear when they strike a deflector to which they're bound, such as the SDeflector.)

2- Spawn on Collision (Spawn effects take place upon collision with a bound deflector.)

3- Spawn on Death (Spawn effects take place at the end of each particle's life.)

4- Spawn Trails (Particles are spawned from existing particles at each frame of that particle's life.)

<Blizzard>.Die__X_frames_after_collision Time default: 0f -- animatable

The life, in frames, that the particle will persist after the collision. Setting this to 0 (the default) causes particles to vanish immediately after the collision.

<Blizzard>.Die__X_frames_after_collision_variation Float default: 0.0 -- animatable, percentage

Varies the Persist value of each particle, when Persist is greater than 0. This lets you "feather" the dying off of the particle density.

<Blizzard>.Spawn_Affects Integer default: 100

The percentage of particles that will spawn. Reducing this reduces the number of particles that produce spawned particles.

<Blizzard>.Spawn_Multiplier_Variation Float default: 0.0 -- percentage

Percentage range by which the Multiplier value will vary, frame by frame.

<Blizzard>.Spawn_Direction_Chaos Float default: 0.0 -- animatable

The amount by which the direction of the spawned particle can vary from the direction of the parent particle. A setting of 0 means no variance. A setting of 100 causes the spawned particle to travel in any random direction. A setting of 50 causes the spawned particle to deviate from its parent's path by up to 90 degrees.

<Blizzard>.Spawn_Speed_Chaos Float default: 0.0 -- animatable

The range of a percentage of change in the speed of the spawned particle relative to its parent. A value of 0 means no change.

<Blizzard>.spawnSpeedType Integer default: 0

Sets the type of speed applied to spawn particles:

0- Slow (Applies the .spawn_Speed_Chaos value randomly to slow the speed of the spawned particles.)

1- Fast (Randomly speeds up particles based on the .spawn_Speed_Chaos value.)

2- Both (Some particles speed up, while others slow down, based on the .spawn_Speed_Chaos value.)

<Blizzard>.spawnInheritVelocity Boolean default: false

When on, spawned particles inherit the speed of their parents, in addition to the effect of the .spawn_Speed_Chaos value.

<Blizzard>.spawnSpeedFixed Boolean default: false

When on, uses the .spawn_Speed_Chaos value as a set value, rather than as a range applied randomly to each particle.

<Blizzard>.lifespanValueQueue Array default: #()

lifespanValueQueue is an array of integers which correspond to lifespan values for each spawned generation of particles.

<Blizzard>.objectMutationQueue Array default: #()

objectMutationQueue is an array of nodes which correspond to instanced-object particle types. Each generation of spawning will use the next node as its object type.