Act Randomizer v2 Plugin Usage Guidance ============================================ Attach the ActRandomizer2 plugin to any Atom and open the Custom UI for the plugin. The UI is split into two sections, the left side controls the randomizer and allows Acts to be added and removed. The right side of the UI allows you to setup each individual Act. An "Act" consists of a start action followed by an end action after a configurable time delay. Note ActRandomizer2 is not backwardly compatible with scenes saved with ActRandomizer. Right-side UI controls for Act setup are as follows: - Act: Select which Act you wish to edit from the drop down list. All other right-side UI controls will be refreshed with values for the chosen Act. - Probability Weighting: Select a weighting that will control the probability of this Act being randomly selected. An Act with a weighting of 2 will be twice as likely to be randomly select as an Act with a 1 weighting. An Act with a weighting of 0.5 will be half as likely to be randomly selected as an Act with a 1 weighting. - Atom/Receiver/Target (Start Act): These three controls allow you to choose any VAM or plugin action, boolean value (e.g. on/off controls), state chooser (e.g. clothing states) or audio action. The chosen item will be executed (or changed) when the Act is randomly selected. - Target Value (Start Act): Depending on the Atom/Receiver/Target chosen this control will allow you to set a value. The options for selecting value will vary depending on the type of target. The supported target types are: + Boolean action: A tick box will allow you to set True or False. + An audio action (e.g. Play Now): the control will allow you to select an Audio Category and then an Audio Clip. + Value Selector (e.g. Node State option of On, Off, Comply, Hold etc.): a drop down list of selectable options + Float value (e.g. Light intensity): A slider to choose a value is presented + URL (e.g. texture file or a jpg for an image panel): Select a file from the folders + Action (e.g. Pause an animation pattern): No - Receiver Group: For person atoms, the Receivers are organised into Groups. In addiition under the Other Group there are some special targets that allow the Loading of Looks, Poses and all Preset and actions to merge load clothing presets and reset clothing physics etc. - Min/Max Act Duration: this control configures the delay between the start action and the end action of this Act. If Min and Max values are different, then a random delay between the two values will be selected. For Animation Patterns and Audio, these values will default to the duration of those items. - Atom/Receiver/Target (End Act): These three controls allow you to choose any VAM or plugin action. The chosen item will be executed after the Duration determined by the Min/Max Act duration controls when an Act is randomly selected. For an End Act an additional option of NO ACTION is always available. - Target Value (End Act): see Target Value Start Act description above. - Test Act: this button allows you test the Act. It will only execute if the randomizer is not currently started. - Hide Save & Restore actions: This toggle hides a number of standard Save & Restore Targt actions that are on every VAM control but are not likely to be needed for Act Randomization. This just declutters the Act setup process. Left-side UI controls are as follows: - Start / End Act / End Gap: this button is pressed once to Start randomly playing the Acts. Once playing the button function will switch to either end the current Act (the end Action for the current Act will be executed if pressed) or end the current Gap between Acts. If the Loop Acts toggle in On then, the randomizer will progress to the next randomly selected Act. - Halt: this button will halt the randomizer. If an Act is in progress, then the end action will be played for that Act before halting. - Loop Acts: this toggle will determine whether the randomizer will repeatedly play random acts or just play a single Act. - Enable Auto Start on Scene Load: this toggle will start the randomizer automatically on Scene Load - Min/Max Act Gap Duration: this control configures a delay between each Act. If Min and Max values are different, then a random delay between the two values will be selected. - Min # Acts between repeats: this prevents the same Act being randomly selected multiple times in a row. It specifies the number of other Acts that must be played before each Act can be repeated. - Randomizer Status: an information box that gives the current status of the Randomizer. - Add Act: this button adds a new Act that can be selected in the Right-side controls - Copy Act: this creates a new Act that is a copy of the currently selected Act in the Right-side controls - Delete Act: this button deletes the Act currently selected in the right-side controls - Add Pre-Act Action: this button adds a special entry to the Act list, which will allow a single Action to be configured. This Pre-Act action will execute before the start of every Act. - Add Post-Act Action: this button adds a special entry to the Act list, which will allow a single Action to be configured. This Post-Act action will execute after the end of every Act. - Bulk Operation/Target: these controls allow various Bulk operations to be performed as follows: - Load Audio To: this operation will create a new Act for each Audio item loaded into the scene. The target control will allow you to specify which Audio source will be the target for every created Act. - Load Pixie Audio To: this operation will create a new Act for each of the Pixie audio clips under FemMoans category. - Load Visemes From: this operation will create a new Act for every Speak action created by the Viseme Aligner v2 plugin. The target control will allow you to select a Person who has that plugin loaded. - Load Images To: this operation can be applied to ImagePanel atoms and will allow a folder to be selected. All jpg files in the folder will be set up as an Act to be loaded on the selected Image panel. - Copy Acts From: this operation will copy all Acts from another ActRandomizer plugin. The target control will list all ActRandomizer plugins in the current scene. - Change : there will be multiple instances of this Bulk Operation - one for every Atom selected in the Acts. It allows the Atom Name to be changed to a different Atom for all Acts. It could be used, for example, with Copy Acts From operation to duplicate a set of Acts and the apply them to a different Person atom. - Execute Bulk Operation: this button will execute the Bulk Operation selected. - Select Import Scene: Acts can be imported from another scene containing an ActRandomizer2 plugin. Select the scene save file using the browser displayed when this button is pressed - Act Rndmizer Plugin: Once an import scene has been selected this will display all ActRandomizer2 plugins in that save file. - Import Acts from Scene: Each Act in the selected external scene and plugin will be re-created as an Act in the current plugin and scene. - Disable Time Scale for Act Duration: this option determines whether the time of each act is impacted by the Time Scale setting on the VAM UI. For Acts that are affected by TimeScale (such as Animation Patterns) this should not be disabled but for Acts that play Audio (which is not slowed by Time Scale) it should be disabled.