Scripted Position Test Example

Description:

The following example uses Script_Test actions to implement scripted position tests with both relative offset and absolute position options.

Can Be Used With:

The two scripts must be used inside the Script_Test : Helper actions.

Effect:

The PF_Source generates particles which get tested for relative offset of -100 to their birth position along the Z axis.
If they pass the scripted offset test, the particles are moved to the second Event which stops them and tests them for Age above 30.
If they pass the Age Test, the particles are moved to the Third event which tests them for absolute offset of -200 along the world Z axis using the second script.
If they pass the scripted position test, the particles are moved to the last Event which stops them.

SCRIPT 1

--The ChannelsUsed handler defines the channels
--to be made available to the script.
--For the list of all channels, see
--Interface: MaxscriptParticleContainer
--The parameter pCont passed to the handler
--contains the Particle Container the script is applied to
on ChannelsUsed pCont do
(
pCont.useTime = true
pCont.usePosition = true
)
 
--The Init handler is called on initialization.
--In this case, it is used to define the offset parameters
on Init pCont do
(
--Data paramters definition
struct paramsStruct (cond_less, axis, testpos, offset)
global paramsData = paramsStruct()
 
--true means less than, false means greater then
paramsData_offset.cond_less = true
--Axis option: x=1, y=2, z=3
paramsData_offset.axis = 3
--When set to true, the offset test is relative
--When set to false, the offset test is absolute.
paramsData_offset.offset = true
--Set the offset value to test for
paramsData_offset.testpos = -100
 
-- collects initial pos of each particle for offset test
global pos_init_array =#()
)
 
--In the Proceed handler, the actual testing is performed
 
on Proceed pCont do
(
count = pCont.NumParticles()
 
for i in 1 to count do
(
pCont.particleIndex = i
-- get ID of active particle
id = pCont.getParticleID pCont.particleIndex
if paramsData.cond_less == true then
(
if paramsData.offset == true then
(
-- collect initial pos for new born particle
if pCont.particleNew == true then
append pos_init_array pCont.particlePosition[paramsData.axis]
pos_id = pCont.GetParticlePositionByID id
if pos_id[paramsData.axis] < (pos_init_array[id] + paramsData.testpos) then
 testSatisfied = true
)
else
(
if pCont.particlePosition[paramsData.axis] < paramsData.testpos then
testSatisfied = true
)
)
else
(
if paramsData.offset == true then
(
-- collect initial pos for new born particle
 if pCont.particleNew == true then
append pos_init_array pCont.particlePosition[paramsData.axis]
pos_id = pCont.GetParticlePositionByID id
 if pos_id[paramsData.axis] > (pos_init_array[id] + paramsData.testpos) then
testSatisfied = true
)
else
(
 if pCont.particlePosition[paramsData.axis] > paramsData.testpos then
testSatisfied = true
)
)
if testSatisfied == true then
(
pCont.particleTestStatus = true
pCont.particleTestTime = pCont.particleTime
)
)
)
 
on Release pCont do
(
)

SCRIPT 2

on ChannelsUsed pCont do
(
pCont.useTime = true
pCont.usePosition = true
)
on Init pCont do
(
--Data paramters definition
struct paramsStruct (cond_less, axis, testpos, offset)
global paramsData = paramsStruct()
 
--true means less than, false means greater then
paramsData.cond_less = true
 
--Axis option: x=1, y=2, z=3
paramsData.axis = 3
--When set to false, the offset test is absolute.
--When set to true, the offset test is relative
paramsData.offset = false
--Set the position value to test
paramsData.testpos = -200
 
-- Collects initial pos of each particle for offset test:
global pos_init_array =#()
)
 
--The Proceed handler is identical to the one in the first script.
--Only the test parameters defined in the Init handler alter the
--behavior of the script!
 
on Proceed pCont do
(
count = pCont.NumParticles()
 
for i in 1 to count do
(
pCont.particleIndex = i
-- get ID of active particle
id = pCont.getParticleID pCont.particleIndex
if paramsData.cond_less == true then
(
if paramsData.offset == true then
(
-- collect initial pos for new born particle
if pCont.particleNew == true then
append pos_init_array pCont.particlePosition[paramsData.axis]
pos_id = pCont.GetParticlePositionByID id
if pos_id[paramsData.axis] < (pos_init_array[id] + paramsData.testpos) then
 testSatisfied = true
)
else
(
if pCont.particlePosition[paramsData.axis] < paramsData.testpos then
testSatisfied = true
)
)
else
(
if paramsData.offset == true then
(
-- collect initial pos for new born particle
if pCont.particleNew == true then
append pos_init_array pCont.particlePosition[paramsData.axis]
pos_id = pCont.GetParticlePositionByID id
if pos_id[paramsData.axis] > (pos_init_array[id] + paramsData.testpos) then
testSatisfied = true
)
else
(
if pCont.particlePosition[paramsData.axis] > paramsData.testpos then
testSatisfied = true
)
)
if testSatisfied == true then
(
pCont.particleTestStatus = true
pCont.particleTestTime = pCont.particleTime
)
)
)
 
on Release pCont do
(
)