Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This extension is a geometry modifier. It loads a particle file, or reads particles stored internally and creates instances of the selected geometry at the particles positions.

Example of how to create a MaxwellCloner object, add a uv channel, set its custom type to "Density" and enable loading the particle densities arraymodifier, and apply it to an already existing object in the scene.

Code Block
languagecpp
linenumberstrue
CextensionManager* extensionManager = CextensionManager::instance();
CgeometryModifierExtension* geomModifExtension = extensionManager->createGeometryModifierExtension( "MaxwellCloner" );
//Get the extension container. When using this method of getting the container,
//nearly all parameters have default values, and there is no need to explicitly set them.
MXparamList* clonerParams = geomModifExtension->getExtensionData();

//Fill the required data
char* filename = "/home/rocco/Emitter01_00023.bin";
clonerParams->setString( "FileName", filename );

//Get the object we want to clone
Cmaxwell::Cobject mxObject = scene->getObject( "MyGeometry" );
isOk = mxObject.applyGeometryModifierExtension( clonerParams );

...

Name

Type

Description

"FileName"

char*

Particles filename

"Radius Factor"

float

Particle radius multiplier

"MB Factor"

float

Motion blur multiplier

"Shutter 1/"

float

Camera shutterspeed

"Load particles %"floatPercentage of particles to load
" Start offset"unsigned intSkip some particles before loading
"Create N particles per particle"unsigned intEnables Multipoint feature if N > 0
"Extra particles dispersion"floatDispersion of the extra particles cloud
"Extra particles deformation"floatDeformation of the extra particles cloud
"Load particle ForceUse velocity"byteLoad or not array of Force vectors
"Min Force"floatMinimum force modulus value
"Max Force"floatMaximum force modulus value
"Load particle Vorticity"byteLoad or not array of Vorticity vectors
"Min Vorticity"floatMinimum vorticity modulus value
"Max Vorticity"floatMaximum vorticity modulus value
"Load particle Normal"byteLoad or not array of Normal vectors
"Load particle neighbors no."byteLoad or not array of particle neighbors#
"Min Nneighbors"unsigned intMinimum number of neighbors value
"Max Nneighbors"unsigned intMaximum number of neighbors value"Max Nneighbors"
"Load particle UV"byteLoad or not array of particle UV
"Load particle Age"byteLoad or not array of particle Age
"Min Age"floatMinimum age value
"Max Age"floatMaximum age value
"Load particle Isolation Time"byteLoad or not array of particle isolation time
"Min Isolation Time"floatMinimum isolation time value
"Max Isolation Time"floatMaximum isolation time value
"Load particle Viscosity"byteLoad or not array of particle viscosity
"Min Viscosity"floatMinimum viscosity value
"Max Viscosity"floatMaximum viscosity value
"Load particle Density"byteLoad or not array of particle density
"Min Density"floatMinimum density value
"Max Density"floatMaximum density value
"Load particle Pressure"byteLoad or not array of particle pressure
"Min Pressure"floatMinimum pressure value
"Max Pressure"floatMaximum pressure value
"Load particle Mass"byteLoad or not array of particle mass
"Min Mass"floatMinimum mass value
"Max Mass"floatMaximum mass value
"Load particle Temperature"byteLoad or not array of particle temperature
"Min Temperature"floatMinimum temperature value
"Max Temperature"floatMaximum temperature value
"Load particle ID"byteLoad or not array of particle IDUse the velocity vector to as Y axis of the instance
"Scale with particle radius"byteScale instances with particle radius
"PARTICLE_POSITIONS"float*Array of particle positions
"PARTICLE_SPEEDS"float*Array of particle speeds
"PARTICLE_RADII"float*Array of particle radii
"PARTICLE_IDS"int*

Array of particleID's

 

 

UV Generators

NameIndex
"Particle UV"0
"Particle UW"1
"Particle VW"2
"Velocity Modulus"3
"Velocity Vx"4
"Velocity Vy"5
"Velocity Vz"6
"Velocity Vx Vy"7
"Velocity Vx Vz"8
"Velocity Vy Vz"9
"Force Modulus"10
"Force Fx"11
"Force Fy"12
"Force Fz"13
"Force Fx Fy"14
"Force Fx Fz"15
"Force Fy Fz"16
"Vorticity Modulus"17
"Vorticity wx"18
"Vorticity wy"19
"Vorticity wz"20
"Vorticity wx wy"21
"Vorticity wx wz"22
"Vorticity wy wz"23
"Normal Nx"24
"Normal Ny"25
"Normal Nz"26
"Normal Nx Ny"27
"Normal Nx Nz"28
"Normal Ny Nz"29
"No. neighbors"30
"Age"31
"Isolation Time"32
"Viscosity"33
"Density"34
"Pressure"35
"Mass"36
"Temperature"37
"ID"

38

 

"FileName"

Name of the file that contains particles data. It is a NULL terminated string.

...

Code Block
languagecpp
float percent = 75.f; 
extParam->setFloat( "Load particles %", percent );

"Start offset"

Skip N particles when loading.

Example:

Code Block
languagecpp
unsigned int nOff = 10;
extParam->setUInt( "Start offset", nOff );

 

"Create N particles per particle"

...

Code Block
languagecpp
float deformation = 1.1f;
extParam->setFloat( "Extra particles deformation", deformation );


"

...

Use velocity"

Use the particle velocity vector as the Y (up) axis of the instanced geometry.

Example:

Code Block
languagecpp
byte useVel = 1;
extParam->setByte( "Use velocity", useVel );


"Scale with particle radius"

Scale the instanced geometry with the particle radius.

Example:

Code Block
languagecpp
byte loadArrayuseRad = 1;
extParam->setByte( "LoadScale with particle Viscosityradius", loadArrayuseRad );

"Min Force" "Max Force" "Min Vorticity" "Max Vorticity" "Min Nneighbors" "Max Nneighbors" "Min Age" "Max Age" "Min Isolation Time" "Max Isolation Time" "Min Viscosity" "Max Viscosity" "Min Density" "Max Density" "Min Pressure" "Max Pressure" "Min Mass" "Max Mass" "Min Temperature" "Max Temperature"

...


"PARTICLE_POSITIONS"

Particle data can come whether in a file or internally stored in the .mxs file. If a filename is not supplied, the extension checks for internal data, and if successful, loads it. This parameter is a linear array of floats x0 y0 z0 x1 y1 z1 x2 y2 z2 x3 y3 z3 x4 y4 z4 ...., its length is 3*numberOfParticles.

...