
  Readme.txt                                           Dec, 2001


    Moyager, version 1.3.4
    Copyright 1999-2001 Zeljko Nikolic and Robert Tibljas


-----------------------------------------------------------------
  ABOUT MOYAGER
-----------------------------------------------------------------

  Moyager is a multimedia player mainly developed to support
  our HAV file format, but it can do much more. Moyager has a
  unique capability to play image sequences (sequentially
  numbered images) like it plays video files. Image sequences
  are frequently the output of video rendering software, digital
  cameras and other video hardware/software. Moyager can be used
  to preview such sequences in real-time before converting them
  to other more efficient video formats like MPEG, AVI or HAV.

-----------------------------------------------------------------
  SYSTEM REQUIREMENTS
-----------------------------------------------------------------

  * Windows 95 or better with DirectX
  * 1.2 MB of disk space
  * AVIFIL32.DLL, MSVFW32.DLL and MSACM32.DLL
    in Windows System folder

-----------------------------------------------------------------
  DISTRIBUTION
-----------------------------------------------------------------

  This program is copyrighted FREEWARE. You can distribute it
  in any way you want as long as all the files from the original
  package are distributed together and unmodified (recompression
  with another archiver is allowed). Feel free to put it on a
  web site, CD, DVD or any other media.

  This software may not be sold or licensed, neither may a fee
  be charged for its use. If a fee is charged in connection with
  this program it should only cover the minimal cost of copying
  and/or distribution.

-----------------------------------------------------------------
  DISCLAIMER
-----------------------------------------------------------------

  THIS SOFTWARE COMES WITHOUT ANY KIND OF WARRANTY, EITHER
  EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE
  IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A
  PARTICULAR PURPOSE. USE IT AT YOUR OWN RISK. AUTHORS ARE
  NOT RESPONSIBLE FOR ANY DAMAGE OR CONSEQUENCES RAISED BY
  USE OR INABILITY TO USE THIS PROGRAM.

-----------------------------------------------------------------
  USER'S MANUAL
-----------------------------------------------------------------

  MAIN WINDOW
  -----------
  The main window contains standard VCR-style buttons. These
  functions can also be achieved by right-clicking the preview
  image or time/frame display and using the context menu. For
  users that prefer keyboard here are the shortcuts:

    Play................... Enter (Return)
    Toggle play/pause...... Space
    Stop................... Esc
    Open/eject............. Insert
    Jump to start.......... Home
    Large step backward.... Page Up
    Small step backward.... Left arrow, Up arrow
    Small step forward..... Right arrow, Down arrow
    Large step forward..... Page Down
    Jump to end............ End
    File information....... F5
    Options................ F10


  OPTIONS WINDOW
  --------------
  Use the "Options" window to modify various player
  settings:

  "Frame rate" - By modifying this field you can play a
    video clip faster or slower. Default frame rate for
    image sequences is 15 fps.

  "Set as default (image seq.)" - The current frame rate
    will be used as the default when playing image sequences.
    For all other files their original frame rate is used.

  "Repeat forever" - Plays a media clip in an endless loop
    until stopped manually.

  "Show frame rate" - Displays reached frame rate during
    the playing. This value can be less than the desired
    frame rate if the video or audio decoding is too slow.

  "Display all frames" - Shows each frame without skipping.
    This is useful for viewing frames that are often skipped
    because their decompression time is too long. This option
    can cause video to go out of sync with audio.

  "Disable sound" - On some computers playing sound can
    cause errors in execution. Use this switch to turn it
    off and play only video. If you open an audio-only file
    this switch is ignored.

  "Show warning: screen color depth" - If you are using
    low-color display settings the player will show you a
    warning each time it's run. You can switch it off by
    unchecking this option.

  "File Associations" - Assigns or unassigns Moyager as a
    default player for the selected video formats. Default
    player is called to play a file when you double-click it
    in Windows Explorer (and other software).

  "Create Desktop Shortcut" - Creates a shortcut to Moyager
    on Windows Desktop.

  Moyager also supports COMMAND LINE PARAMETERS, which are
  useful when another software calls it. Supported parameters
  are:

  /Open="filename"
  - Opens the file

  /Play="filename"
  - Opens and plays the file

  /PlayClose="filename"
  - Plays the file, then closes the player

  /Inst
  - Adds few lines to Win.Ini so that other apps can find it

  /Uninst
  - Clears all file associations to Moyager

-----------------------------------------------------------------
  IMAGE SEQUENCES
-----------------------------------------------------------------

  Moyager has a unique capability to play sequentially numbered
  images. All you have to do is to open the first image in the
  sequence (the one with the lowest number). Image sequence, as
  understood by Moyager, must comply to the following rules:

  - All the images in the sequence must be of the same type
    (check if they all have the same file extension).
  - Each file must have an equally formatted number in its name
    (e.g. pic0001.tga, pic0002.tga, etc.).
  - There should be no gaps in the numeration
    (pic101, pic102, pic153 won't work).
  - Their resolution must be equal
    (their width and height in pixels).
  - Also, their color depth must be the same
    (i.e. can't mix 8-bit and 24-bit images).

  If you created a sequence with some 3D rendering or video
  capture software these images usually already comply to the
  rules above. If the problem is in the file name numeration
  (gaps between the numbers) use our other product, Renum, to
  add numbers, change them, split and join sequences of files,
  etc. You can find Renum on our web site.

  In the Options dialog you can change the default frame rate
  for playing image sequences.

-----------------------------------------------------------------
  KNOWN ISSUES
-----------------------------------------------------------------

  Though this player can open MPEG and MP3 files, it requires
  a great amount of processing power for smooth playing. On
  slower computers we recommend some other software for playing
  audio/video MPEG files.

-----------------------------------------------------------------
  SUPPORTED FILE FORMATS
-----------------------------------------------------------------

  To reach maximum reproduction performance use Moyager for
  playing media files that it's optimized for. Each file format
  has one of the following markers:

  (+) - optimized for this format
  (=) - real-time playing possible only on faster systems
  (-) - play it with some other (specialized) player


  (+) AVI Windows Audio Video Interleaved
          (avi)
  (+) BAY Bayer Image
          (bay)
  (+) BMP Windows Device Independent Bitmap, 8/15/24bit
          (bmp,dib,rle)
  (+) FLC Autodesk FLIC/FLIC-Pro, 8bit
          (fli,flc)
  (-) GIF Graphics Interchange Format, (read only)
          (gif,giff)
  (+) HAV High quality Audio Video
          (hav)
  (+) JPG Joint Photographic Expert Group, JFIF 1.02
          (jpg,jpeg,jif,jfif,jpe,J)
  (=) MPA MPEG Audio Layer I/II/III, MPEG-1/2
          (mp3,mpa,mp2)
  (=) MPG Moving Pictures Expert Group, MPEG-1
          (mpg,mpeg,mpe,m1v)
  (+) OGG Ogg Vorbis Audio
          (ogg)
  (+) PCX Zsoft Paintbrush, 8/24bit
          (pcx)
  (+) PNG Portable Network Graphics
          (png)
  (+) PNM Portable Image, 8/15/24bit
          (pnm,ppm,pgm)
  (+) RAS Sun Raster Image, 8/24/32bit
          (ras,sun)
  (+) RGB Silicon Graphics Image, 8/24/32bit
          (rgb,rgba,bw,sgi)
  (+) TGA Truevision Targa, 8/15/24/32bit
          (tga)
  (+) TIF Tagged Image File Format
          (tif,tiff)
  (+) WAV Windows Wave Sound
          (wav)
  (=) XPM X-Pixmap
          (xpm)

-----------------------------------------------------------------
  ABOUT HAV FILE FORMAT
-----------------------------------------------------------------

  HAV is our own file format made for real-time playing and
  archiving of high quality audio and video. By using lossless 
  compression HAV format reduces the video size and still offers 
  100% original uncompressed quality. Other famous formats, like 
  AVI, JPEG and MPEG usually use some of the lossy compression 
  schemes which can dramatically decrease the video quality. HAV 
  is especially efficient for compressing computer generated 
  animations and drawings. It compresses at least twice as good 
  as FLI/FLC and supports 256, 64k and 16.7M colors (FLI/FLC 
  supports only up to 256 colors).

-----------------------------------------------------------------
  CREDITS GO TO
-----------------------------------------------------------------

  * GNU-CC and MinGW teams
      gcc-2.95.3 / MinGW 1.1
  * Jordan Russel
      Inno Setup
  * Bjornan Henden and Andrei Stcherbatchenko
      IS Tool for Inno Setup
  * Mark Adler, Richard B. Wales, Jean-loup Gailly,
    Onno van der Linden and Kai Uwe Rommel
      ZIP compression and file packaging utility

  Moyager is based in part on the work of the following people:
  * Independent JPEG Group
      JPEG library release 6b
  * Group 42, Inc. and all contributing authors
      PNG reference library version 1.0.12
  * Jean-loup Gailly and Mark Adler
      ZLIB library version 1.1.3
  * Sam Leffler and Silicon Graphics, Inc.
      TIFF library version 3.4 beta 037
  * The Regents of the University of California
      BERKELEY MPEG TOOLS, Version 1.0, Release 2
  * Brent Beyeler
      bbMPEG and bbTools
  * ISO MPEG Audio Subgroup Software Simulation Group
      MPEG-2 Audio Simulation Software Distribution 10
  * MPEG Software Simulation Group
      MPEG-2 Encoder / Decoder, Version 1.2
  * GROUPE BULL
      XPM library version 3.4k
  * The XIPHOPHORUS Company
      Ogg Vorbis audio format library
  * Armin Sander of Digital SimpleX
      Audio Compression Manager public header file
  * Erik Unger
      DirectX public header files

-----------------------------------------------------------------
  HOME PAGE
-----------------------------------------------------------------

  Home page:
    http://gromada.com/Moyager.html

  Main web site:
    gromada.com

-----------------------------------------------------------------
END OF DOCUMENT
