ROI Toolbox Docs

Documentation: Movie of Images (spm_movie.m)
--------------------------------------------
Jeff Cooper
12/11/02

1. Summary

spm_movie is a simple utility intended to aid visual detection of
artifacts by quickly running through a given set of images as a movie,
looking at a single plane of each image in a given movie.
The movie can either run automatically or be controlled by a slider, to
allow users maximum control over detection.  Movies can be viewed
in any of the three orthographic axes. 

2. Usage

spm_movie takes no inputs; it can be run from the command line with 
the command line ‘spm_movie’ or from the ROI Toolbox with the ‘Movie
of Images’ button.  When selected, it asks the user to pick a viewing
orientation: transverse (axial), sagittal, or coronal.  The user then
selects a set of images to view as the movie; any set can be chosen,
whether contiguous or non-contiguous.  The user is then queried for a 
plane number to view within the movie; this is the plane that will be 
displayed for all images in the sequence.  No error-checking is done
on this number; if the user selects a plane outside the image, a blank
movie will display.  
	The user then chooses which style of control to use – the slider
or no slider.  If the user picks ‘no,’ the script asks how many times to
run through the movie before stopping.
	There’s then a short wait while the script caches the images of 
each plane in order; during this time, the Graphics window shouldn’t be
moved, or else a Segmentation Fault will happen and matlab will crash.
No fun.  After this interval, if the user has chosen
not to use the slider, the movie runs through, uninterruptibly, as many
times as it was told.  If the user has chosen to use the slider, he or 
she can use the slider below the viewing window to click through each
image, back and forth, as long as they want.
	Once the movie has stopped, or the user is done sliding through
each image, the script is finished, and the Graphics and interactive
windows can be closed at will.


3. Output

None.


4. Last Bits

spm_movie.m was written by John Ashburner and Chloe Hutton as an 
adjunct to the SPM99 software.    

This code is in a very fluid state of development, and any suggested
modifications are welcomed and invited.  Please contact Jeff Cooper
in the Stanford Psychology Department at jcooper@stanford.edu with 
any questions about usage, bug reports, or suggestions for further
revision.  Good luck...

