Difference between revisions of "IC Python API:PopcornFX Sequencer"

Latest revision as of 20:31, 8 March 2020

Main article: RL Python Samples.

Demo Video

Description

PopcornFX Sequencer Demo plug-in can be used to easily and intuitively manage PopcornFX particle emit time and loop status without using the timeline. You can drag/drop selected particles to the item list, change their emit order, set delay time, toggle loop status, or set the custom life cycle for each particle. Press the Apply button to deploy the particles to the scene and apply the custom settings.

The demo version of PopcornFX Sequencer is mentioned in this article. For the fully featured paid version please visit the Reallusion Market Place. The differences between the two version are listed below:

Course Prerequisites

You should familiarize yourself with the following fundamental articles before you proceed:

Takeaway Lessons

• Learn to use PopcornFX related API.
• Handle AP event callbacks to update UI.
• Use Python dictionary to store settings for each particle.

Required Files

• PopcornFX Sequencer and Extensions Python script files.
• Installed PopcornFX particles, either from embedded content or store bought content packs.

You can buy the full version of this plugin from the Reallusion Marketplace. To acquire and view the source code for the demo version, please visit Reallusion GitHub.

Usage Instructions

1. Clone or download the Reallusion/iClone GitHub.
2. Copy PopcornFX_Sequencer_Demo folder into the iClone install directory > ...\Bin64\OpenPlugin.
3. Load the script into the project from the menu: Plugins > Python Samples > PopcornFX Sequencer (Demo).
4. After loading some PopcornFX particles into the scene, the particles list will be filled with all of the existing particles in the scene.
5. Use drag and drop to reorder the list of particles. You can also use the checkbox to decide which particle will participate in the sequencer script.
6. Next, use the UI below to adjust the emit time and looping for every participating particle.
   • Delay with Previous Emitter is used to delay the current particle's emit time from the previous particle emit time. If this setting is 0, then the current particle will emit at the same time as the previous particle.
   • Auto Loop and Custom Life Cycle are mutually exclusive functions.
     • When Auto Loop is activated, the particle emit in a loop. Loop Interval determines the duration of each loop cycle. Be aware that this attribute is not emission frequency, because loops are inherently infinite ).
     • Custom Life Cycle can be used to customize the interval between multiple emissions.
7. Click on the Apply button to apply all of the settings to the particles as timeline keys and playback the project.
8. Clear Key can be used to remove all of the particle keys set by the sequencer script.

Code Flow

APIs Used

You can research the following references for the APIs deployed in this code.

main.py

Extensions.py