Looking for the latest version? Download a3images-2.4.6.0.7z (33.3 kB)
Home
Name Modified Size Downloads / Week Status
Totals: 3 Items   23.6 kB 2
Releases 2014-02-02 11 weekly downloads
readme.txt 2014-02-02 10.1 kB 11 weekly downloads
test-images.7z 2010-08-15 13.5 kB 11 weekly downloads
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