Short:    Creates a QuickTime-Movie with many JPEGs in it (+GUI)
Author:   ALeX Kazik <alex@kazik.de>
Uploader: ALeX Kazik <alex@kazik.de>
Version:  2.0
Type:     gfx/conv
Requires: 68020+, AmigaOS 2.04? (Tested: 3.x)


News:
=====

It has an own GUI!
Support of sound and more picture types.


Overview:
=========

This litte tool allows you to create a QT-MOV from many pictures.
You can directly save a MovieShop project to a MOV, for example.

All pictures must have the same size.
The pictures will be stored in the MOV without any changes.

Supported picture types:
-JPEG, 8bit greyscale
-JPEG, 24bit color
-PNM: pgm, 8bit greyscale, format P5 
-PNM: ppm, 24bit color, format P6

Supported sound types:
-AIFF, 1-16bits, 100Hz-65kHz, 1/2 Channels

Such movies will be very big, if You're using PNM, or it won't be
playable on the most computers, if You're using JPEG. So just take the
movie, use an (emulated) Macintosh and e.g. the shareware program
"DesktopMovieFat" to recompress the movie!!

URL: ftp://ftp.leo.org/pub/comp/os/macintosh/leo/quicktime/desktop-movie-150.sit


Usage:
======

There are two ways to use JPEG2MOV.
-The Command Line Interface (CLI)
-The Graphical User Interface (GUI)


GUI-Usage:
==========

The GUI requires MUI 3.x (tested 3.8)!

Just start JPEG2MOV from WorkBench, or from CLI with "gui" as the only parameter.

I hope that the GUI is self explainend.

For general help, read the CLI section.

The CLI-Version is more powerful!


CLI-Usage:
==========

JPEG2MOV FROM,TO/A,START/N,MAXFRAMES/K/N,
         SCALEWIDTH=SW/K/N,SCALEHEIGHT=SH/K/N,
         CROPWIDTH=CW/K/N,CROPHEIGHT=CH/K/N,CROPTOP=CT/K/N,CROPLEFT=CL/K/N,
         ORIGFPS=OLDFPS/K/N,FPS=NEWFPS/K/N,SEQUENCE=SEQ/K,TIMESCALE/K/N,SPEED/K/N,
         SOUNDFILE=SND/K,SETFREQ/K/N,
         READALL/S/K,INFO/S


Required Options:
-----------------

TO/A = The movie that should be build. An existing file will be overwitten!

And you have to specify video and/or sound.


Optional Parameters:
--------------------

INFO/S = Just show information about the movie, which will be created,
         but don't do it.


Video:
======

Required Options:
-----------------

FROM/A = The path and name of the pictures. There are two methods:
         -Specify an ANSI-C-type-form-string for the pictures,
          e.g. "JP:pic.%04d.jpeg" (only if you know what you do!!)
         -Specify the first picture: e.g. "JP:pic.0012.jpeg", the program
          will automatically convert it to the other format and extract the
          first picure.

To specify the speed of the movie (FPS) You have many options.
If the stored pictures have the same speed like the movie, just specify
one of this options:

ORIGFPS=OLDFPS/K/N = The FramesPerSecond of the images.
NEWFPS=FPS/K/N = The FramesPerSecond of the movie.
TIMESCALE/K/N,SPEED/K/N = TIMESCALE divides one second into units.
                          SPEED is how long an picture should be displayd
                          (measured in units). Example: TIMESCALE=600,
                          SPEED=10 -> FPS=TIMESCALE/SPEED=60

If the original and the new FPS-rates are different, You have some
methods to do that.
The skipped pictures won't be stored in the movie.

SEQUENCE=SEQ/K = An text which specifies, which picture should be picked "P"
                 (stored in the movie) or skipped "S".

Now You can do some combinations:
-ORIGFPS and NEWFPS
-ORIGFPS and SEQUENCE
-NEWFPS and SEQUENCE
-TIMESCALE+SPEED and SEQUENCE

Tip: switch on INFO an play a little bit with this options.


Optional Parameters:
--------------------

START/N = Specifies the first picture. It defaults to the number, which will
          be extracted from the FROM-Option - if there is a number in it -
          or 1.

MAXFRAMES/K/N = Maximum numbers of frames to read/skip. (If Your orig and new
                FPS-Rate are equal, this means also the numbers of written frames)

READALL/S/K = Force to read all pictures, even if there skipped.
              This option is essential, if you've stored the pics a PIPE
              and only want to read some of the pictures.
              
Note: If some programms (e.g. MovieShop) don't allow to store to PIPE: (cause
      it's no filesystem), get the "PipeHandler.lha" from AmiNet.


Scale / Crop-Options:
---------------------

The program does NOT change the JPEGs, it will only set the needed options
in the movie, that tell good QT-Programs that the movie should be shown
scaled/cropped.
QT and CyberQT do not support them at all. The Windows QT-Player supports
scaling.
All Mac programs support both!

SCALEWIDTH=SW/K/N,SCALEHEIGHT=SH/K/N = The size of the scaled picture.
                                       (default: original picture)

The picture will be first scaled, than cropped.

CROPWIDTH=CW/K/N,CROPHEIGHT=CH/K/N = The size of the cropped picture.
                                     (default: scaled picture)

CROPTOP=CT/K/N,CROPLEFT=CL/K/N = The offset to the left-top-edge of the
                                 cropped picture. (default: the picture will
                                 be centered)


Audio:
======

Required Options:
-----------------

SOUNDFILE=SND/K = The soundfile.


Optional Parameters:
--------------------

SETFREQ/K/N = If Your soundfile e.g. have the frequency 40099 but You're knowing
              that that is an error, You can change the rate with this option to
              44100 (or any other freq.).

        Note: The sample will not be resampled, only the signature will be changed.


Thats all, have fun!!


History:
========

Version 2.0 (26.12.98)
- GUI

Version 1.9 (22.11.98)
- Sound support
- PNM support

Version 1.0 (29.09.98)
- First release


Author:
=======


                        ALeX  Kazik
                    Stapenhorststr.  81
                      33615 Bielefeld
                          Germany

                   E-Mail: alex@kazik.de
            HomePage:  http://www.kazik.de/alex





                                                ###### ##      ####  ##   ##
                                               ##   ## ##     ##  ##  ## ##
                                               #### ## ##     ######   ###
                                               ## #### ##     ##      ## ##
                                               ##   ## ######  ####  ##   ##


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
   40716   22549 44.6% 26-Dec-98 11:43:38  JPEG2MOV
    2502    1566 37.4% 26-Dec-98 11:58:54  JPEG2MOV.info
    6346    2595 59.1% 26-Dec-98 14:26:18  JPEG2MOV.readme
-------- ------- ----- --------- --------
   49564   26710 46.1% 27-Dec-98 06:11:06   3 files
