MASSCONV 2.00

Copyright (c) 2006 Stoyan Nikolov <stoyannc@yahoo.com>.
MASSCONV uses 3rd party libraries, and is based on paintlib.
For details see the "LICENSE STUFF" part of this file.


For detailed inforamtion, take a look at the "docs" directory.


INSTRUCTIONS ON THE CONSOLE-BASED EXECUTABLE

MassConv converts whole directories of image files. The program is console and GUI based.

Please use this starting form:

massconv.exe [SourceDir] [DestDir] -[Dest Format] OPTIONAL: .[Source Format] [Preserve Structure] [FilterFile].fil

IMPORTANT: give absolute paths, not relative ones. For instance: C:\Some\dir\ NOT ..\dir\
[Destination formats]: -bmp, -png, -jpeg, -tiff.
[Source format] can be any valid supported format (.tga, .psd etc.).
The [preserve structure] flag tells if the directory structure of the source dir should be recreated
in the output one. If not, all output files are sent to the root output dir.
[FilterFile] defines filters to be applied to the converted files. The filter file must have a .fil extension.
For further information see filters.txt.

IMPORTANT:
If any output filenames coincide, files are overwritten without notice.

EXAMPLES:

massconv c:\somedir\ d:\someoutput\dir\ -png
massconv c:\somedir\ d:\someother\ -jpeg .psd {only .psd files will be converted to JPEG}
massconv c:\dir d:\out -tiff -nopres {directory structure won't be preserved}
massconv c:\dir d:\out -tiff MyFilters.fil {apply the filters defined in MyFilters.fil}

IMPORTANT: After the conversion all layer information is lost in all output formats.

For PNG and JPEG formats You can specify some conversion options like the compression level.
These options reside in the PNG.ini and JPEG.ini files, which You can edit to customize the quality
of the output images. There is only 1 option for PNG files:

PNG_COMPRESSION_LEVEL(0); You could change the value in the brackets to a different 
compression level 0-9, where 9 is the strongest one.

For JPEG files available options are:
JPEG_QUALITY(100); Values: 0-100. Defines output quality, 100 is the best, but files are bigger.
JPEG_OPTIMIZED_ENCODING(1); Values:1-0. Enable or disable the generation of optimal Huffmann coding tables.
JPEG_SMOOTHING_FACTOR(0); Values: 0-100. 0 turns it off. Defines the smoothing factor.  


SUPPORTED FORMATS:

Input:

GIF
PGM
PPM
PNG
TGA
TIFF
JPEG
PCX
Photoshop PSD
Windows BMP
Amiga IFF
SGI
Mac PICT

Output:

BMP
JPEG
TIFF(no compression)
PNG


CONTACT

Bug report and suggestions will be highly appreciated. Write to stoyannc@yahoo.com.


LICENSE STUFF

MASSCONV is free software. You can distribute it without permission in non-profit
suites, but it should be given "AS IS". This file must be included. 
Selling this software is prohibited without my express
written approval. You use this software at Your own risk. The author assumes no liability for 
direct, indirect, incidental, special, exemplary, or consequential damages, which may result 
from the use of massconv, even if advised of the possibility of such damage.
MassConv contains paintlib code. paintlib is copyright (c) 1996-2002 Ulrich von Zadow and other contributors.
It also contains the following libraries:
libpng (http://www.libpng.org)
libungif (sourceforge.net/projects/libungif)
JPEG library
zlib (http://www.zlib.net/)
libtiff (http://www.remotesensing.org/libtiff/)
curl (http://curl.haxx.se/)
