TABLE OF CONTENT
CHANGELOG
DESCRIPTION
TESTED ON
PREREQUISITES
USAGE
BATCH PROCESSING (RECOMMENDED)
MANUAL PROCESSING
SETTINGS
HOW IT WORKS
KNOWN ISSUES
QUIRKS
CHANGELOG
2.4.6.0 2014/02/02
[+] PngScan utility: scans if PNG left and right borders consist of white pixels only (requires .NET 3.5).
[*] Switched to ImageMagick 6.8.8 Q8
2.4.5.0 2011/07/24
[!] Yonkoma and 2-pages fix for ImageMagick 6.7.0+ (*NOT COMPATIBLE* with older ImageMagick releases)
[*] Switched to ImageMagick 6.7.1
2.4.4.0 2011/02/17
[+] Show progress in window title.
[*] Crop image by exact height.
[*] Renamed ZZZZZ-EOF to ~~~EOF~~~
[*] Switched to ImageMagick 6.6.7
2.4.3.0 2010/01/07
[+] Image padding to avoid auto stretching.
[*] Switched to ImageMagick 6.6.6
2.4.2.0 2010/12/10
[+] Separated Color and BW processing modes. BW mode is default.
2.4.1.0 2010/11/27
[!] Pathnames with parentheses fix.
[!] Create folder before EOF creation.
2.4.0.0 2010/11/11
[+] Parallel processing. At least 2x speed up.
[+] Possibility to process range of images by specifying start and end image index.
[+] Rotated images with width more than 2000px will be shrunk.
[+] Notify user if ImageMagick is not installed or properly configured.
[+] Warning if no files to process.
[+] Percent progress indicator.
[*] Switched to ImageMagick 6.6.5
[*] Start/end processing times are displayed if configured.
[*] Temporary PNG image compression optimized for speed (requires more memory).
[*] Trim of black and than white borders. Default color distance is 45% for both.
[*] Separate settings for BW and color images borders trimming.
[*] Draw white border sized 4x2
[!] Fixed PNG compression value according to ImageMagick specs.
2.3.1.0 2010/08/15
[!] Fixed A3 incorrect (rare) image display by adding 1px wide border around image.
[*] Test images are separate download from now.
2.3.0.0 2010/08/01
[!] Renamed rotate to a3images.
[+] Temporary images format is png.
[+] mangafox.com footer removal. To remove footer place files into mangafox.com folder.
2.2.0.0 2010/05/15
[+] Separate settings folder. See SETTINGS section.
2.1.1.0 2010/05/02
[!] Filenames with '&' character issue.
2.1.0.0 2010/04/26
[+] Swap split images. Useful for changing pages order.
2.0.0.0 2010/04/18
[+] Batch processing. See BATCH PROCESSING section.
1.1.0.0 2010/04/10
[!] Improved image border trimming.
[+] Test files (test-img.zip).
1.0.0.0 2010/03/27
Initial release
DESCRIPTION
Windows batch script for preparing manga (images) for comfort reading on Cowon A3.
TESTED ON
Windows XP SP2, SP3
READ CAREFULLY BEFORE USAGE
SCRIPT IS PROVIDED AS IS, AUTHOR TAKES NO RESPONSIBILITY FOR USER ACTIONS.
WARNING: FILES WILL BE MODIFIED INPLACE!
PREREQUISITES
ImageMagick v6.6.6 or higher (Open Source)
Can be found at http://www.imagemagick.org/script/binary-releases.php#windows
Edit a3images.settings\global.bat to specify script wide settings.
See SETTINGS section for details.
USAGE
1. Install ImageMagick to default folder.
2. Create new folder.
3. Copy a3images.bat to folder.
4. Copy images to folder.
5. Run a3images.bat.
All subfolders in script folder will be processed recursively.
You can also use generated a3images_exec.bat as follows:
a3images_exec.bat [firstImageIndex] [lastImageIndex]
where firstImageIndex and lastImageIndex are optional parameters. Image index is in range from 1 to total image count.
* If no parameters are specified all images will be processed.
* If firstImageIndex and/or lastImageIndex are specified images will be processed in given boundaries (inclusive).
Examples:
* Process all images.
a3images_exec.bat
* Process images starting from 3rd to an end.
a3images_exec.bat 3
* Process images starting from 3rd to 5th (inclusive).
a3images_exec.bat 3 5
WARNING: FILES WILL BE MODIFIED INPLACE.
After launch the following menu will appear:
0. Exit.
Exits script.
*. BW mode is active
Changes between color and BW processing modes.
BATCH PROCESSING (RECOMMENDED)
A. Rotate, trim white border, pad, group, add EOF
Combination of:
1. Rotate only
6. Trim image borders using color distances: black=45%, white=45%
J. Pad images to avoid auto stretching.
7. Group files by 30 files per folder
8. Add EOF image for each folder with images
B. Yonkoma split, rotate, trim white border, pad, group, add EOF
Combination of:
2. Yonkoma (height > width) split and rotate (Right to Left). Original files will be deleted
6. Trim image borders using color distances: black=45%, white=45%
J. Pad images to avoid auto stretching.
7. Group files by 30 files per folder
8. Add EOF image for each folder with images
C. 2-pages manga split, rotate, trim white border, pad, group, add EOF
Combination of:
3. 2-pages manga (width >= height) split and rotate (Right to Left). Original files will be deleted
6. Trim image borders using color distances: black=45%, white=45%
J. Pad images to avoid auto stretching.
7. Group files by 30 files per folder
8. Add EOF image for each folder with images
D. Adjust page size, split by height=480px, group, add EOF
Combination of:
4. Crop images by width=800px, height=1440px, x=203px, y=281px
5. Crop images by height=480px. Original files will be deleted
7. Group files by 30 files per folder
8. Add EOF image for each folder with images
MANUAL PROCESSING
1. Rotate only
img1.jpg
-------- img1.jpg
|* | -----------
| | | |
| | => | |
| | |* |
| | -----------
--------
2. Yonkoma (height > width) split and rotate (Right to Left). Original files will be deleted
img1.jpg
--------- img1-0.jpg
| | | -----------
| | | | 1 |
| 2 | 1 | => -----------
| | | img1-1.jpg
| | | -----------
| | | | 2 |
--------- -----------
3. 2-pages manga (width >= height) split and rotate (Right to Left). Original files will be deleted
img1.jpg img1-0.jpg
-------------- -----------
| | | | 1 |
| 2 | 1 | -----------
| | | => img1-1.jpg
| | | -----------
-------------- | 2 |
-----------
4. Crop images by width=800px, height=1440px, x=203px, y=281px
Crops images by width, height starting from x, y.
Edit a3images.settings\crop.bat to specify crop settings.
See SETTINGS section for details.
5. Crop images by height=480px. Original files will be deleted
Crops images by 480px. Number of newly created images depends from image height.
Crop parameter:
set cropHeightVal=%screenHeight%
6. Trim image borders using color distances: black=45%, white=45%
Trims image black and than white borders as much as possible.
Edit a3images.settings\modes\*.bat to specify trim settings.
See SETTINGS section for details.
7. Group files by 30 files per folder
If number of files in folder is more than 30 then new subfolders containing 30 files each will be created inside files' folder.
Edit a3images.settings\group.bat to specify number of files in group.
See SETTINGS section for details.
8. Add EOF image for each folder with images
Adds image "ZZZZZ-EOF.gif" for each forder containing images. This image will be last in the folder. If it reached then no more images left.
9. Swap split images
Renames images "*-0.*" to "*-1.*" and vice versa. Useful for changing pages order.
J. Pad images to avoid auto stretching.
Pad images to avoid auto stretching by player.
SETTINGS
To simplify script settings adjustment the following files were placed in folder
a3images.settings:
* crop.bat
Settings for 4. Crop images by width=800px, height=1440px, x=211px, y=234px
set cropPictureX=211
set cropPictureY=234
set cropPictureHeight=1220
* global.bat
Global script settings
ImageMagick location
set ImageMagickPath=%PROGRAMFILES%\ImageMagick-6.6.6-Q16
Number of parallel processes. Optimal number is 5.
Depends from disk system speed (probably speed of random access).
For memory drives or SSD might be increased (not verified).
set /a numberOfProcesses=5
Show elapsed time. Do not close first and last processes windows if any.
set /a showElapsedTime=0
Enables image padding for group operations (useful for avoiding image auto stretching).
set /a useImagePadding=1
* group.bat
Settings for 7. Group files by 30 files per folder
set /a groupFilesCountPerFolder=30
* modes\*.bat
Settings for 6. Trim image borders using color distances: black=45%, white=45%
There are settings for BW and color processing modes. BW is used by default.
BW mode settings:
set imageBorder=-bordercolor "#FFFFFF" -border 4x2
set trimDistanceBlackValue=45
set trimDistanceWhiteValue=45
Color mode settings:
set imageBorder=
set trimDistanceBlackValue=10
set trimDistanceWhiteValue=10
* resize.bat
Settings for 6. Rotated images with width more than 2000px will be shrunk.
set resizeClause=-resize "2000x>"
HOW IT WORKS
1. a3images.bat scans all subfolders recursively starting from script folder.
2. a3images_exec.bat script will be generated.
3. a3images_exec.bat will be automatically launched. To prevent it from launching specify any command line to a3images.bat
4. If processing is successful you can delete a3images_exec.bat.
5. If processing is failed you can manually adjust a3images_exec.bat and launch it again.
KNOWN ISSUES
Unicode file names are not supported (e.g. including Cyrillic, German letters, etc.) and won't be supported.
QUIRKS
On Windows Vista/7 there is a message after successfully completed script (it appears only if script is launched in parallel mode):
Not enough storage is available to process this command.
It can be ignored.
