Krakatoa File ID Test¶
Available in: Krakatoa v1.1.0 and higher.
Overview¶
- The File ID Test can be used to compare values stored in the custom File ID channel created by the Krakatoa PRT Loader Birth or Krakatoa File Birth Operators to determine which particles have died on the current frame according to the particle sequence files being loaded.
- When the Krakatoa Birth operators load particle sequence files, they compare the ID channel of the file to be loaded with the ID channel of the particles already in the scene.
- If a particle does exist in the file but does not exist in the scene, it will be born.
- If a particle does not exist in the file but does exist in the scene, it must die so its File ID channel will be set to -1.
- The default settings of the File ID Test Operator will send out any particles that have an ID of -1 (and have thus “left” the sequence according to the file being loaded) - wiring the File ID Test to an Event containing a Delete operator will remove these particles from the flow.
- The test can also be used to split particles whose File ID channel is in a certain range by using the Less Than, Greater Than, Or and And options to specify a test range.
- For example, to split particles whose File ID (which is typically the Born ID from a saved Particle Flow) is between 100 and 542, you could check the “Greater Than” option, set its value to 100 and enter 542 in the Less Than field.
WARNING: Loading a particle file sequence containing duplicated IDs will affect all particles matching the ID range. For example, if two Particle Flow systems were saved to the same PRT file, resulting in more than one particle with the same ID, and you set the ID Test to send out particles with IDs between 0 and 100, BOTH sets of particles from the two PFlows in that ID range will be sent out.
