v 2.0 - what's new   Gallery   Manual   Tutorial   Downloads   Links  
     

  AnimationLab v 2.0  

Manual - Commands Reference

Overview

Commands Reference

Scenario Editor

Scenario Recorder

      

Commands syntax:

From To CommandName Parameter1 Parameter2 …

Parameters:

From, To - frame index range for which the command will be executed
CommandName - name of the command (Move, Rotate, Scale etc.) 
Parameter1 Parameter2… - command parameters

Numbers, variables and expressions (functions, arrays, etc.) can be used as parameters.

Examples:

Numeric parameter:
Each step from step 0 to step 50 shifts the object by dx = 1, dy = 2, dz=1 relative the current position

0 50 Move 1 2 1 

Variable parameter:
variables must be initialized in custom script

0 50 Move X Y Z 

Custom script:

Dim X,Y,Z
x = 1
y = 0.5
Z = 0
Sub StepCustomAction
'// TODO your code
end sub

Parameter as expression:
The actor will be moved along 3D spiral

0 50 MoveAbs X y(X) z(X)

Custom script :

Dim X
X = 0
Sub StepCustomAction
X = X + 0.5
end sub

function y(x)
y = sin(3*x) 
end function

function z(x)
z = cos(3*x) 
end function

Using arrays:
This command will replace material of the actor graphic with the value retrieved from the array.

0 50 Material Name

Custom script:

‘ initialize materials array
Dim Name
Dim Mats(3)
Mats(0)= "Wood\Dark Wood"
Mats(1)= "Wood\Varnished Dark Wood"
Mats(2) = "Wood\Varnished Redwood"

Sub StepCustomAction
if(StepNum < Ubound(Mats)) then
Name = Mats(StepNum)
end if
end sub

Command Name Param-1 Param-2 Param-3 Param-4

Description

Move Dx dy Dz  

Shift the object by dx, dy, dz from current position

MoveAbs X y Z   Move the object to x, y, z position
Rotate AngleX AngleY AngleZ   Rotate the object around x, y, z, axes
Scale ScaleX ScaleY ScaleZ   Scale the object along x, y, z axes
SlideByNodes PathName StartNode Step   Slide the object along path graphic (PathName - name of actor that is a path)
SlideByPath PathName Start% End% Spline Slide the object along path graphic (PathName - name of actor that is a path) with interpolation
FollowByNodes PathName StartNode Step   Move the object along path graphic (PathName - name of actor that is a path) following all path windings
FollowByPath PathName Start% End% Spline Move the object along path graphic (PathName - name of actor that is a path) following all path windings with interpolation
CameraPos X y Z   Set camera to x, y, z position 
CameraLookAt X y Z   Set camera looking at x, y, z 
CameraUp X y     Set camera’s up vector
CameraUpByNodes PathName StartNode Step   Move the camera's Up vector along path graphic (PathName - name of actor that is a path) following all path windings
CameraPosByNodes PathName StartNod Step   Move the camera's position along path graphic (PathName - name of actor that is a path) following all path windings
CameraPosByPath PathName Start% End% Spline Move the camera's position along path graphic (PathName - name of actor that is a path)
CameraLookByNodes PathName StartNode Step   Move the camera's lookAt point along path graphic (PathName - name of actor that is a path) following all path windings
CameraLookByPath PathName Start% End% Spline Move the camera's looking point along path graphic (PathName - name of actor that is a path)
LightSwitch On(Off)       Switch the Light ON / OFF
LightColor Red Green Blue   Change the color of the Light 
LightColorInc DRed dGreen Dblue   Increment of the color of the Light 
LightCone Degrees       Define the Cone properties for the Light 
LightPower Wats        Define the Power property value for the Light
LayerSwitch On(Off) LayerName     Switch the layer ON / OFF
AttachToGroup ActorName       Attach the object to the group (ActorName)
DetachFromGroup ActorName       Detach the object from the group (ActorName)
PenColor Red Green Blue   Change the PenColor of the actor
PenColorIncr DRed dGreen Dblue   Increment (decrement) of the PenColor of the actor
Layer LayerName       Move the actor to an layer
Thickness H       Set Thickness property = H
ThicknessIncr DH       Increment (decrement) the value of theThickness property
Material MaterialName       Set actor material
Morphing TemplateGraphic  StartNode     Transforms actor graphic to match template graphic
AddNode X Y Z   Add node with coordinates X,Y,Z to the actor’s vertices collection
DeleteNode NodeIndex       Delete node number NodeIndex (NodeIndex = -1  means last node)from actor’s vertices collection
 
    
  Scroll To Start  AnimationLab Home Page    Contacts SoftDev SPb Home Page