ALeX: Project JPEG2MOV

JPEG2MOV V2.3 (1999-06-15)

Creates a QuickTime-Movie

The latest Version can be found under:
http://www.kazik.de/en/jpeg2mov.html
My HomePage: http://www.kazik.de/alx/

Requirements

68020+, AmigaOS 2.04? (Tested: 3.1)

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

-RAW, 8/16bits, 100Hz-65kHz, 1/2 Channels, MSBF, Signed (Cli-Only)

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

It is also possible to use QuickTime3 (Registred) on an Mac or PC to Recompress any Movie. URL: http://quicktime.apple.com/.

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=FREQ/K/N,BITS/K/N,CHANNELS=CHAN/K/N,HEADER/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.

Scale / Crop-Options:

The program does not change the pictures, 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, then 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:

AIFF: Required Options:

SOUNDFILE=SND/K

The soundfile

AIFF: 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.

RAW: Required Options:

SOUNDFILE=SND/K	The soundfile
FREQ/K/N	The Frequency (100Hz - 65kHz)
BITS/K/N	8 or 16 bits There must be signed datas 16bit format: Motorola (MSBF)
CHANNELS/k/N	1 or 2 Channels Stereo must be interleaved

RAW: Optional Parameters:

HEADER/K/N

Skip the first n Bytes of the file

Thats all, have fun!!

Note for MovieShop Users

If some programms (e.g. MovieShop) don't allow to store to PIPE: (cause it's no filesystem), get the "PipeHandler.lha" from AmiNet.

Save a MovieShop Block direct to a QT-Movie

Get the "PipeHandler.lha" from the AmiNet and install them
Mount "PIPE-DIR:" (from the PipeHandler).
Export the sound to an AIFF-Sample (if You want have sound)
Export the pictures (JPEG-Direct) to "PIPE-DIR:p"
Use JPEG2MOV with
- FROM=PIPE-DIR:p.00001 (or similar)
- TO=<where You want>
- ORIGFPS=50 (PAL, 60 for NTSC)
- If You want to reduce the the FPS-Rate:
  - Use FPS or SEQUENCE
  - Always switch the opention READALL on.
- Assuming, that the original screen size is 768x544, the QT-Movie will have the size of 768x272. To change that You can do that:
  - SACLEWIDTH=384, to correct the aspect
- To use only the std. size:
  - CROPWIDTH=320
  - CROPHEIGHT=240
- SND=<the sound file> (if You want have sound)
- Read the documentation above for more informations.
Thats all.

Known Bugs

None.

Disclaimer

The program is CardWare, also: You have to write me a postcard of Your town. (If You really don't have enough money for that, send me an EMail)

Use it at Your own risk!

History

History:
2.3	1999-06-15	Removed the "Draco Feature" Added Support for RAW-Sound Small Stack Bugfix
2.2	1999-05-23	Bugfix: Colored PNM picture reader Bugfix: Added some GUI error requester Bugfix: Corrected the CTRL-C handling Corrected the CLI-Output a bit Changed the documentation to HTML Added a section to the documentation
2.1	1999-01-30	Bugfix: CLI: MAXFRAMES Made the CLI-Output more readable
2.0	1998-12-26	GUI
1.9	1998-11-22	Sound support PNM support
1.0	1998-09-29	First release