| Name |
mvcd-process
|
| Version |
1.12 |
| Updated |
2003/03/16 22:51:19 |
| RCS |
mvcd-process,v 1.12 2003/03/16 22:51:19 forman Exp forman |
| Rating |
|
| Category |
Photography, File manipulation |
| Description |
mvcd-process is a multipurpose program designed originally to read photos off of a Sony Mavica CD 8-cm disk and create a digital photo album. The photo album consists of a directory containing the original pictures, pictures reduced in size to 640x480, thumbnails of the pictures, photographic indexes of all pictures and mpeg movies, and an html index file to explore the directories with a web browser.
In summary, the program in basic mode expects and provides the following:
Input: A finalized Mavica 8-cm CD with images and movies
Output: A photo album in a directory containing:
The original mpg movies
The original jpg pictures
The pictures at 640x480 suitable for emailing
The pictures at 240x180 to be used as thumbnails
The first frame of each movie at 240x180
Index pictures showing 24 images at a time
An html index file for viewing with a web browser
Since the original inception of the program several extend modes have been developed. The extended modes and their functionality are as follows:
The ability to generate photo albums from sources other than a 8-cm Mavica CD.
The ability to interrupt the program and have it continue where it left off without redoing work that's already been done.
The ability to regenerate html files and index pictures to reflect a change in date or title.
|
Download |
mvcd-process
|
MVCD-PROCESS(1)User Contributed Perl DocumentationMVCD-PROCESS(1)
NAME
mvcd-process - generates a photo album from image sources.
SYNOPSIS
mvcd-process [ -h ] [ -fgnrs ] [ -t "Title" ] [ -d "YYYY-
MM-DD" ] [ -S [directory] ] [ -D [directory] ]
DESCRIPTION
mvcd-process is a multipurpose program designed originally
to read photos off of a Sony Mavica CD 8-cm disk and cre
ate a digital photo album. The photo album consists of a
directory containing the original pictures, pictures
reduced in size to 640x480, thumbnails of the pictures,
photographic indexes of all pictures and mpeg movies, and
an html index file to explore the directories with a web
browser.
In summary, the program in basic mode expects and provides
the following:
Input: A finalized Mavica 8-cm CD with images and movies
Output: A photo album in a directory containing:
· The original mpg movies
· The original jpg pictures
· The pictures at 640x480 suitable for emailing
· The pictures at 240x180 to be used as thumbnails
· The first frame of each movie at 240x180
· Index pictures showing 24 images at a time
· An html index file for viewing with a web browser
Since the original inception of the program several extend
modes have been developed. The extended modes and their
functionality are as follows:
· The ability to generate photo albums from sources
other than a 8-cm Mavica CD.
· The ability to interrupt the program and have it con
tinue where it left off without redoing work that's
already been done.
· The ability to regenerate html files and index pic
tures to reflect a change in date or title.
OPTIONS
-D --destination [directory]
Specify the name of the destination directory. The
default is MVCD-YYYY-MM-DD where YYYY-MM-DD is an iso-6801
compliant date string for the current date.
-S --src --source [directory]
Specify the name of the source directory.
If this option is not set, the program will attempt to
mount the CD on the mount point "/cdrom".
If this option is set, the program will not mount the CD
and assume that you have either mounted the CD yourself or
have preexisting files in the directory.
-d --date [date]
Specifies a date in iso-6801 compliant form (YYYY-MM-DD).
This is used for setting the correct date while processing
an old disk.
-h --help
Prints this information.
-f --force
The program will automatically exit if the destination
directory already exists to prevent the loss of data.
This option will force the program to continue. This is
necessary if continuing a previously interrupted conver
tion attempt.
-g --glean
For users who are building a photo album from a preexist
ing directory, the glean flag, -g, will attempt to pull
the date out of the source directory name set by the flag
"-S". If there is no iso-6801 compliant date embeded in
the name of the directory (such as 2001-10-14-San
dia_Labs), the current date will be used. This is consid
ered an advanced option (in other words something that I
find useful because I'm lazy.)
--nocal
Don't create HTML calendar.
--nompeg --nompg
Don't create thumbnails of mpeg files.
-r --regenerate
Regenerate the html index file and image index files to
reflect a change in the title or date. Note: this option
must be invoked with the source directory (-S [direc
tory]), the new date (-d [YYYY-MM-DD]), and the new title
(-t [title]). It assumes the images are in the subdirec
tory "jpg" and the movies are in the subdirectory "mpg".
-s --simple
This is set if the source directory does not use the Mav
ica CD naming convention, but instead is a simple direc
tory. A simple directory contains two subdirectories, one
called "jpg" and one called "mpg". This is useful for
using the program to build thumbnails, indexes, and html
files on pictures and movies that are not stored on a Mav
ica CD.
When using this flag, it is almost always neccessary to
define a source directory with the -S flag.
-t --title [title]
Set the title that will appear in the html and on the
index images.
-v --verbose
Print detailed debugging information.
EXAMPLE
The example below is the standard usage. It assumes that
the source directory and mount point for the 8-cm Mavica
CD is "/cdrom" and places the processed files into a
directory called MVCD-YYYY-MM-DD. Index pictures and html
files will be stamped with the current date (YYYY-MM-DD)
and given the title "Birthday Party".
mvcd-process -t "Birthday Party"
The next example calls the simple, "-s", flag with the
source directory set by "-S" to "/scratch". This tells
the program to look for pictures in the directory
"/scratch/jpg" and movies in the directory "/scratch/mpg".
mvcd-process -S /scratch -s -t "Title"
The following example is used to regenerate html and image
index files using the regenerate flag, "-r". When using
regenerate, the specified destination directory acts as
both the source and destination of the files.
mvcd-process -r -S MVCD-2001-10-14 -d 2001-10-14
-t "Title"
The final example is useful with Kodak Picture CDs. Since
the date of the pictures is not preserved on a disk, use
the "--nocal" flag to supress the HTML calendar and "-p"
to preserve the original file names. Copy the files to a
directory called "tmp/jpg" and execute the following:
mvcd-process -p --nocal -s -S tmp -t "Title"
BUGS
· Currently calls ImageMagick utils using the shell.
Needs to be updated to use the ImageMagick perl mod
ule.
· A bug in ImageMagick won't allow processed files to be
copied across mounted file systems. Because of this
it is necessary to copy files to the same disk where
"/tmp" resides (to a subdir in tmp), convert the
files, then copy the converted files back to destina
tion directory.
SEE ALSO
mvcd-process, mpeg_play, ImageMagick, convert, montage,
mogrify
AUTHOR AND COPYRIGHT
Michael Forman http://www.Michael-Forman.com
Copyright (C) 2001, 2002 Michael Forman. All rights reserved.
This program is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
Please see the Perl Artistic License.
VERSION
Current Revision: $Revision: 1.12 $
Last Modification: $Date: 2003/03/16 22:51:19 $
perl v5.8.1 2004-03-16 MVCD-PROCESS(1)
