The img-to-movie.c program in the /usr/people/4Dgifts/examples/libmovie/misc directory creates a movie file from an image file. The image file can have a single image, in which case the movie file has only a single frame, or a sequence of images. The resulting movie file has a frame rate of 15.0 frames per second and uses MVC1 compression.

To run the program, enter:

img-to-movie imagefile newmoviefile

where:

The aud-to-movie.c program in the /usr/people/4Dgifts/examples/libmovie/misc directory adds an audio track to a silent movie or replaces the movie's existing audio track. The audio track can be an AIFF file or any audio file that is readable by libaudiofile.

To run the program, enter:

aud-to-movie audiofile moviefile

where:

simplemovie has a keyboard interface for playing a movie. To run the program, enter:
simplemovie moviefile

The keyboard commands are:

manymovie is a command line program for playing up to 4 movies simultaneously. The movies can have different frame sizes.

---

Note: The 4 movie limitation is not related to the Movie Library; rather, it is the result of the very simple layout scheme used in manymovie for placing all movies in one window.

---

To run the program, enter:

manymovie [-one] moviefile1 [moviefile2…]

By default, each of the movies appears in a separate window. When each movie is played in a separate window, the keyboard commands apply only to the current window, except for the quit command, which always exits from manymovie.

To play all movies in a single window, use the -one command line option. If the -one option is used, all keyboard commands apply simultaneously to all movies.

manymovie uses the following keyboard interface:

manymovie contains the following files:

moviescreen is a screensaver application that plays movies. moviescreen does not save screens by itself; rather, it is designed to run under haven(1), a wrapper for IRIS GL-based screensavers, which is available on Silicon Graphics computers. Normally, the screen turns black and the movie begins playing silently, slowly drifting around the screen as it plays.

To run the program as a screensaver under haven(1), enter:

haven [-n |-o] [< moviescreen [-f] [-s] [-v volume] [-z zoom] [-l loopmode] moviefile1 [moviefile2…]>|-k]

where:

moviescreen contains the following files:

Figure 32-5 shows the call graph for moviescreen.c

Figure 32-5. Call Graph for moviescreen.c

To access the frame closest to a given SMPTE code, pass the SMPTE code as a string to mvStringToFrame(), which converts the given string to a frame number in the specified movie. Its function prototype is:

extern DMstatus mvStringToFrame ( MVid        movieid,
                                  char        *timestring,
                                  MVtimetype  timetype,
                                  MVframe     *framereturn )

where:

Specify the time code string in the format "HH:MM:SS:FF" where HH signifies two digits that represent hours, and similarly, MM minutes, SS seconds, and FF the frame count for the current second. The converter assumes that incomplete time strings are specified from the least-significant unit up; that is, a value of "02" means SMPTE frame code 02 of the current second. "03:02" means second 03, frame 02 of the current minute, and so on. The frame number is between 0 and one less than the total number of frames in the movie.

To obtain a SMTPE-style time code string for a given frame number, call mvFrameToString() with the frame number for which you need the SMPTE code. Its function prototype is:

extern DMstatus mvFrameToString ( MVid        movieid,
                                  MVframe     frame,
                                  MVtimetype  timetype,
                                  char        *timereturn )

where:

The SMPTE code is returned as a string that lists the hour, minute, second, and frame count for the given frame number.

To convert a fully formed time code to the nearest corresponding frame in the specified movie, call mvTimeToFrame(). Its function prototype is:

extern DMstatus mvTimeToFrame ( MVid        movieid,
                                int         hour,
                                int         minute,
                                int         second,
                                MVframe     framecnt,
                                MVtimetype  timetype,
                                MVframe     *framereturn)

where:

To obtain a time code corresponding to a particular frame, call mvFrameToTime() with the index of the frame for which you want the time code. Its function prototype is:

DMstatus mvFrameToTime    ( MVid        movieid,
                            MVframe     frame,
                            MVtimetype  timetype,
                            int         *hourreturn,
                            int         *minutereturn,
                            int         *secondreturn,
                            MVframe     *framecntreturn)

where: