Input mParticles Suboperator

The Input mParticles suboperator is for reading data from the MassFX engine when creating custom Particle Flow operators. This feature is intended for use with the Data operators.

Interface

Apply Anti-Gravity
This data channel reflects whether the anti-gravity effect from a mParticles Switch operator was applied to a particle. Input mParticles suboperator just reads these data; the data are set by either Output mParticles suboperator, or by mParticles Switch operator.
Collision Registration
To get the data flowing into the Data operator, you need to turn on Report To Data Operator in a mParticles Collision or mParticles InterCollision test. Also, these tests must come before the Data Operator in the event. The options are:
  • Collided Reports whether a particle collided with other particles or a deflector(s) in the current frame (more precisely, the current integration step).
  • # Collisions Provides the number of times a particle collided with anything in the current integration step. The latter option works properly only if you use the Collided Multiple Times option in mParticles Collision and/or mParticles InterCollision tests.

With either option, choose from the drop-down list to specify whether the data reports collisions with deflectors or with other particles.

Force
Reads a force value either calculated by a mParticles Force operator or defined by an Output mParticles suboperator.
Force Influence
Reads force influence value that is defined either by a mParticles Force operator or an Output mParticles suboperator.
Interpenetration Tolerance / Mass
Reads values defined either by a mParticles Shape operator or an Output mParticles suboperator.
Match
Reads different check box values defined by a mParticles Switch operator. Keep in mind that the Output mParticles suboperator can also define these data. The choices are Position, Rotation, Speed, Speed Limit, Spin, and Spin Limit.
Test Immunity
Reads values defined by an Output mParticles suboperator. The data in this Boolean data channel are used by mParticles tests (mParticles Collision, mParticles InterCollision, and mParticles Glue) to suspend particles in their current event even if they test as True and would normally be redirected to the next event.
Sleep Thresholds
Reads sleep threshold values as defined either by mParticles World driver or an Output mParticles suboperator.
Torque
Similar to the Force option (see preceding), reads the torque value either calculated by a mParticles Force operator or defined by an Output mParticles suboperator.
Turn Off Simulation
Reflects whether the simulation is off for a particle—in effect, its kinematic status. The Input mParticles suboperator simply reads these data; the values are set either by the Output mParticles suboperator or by a mParticles Switch operator.