home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / Converter / BCONVERT.LHA / BatchConverter / Batchconverter.doc < prev    next >
Encoding:
Text File  |  1996-05-28  |  12.4 KB  |  331 lines
  1.  
  2.                         Batchconverter  1.0
  3.  
  4.                          by Ramiro Garcia
  5.  
  6.                            25 May 1996
  7.  
  8.  
  9. ------------------------------- What is it? ------------------------------
  10.  
  11. Batchconverter 1.0 is an AREXX script that uses ADPro for format conversion.
  12. Once you point it towards a directory full of pictures, and select the
  13. options you want, it will convert them all to IFF, GIF, or JPEG files
  14. automatically.
  15.  
  16. Requesters appear for all choices.
  17.  
  18. If you would like a version of this program in Spanish, email me. I
  19. make no promises, however.
  20.  
  21. Si ud. quisiera una copia de este programa en español, escribeme,
  22. pero no puedo prometirte nada.
  23.  
  24. ------------------------------ Requirements ------------------------------
  25.  
  26. 1. ADPro version 2.5.
  27. 2. AREXX (Part of Workbench 2.+)
  28. 3. RexxMast should be running.
  29. 4. AmigaDOS 2.+
  30. 5. Enough empty space on a destination device to store the processed
  31.    pictures.
  32. 6. A directory containing only the pictures you want to convert.
  33.  
  34. This program uses ADPro, and ADPro runs best with lots of RAM and an
  35. accelerated machine.
  36.  
  37. ------------------------------ Installation ------------------------------
  38.  
  39. If you're going to use Batchconverter by clicking on the icon, you can drag it
  40. onto the hard disk anywhere that you want.
  41.  
  42. If you're going to use Batchconverter from the shell (which I recommend),
  43. copy Batchconvert.rexx to the s: directory.  One way to do this is by typing
  44. "copy Batchconvert.rexx to s:" in a shell.
  45.  
  46. --------------------------- How do you use it? ---------------------------
  47.  
  48.  
  49. Type the following in a shell: "sys:rexxc/rx s:Batchconvert.rexx"
  50. or click on the icon. (Go ahead and use the shell.  It's For Your Own Good.
  51. You'll Thank Me When You're Older. 8^D)
  52.  
  53. Requesters will appear asking you what you want to do.
  54.  
  55. They will ask what format you want the output files in, (IFF, IFF-HAM,
  56. GIF, or JPEG), where the directory with the files you want processed is,
  57. where you want the finished pictures to go, and a few other things. The
  58. destination directory (where the processed files will go) must be different
  59. from the source directory (where the originals are).
  60.  
  61. If you select IFF format, you will be asked how many colors you wish the
  62. final pictures to have.  You can enter 2, 4, 8, 16, 32, 64, 128, 256, EHB,
  63. or HAM8.
  64.  
  65. If you select IFF-HAM format, you will be asked if you wish to shrink them in
  66. half horizontally, since ECS HAM (4096 color, 6-bit HAM) is usually displayed
  67. in low-resolution.
  68.  
  69. If you select JPEG format, you will be asked to pick the "Quality".
  70. The higher this number is, the larger the output files will be, and the
  71. closer in content to the original file.  A quality of 1000 will preserve
  72. most (not all) of the data in the original file, at the cost of bulkiness.
  73. Even so, it will be half the size of a comparable 24-bit file.  The
  74. default Quality is 32, which is what ADPro sets it at.
  75.  
  76. This program was rigorously tested: it usually ran OK on my Amiga,
  77. Sir CrashAlot.
  78.  
  79. I also tried it on two machines other than my own, and it failed on both.
  80. 8^D.  But it's really really really fixed now.  Honest. (How many really's
  81. was that?)
  82.  
  83. ------------------------------ Having Problems? --------------------------
  84.  
  85.  1) If you pick the same directory for source and destination, the program
  86.     won't work.  Incidentally, this program will not rename the output
  87.     pictures.
  88.  
  89.  2) If REXXMast isn't running, you may get a message like this:
  90.  
  91.                     rexxmast: Unknown command
  92.                     rexxmast failed returncode 10
  93.                     ARexx server not active
  94.  
  95.     The solution to that is, run rexxmast. Typing "run sys:system/rexxmast"
  96.     ought to work, or click on rexxmast's icon/
  97.  
  98.  3) If ADPro: isn't assigned, Batchconverter won't be able to find ADPro and
  99.     start it up.  However, ADPro itself requires the ADPro: assignment
  100.     to run.
  101.  
  102.  4) This program doesn't require much RAM:, but ADPro: does.  You should
  103.     have 4.5 Megabytes of contiguous free fastmem.  If you're not sure
  104.     how much you have, type "avail" in a shell, and look in the "Largest"
  105.     column. You want to have a number there that's "4500000" or greater.
  106.     If your pictures are no larger than 800x600 pixels, you might get
  107.     by with "2500000" in the "Largest" column.
  108.  
  109.  5) Color pictures more than 1350 x 1100 pixels in size will choke the
  110.     program.  Change the line:
  111.  
  112. ADDRESS COMMAND "run < nil: > nil: adpro:adpro MAXMEM=4500000 MINIMIZED LISTINTERFACE NL NS"
  113.  
  114.                             to:
  115.  
  116. ADDRESS COMMAND "run < nil: > nil: adpro:adpro MINIMIZED LISTINTERFACE NL NS"
  117.  
  118.     This allows ADPro to grab almost all the free RAM on your system.
  119.     If you have enough available RAM, then ADPro will be able to load
  120.     the picture.  If not, you can buy more RAM, or try the program VMEM.
  121.     It's on Aminet (util/boot/VMem.lha).
  122.  
  123.  6) If you use a version of ADPro earlier than 2.5, the results are
  124.     unpredictable.  Don't.
  125.  
  126.  7) The source directory should have only pictures, although this program
  127.     should ignore icons in the source directory.  If you have anything other
  128.     than icons or pictures in the source directory, however, the program
  129.     will quit.
  130.  
  131.  8) You need to know how to use a file requester.  Click on the "VOLUMES"
  132.     button for a list of choices.  You can also type a full path name into
  133.     the "File" part of the requester, and then click on "OK".
  134.  
  135.  9) I tested Batchconverter with "PatchReq V 1.4", which replaces some requesters
  136.     with the req.library requester, and "RTPatch V 1.4", which brings in the
  137.     ReqTools requester. It works, but you might try getting rid of them if
  138.     you're having problems.
  139.  
  140. 10) If the source directory is empty, the program will fail.  Make sure
  141.     there are pictures to convert in the source directory.
  142.  
  143. 11) This program uses the AmigaDOS commands "dir" and "list".  If you have
  144.     deleted or renamed them, the program can fail.
  145.  
  146. 12) This program uses the AmigaDOS library "rexxsyslib.library".  This is
  147.     normally located in the "Libs:" directory. If you have deleted this
  148.     library (but why would you do that?), the program cannot talk to ADPro.
  149.  
  150. 13) T:pic.list is an ASCII (text file) generated by Batchconvert, listing
  151.     the names of the files to be processed, one per line.  If you're
  152.     having problems, looking at this file may provide a clue.
  153.  
  154. 14) If you're running Batchconverter over and over for troubleshooting,
  155.     you can go to the end of the program and comment out the lines:
  156.  
  157.     ADPRO_EXIT
  158.     address command 'wait 3 secs'
  159.  
  160.     like so:
  161.  
  162. /*  ADPRO_EXIT                    */
  163. /*  address command 'wait 3 secs' */
  164.  
  165.     This leaves ADPro running, so it doesn't have to be loaded from disk
  166.     each time you run Batchconvert.
  167.  
  168.  
  169. Send me email if you're having trouble, and maybe I can help you out.
  170. I know how frustrating it is trying to get something to work properly.
  171.  
  172. email: ramiro@calweb.com
  173.  
  174.  
  175. ---------------------------------- Bugs ----------------------------------
  176.  
  177. None that I know of.  It won't work without RexxMast running, without the
  178. ADPro: assignment, with earlier versions of ADPro, with AmigaDOS 1.3,
  179. etc., but that's normal behavior.
  180.  
  181. If (hah, "if") there are bugs, let me know so I can feed them to my
  182. house spiders.
  183.  
  184. ---------------------------- Legal Disclaimer ----------------------------
  185.  
  186. I've tried my very best to make this program foolproof. Unfortunately, in
  187. these litigious times, good will isn't good enough.
  188.  
  189. I won't accept responsibility for any damage done to your system or data
  190. lost, directly or indirectly, as a result from using Batchconverter or any of
  191. its associated files. You use the program entirely at your own risk.
  192.  
  193. If you *do* experience problems please let me know. I can't promise
  194. anything, but it's worth a try.
  195.  
  196. Batchconverter and its associated files are not public domain. They may be
  197. distributed freely as long as no unreasonable charge is imposed. It may
  198. not be included within any commercial package without express written
  199. permission from the author; the exceptions from this are the AmiNet CDs
  200. and Fred Fish's utility collections. Batchconverter and its associated utilities
  201. may only be distributed if all files contained within the original archive
  202. are present.
  203.  
  204. ------------------------------- Credits-----------------------------------
  205.  
  206. I got chunks of the code from the examples that come with ADPro 2.5.
  207.  
  208. Daniel J. McCoy's DoThumbnails.rexx was a big help in providing examples
  209. of how AREXX and ADPro work.
  210.  
  211. Petri Nordlund's Register.rexx (Part of his Executive.lha archive) showed me
  212. a better way of controlling console highlighting.
  213.  
  214. Merril Callaway's "The AREXX Cookbook" was invaluable.
  215.  
  216. Martin Taillifer's "TurboText 2.0", my Favorite, Great text editor.
  217.  
  218. My wonderful Amiga, which didn't lock up or crash once until I tried this
  219. with ADPro 2.2.  Caveat Emptor.
  220.  
  221. Applied Computer Systems, for letting me test Batchconverter on their machine.
  222. ("Ramiro, what did you do to the machine?"  "Nothing, nothing.  Just let
  223.   me reboot, and it will be fine again.")
  224.  
  225. Chris Brenner, from ACS, for getting me thinking about keeping ADPro on the
  226. Workbench Screen.
  227.  
  228. BattleField Band, The Tannahill Weavers, The Hillbillies from Mars,
  229. Chorovaya Akademia's "Ancient Echoes", Claudio Arrau's Chopin Nocturnes,
  230. and John O'Connor's John Fields Nocturnes.
  231.  
  232. Pepperidge Farm Sausalito cookies. (Many bags).
  233.  
  234.  
  235. ------------------------------ Shareware ---------------------------------
  236.  
  237. This program has to be quite a bit better than it is now before I have the
  238. nerve to ask for money for it.
  239.  
  240. I would be delighted, however, to get email from anyone using the program,
  241. or a postcard if you don't have internet access.  I write about three Snail
  242. Mail letters a year, and those go to my relatives.
  243.  
  244. -------------------------------- Author ----------------------------------
  245.  
  246.                                                     f
  247.                                                     i
  248.                                                     n        p
  249.                                                     g        u
  250.                                                     e    f   b k
  251.   Snail Mail: Ramiro Garcia                  email: ramiro@calweb.com
  252.               10055 Terra Loma #6                     e  r   i y
  253.               Rancho Cordova CA 95670                        c
  254.               USA
  255.  
  256.  
  257.  
  258.  
  259. I'm a member of the Sacramento Amiga Computer Club. Our home page is:
  260.  
  261.                http://www.calweb.com/~kab.
  262.  
  263. This is my first program for the public.  I hope it's useful to people.
  264. Someday, I hope to write good enough code that someone will offer me a job.
  265.  
  266.  
  267. Remember:
  268.  
  269.  Time flies like an arrow.
  270.  Fruit flies like a banana.
  271.  
  272. ------------------------------- History ----------------------------------
  273.  
  274. Version 1.00 (05 May 1996)
  275.  
  276.         Called program BatchIFF.
  277.     Writes 2-256 color IFFs only.
  278.  
  279. Version 1.01 (06 May 1996)
  280.  
  281.         Added bug to directory handling.
  282.  
  283. Version 1.02 (07 May 1996)
  284.  
  285.         Added Interlace/NonInterlaced requester
  286.  
  287. Version 1.2 (09 May 1996)
  288.  
  289.         Fixed bug in directory handling.
  290.         Added EHB, HAM, and HAM8, and GIF to output format.
  291.         Added JPEG to output format (I thought).
  292.         Added Scale-in-half choice for HAM.
  293.         Made output to shell prettier.
  294.         Reorganized code to modular format.
  295.  
  296. Version 1.3 (10 May 1996)
  297.  
  298.         JPEG output format works now.
  299.         Eliminated render step for JPEG option-big speedup.
  300.         Spruced up file listing, destination directory.
  301.         Added check for identical source and destination directory.
  302.  
  303. Version 1.4 (10 May 1996)
  304.  
  305.         Added console  highlighting  for Aminet release.
  306.         Commented out MAXMEM = 4500000 limit.  If you're batch processing
  307.         pictures, it's safer to leave the system alone anyway.
  308.         Directory parsing failed the minute I tried it on the local
  309.         Amiga dealer's machine. Back to the drawing board.
  310.  
  311. Version 1.5 (18 May 1996)
  312.         Put "MAXMEM = 4500000" limit back in.
  313.         Improved directory parsing.  It's fixed now. Honest. 8^D.
  314.         Added more sanity checks, and meaningful error feedback.
  315.         Tightened code and increased robustness.
  316.         Rewrote and reformatted docs.
  317.         First public release.
  318.  
  319. Version 1.6 (27 May 1996) (BatchIFF)
  320. Version 1.0 (27 May 1996) (Batchconverter)
  321.  
  322.         Changed program name to "Batchconverter"
  323.         Reformatted source for legibility.
  324.         Changed JPEG GetString requester to GetNumber.
  325.         ADPro now quits after program runs.
  326.         Force minimized ADPro onto WB Screen.
  327.         "All done!" notifications.
  328.         Added some more "Problems" to docs. (Not
  329.         more problems, mind you.)
  330.         First Aminet release.
  331.