Changes between Version 11 and Version 12 of AnimationCommands

Timestamp:

Jun 22, 2011, 12:29:01 AM (15 years ago)

Author:

Darren Weber

Comment:

--

AnimationCommands

@@ -56 +56 @@
  2. Have a special scene name that always means the current scene.  Then "animate" could be used with the syntax of Elaine's proposal (see below) to go from the current scene to any other.
 
-'''Darren's note''':  If so, that breaks the implicit convention that the first scene in an "animate" command is always a 'snap' transition with 1 frame (as it is in [http://www.cgl.ucsf.edu/chimera/docs/UsersGuide/midas/fly.html fly]).  Also, it means that the first scene in an animate command will always use the [master-frames[,master-trans]] arguments.  It can have defaults, but not anything else, without breaking the current syntax convention and the parsing implementation for "animate".  That is, we could not specify something like:  "{{{animate 20,linear 5 scene1 scene2}}}" to get 5 linear frames to scene1 and then 20 linear frames to scene2; the extra 5 is a real headache!  (How would you parse that without making master-frames,master-trans required arguments?)
+'''Darren's note''':  If so, that breaks the implicit convention that the first scene in an "animate" command is always a 'snap' transition with 1 frame (as it is in [http://www.cgl.ucsf.edu/chimera/docs/UsersGuide/midas/fly.html fly]).  Also, it means that the first scene in an animate command will always use the [master-frames[,master-trans]] arguments.  It could have a default that is different from the master (such as the 'snap' with 1 frame), but nothing else is possible without breaking the current conventions and assumptions for "animate".  That is, we could not specify something like: "{{{animate 20,linear 5 scene1 scene2}}}" to get 5 linear frames to scene1 and then 20 linear frames to scene2; that extra 5 is a real headache!  (How would you parse that without making master-frames,master-trans required arguments?)
 
 
@@ -165 +165 @@
 === animate command ===
 
-Implemented in r33819.
+Implemented in r33819 - that completes the first approximation for an implementation of all the animation commands.
 
-In order to provide reliability in parsing the animate command, the comma in the [frameN[,trans-name]] construct is required to specify any trans-name.  Moreover, whenever a comma is present in the command arguments, it must be preceded by a frameN argument and followed by a trans-name argument, with no whitespace allowed between any of these elements.  Hence, to specify a scene animation that will use the master-frames but a different trans-name, it is necessary to use a '0' in the place of the framesN argument.  For example, "{{{animate 10,snap scene1 0,linear scene2}}}" will result in master-frames=10, master-trans=snap and scene2 will have 10 frames (not zero frames, that's impossible), with a 'linear' transition instead of a 'snap' master transition.
+In essence, the implementation of the animate command boils down to something like this:
+
+{{{
+animate <scene-expression1> [<scene-expression2> ... <scene-expressionN>]
+<scene-expression1> := [<master-frames>[,<master-transName>]] <sceneName1>
+<scene-expressionN> := [<frames>[,<transName>]] <sceneNameN>
+}}}
+
+
+Notes:
+ - '''Implicit transition for <sceneName1>''': The first scene, {{{<sceneName1>}}}, is always a "snap" transition with 1 frame.  This "snap" transition of 1 frame is the default scene transition (therefore, it is the default values for {{{[<master-frames>[,<master-transName>]]}}}).
+ - In order to provide reliability in parsing the animate command, the comma in the {{{[frameN[,trans-name]]}}} construct is required to specify any trans-name.  Moreover, whenever a comma is present in the command arguments, it must be preceded by a frameN argument and followed by a trans-name argument, with no whitespace allowed between any of these elements.
+ - To specify a scene animation that will use the master-frames but a different trans-name, it is necessary to use a '0' in the place of the framesN argument.  For example, "{{{animate 10,snap scene1 0,linear scene2}}}" will result in master-frames=10, master-trans=snap and scene2 will have 10 frames (not zero frames, that's impossible), with a 'linear' transition instead of a 'snap' master transition.