The interactive file manager requires Javascript. Please enable it or use sftp or scp.
You may still browse the files here.

Download Latest Version a3images-2.4.6.0.7z (33.3 kB)
Email in envelope

Get an email when there's a new version of COWON A3 Images Preparation Script

Home
Name Modified Size InfoDownloads / Week
Releases 2014-02-02
0
readme.txt 2014-02-02 10.1 kB
0
test-images.7z 2010-08-15 13.5 kB
0
Totals: 3 Items   23.6 kB 0 
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.
Source: readme.txt, updated 2014-02-02