home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 491.lha / PicToANSI / PicToANSI.Doc < prev    next >
Encoding:
Text File  |  1991-04-06  |  4.1 KB  |  82 lines
  1. Pic To ANSI     Written on February 1991 by Patrick Evans
  2. -------------------------------------------------------------------
  3.  
  4.    After years of seeing keyboard-graphic title pages on almost every
  5. bulletin board system advertisement, contest, or anything else worth making
  6. a title page for, one would like a new dimension to the primitive graphics
  7. programs for making text files.  The capabilities of the Amiga and the
  8. graphics artists who work with this powerful machine are quite incredible.
  9. There just had to be a way to make things more versatile.....
  10.  
  11.    And after pondering some ideas, I am proud to provide this program to
  12. every and any Amiga user who wants to go beyond keyboard graphics.  Put
  13. simply, the process of creation is very simple;  use your favourite 
  14. paint program to create a 320x200 size picture, one plane deep.  The
  15. picture can actually be up to 5 planes, but the last four will be absent in
  16. the final product  (ie. you will see only the first bit plane image).  This
  17. picture must (for now) be in IFF format.  Popular programs include Deluxe
  18. Paint, Fusion Paint, Graphic Craft, and you could even use Grabbit if you
  19. wanted.
  20.  
  21.    The next step is the conversion process;  Get yourself a CLI and
  22. unarchive this program (which you must have done by now, right? :>).  The
  23. following is a simple breakdown of the features;
  24.  
  25.      PicToANSI <infile> <outfile> <xsize> <ysize>
  26.  
  27.   The <infile> is your IFF picture (ex. DH1:MYTITLE.PIC). The <outfile> is
  28. the path and file name of the output file (ex. DH1:MYTITLE.TXT).  The
  29. <xsize> is an interesting animal;  It is the horizontal size in WORDS (16
  30. bit chunks) describing how far from the left-hand side of your picture to
  31. convert.  To convert your pixels to bytes, divide by 16 (ex. 320/16=20).
  32. You may have to experiment with this a bit to get the desired size.
  33. Default is 40 if you don't give it a size.  The <ysize> is just the number
  34. of vertical lines to take from your bitmap.  The default is 180, as windows
  35. consume a top and bottom border, but you can push it to 200 (it will draw
  36. harmlessly off the bottom of the screen).
  37.  
  38.   Here's an example:
  39.  
  40.       PicToANSI dh1:MyTitle.pic dh1:MyTitle.txt 20 100
  41.  
  42.    The final product (dh1:MyTitle.txt) when displayed would be 160 pixels
  43. across by 100 pixels vertical.
  44.  
  45.       PicToANSI dh1:MyTitle.pic dh1:MyTitle.txt
  46.  
  47.    The final product defaults to a 320x180 display!  Nice eh?
  48.  
  49.    The output text file can be displayed by typing it (ex. type myout.txt),
  50. or by displaying in any ANSI supporting display.  Terminal programs WILL
  51. NOT support the picture.. you will just see ANSI codes!  An exceptional
  52. idea is the use of Lharc by Paolo Zibetti, in which if you add a .DISPLAYME
  53. to the text file, it will open up a window the same size as your picture
  54. and display it when the archive is unlharc'ed.  Very handy!
  55.  
  56.    You will also notice that even though a full size picture can be almost
  57. 33 000 bytes large, it will compress to anywhere from 1 000 bytes to 4 000
  58. bytes in an archive!  This is very nice!
  59.     (some example pictures have been included)
  60.  
  61.    It is my hopes that everyone will enjoy this program and make "blocky"
  62. text and pictures a thing of the past.  Use your talents, and show the
  63. world what you can do, now that you have the technology!
  64.  
  65.    This program is ShareWare.  Copy it, give it to your friends, other
  66. systems and your enemies.  I ask only that this text file, the program and
  67. thier .info files be distributed together, and that if you use this
  68. program and find it helpful, PLEASE, make a donation, so that authors like
  69. me and many others can make MORE programs like this one!  Yes, I know
  70. you've heard it all before, but ANY donation would help me!
  71.    If you send five dollars or more, I will register you, and send you
  72. any future updates, and new versions, which will include a much faster
  73. displaying time on the output files (the major drawback right now).
  74.       The following is an address where you can send comments/donations/or
  75. any programs you want me to test or anything else!
  76.      Patrick Evans, Box 785, Nobleton, Ontario, Canada, LOG1N0.
  77.  
  78.    This program uses the IFF library version 18.4, written by Christian A.
  79. Weber, which is a freely distributable library.
  80.  
  81. Have fun, and happy programming!
  82.