Editor – Actions Tab

Actions are the tools IMVU Creators use to piece Animations and sounds together in their product.
This tutorial covers how to use the Actions tab in the Create Mode Editor.
This tutorial assumes you have already read the Create Mode Introduction and the Editor Introduction.

The IMVU Action System

It is always good to know the following rules of how an IMVU Action works:


- An Action can include a single sound.

- An Action can also be a collection of one or more Ensembles and a few rules that the Ensembles follow.

- The trigger name supplied in an Action dictates whether the action is an Idle or a triggered action.

- An Ensemble contains the actual Animation Assets and the rules that those Assets follow

- There can be multiple Actions of the same name. For example, there can be multiple Actions named stance.Idle

- There can be multiple Ensembles in each Action.


The Actions Tab

All Actions are found in the Action Tab in the Editor.


Add Action: Empty Slate

When you first enter an empty Action tab, you will see something like this:


Add Action

The first step towards creating an Action is to click the 'Add' button. This will create a new, blue panel entitled 'Action 0' and a new, red panel entitled 'Ensemble 0'. Every time you create a new Action, one Ensemble will be automatically added to the Action. Each Action you add from now on will ascend in number and this number will be evident in the action name, 'Action 1', Action 2', and so on.


The Action and Ensemble names begin at '0' vs. '1'.

Actions do not necessarily need Ensembles in order to work (like sound Actions). However, the vast majority of them do need an Ensemble so we added it automatically.



Action Panel Detials: Action Parameters
Here are the details of the Action Maker:

Play - At the top right of the panel is the Play button. Clicking this button after you click the Apply Changes button will cause your action to play. This allows you to test your Actions before submitting them to the IMVU catalog.

Remove Action - Clicking this will remove the Action you are currently viewing.

Action parameters
The first panel in the Actions tab is called 'Action Parameters'. Like all panels in the Editor, this can be collapsed or expanded and the Editor will remember your settings in between edit sessions. The Parameters in this panel are the most used Parameters in the Action panel.

Trigger: This field is where you type in the word or words that will cause the Action to play. A Trigger word can be anything you like. When that word is typed in the IMVU messenger, the Action will play. An Action that does not contain a Trigger word will not play. Trigger words can also be named after Idle or Stance Animations. To learn more, please consult the Avatar Actions Introduction Tutorial.

You can have multiple words Trigger one Action. To achieve this, you add a comma separated list of words such as, "ha, haha, heh, har, hardy, lol".

Type: The type field is where you tell the Action whether it ought to apply to an Avatar Skeleton or, in the case of Rooms, Furniture or Accessories, or finally the Skeleton of the product you're editing. The two options you have in this drop down menu are 'Avatar' or 'Room'. The 'Room' choice is good for Rooms, Furniture and Accessories. In order for your Action to work properly, you must choose a 'Type'.

# of ensembles played: This field tells the Action how many Ensembles it ought to play. If you want the Action to loop forever, you type '0' in this field. If you want the Action to play once, just type in '1'.

After playing: This drop down menu tells the Action what it ought to do after playing an Ensemble. You have three choices:

Pick new Ensemble This option tells the Action to randomly choose a new Ensemble to play next.
Pick same Ensemble This option tells the Action to play the same Ensemble repeatedly.
Cycle through Ensembles This option tells the Action to play the next Ensemble in the sequence. This option is used mostly to test that all of the Ensembles are actually working as designed.


Action Panel Details: Sound .ogg file

An Action can contain a sound as well as Animation Assets. In fact, an Action can contain ONLY a sound as well. The sound is just Triggered by a Trigger word like any other Action. Currently, IMVU supports only sound files in the .OGG file format. Regardless of how long your .ogg file is, IMVU restricts the length of play to 20 seconds.


Add .OGG - Click to find and add your OGG file.

Delete - CLick this if you want to remove an OGG file from an Action.

Loop - Clicking this checkbox allows your sound to play indefinitely. This is really handy for background sound effects in Room products.

Delay (secs) - Unless otherwise specified, an Action plays an embedded sound immediately. Specifying a time value in this field delays the start time of the sound by that many seconds. NOTE: fractions are possible (ie - "1.5" for one and one half seconds.) The delay is capped between 0 and 10 seconds. Any number lower than 0 or greater than 10 will be treated as if it were 10.


Multiple Actions

Clicking the Add tab adds multiple Actions which appear in the Actions list on the left side of the Actions tab.


You can have multiple Actions in one product. What's more, each individual Action in the Product can have have the same Trigger name. This is especially handy for Idle actions.


Ensemble?

An Ensemble contains the Animation details of your Action. The Ensemble is where your .xaf and .xpf files are loaded. Your Action can contain multiple Ensembles for some very fun variations.


Add Ensemble

As a reminder, your first Ensemble is added for you whenever you add an Action.

However, if you wish to add more, you can do so by clicking the 'Add' button in the Ensemble Section. Each Action can contain up to 99 Ensembles.

Ensemble Details:
The Ensemble panel is where you actually upload Animation Assets into your Action. What's more, the settings in this panel tell those Animation Assets how to behave.

Remove Ensemble - If you want to get rid of an Ensemble, click this button. Remember, this button works on all Ensembles except the first one created in conjunction with the Action.


Ensemble Parameters Panel

Speed multiplier: The Speed Multiplier settings allow you to speed up or slow down the playback speed of your Animation when Triggered. However, this box does not effect sound effects. Here are examples of what certain values do:


