NAME

movie − Mathematica animation tool

SYNOPSIS

movie [options] [file...]

DESCRIPTION

Movie lets you animate a sequence of one or more 3Script files (standard input by default).  If the files share the same viewpoint and light sources, movie lets you change this global viewpoint and light source position and color as the animation proceeds, and return the new viewpoint and light sources upon completion of the animation. 

Typically, you would not invoke movie directly, but rather do it from inside Mathematica using the functions found in Animation.m.  For example, you may do the following:

In[1]:= g = Plot3D[ Sin[x y], {x, 0, 3}, {y, 0, 3}, Lighting -> True]
Out[1]= -SurfaceGraphics-
In[2]:= ShowEdit[g]
Out[2]= {ViewPoint -> {2.5411, -0.804, 2.0847},
>    LightSources ->
>     {{{0.7071, 0, 0.7071}, RGBColor[1, 0, 0]},
>      {{0.5773, 0.5773, 0.5773}, RGBColor[0, 1, 0]},
>      {{0, 0.7071, 0.7071}, RGBColor[0, 0, 1]}}}
In[3]:= Show[g, %]

ViewPoint and LightSource editor

If all the frames of the animation have the same viewpoint, holding down the middle mouse button brings up a ViewSphere, with two "cross-hairs" indicating the position of the viewer.  The viewer is always is looking toward the center of the sphere, with the z-axis of the graphics pointing directly up when projected on the viewr’s retina.  When you hold down the middle mouse button and drag the mouse, you change the viewpoint position.  Moving the mouse cursor up and down changes the latitude, while moving the cursor left and right changes the longtitude of the viewpoint.  To change the perspective, you hold the left mouse button and drag the mouse up (for increased distortion) or down (for decreased distortion). 

When you select the "viewpoint/lightsources" menu option, you get a dialog box in the upper right-hand corner, which lets you select the light source you want to edit.  You change the light source position in the same way you change the viewpoint position.  In addition, you can change the color of the light source by moving the Red, Green and Blue sliders with the mouse. You can also turn the light source off entirely by clicking on the On button. 

MENU

A fair amount of interactive control can be exercised over the progress of the animation and the graphics environment of each of the frames.  Here is a brief synopsis of the menu of possible actions obtained by holding down the right mouse button and selecting from the menu or typing the keyboard equivalent.  Some of the options may not be available for a particular sequence of frames. 

forward (RIGHTARROW)
-- go through the frames f1, f2, ...,fn in the order f1, f2, ..., fn, f1,...  When the animation is stopped using the pause option (see below), forward moves one frame forward. 

reverse (LEFTARROW)
-- go through the frames f1, f2, ...,fn in the order fn, fn-1, ..., f1, fn,...  When the animation is stopped, reverse moves one frame backwards. 

cycle (c)
 -- loop through the frames f1, f2,...,fn in the order f1, f2,...fn, fn-1, fn-2,...,f1,...

toggle pause (SPACE)
 -- pauses the animation or restarts it if it is presently pausing.

faster (UPARROW)
-- increase the speed at which the animation is displayed.

slower (DOWNARROW)
-- decrease the speed at which the animation is displayed.

smooth/flat shading (s)
 -- toggles surface shading between flat and Gouraud shading.

bounding box on/off (b)
 -- toggles the display of the bounding box.

polygon outlining on/off (o)
 -- toggle the outlines of the polygons.

viewpoint/lightsource selector (v)
 -- edit the position of the viewpoint and the positions and colors of the light sources, as described earlier.

reset (HOME)
 -- resets the animation to its initial state.

exit (ESC)
 -- exits the animation.

OPTIONS

Note: in the options that take an RGB value as an argument, the R, G, and B values are integers between 0 and 255, and are separated by commas only (no spaces), as in movie -bb 100,100,100 pic.ts. 

−title titlestring
Set the title of the window. The default is Mathematica Movie. 

−size x,y
Set the default window size to x by y pixels. 

−pos left,right,bottom,top
Make the default window appear in the rectangle defined by left, right, bottom and top.  Only one of −size, −pos cane be used. 

−bg RGB
Set the RGB value of the background color of the window. The default value is 0,120,200 (azure)

−bb RGB
Set the RGB value of the color of the bounding box. The default value is 200,200,0 (canary yellow).

−outlineb RGB
Set the RGB value of the color of the polygon outlines. The default value is 0,0,0 (black).

−sphere RGB
Set the RGB value of the color of the ViewSphere. The default value is 180,180,180 (light gray). 

−sgrid RGB
Set the number of latitude and longtitude lines on the ViewSphere. The default value is 18.  When the value is 0, movie refrains from displaying the viewer’s cross-hair during reorientation.  When the value is between 0 and 1, no grid is displayed but mthe viewer’s cross-hair is displayed. 

−eye RGB
Set the RGB value of the color of the cross-hair on the ViewSphere. The default value is 255, 0, 255 (magenta). 

−translucent
Causes all the polygons to be translucent. (GT only).  Note that the default values described above are not apropriate for translucent polygons; for example, it is better to have a white backround in this case.

LIMITATIONS

At present no more than four light sources may be in use at a time. 

DIAGNOSTICS

ERROR -- line # nnn , unknown token = word: an error was encountered while reading the 3Script file. 

HARDWARE REQUIREMENTS

8 bits of z-buffer, and at least 12 bitplanes. 

SEE ALSO

live(1)

AUTHOR

Yossi Friedman

ORIGIN

Wolfram Research, Inc. 

Version   —  September 12, 1990