A Preparable is a SmartDancer Command that happens in preparation for a FORMATION move command.
An Immediate is a SmartDancer Command that executes immediately and makes use of the most previous Preparable commands.
Preparable commands include:
1 – Grouping commands – HALF, ALTERNATE, NO_DIVISION – These specify if subsequent commands will target ALL or HALF of the avatars/animesh (or combinations thereof) that are present.
2 – Send commands – SendA, SendB, SendC – These command determine which half of a division (assuming there is a HALF or ALTERNATE specified) that subsequent IMMEDIATE commands will affect. SendC directs subsequent commands to affect ALL avatars/animesh.
3 – MoveSpeed command – This allows for DYNAMIC change of move speed for FORMATION moves only. It DOES NOT apply to TURNS, JUNES, or CANONS. The higher the number, the slower the move. This value is initialized on the *formations nc using the DDMoveTau entry. Please be aware that any re-Registering of a controller will reinitialize this value to its DDMoveTau,3.5 value. Of course you can change this initial value.
For dynamic run-time adjustments use the following format:
SD=SPEEDxx.x (xx.x=duration of formation or june)
4 –FlipAB – this command only affects HALF and ALTERNATE divisioning. It reverses the assignment of the A and B assignments.
5 – SetJunes – SetJuneRight, (clockwise), SetJuneLeft (counter-clockwise – The ‘Set‘ word is meant to remind people that the JUNE is not immediate but in preparation for the next formation move. It is recommended that you not use SetJuneHome in production as the results are a straight-line and not what you would expect. This may be modified at a later date.
UPDATE 01-23-21: SetJuneRight and SetJuneLeft now execute immediately if AutoJune is OFF, which is the default. They use the last selected formations for J-R *formations nc and A-I *expansions nc
6 – CanonReverse and CanonForward – These commands set the direction of susequent CANON operations.
Forward is default and operates in alphabetical order (i.e. ArtistePalette_01_A thru ArtistePalette_01_R)
Reverse operates in reverse alphabetical order (i.e. ArtistePalette_01_R thru ArtistePalette_01_A)
7 – Turns Only – this is a toggle whose status is displayed in the menu. Either TurnsOnly or Turns & Anims. This command says that subsequent CANON operations will suppress any execution of the specified CANON animation, if one exists. It is specified in the *smartdancer nc inside an animesh or palette. Example: CanonAnimation,KatananLow.
**********************************
Immediate commands include:
1 – Formations – self-explanatory
2 – Turns – TurnLeft, TurnRight, TurnIn, TurnOut, TurnHome
3 – Canons – CanonLeft, CanonRight, CanonTurnIn, CanonTurnOut, CanonHome
4 – AnimateOnly – this executes the CanonAnimation immediately taking into consideration the CanonInterval but excludes normal turns associated with a Canon.
5 – Semis – SemiLeft & SemiRight – These 2 June operations perform 2 Junes in a row using the last/current formation. Interestingly enough, the dancers maintain the facial direction. So it is essentially a 180 June vs the normal 90 degree SetJuneLeft/SetJuneRight
NOTE: TurnHome and CanonHome commands STOP the CanonAnimation.
Also, it is suggested that you use at least a priority-4 animation for the DefaultSitAnim,Pray Bow in the *palette nc in the Artiste Palette