Birth_Texture : Helper

Birth_Texture - superclass: helper; super-superclass:node -37:0 - classID:#(1395943176, 515064320) 

Value > MAXWrapper > Node > Helper > Birth_Texture

 

   

Particle Flow - Quick Navigation

Description:

The Birth_Texture operator uses an animated texture to calculate the timing, location, and scale of particles. In general, Birth_Texture causes particles to emit from the object where the texture is white or a bright color.

The Birth_Texture operator was first added to 3ds Max as part of the Creativity Extension to 3ds Max 2009 and became an integral part in 3ds Max 2010. It was previously available in the Particle Flow Tools Box #1.

   

Constructor:

Birth_Texture... 

   

Properties:

Particle Flow User Interface

<Birth_Texture>.Emit_Start: integer 

Get/set the Emit Start value defining the frame at which the operator begins emitting particles.

   

<Birth_Texture>.Emit_Stop: integer 

Get/set the Emit Stop value defining the frame at which the operator stops emitting particles. The exact timing of start and stop may vary due to the timing of individual particles, which is dependent on the emitter's animated texture.

   

<Birth_Texture>.Lock_On_Emitter: boolean 

Get/set the state of the Lock On Emitter option.

When set to true, it causes all particles’ pivot points to be "glued" to the painted objects. The option tells the Birth Texture operator to continue controlling particle position even after the particles are born.

   

Modifier Panel User Interface

Quantity:

<Birth_Texture>.Emission_Type: radiobtnIndex 

Get/set the selection index of the Quantity Type radio buttons.

Possible values are:

0 - Amount (default)

1 - Max.Rate

2 - Separate

   

<Birth_Texture>.Maximum_Amount: integer 

Get/set the Amount value used when .Emission_Type is set to 0.

   

<Birth_Texture>.Maximum_Rate: float 

Get/set the Max.Rate value used when .Emission_Type is set to 1.

   

<Birth_Texture>.Separate_Distance: worldUnits 

Get/set the Separate value used when .Emission_Type is set to 2.

   

<Birth_Texture>.Adjust_Separation_By_Scale_Factor: boolean 

Get/set the state of the Adjust By Scale Factor checkbox used when .Emission_Type is set to 2.

   

<Birth_Texture>.Use_Subdivision: boolean 

Get/set the state of the Subdivide checkbox.

   

<Birth_Texture>.Subdivision_Length: worldUnits 

Get/set the Subdivide value.

   

<Birth_Texture>.Amount_Limit: integer 

Get/set the Amount Limit value.

   

Timing:

<Birth_Texture>.Data_Start: integer 

Get/set the Start value.

   

<Birth_Texture>.Data_Stop: integer 

Get/set the Stop value.

   

<Birth_Texture>.Delay_Variation: integer 

Get/set the Delay Var. value.

   

<Birth_Texture>.Use_Latency: boolean 

Get/set the state of the Latency checkbox.

   

<Birth_Texture>.Latency: integer 

Get/set the Latency value.

   

<Birth_Texture>.Precision: integer 

Get/set the selection index of the Precision drop-down list.

Possible values are:

0 - Frame

1 - Half Frame

2 - 1/4 Frame

3 - 1/8 Frame

   

Emission By:

<Birth_Texture>.Emission_By: integer 

Get/set the selection index of the Emission By drop-down list.

Possible values are:

0 - Material (default)-Gathers colors from the emitter's material.

1 - Sub-Material -Gathers colors from a single sub-material, and generates particles only on faces with the specified sub-material ID (Material ID). The sub-material ID is set by the Sub-Mtl ID parameter.

2 - Sub-Mtl Global -Gathers colors from a single sub-material, and generates particles over the entire emitter surface regardless of the faces' Material IDs. The sub-material ID is set by the Sub-Mtl ID parameter.

3 - Vertex Color -Gathers colors from the Vertex Color channel.

4 - Vertex Alpha -Gathers colors from the Vertex Alpha channel.

5 - Vertex Illum -Gathers colors from the Vertex Illum channel.

6 - Mapping -Gathers colors from a mapping channel. A mapping channel can be used by the Vertex Paint modifier to color vertices. The mapping channel index is defined by the Channel parameter.

   

<Birth_Texture>.Emission_RGB_Channels: boolean array 

Get/set the states of the R, G and B checkbuttons as an array of Booleans.

   

<Birth_Texture>.Emission_Texture_SubMaterial_ID: integer 

Get/set the Sub-Mtl ID value.

   

<Birth_Texture>.Whiteness: percent 

Get/set the Whiteness % value.

   

Emitter Objects:

<Birth_Texture>.Emitter_Objects: node array 

Get/set the array of emitter objects.

   

<Birth_Texture>.Animated_Shape: boolean 

Get/set the state of the Animated Emitters checkbox.

   

<Birth_Texture>.Surface_Normal_Offset: boolean 

Get/set the state of the Surface Normal Offset checkbox.

   

<Birth_Texture>.Surface_Offset_Minimum: worldUnits 

Get/set theOffset Min. value.

   

<Birth_Texture>.Surface_Offset_Maximum: worldUnits 

Get/set the Offset Max. value.

   

Scale Factor:

<Birth_Texture>.Scale_Type: integer 

Get/set the selection index of the Scale By drop-down list.

Possible values are:

0 - None (default) - No particle scaling is set.

1 - Sub-Material - Uses a single sub-material to set the scale, and uses this scale over the entire emitter surface regardless of the faces' Material IDs. The sub-material ID is set by the Sub-Mtl ID parameter.

2 - Vertex Color - Uses the Vertex Color channel to define particle scale.

3 - Vertex Alpha - Uses the Vertex Alpha channel to define particle scale.

4 - Vertex Illum - Uses the Vertex Illum channel to define particle scale.

5 - Mapping -Defines particle scale with a mapping channel that is used for vertex coloring by the Vertex Paint modifier. The mapping channel index is defined by the Channel parameter.

   

<Birth_Texture>.Scale_Factor_SubMtl_ID: integer 

Get/set the SubMat ID value.

   

<Birth_Texture>.Black_Scale: percent 

Get/set the Black Scale % value.

   

<Birth_Texture>.White_Scale: percent 

Get/set the White Scale % value.

Display:

   

<Birth_Texture>.Show_Particles: boolean 

Get/set the state of the Show Particles checkbox.

   

<Birth_Texture>.Display_Type: radiobtnIndex 

Get/set the selection index of the Display Type radio buttons.

Possible values are:

0 - All

1 - By Timing (default)

   

<Birth_Texture>.Show_Only_When_Selected: boolean 

Get/set the state of the Only When Selected checkbox.

   

<Birth_Texture>.Icon_Size: worldUnits 

Get/set the Icon Size value.

   

<Birth_Texture>.Color_Coordinated: boolean 

Get/set the state of the Color Coordinated checkbox.

   

Uniqueness:

<Birth_Texture>.Random_Seed: integer 

Get/set the Seed value.

   

Others:

<Birth_Texture>.Fast_Approximate_Separation: boolean 

   

Birth_TextureInterfaces:

Interface: BirthTextureOperator 

Methods:

<void>initialize() 

Initializes the Birth Texture operator. Equivalent to pressing the "Initialize Particle Emission" button in the Modify Panel UI.

   

The following common Interfaces are exposed by the Birth_TextureClass:

Interface: action

Interface: operator

Interface: PViewItem

See Also