dmedia_tools Release Notes

1 Introduction

2 Installation Information

3 Sound Tools

4 Movie Tools

5 Capture Tool

 



                                  - 1 -



       1.  Introduction

       The Digital Media Tools (dmedia_tools) are a set of end-user
       tools that give you access to the digital media capabilities
       of your workstation. The tools fall into two categories:
       sound tools and movie tools.

       The sound tools in Digital Media Tools include:

       Sound Filer/Sound File Utilities

       Sound Editor
       CD Manager

       DAT Manager
       Prosonus Sound Library

       The movie tools in Digital Media Tools include:

       Movie Player

       Movie Maker
       Capture Tool


       Note:  Packaged with these release notes is a separate sheet
              that contains the Software License Agreement.  This
              software is provided to you solely under the terms
              and conditions of the Software License Agreement.
              Please take a few moments to review the Agreement.
































                                  - 2 -



       This document contains the following chapters:

         1.  Introduction

         2.  Installation Information

         3.  Sound Tools

         4.  Movie Tools

         5.  Capture Tool



       1.1  Release_Identification_Information

       Following is the release identification information for the
       Digital Media Tools:

       Software Product               dmedia_tools

       Version                        5.2
       System Software Requirements   IRIX 5.2

       1.2  Hardware_Requirements

       Sound tools such as Sound Editor and Sound Filer which
       require audio I/O hardware for recording or playback will
       run on IRIS Indigo2, Indy, Indigo, 4D/35, and 4D/30 (with
       audio card) workstations. These tools include Sound Editor
       and Sound Filer. Some of the sound tools which perform audio
       file conversion such as aifcresample and aifccompress
       require no audio I/O hardware and will run on any IRIS
       system.

       CD Manager requires IRIS audio I/O hardware and a SCSI CD-
       ROM option drive. DAT Manager requires IRIS audio I/O
       hardware and a SCSI DAT option drive.

       The movie tools will run on any Silicon Graphicsr platform.
       On systems without audio support, movies are played back
       silently.  Capture Tool will record audio input on any IRIS
       workstation which runs the other audio tools. Capture Tool
       will record video input on Indy workstations or Indigo2
       workstations with a video option board.

















                                  - 3 -



       1.3  On-Line_Release_Notes

       After you install the on-line documentation for a product
       (the relnotes subsystem), you can view the release notes on
       your screen.

       If you have a graphics system, select ``Release Notes'' from
       the Tools submenu of the Toolchest. This displays the
       grelnotes(1) graphical browser for the on-line release
       notes.

       Refer to the grelnotes(1) man page for information on
       options to this command.

       If you do not have a graphics system, you can use the
       relnotes command.  Refer to the relnotes(1) man page for
       accessing the on-line release notes.

       1.4  Product_Support

       Silicon Graphics, Inc., provides a comprehensive product
       support maintenance program for its products.

       If you are in North America and would like support for your
       Silicon Graphics-supported products, contact the Technical
       Assistance Center at
       1-800-800-4SGI.

       If you are outside North America, contact the Silicon
       Graphics subsidiary or authorized distributor in your
       country.




























 



                                  - 1 -



       2.  Installation_Information

       This chapter lists product-specific information supplemental
       to the IRIS Software Installation Guide.  Use it with the
       Installation Guide to install this product.

       2.1  Digital_Media_Tools_(dmedia_tools)_Subsystems

       The Digital Media Tools can be found in the dmedia_tools
       software images.

       The following subsystems are included in dmedia_tools:

       dmedia_tools.sw.soundtools Tools for sound recording,
                                  playback, and conversion.
                                  Includes Sound Editor, Sound
                                  Filer, and several command-line
                                  utility programs: aiff2aifc,
                                  aifc2aiff, aifccompress,
                                  aifcdecompress, aifcinfo,
                                  aifcresample, and others.

       dmedia_tools.man.soundtools Manual pages for the sound
                                  tools.

       dmedia_tools.sw.cddat      CD Manager (audio CD playback)
                                  and DAT Manager (audio DAT
                                  playback/recording).

       dmedia_tools.man.cddat     Manual pages which describe CD
                                  Manager, DAT Manager, and the CD
                                  and DAT audio data formats.

       dmedia_tools.data.prosonus Collection of digitally-sampled
                                  audio sound files provided by
                                  Prosonus.  The library includes
                                  ambient sounds, instrument
                                  samples, music tags, and sound
                                  effects.  This subsystem is the
                                  same as that first provided in
                                  IRIX 4.0.1.  It is included in
                                  Digital Media Tools as a
                                  convenience for those who haven't
                                  already installed it.

       dmedia_tools.man.prosonus  Manual page describing the
                                  Prosonus sound sample library.

       dmedia_tools.sw.movietools Tools for movie capture,
                                  playback, and conversion.
                                  Includes Movie Player, Movie











                                  - 2 -



                                  Maker, Capture Tool, and
                                  makemovie.

       dmedia_tools.data.movies   Two sample movie files:
                                  "somersault.mv" and
                                  "sampleQT.mv".

       dmedia_tools.man.movietools Manual pages for the movie
                                  tools.

       dmedia_tools.man.relnotes  Release notes for the digital
                                  media tools.

       dmedia_tools.books.MediaTls_UG On-line Insight Digital Media
                                  Tools User's Guide and Insight-
                                  based SGI Help information for
                                  the digital media tools.

       2.2  Digital_Media_Tools_Subsystem_Disk_Space_Requirements

       This section lists the subsystems (and their sizes) of the
       Digital Media Tools.

       If you are installing this option for the first time, the
       subsystems marked ``default'' are those that are installed
       if you use the ``go'' menu item.  To install a different set
       of subsystems, use the ``install,'' ``remove,'' ``keep,''
       and ``step'' commands in inst to customize the list of
       subsystems to be installed, then select the ``go'' menu
       item.

       Note:  The listed subsystem sizes are approximate. Refer to
              the IRIS Software Installation Guide for information
              on finding exact sizes.

       Subsystem Name                             Subsystem Size
                                                  (512-byte blocks)

       dmedia_tools.sw.soundtools(default)               2708
       dmedia_tools.man.soundtools(default)                41

       dmedia_tools.sw.cddat (default)                   2075
       dmedia_tools.man.cddat (default)                    80

       dmedia_tools.sw.movietools (default)             10520
       dmedia_tools.man.movietools (default)               23

       dmedia_tools.data.prosonus (default)             21929
       dmedia_tools.man.prosonus (default)                 10













                                  - 3 -



       dmedia_tools.data.movies (default)                1204

       dmedia_tools.man.relnotes (default)                 46
       dmedia_tools.books.MediaTls_UG (default)         XXXX

       2.3  Installation_Method

       The Digital Media Tools can be installed from IRIX.  Refer
       to the IRIS Software Installation Guide for complete
       installation instructions.

       IRIX 5.2 system software must be installed to run the
       Digital Media Tools subsystems.














































 



                                  - 1 -



       3.  Sound_Tools

       This chapter lists information about the sound tools in the
       Digital Media Tools set, including changes and additions
       since the last release, bug fixes, known problems, and
       documentation errors. The following audio tools are included
       in the Digital Media Tools set:

          o Sound Filer/Sound File Utility Programs

          o Sound Editor

          o CD Manager/DAT Manager

          o AIFF-C File Utility Programs

          o Prosonus Sound Sample Library


       3.1  Sound_Filer/Sound_File_Utility_Programs

       Sound Filer is a graphical, easy-to-use utility for browsing
       and auditioning sound files, and for converting among sound
       file formats, data formats, and sampling rates.  Currently
       supported sound formats are:

          o aifc    AIFF-C file format

          o aiff    AIFF file format

          o next    NeXT/Sunr Format

          o wave    Microsoftr RIFF WAVE Format

       The supported data formats are raw signed or unsigned pulse
       code modulation, mu-law, and floating point.

       You can invoke Sound Filer from the command-line with the
       command soundfiler.  See the man page soundfiler(1) or Sound
       Filer's on-line help for more information.

       There are also three utility programs that provide similar
       functionality from the command line:

          o sfinfo displays information about the contents of a
            sound file.  Refer to the man page sfinfo(1) for more
            details.

          o sfplay plays audio files in any of the above standard
            formats.  Refer to the man page sfplay(1) for more
            details.











                                  - 2 -



          o sfconvert supports the file conversions described
            above.  Refer to the man page sfconvert(1) for more
            details.

       3.1.1  Changes_and_Additions  This section lists
       changes/additions to Sound Filer since the last release.

          o None.

       3.1.2  Known_Problems_and_Workarounds  This section lists
       known problems in Sound Filer and ways to work around them.

          o When Sound Filer converts between AIFF-C and AIFF
            files, it deletes many of the auxiliary header fields,
            such as author string, sampler parameters, and
            application-specific data.  To convert between AIFF-C
            and AIFF files, use the programs aiff2aifc and
            aifc2aiff described in Section 3.5.1.

          o Sound Filer does not yet support the standard audio
            compression algorithms registered by Silicon Graphics
            for use with AIFF-C files. To compress or decompress
            AIFF-C audio data, use aifccompress and aifcdecompress
            described in Section XXXXX.  To directly play or record
            files that contain compressed audio data, use playaifc
            and recordaifc, which are installed from
            dmedia_eoe.sw.audio.

          o sfconvert now writes little-endian integer sample
            files, but it does not yet write little-endian
            floating-point output files.  Currently, the only file
            format that requires little-endian support is WAVE, and
            it does not support floating point samples, so this is
            an issue only when transferring raw floating point data
            files between an SGI platform and a little-endian
            machine.

          o Sound Filer's convert window does not currently have a
            selection for big- or little-endian.  AIFF-C, AIFF,
            Next/Sun, and raw data files are assumed to contain
            big-endian data. WAVE files are assumed to contain
            little-endian data.  To read or write little-endian raw
            data, use sfconvert.

          o Use the program aifcinfo, described in Section 3.5.1,
            to obtain a more detailed description of the audio data
            and auxiliary information stored in an AIFF-C or AIFF
            file than the description supplied by sfinfo.  Note
            that aifcinfo understands only AIFF-C and AIFF files,
            while sfinfo understands several additional formats.












                                  - 3 -



       3.2  Sound_Editor

       Sound Editor (invoked from the command line as soundeditor)
       is a Motif application for recording and editing soundfiles
       in AIFF/C format.  This program requires a Silicon Graphics
       system with digital audio hardware components.  A graphic
       display of the audio stream data is presented along with
       word-processing-style commands for manipulation.  Sound
       segments can be cut, copied, pasted, or mixed by marking a
       region with the mouse and invoking the proper command.
       Additional functions are provided to modify levels and to
       perform fades and special effects.

       You can customize the appearance of Sound Editor by altering
       its Motif application defaults file, SoundEditor, in the
       directory /usr/lib/X11/app-defaults.

       See your Motif/X11 documentation regarding use of the
       application defaults file.

       3.2.1  Bug_Fixes  This section lists the bugs fixed since
       the previous release.

          o The audio waveform is now displayed right side up
            (correct polarity).

          o The wave display is correctly cleared after File New
            operation.

          o Fade-in and out curve changed from linear to more
            natural-sounding exponential.

          o Clipping of sample overflow values properly
            implemented.

          o Louder and softer operations are exactly complementary.

          o Fixed problem of core dump when dismissing File Browser
            window.

          o Fixed problem of core dump when screen13 font not
            found.


       3.2.2  Changes_and_Additions  This section lists
       changes/additions to Sound Editor since its previous
       release.

          o Selection of edit regions using mouse click-and-drag
            changed to be compatible with standard style used by
            word-processing applications.











                                  - 4 -



          o User interface streamlined by removing meter window and
            other non-essential buttons.

          o Improved zoom functionality with ability to specify
            exact timespan for wave view.

          o Handles four channel audio files.


       3.2.3  Known_Problems_and_Workarounds  This section lists
       problems in SoundEditor and ways to work around them.

          o SoundEditor can edit only AIFF/C format soundfiles with
            a sample width of 16-bits.  Other types of files must
            first be converted using the soundfile utility
            programs.

          o Selection operations using the mouse occasionally will
            leave lines in the wave display that appear to be
            unselected.

          o At certain zoom levels, the wave display will show
            aliasing artifacts.

          o It is possible to create a situation where the time
            ruler line in the wave display disappears temporarily.

          o Under certain conditions, the keyboard accelerators can
            become disabled.  Bringing up the menu containing the
            desired command usually corrects this situation.

          o When altering the selected region during repeat play,
            it is possible for the play region to lag behind the
            user's input or sometimes play material outside the
            marked region.  This behavior normally corrects itself
            after cycling through the marked play region.

       See the man page soundeditor(1) and Sound Editor's on-line
       help for additional information.























                                  - 5 -



       3.3  CD_Manager_and_DAT_Manager

       CD Manager and DAT Manager, invoked from the command line as
       cdman and datman, allow you to play audio CDs and DAT tapes
       on the IRIS SCSI CD-ROM and DAT drives.  The audio is played
       through the IRIS audio hardware.

       CD Manager and DAT Manager also let you copy data from CD or
       tape to a disk file in the computer's file system.  Any such
       copying is, of course, subject to copyright law.

       DAT Manager is a recorder as well as a player.  It can
       record data coming from the IRIS audio hardware or from a
       file in the computer's file system.  The tapes recorded and
       played by DAT Manager are compatible with commercial DAT
       recorders.

       CD Manager and DAT Manager are actually the same program.
       The name used to invoke the program, or a command-line
       option, determines whether the program runs as CD Manager or
       as DAT Manager.

       3.3.1  Known_Problems_and_Workarounds  This section lists
       problems in the CD Manager/DAT Manager software and ways to
       work around them.

          o Neither CD Manager nor DAT Manager lets you cue to an
            index on a CD or tape.

          o The only nonaudio data DAT Manager currently records is
            program number and absolute time code.  This means that
            DAT Manager does not record program time.  There is
            currently no way to renumber the programs on a tape or
            to erase a program number.

          o DAT Manager displays uncorrected frame numbers when
            playing back a tape recorded with SMPTE time code in
            place of running time.

          o When recording to a file from DAT Manager, the sampling
            rate stored in the AIFF-C file header is the rate of
            the most recently played portion of the DAT.  This
            means that given a DAT that has programs recorded at
            different sampling rates, DAT Manager might create a
            file with the wrong sampling rate if you have just
            played a program with a different sampling rate from
            the program about to be recorded.

            Workaround: When recording to disk from a DAT that
            contains programs with different sampling rates, use
            separate AIFF-C files for the different programs.  When











                                  - 6 -



            you are about to record a DAT program to disk that has
            a different sampling rate from the last program you
            played, first play a portion of the new program.  Then,
            rewind to the beginning of the program and begin
            recording to an AIFF-C file.

          o The music catalog function is not currently implemented
            for tapes because so few of them have the table of
            contents necessary to uniquely identify a tape.


       3.4  AIFF-C_Utility_Programs

       Beginning with the IRIX 4.0.1 software release, Silicon
       Graphics introduced AIFF-C (Audio Interchange File Format
       with Compression extensions) as its standard audio
       interchange file format.  The AIFF-C format is an extended
       version of the AIFF format, supported by Silicon Graphics
       and Apple digital media applications.  AIFF-C files can
       store either compressed audio data or standard linear PCM
       data, and optionally include header fields that store many
       kinds of additional information such as text, sample
       parameters, sample frame markers, and application-defined
       data.

       In the Digital Media Tools package, the digital media tools
       that import audio data from disk files are now capable of
       reading both AIFF-C and AIFF files.  All of the standard
       Silicon Graphics digital media tools that save audio data to
       files now generate AIFF-C files by default.

       Digital Media Tools includes a number of new command-line
       utility programs that allow you to record, play back, and
       convert files in the AIFF-C format. These programs differ
       from the Sound Filer utilities described in Section 3.2 in
       that they are designed for working exclusively with AIFF-C
       and AIFF files.  The AIFF-C conversion utilities described
       in Section 3.5.1 preserve the auxiliary nonaudio data (loop
       points, author string, application-specific data) stored in
       the various optional AIFF-C (AIFF) header fields.

       The AIFF-C utility programs are built on top of the Silicon
       Graphics Audio File Library, and support the audio
       compression algorithms for AIFF-C, which are built into the
       library (CCITT G.711 and CCITT G.722). 4DGifts source code
       for each of the utilities (except for aifcresample, which
       contains proprietary high-quality rate-conversion code) is
       included in the IRIS Digital Media Development Option
       (DMDEV).













                                  - 7 -



       3.4.1  Changes_and_Additions  This section lists
       changes/additions to the AIFF-C (and AIFF) utility programs
       since their last release.

          o None


       3.4.2  Bug_Fixes  This section lists the bugs fixed since
       the last release of the AIFF utility programs.

          o aifcresample now outputs a compressed file for
            compressed input files.

       3.4.3  Known_Problems_and_Workarounds  This section lists
       known problems in the AIFF-C (AIFF) utility programs and
       ways to work around them.

          o G.722 compression or decompression is CPU-intensive. To
            record or play back an AIFF-C file that contains mono
            or stereo audio data compressed using the G.722
            algorithm, you might have to run recordaifc or playaifc
            with nondegrading high priority.  See the man page
            npri(1) for information about how to do this.  An
            alternative is to record and play standard linear PCM
            sample data into AIFF-C files, and compress/decompress
            the data when necessary using aifccompress and
            aifcdecompress.

          o None of the AIFF-C conversion programs recognize the
            comment-marker chunk described in the AIFF-C
            specification.  This chunk disappears when a file is
            converted using one of the utilities.

          o The AIFF-C utility programs are not able to decode the
            Apple proprietary audio compression schemes (ACE/MAC
            algorithms) described in the AIFF-C specification.

            Workaround: Always uncompress AIFF-C files before
            transferring them from a Macintosh to an SGI platform.

          o aifcresample does not modify the optional AES channel
            status information in the AIFF-C file header to reflect
            the new sampling rate.

            Workaround: If the AES channel status information says
            the audio data should be played at one rate, and the
            AIFF-C (AIFF) file header says the audio data should be
            played at another rate, go with sampling rate in the
            file header.










 



                                  - 1 -



       4.  Movie_Tools

       This chapter lists information about the Movie Player, Movie
       Maker, and Make Movie tools in the Digital Media Tools set,
       including known problems.  The movie tools are:

          o Movie Player

          o Movie Maker

          o Make Movie

       All of these tools can now read QuickTime (TM) movies.
       Although neither Movie Maker nor Make Movie can write
       QuickTime movies yet.

       Please read chapter 5 for more detailed information about
       the Capture tool.



       4.1  Movie_Player

       Movie Player (invoked from the command line as movieplayer)
       is a graphical tool that allows you to play back movie
       files. Movie files can be created using Movie Maker, Make
       Movie, or Capture (see below). Movies can be silent or
       include a soundtrack.

       See the man page movieplayer(1) or Movie Player's on-line
       help for more information.

       A sample SGI movie file, somersault.mv, can be found in
       /usr/share/data/movies. A sample QuickTime movie sampleQT.mv
       is there too.



























                                  - 2 -



       4.1.1  Known_Problems_and_Workarounds  This section lists
       problems in the Movie Player software and ways to work
       around them.

          o The movie format version number has been increased to
            3. Movies made or edited with this release of Movie
            Maker might not play or might play incorrectly with the
            previous version of Movie Player.  However, the current
            version of Movie Player plays all versions (1, 2 and 3)
            of movies correctly.

          o Movie Player does not work correctly over the network.
            The user interface and images will display on the local
            machine, but the audio will play on the remote machine.

          o Movie Player does not support the playback of FIT image
            sequences in this release. You can work around this
            problem by using Movie Maker or Make Movie to convert
            your FIT images to SGI Movie format.

          o The -D option of Movie Player does not work. It is
            supposed to make Movie Player be double buffered.

          o MoviePlayer will allow the user to invoke apanel on
            machines without audio.

          o If you try to play a very large movie, such as one that
            is full screen, the image will not display correctly if
            it is zoomed at all.

       4.1.2  Changes_from_previous_Movie_Player  This section
       lists the changes in the functionality and interface of
       Movie Player from the version shipped with IRIX 4.0.5.

          o Movie Player can now play QuickTime movies that use
            Apple's "Animation" or "Video" compression.

          o Movie Player 2.0 has been reimplemented as an X/Motif
            application. To avoid conflicts with the standard X
            toolkit options the command line options "-n", "-s" and
            "-d" have been renamed to "-N", "-W" and "-D"
            respectively.

          o The scrollbar for rapidly moving to an arbitrary frame
            in the movie has been replaced by a control triangle on
            the movie itself. Use the left mouse button (button 1)
            to click and drag the triangle to move the movie.

          o The accelerator keys for zooming have been changed to
            z for zooming up and d for zooming
            down.











                                  - 3 -



          o Movie Player can play movies that have been compressed
            using MVC2 which is a compression alogirhtm which
            allows for faster playback of movies.

          o Movie Player can now play black and white movies and
            movies with 8 bit RGB data.

       4.1.3  Bug_Fixes  This section lists the bugs fixed since
       the last release of the Movie Player.

          o Movie Player did not work on any mulit-processor
            machine in the IRIX 5.1 release. It now works on
            mulit-processors.


       4.2  Movie_Maker

       Movie Maker (invoked from the command line as moviemaker) is
       a graphical tool for creating and editing movies.  Movies
       can include images from IRIS ImageVision Library image
       files, sound from audio files, and images and sound from
       movie files.

       Either sound or silent movies can be created.  Movie Maker
       includes cut, copy, and paste editing capabilities for movie
       files.

       On-line help is available describing in detail how to go
       about creating and editing movies.

       4.2.1  Known_Problems_and_Workarounds  This section lists
       problems in the Movie Maker software and ways to work around
       them.

          o Optimizing a movie requires copying the movie file,
            which can take a significant amout of disk space.  If
            there is not enough, Movie Maker will report this fact
            and leave the movie unoptimized.

          o The Undo command is still not supported in this
            release.

          o When previewing a movie, the commands under the Edit
            menu are greyed out. However, the speed key shortcuts
            are still active. Avoid using the speed keys when
            previewing the movie.

          o Movie Maker behaves unintuitively when inserting just
            audio or just image frames into an existing movie. You
            would expect that it would move the existing audio and
            image data together to maintain the syncronization.











                                  - 4 -



            However, only the data in the track that you are
            inserting into gets moved. To workaround, you need to
            insert an equal amount of the other data.

       4.2.2  Changes_from_the_previous_Movie_Maker  This section
       lists the changes in the interface of Movie Maker from the
       4.0.5 version.

          o Movie Maker can read, but not edit, QuickTime movies
            that use Apple's "Animation" and "Video" compression.
            All or part of a QuickTime movie can be exported as an
            SGI movie file for editing.

          o Movie Maker now edits movies in place.  This means that
            any changes made to the movie are immediately reflected
            in the movie file.  The advantage of this change is
            that much less disk space is required for editing
            movies.

          o All of the command-line options for creating movies
            have been taken out of Movie Maker.  The new
            application Make Movie should be used for creating
            movies from the command line.

          o Movies stored in older SGI movie formats (versions 1
            and 2) will be automatically converted to the current
            version (3) when they are edited.


       4.3  Make_Movie

       Make Movie (invoked from the command line as makemovie), is
       a simple command that can be used to create movies from the
       shell from inside a shell script.  It can take IRIS
       ImageVision Library image files, audio files, and existing
       movies and merge them into one movie file.

       Common uses of makemovie are:

          o making a movie from a sequence of rendered images,
            along with a sound track, and

          o translating a QuickTime movie into an SGI movie.

       The man page for makemovie lists all of the available
       options and includes some examples of how to use it.













 



                                  - 1 -



       5.  Capture_Tool

       This chapter lists information about the capture tool in the
       Media Tools set.

       5.1  Capture_Tool

       The Capture Tool (invoked from the command line as capture)
       is a graphical tool that allows you to record audio files,
       movie files or still images from the camera or other video
       source and microphone.

       Currently, the still image capture and movie capture modes
       of the Capture tool work on either an Indy workstation or
       Indigo2 workstation with any SGI video option board.

       See the man page capture(1) or the Capture Tool's on-line
       help for more information.

       5.1.1  Changes_and_Additions  This section lists changes and
       additions to the Capture tool since the IRIX 5.1 release.
       Capture has had a lot of work since its first release. It is
       much more stable and has better image quality and
       performance.

          o An Image Quality button was added to the movie capture
            mode so that the user can choose between high and lower
            quality images. The high quality images record about
            twice the amount of data, so expect a lower frame rate.
            Previously, Capture only supported grabbing 8 bit
            images.

          o The user interface layout and wording has been changed
            especially on the Settings panels.

          o Error reporting has been greatly enhanced to handle out
            of disk space problems as well as frame rate issues.
            The user gets a clear message when the specified frame
            rate is unattainable.

          o The code has been optimized to attain the highest
            possible frame rate given the frame size and image
            quality settings.

       5.1.2  Bug_Fixes  Many, many bugs in Capture have been fixed
       -- too numerous to list.  It's almost like a new tool.

       5.1.3  Known_Problems_and_Workarounds  This section lists
       known problems in the Capture Tool.













                                  - 2 -



          o When in audio mode, it is possible to get the audio
            window in a mode where it can not be resized.  To fix
            this, switch to video mode and back to audio.

          o The default cropping in video is supposed to include
            the entire image, but sometimes it is one pixel off.
            If this is bothersome, you can reset it by bringing up
            the Settings panel, picking "Square Frame" from the
            crop area option menu, and then choosing "Full Frame"
            from the same menu.

          o Sometimes, no sound will be recorded, and no waveform
            will appear in the audio mode.  To fix, bring up the
            Audio Control Panel (invoked from the command line as
            apanel), and click on and off the Monitor button.  You
            should also make sure you have the input source set
            correctly (to use the microphone, select Mic from the
            Input menu).

          o Since the system has limited video resources, it is
            best to avoid running more than one application that
            uses video.  In particular, you shouldn't run Live
            Video Input (videoin from the command line) at the same
            time as running capture.  Nor should you attempt to run
            two instances of capture.

          o It can take up to a second or two for video to start or
            stop recording after you press the Record button.

          o Don't attempt to record a movie with a Movie Frame Rate
            higher than 30 frames per second.

          o The Capture Tool creates large temporary directories to
            hold the raw data when creating movies. Sometimes these
            directories are not removed when capture exits. Since
            the directories begin with a period, ".", you must use
            "ls -a" to see them. Only remove Capture's temporary
            directories when Capture is not running.

          o When the video input timing switches between PAL and
            NTSC, Capture will not always display the correct crop
            area. It might specify that "No Crop" is selected,
            however the red crop outline will not be full screen.
            To workaround, reset the crop to "No Crop".

          o If the frame rate on Capture is set to less than 1
            frame per second, sometimes Capture will abort movie
            creation after a short period of time. Avoid setting
            fractional frame rates.













                                  - 3 -



          o It is possible to create movies using Capture, that are
            not possible to play back. For example, a full sized,
            uncompressed movie, with a high frame rate might be
            impossible to play because of disk IO or CPU
            limitations. Try to limit the size and image quality to
            match the capbilities of the machine on which you want
            to play the movie.

          o Sometimes when previewing a movie, the cursor stays in
            as a "stretch" cursor. It reverts back to the pointer
            at the end of the preview.

          o Capture doesn't work well when capturing audio data and
            the input and/or output sampling rates are set to
            Digital.