0.5 = half playback speed.
1 = same playback speed.
2 = double playback speed.
IMVU typically leaves these boxes empty.


Stop After: In the "Stop After" box, you may choose to stop the Ensemble after the "Longer effect ends" or the "Shorter effect ends". If you choose to stop the Ensemble after "Longer effect ends", then the Ensemble will wait until the last frame of the last Asset to stop.

If you choose to stop the Ensemble after "Shorter effect ends", then the Ensemble will stop on the last frame of the first Asset to end.

Extra # of loops (up to): This setting allows you to add a random multiplier to the amount of loops your Ensemble will play. This only adds, not subtracts, loops to the number used in the “# of Loops” box found in each Animation's Frame Controls. This allows you to have a random playback length every time your Action file is played which is very handy for Idle Animations and gives a lifelike quality to your Actions. If your initial “# of Loops” is zero, any change to “Extra # of Loops (up to)” will do nothing.

Probability of playing When your Action contains multiple Ensembles, the number typed here will tell the Action how often it should choose to play this particular Ensemble. The number typed here ought to be 1.0 or a fraction of 1.0. For example, if you want this Ensemble to play roughly 30% of the time, you would type in .3. It is best, though not required, to have the total values of all of the 'Probability of playing' boxes across all of your Ensembles equal 1.0. IMVU typically leaves this box empty.

Disable Gaze This check box allows you to control whether the Avatar will "look around" using IMVU's Procedural Gaze settings.


Ensemble Details: Skeletal Animation Panel

The Skeletal Animation Panel is where you browse for and edit settings for your Skeletal Animation - .xaf file. The Browse and Delete buttons are self-explanatory.



Add .XAF This allows you to browse for .XAF, Skeletal Animation Assets.

Delete This removes the .XAF Skeletal Animation Asset from the Action.

Playback Speed: Not only can you control the overall playback speed of the entire Ensemble (using the Speed Multipyler inputs), but you can also change the playback speed of individual Assets within the Ensemble. By adding a value of '2.0' you can double the speed of the Asset loaded. IMVU typically leaves this box empty.

Composition: The "Composition" box allows you to effect whether an Animation replaces or averages with other Animations in the Action.

Replace Overrules Average.

To clarify: when you choose Average, the effects will compose with influence in proportion to their ramped relative Weights. If there are two effects of equal relative Weight, a fully ramped Average effect will have 50% influence, sharing the other 50% with an existing effect, instead of reducing the existing effect to 0% influence. Therefore, Average Defers to Replace.

NOTE: If you are making a Vogue, be sure to set the Composition to "Replace". To learn more about Vogue Animations, please consult the Morph Animation Tutorial or the Skeletal Animation Tutorial.

Ensemble Details: Frame Controls Panels

Each type of Animation panel contains its own Frame Controls panel. This is because the Skeletal and Morph Animation Assets can be of different lengths and, therefore, require their own loop settings.



The looping and blending tools in these two panels are the life blood of Actions within IMVU as understanding how they work influences the creation of the Animation Assets they, in turn, will influence. It is important to experiment to fully understand the way they work.

The Frame Controls allow you to set Blend In/Out frames, Loop Start/End frames, and the # of Loops for a given Animation Asset. The Blend In/Out boxes allow your Animation to blend seamlessly from whatever was playing before your Action and then to whatever is meant to play after your Action. If you choose a Blend In/Out time of 0 frames, then your Animation will snap. It is suggested that you use the 5 to 10 range.

It is important to know up front that the 'Composition' setting greatly influences whether an Action can blend with another one. For example, if two back to back Actions are both set to Replace, then no amount of Blend tweaking will allow them to Blend together. Rather, they will simply snap from one to the other. It is possible to loop your Animation for as long as you want and for as many frames within your Asset as you want. This can effectively cut your .xaf down to only the necessary frames needed to Export. Much can be accomplished by simply playing with the loop Parameters.

More on Looping:
This Parameter specifies where the loop section begins. The effect will begin on Frame N, advancing to the End Frame, then cycling back to the Start Frame for the remaining loop iterations. After all iterations have played, the effect will advance through the End Frame to the remaining Frames. The effect remains "on" during the release period.

If the start and End Frame are both zero and the effect loads successfully, then the End Frame will be adjusted to be the last Frame. Thus if you want a simple looping effect you can set the Start Frame, End Frame, and loop Iterations to zero. If you want a simple one shot effect, then set the Start Frame and End Frame to zero, but set loop Iterations to one.

If the Start and adjusted End Frame are the same, then the effect does not have a loop section, and the loop Iterations Parameter will be ignored.

Ensemble Details: Morph Animation Panel


The first difference between the Morph and Skeletal Animation panels is that the Morph panel is missing the "Composition" box. This is because this functionality needs to take place in the actual Morph Target name within your 3D program.

The second difference is the addition of the "Amplitude Scale" box. By adding numerical values greater than 1.0 to the "Amplitude Scale" box, the .xpf will scale the active Morph Targets. For example, if you had set a Morph to 75% upon Export, and then set your Amplitude Scale to 2, the Morph would play back at 150%.


Multiple Ensembles

Each Action may contain numerous Ensembles. This functionality coupled with the 'After playing' and 'Probability of playing' settings allows you to create the compelling and wonderful illusion of life.


Fully Loaded Action

This is what a fully loaded action panel looks like:

© 2017 IMVU All rights reserved