home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / WP / AMIADD.ZIP / AMIADD.DOC next >
Text File  |  1994-01-30  |  5KB  |  118 lines
  1. AmiAdd v1.0
  2. by Lee Gaiteri
  3. DOCUMENTATION FILE
  4. ------------------
  5.  
  6.     AmiAdd is a DOS utility designed to add ready-made smarticons to Ami Pro.
  7. Now you can share your homemade smarticons with friends and the general public
  8. by using this program. Ami Pro allows you to edit a bitmap for a smarticon,
  9. make a macro to go with it, and give it a description, but its support for
  10. using existing bitmaps is minimal. To add a smarticon to Ami Pro which has
  11. already been made, you have to:
  12.  
  13. 1. Copy the bitmap and macro files to their respective directories.
  14. 2. Load the bitmap into Windows Paintbrush, cut out its entire 21x21 area and
  15.     paste it to the clipboard. (Some programs can paste the entire bitmap
  16.     without requiring you to select an area to cut/copy from it.
  17. 3. Open Ami Pro, and select Tools/Smarticons.
  18. 4. Press the Edit Icon button.
  19. 5. Press the New Icon button and make a new name for the bitmap.
  20. 6. Type SHIFT-Ins or Ctrl-V to paste the bitmap into the editor.
  21. 7. Type in the macro name and instructions
  22. 8. Give the icon a description.
  23.  
  24.     Not very simple, is it?
  25.     Well, with AmiAdd, you need to follow fewer steps and do less precision
  26. mouse work than before.
  27.  
  28. 1. Same as step 1 above.
  29. 2. Make a list file for AmiAdd telling it how many icons to add, the bitmap
  30.     files they will use, the macros they will use, and their descriptions.
  31. 3. Go to the Ami Pro directory (on my system, this is c:\amipro)
  32. 4. On the DOS command line, type AMIADD followed by the name of the list file.
  33.  
  34.     List files are easy to make and allow you much greater control over the
  35. way you add smarticons than Ami Pro does.
  36.     A list file looks something like this:
  37.  
  38. 2                                       <- number of icons to add
  39. c:\amipro\icons\test.bmp                <- bitmap 1
  40. c:\amipro\macros\test.smm               <- macro 1
  41. Test icon                               <- description 1
  42. c:\amipro\icons\myicon.bmp              <- bitmap 2
  43. c:\amipro\macros\myicon.smm!do(1)       <- macro 2
  44. My icon                                 <- description 2
  45.  
  46.     Path and file names can be up to 80 characters long. Descriptions can be
  47. up to 120. Do not use blank lines in between icon information, such as:
  48.  
  49. .....
  50. Test icon
  51.  
  52. c:\amipro\icons\myicon.bmp
  53. .....
  54.  
  55.     Blank lines are simply interpreted as a lack of data, so in the case above
  56. no bitmap file would be provided for icon 2 and it would use the bitmap as a
  57. macro, and the macro name as a description.
  58.  
  59.     AmiAdd makes it possible to share the smarticons you make by simply
  60. distributing the bitmaps and macros necessary, as well as a text file with a
  61. little information about what each icon is.
  62.     
  63.     The files included in this upload are:
  64.  
  65. AMIADD.EXE - AmiAdd program
  66. AMIADD.DOC - this file
  67. NEWICONS.DAT - list file for the smarticons included
  68. OPEN1.BMP - icon bitmaps
  69. OPEN2.BMP
  70. OPEN3.BMP
  71. OPEN4.BMP
  72. OPEN5.BMP
  73. FACING.BMP
  74. SMALLCAP.BMP
  75. OPENPREV.SMM - icon macros
  76. FACING.SMM
  77. SMALLCAP.SMM
  78.  
  79.     To install the new icons:
  80.  
  81. 1. Copy the bitmaps (.BMP) to the Ami Pro icons directory (c:\amipro\icons on
  82.     my system) and the macros (.SMM) to the macros directory
  83.     (c:\amipro\macros).
  84. 2. Copy AMIADD.EXE, AMIADD.DOC, and NEWICONS.DAT to the Ami Pro directory.
  85. 3. Edit NEWICONS.DAT if necessary, in case you don't have Ami Pro installed in
  86.     the c:\amipro directory, and change path names to reflect where Ami Pro
  87.     is installed (i.e., if you installed Ami Pro on the D: drive, change
  88.     c:\amipro to d:\amipro, etc.).
  89. 4. Go to the Ami Pro directory (cd\amipro).
  90. 5. Type AMIADD NEWICONS.DAT
  91. 6. Delete NEWICONS.DAT (which is now useless) or keep it to look at later as
  92.     a guide to writing your own list files.
  93.  
  94. DISCLAIMER:
  95.  
  96.     Just to be on the safe side... Don't worry, it's just a precaution.
  97.  
  98.     I assume no responsibility, nor can be held liable for any errors
  99. resulting from the use or misuse of this program, nor any loss of files, data,
  100. or any monetary losses due to the interruption of business.
  101.  
  102. SHAREWARE AND DISTRIBUTION INFO:
  103.  
  104.     This program is shareware and may be distributed freely.
  105.     If you use this program a lot, please consider making a donation for my
  106. efforts in programming this and hacking the Ami Pro files on my system. Any
  107. amount would be appreciated- just send what you feel is appropriate.
  108.     My address is:
  109.  
  110. Lee Gaiteri
  111. P.O. Box 68
  112. Elbridge, NY  13060
  113.  
  114.     If you have any questions or comments, you may write me at the same
  115. address (but don't expect a response if you do- stamps are getting expensive),
  116. or you can write to Lummox JR on America Online. I am also available through
  117. the Internet as Lummox JR@aol.com.
  118.