ReaConverter Pro online documentation
Contents:
Overview
Command line utility
Format of text script file
Format of config file
Supported file formats
Overview:
ReaConverter Pro has easy to use and powerful utilities for batch conversion of image files using scripts!
To convert image files using ReaConverter Pro you need to:
- select files you want to be converted and add them to the File List;
- choose an action, set parameters and add the action to a script;
- specify save parameters and press the Start button to begin the conversion.
Before adding a command to the script you may apply it to the test image. Also, you can test the script or any action on a test image.
The following actions are available:
- resize, crop images
- rotate, mirror images
- change color resolution
- change image's brightness, contrast, and gamma
- change color balance using the filters, which operate in RGB, CMY, YCbCr, HLS, and HSV color spaces
- modify images using the sharpen, detail, smooth, blur, and contour effects
- add transparency watermarks and borders
- replace one color with another
- convert images to BMP, JPG, GIF, PBM, PGM, PNG, PPM, TGA, TIF formats
- rename converted files
- make a transparent GIF
Command line utility:
ReaConverter Pro command line utility allows you to process image files in console mode using script file (*.wps) created by the ReaConverter Pro main program or using a text script file (*.wpt) created by any text editor.
Format for using the command line utility:
cons_pic.exe config.cfg script.wps
or
cons_pic.exe config.cfg script.wpt
Where config.cfg is the configuration file like this:
[Common]
Source=c:\
Ext_source=TIF
Destination=c:\123
Ext_dest=jpg
Same_date=0
Save_path=1
Use_FileList=c:\filelist.txt
Read_Subfolders=0
[File name]
Prefix=new_
Suffix=_new
Add_prefix=0
Add_suffix=0
File_case=0
Ext_case=0
[Jpeg]
Quality=75
Resolution=200
[Gif]
Transparency=0
Auto_color=0
Color_red=0
Color_green=0
Color_blue=0
[Thumbnail]
Create=1
Destination=c:\
Jpg_quality=75
Jpg_res=72
Height=100
Width=150
Save_path=1
Prefix=thumb_
Suffix=_thumb
Add_prefix=0
Add_suffix=0
Ext_case=1
Case=1
Resize_type=1
And script.wpt is a text script file like this:
Watermark(C:\NOT_REG.BMP;100;100;100)
Add_Border(5;128;128;128;1)
Rotate(90;1;128;128;128)
Mirror(1)
Crop(10;10;10;10)
Resize(100;100;1)
HSV(0;0;0)
Smooth(0.75;50;1)
Blur(2.50;50)
Sharpen(0.75;50;1)
Detail(0.75;50;1)
Contour(1.00;100;1;1)
BCG(0;0.58;1.65;2)
RGB(30;0;0)
CMY(0;0;0)
YCbCr(0;0;0)
HLS(0;0;0)
Color_Replace(128;128;128;128;128;128;5)
Change_to_2(1)
Change_to_16(1)
Change_to_256(1)
Change_to_True
Change_to_Gray(1)
Change_to_Negative
Format of text script file:
There is a new format for script files (*.wpt) you can use to process your image files. The script file is just a text file that can be created by any text editor (like notepad). Each string line of the file must be one of the following commands:
BCG(i1;r1;r2;p1) change Brightness, Contrast and Gamma balance
i1 - brightness (integer from -100 to 100 %)
r1 - contrast (real from 0.2 to 5.0)
r2 - gamma (real from 0.2 to 5.0)
For p1 = 1 the filter will applied on Y
p1 = 2 the filter will applied on RGB
RGB(i1;i2;i3) change Red, Breen and Blue balance
i1 - Red (integer from -100 to 100 %)
i2 - Green (integer from -100 to 100 %)
i3 - Blue (integer from -100 to 100 %)
CMY(i1;i2;i3) change Cyan, Magenta and Yellow balance
i1 - Cyan (integer from -100 to 100 %)
i2 - Magenta (integer from -100 to 100 %)
i3 - Yellow (integer from -100 to 100 %)
YCbCr(i1;i2;i3) change Y, Cb and Cr balance
i1 - Y (integer from -100 to 100 %)
i2 - Cb (integer from -100 to 100 %)
i3 - Cr (integer from -100 to 100 %)
HLS(i1;i2;i3) change Hue, Luminance and Saturation balance
i1 - Hue (integer from -100 to 100 %)
i2 - Luminance (integer from -100 to 100 %)
i3 - Saturation (integer from -100 to 100 %)
HSV(i1;i2;i3) change Hue, Saturation and Volume balance
i1 - Hue (integer from -100 to 100 %)
i2 - Saturation (integer from -100 to 100 %)
i3 - Volume (integer from -100 to 100 %)
Smooth(r1;i1;p1) apply Smooth filter
r1 - Std. deviation (real from 0.4 to 1.3)
i1 - Strength (integer from 10 to 100 %)
For p1 = 1 the filter will use Tent distribution shape
p1 = 2 the filter will use Rect distribution shape
p1 = 3 the filter will use Gaussian distribution shape
Blur(r1;i1) apply Blur filter
r1 - Readius (real from 0.5 to 2.5)
i1 - Strength (integer from 10 to 100 %)
Sharpen(r1;i1;p1) apply Sharpen filter
r1 - Std. deviation (real from 0.4 to 1.3)
i1 - Strength (integer from 10 to 100 %)
For p1 = 1 the filter will use Tent distribution shape
p1 = 2 the filter will use Rect distribution shape
p1 = 3 the filter will use Gaussian distribution shape
Detail(r1;i1;p1) apply Detail filter
r1 - Std. deviation (real from 0.4 to 1.3)
i1 - Strength (integer from 10 to 100 %)
For p1 = 1 the filter will use Tent distribution shape
p1 = 2 the filter will use Rect distribution shape
p1 = 3 the filter will use Gaussian distribution shape
Contour(r1;i1;p1;p2) apply Contour filter
r1 - Std. deviation (real from 0.4 to 1.3)
i1 - Strength (integer from 100 to 1000 %)
For p1 = 1 the filter will use Tent distribution shape
p1 = 2 the filter will use Rect distribution shape
p1 = 3 the filter will use Gaussian distribution shape
For p2 = 1 the filter will use White background
p2 = 2 the filter will use Black background
Contour(r1;i1;p1;p2) apply Contour filter
r1 - Std. deviation (real from 0.4 to 1.3)
i1 - Strength (integer from 100 to 1000 %)
For p1 = 1 the filter will use Tent distribution shape
p1 = 2 the filter will use Rect distribution shape
p1 = 3 the filter will use Gaussian distribution shape
Rotate(i1;p1;i2;i3;i4) Rotate an image
i1 - Angle (integer from 0 to 360)
i2 - Red component of background color (integer form 0 to 255)
i3 - Green component of background color (integer form 0 to 255)
i4 - Blue component of background color (integer form 0 to 255)
For p1 = 1 the an image will be rotated Clockwise
p1 = 1 the an image will be rotated Counter clockwise
Mirror(p1) Mirror an image
For p1 = 1 the an image will be mirrored Vertically
p1 = 1 the an image will be mirrored Horizontally
Crop(i1;i2;i3;i4) Crop an image from adges
i1 - Pixels from an image Top (integer)
i2 - Pixels from an image Bottom (integer)
i3 - Pixels from an image Left (integer)
i4 - Pixels from an image Right (integer)
Crop(i1;i2) Crop an image from center
i1 - Height (integer)
i2 - Width (integer)
Resize(i1;i2;p1) Resize an image by Pixels
i1 - New Height of an image (integer)
i2 - New Width of an image (integer)
For p1 = 1 Height will be used to calculate new Width (keepping aspect)
p1 = 2 Width will be used to calculate new Height (keepping aspect)
p1 = 3 both Height and Width will be used to resize an image (without keepping aspect)
Resize(i1;i2) Resize an image by Percentage
i1 - Procent of current Height of an image (integer from 1 to 100 %)
i2 - Procent of current Width of an image (integer from 1 to 100 %)
Watermark(s1;i1;i2;i3) Add Watermark without transperency effect
s1 - Full path to watermark imege file (string without quotation marks)
i1 - Percent horizontal position of left upper watermark image's corner (integer from 1 to 100 %)
i2 - Percent vertical position of left upper watermark image's corner (integer from 1 to 100 %)
i3 - Opacity percent of watermark image (integer from 1 to 100 %)
Watermark(s1;i1;i2;i3;i4;i5;i6;i7) Add Watermark with transperency effect
s1 - Full path to watermark imege file (string without quotation marks)
i1 - Percent horizontal position of left upper watermark image's corner (integer from 1 to 100 %)
i2 - Percent vertical position of left upper watermark image's corner (integer from 1 to 100 %)
i3 - Opacity percent of watermark image (integer from 1 to 100 %)
i4 - Red component of transparency color (integer form 0 to 255)
i5 - Green component of transparency color (integer form 0 to 255)
i6 - Blue component of transparency color (integer form 0 to 255)
i7 - Tolerance value for transparency color coincidence (integer from 0 to 100)
Add_Border(i1;i2;i3;i4;p1) Add color border to an image
i1 - Border width (integer)
i2 - Red component of border color (integer form 0 to 255)
i3 - Green component of border color (integer form 0 to 255)
i4 - Blue component of border color (integer form 0 to 255)
For p1 = 1 Border shape will be ellipse
p1 = 2 Border shape will be rectangle
Color_Replace(i1;i2;i3;i4;i5;i6;i7) replace colors of pixels
i1 - Red component of original color (integer form 0 to 255)
i2 - Green component of original color (integer form 0 to 255)
i3 - Blue component of original color (integer form 0 to 255)
i4 - Red component of replacement color (integer form 0 to 255)
i5 - Green component of replacement color (integer form 0 to 255)
i6 - Blue component of replacement color (integer form 0 to 255)
i7 - Tolerance value for the colors coincidence (integer from 0 to 100)
Change_to_2(p1) Change color resolution to 2 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_4(p1) Change color resolution to 4 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_8(p1) Change color resolution to 8 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_16(p1) Change color resolution to 16 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_32(p1) Change color resolution to 32 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_64(p1) Change color resolution to 64 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_128(p1) Change color resolution to 128 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_256(p1) Change color resolution to 256 colors
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_True Change color resolution to True colors
Change_to_Gray(p1) Change color resolution to Gray (8 bits)
For p1 = 1 will be used dithering
p1 = 2 will not be used dithering
Change_to_Negative Make negative color transformation
This is an example of a text script file:
Watermark(C:\NOT_REG.BMP;100;100;100)
Add_Border(5;128;128;128;1)
Rotate(90;1;128;128;128)
Mirror(1)
Crop(10;10;10;10)
Resize(100;100;1)
HSV(0;0;0)
Smooth(0.75;50;1)
Blur(2.50;50)
Sharpen(0.75;50;1)
Detail(0.75;50;1)
Contour(1.00;100;1;1)
BCG(0;0.58;1.65;2)
RGB(30;0;0)
CMY(0;0;0)
YCbCr(0;0;0)
HLS(0;0;0)
Color_Replace(128;128;128;128;128;128;5)
Change_to_2(1)
Change_to_4(1)
Change_to_8(1)
Change_to_16(1)
Change_to_32(1)
Change_to_64(1)
Change_to_128(1)
Change_to_256(1)
Change_to_True
Change_to_Gray(1)
Change_to_Negative
Format of config file (*.cfg)
Section [Common]
1) Source = string with path to image files you want to be converted
2) Ext_source = string with extension (type) of image files you want to be converted
3) Destination = string with path to the destination folder
4) Ext_dest = string with extension (type) of converted image files
5) Same_date = 1 if you want to set converted file date same as original file and = 0 otherwise
6) Save_path = 1 if you want to convert with saving path info of an original file and = 0 otherwise
7) Use_FileList = string with path to a text file with list of files you want to be converted
8) Read_Subfolders = 1 if you want to process files from subfolders of folder
defined by "Source" parameter and = 0 therwise
Examples:
1. It will process all TIF files from c:\
[Common]
Source=c:\
Ext_source=TIF
Destination=c:\123
Ext_dest=jpg
Same_date=0
Save_path=1
Use_FileList=
Read_Subfolders=0
2. It will process all files described in filelist.txt.
[Common]
Source=c:\
Ext_source=TIF
Destination=c:\123
Ext_dest=jpg
Same_date=0
Save_path=1
Use_FileList=c:\filelist.txt
Read_Subfolders=0Example of filelist.txt:
c:\folder1\file1.bmp
c:\folder1\file2.jpg
c:\folder2\folder3\file2.png
Section [File name]
1) Prefix = string with prefix that will be added to filename of converted files
2) Suffix = string with suffix that will be added to filename of converted files
3) Add_prefix = 1 if you want to add prefix to filename of converted files and = 0 otherwise
4) Add_suffix = 1 if you want to add suffix to filename of converted files and = 0 otherwise
5) File_case = 0 for lower case, = 1 for upper case and = 2 for no change of converted filenames
6) Ext_case = 1 if you want to get converted files with lower case extension and = 0 otherwise
Example:
[File name]
Prefix=new_
Suffix=_new
Add_prefix=0
Section [Jpeg]
1) Quality = quality for converted JPG files (from 5 to 100%)
2) Resolution = resolution for converted JPG files (from 1 to 10000dpi)
Example:
[Jpeg]
Quality=75
Resolution=200
Section [Gif]
1) Transparency = 1 if you want to create transparent GIF file and = 0 otherwise
2) Auto_color = 1 if you want the program to take transparency color in auto mode and = 0 otherwise
3) Color_red = red component of transparency color (from 0 to 255)
4) Color_green = green component of transparency color (from 0 to 255)
5) Color_blue = blue component of transparency color (from 0 to 255)
Example:
[Gif]
Transparency=1
Auto_color=1
Color_red=0
Color_green=0
Color_blue=0
Section [Thumbnail]
1) Create = 1 if you want to create thumbnail copy of converted image to JPG file and = 0 otherwise
2) Destination = string with path to the destination folder
3) Jpg_quality = quality for converted JPG files (from 5 to 100%)
4) Jpg_res = resolution for converted JPG files (from 1 to 10000dpi)
5) Height = height of thumbnail copy in pixels
6) Width = width of thumbnail copy in pixels
7) Save_path = 1 if you want to save copy with path info of an original file and = 0 otherwise
8) Prefix = string with prefix that will be added to filename of thumbnail copy
9) Suffix = string with suffix that will be added to filename of thumbnail copy
10) Add_prefix = 1 if you want to add prefix to filename of thumbnail copy and = 0 otherwise
11) Add_suffix = 1 if you want to add suffix to filename of thumbnail copy and = 0 otherwise
12) Ext_case = if you want to get thumbnail copy files with lower case extension and = 0 otherwise
13) Case = 0 for lower case, = 1 for upper case and = 2 for no change of thumbnail copy filenames
14) Resize_type = 1 to use both height and width of thumbnail copy,
= 2 to use only height (keep aspect) and = 3 to use only width (keep aspect)
Example:
[Thumbnail]
Create=1
Destination=c:\
Jpg_quality=75
Jpg_res=72
Height=100
Width=150
Save_path=1
Prefix=thumb_
Suffix=_thumb
Add_prefix=0
Add_suffix=0
Ext_case=1
Case=1
Resize_type=1
Supported file formats:
BMP (Bitmap, OS/2 RGB)
Read: 1 bit, 4 bit, 8 bit Color, 24 bit
BMP (Bitmap, Windows RGB)
Read: 1 bit, 4 bit, 8 bit Color, 16 bit Color, 24 bit, 32 bit
Write: 1 bit, 4 bit, 8 bit Color, 24 bit
BMP (Bitmap, Windows RLE)
Read: 4 bit, 8 bit Color
DIB (Bitmap, OS/2 RGB)
Read: 1 bit, 4 bit, 8 bit Color, 24 bit
DIB (Bitmap, Windows RGB)
Read: 1 bit, 4 bit, 8 bit Color, 16 bit Color, 24 bit, 32 bit
DIB (Bitmap, Windows RLE)
Read: 4 bit, 8 bit Color
DCR (Kodak DCR Format)
Read: 24 bit
MF (Enhanced Metafile)
Read: 8 bit Color
GIF (Graphics Interchange Format)
Read: 3 bit, 4 bit, 5 bit Color, 6 bit Color, 7 bit Color, 8 bit Color
Write: 3 bit, 4 bit, 5 bit Color, 6 bit Color, 7 bit Color, 8 bit Color
ICO (Windows Icon)
Read: 4 bit
JIF (JPEG, Huffman Standard)
Read: 8 bit Gray, 24 bit
JIF (JPEG, Huffman Progressive)
Read: 8 bit Gray, 24 bit
JPG (JPEG, Huffman Standard)
Read: 8 bit Gray, 24 bit
Write: 8 bit Gray, 24 bit
JPG (JPEG, Huffman Progressive)
Read: 8 bit Gray, 24 bit
Write: 8 bit Gray, 24 bit
JPEG (JPEG, Huffman Standard)
Read: 8 bit Gray, 24 bit
JPEG (JPEG, Huffman Progressive)
Read: 8 bit Gray, 24 bit
PBM (Portable Bitmap, ASCll)
Read: 1 bit
Write: 1 bit
PBM (Portable Bitmap, Binary)
Read: 1 bit
Write: 1 bit
PCX (Paintbrush, Version 2.5)
Read: 1 bit
PCX (Paintbrush, Version 2.8)
Read: 1 bit, 4 bit
PCX (Paintbrush, Version 3.0)
Read: 1 bit, 4 bit, 8 bit Color, 24 bit
PGM (Portable Graymap, ASCll)
Read: 8 bit Gray
Write: 8 bit Gray
PGM (Portable Graymap, Binary)
Read: 8 bit Gray
Write: 8 bit Gray
PNG (Portable Network Graphics)
Read: 2 bit, 4 bit, 8 bit Gray, 8 bit Color, 16 bit Color, 24 bit, 48 bit
Write: 1 bit, 4 bit, 8 bit Gray, 8 bit Color, 24 bit
PPM (Portable Pixelmap, ASCll)
Read: 24 bit
Write: 24 bit
PPM (Portable Pixelmap, Binary)
Read: 24 bit
Write: 24 bit
RLE (Bitmap, Windows RLE)
Read: 4 bit, 8 bit Color
TGA (Truevision Targa, uncompressed)
Read: 8 bit Color, 16 bit Gray, 24 bit
Write: 8 bit Color, 24 bit
TGA (Truevision Targa, compressed)
Read: 8 bit Color, 16 bit Gray, 24 bit
TIF (Kodak DCS TIF Format)
Read : 24 bit
TIF (Tagged Image File Format, uncompressed)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
Write: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIF (Tagged Image File Format, Packbits)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIF (Tagged Image File Format, CCITT Group 3, 1D)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIF (Tagged Image File Format, CCITT Group 3, 2D)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIF (Tagged Image File Format, CCITT Group 4, 2D)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIFF (Tagged Image File Format, uncompressed)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIFF (Tagged Image File Format, Packbits)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIFF (Tagged Image File Format, CCITT Group 3, 1D)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIFF (Tagged Image File Format, CCITT Group 3, 2D)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
TIFF (Tagged Image File Format, CCITT Group 4, 2D)
Read: 1 bit, 4 bit, 8 Gray, 8 bit Color, 24 bit, 32 bit
WMF (Windows Metafile)
Read: 8 bit Color
|
|
