home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / a / aim / !Aim2 / Readme300 < prev    next >
Text File  |  1993-11-17  |  13KB  |  302 lines
  1.  
  2.                        AIM : ANOTHER IMAGE MANAGER
  3.  
  4.                           also known as
  5.  
  6.                        Atari Image Manager,
  7.                        Archimedes Image Manager,
  8.                        Amiga Image Manager.
  9.  
  10. The image processing program AIM was originally developed for the 
  11. ATARI-ST  by Frans Groen and  Robert de Vries.  Since  the  first 
  12. version  of  AIM, the improvement of  this  public  domain  image 
  13. processing  package  has  become a joint effort of  a  number  of 
  14. people from the Delft University of Technology and the University 
  15. of  Amsterdam.  Especially Piet Verbeek supplied many linear  and 
  16. non-linear  filtering routines,  Lucas van Vliet and  Ben  Verwer 
  17. developed  the  fast  morphological  operations.  Also  Gert  van 
  18. Antwerpen,  Damir  Sudar  and  Igor Weber supplied  a  number  of 
  19. routines to AIM.
  20.  
  21. AIM is *not* a demo version of the professional  image processing
  22. packages TCL-Image and SCIL-Image.
  23. AIM is limited in functionality as well as in flexibility.
  24. AIM has *no* support. However, you may like it.
  25.  
  26. AIM has been ported to the ARCHIMEDES (Arthur version) by  Robert
  27. Ellens, Damir Sudar and Alle-Jan van der Veen.
  28. Ed Doppenberg  was succesful in the port to RISC-OS.
  29. The RISC-OS2 versions will de indicated by 'AIM/2'.
  30. The RISC-OS3 versions will de indicated by 'AIM/3'.
  31.  
  32. AIM/3 runs best in mode 21 or 28 (multi-scan or VGA),  although a
  33. standard monitor in mode 15 may be applied too (limited quality).
  34. AIM has been written in the C-language.  The main  purpose of the
  35. program is to experiment with digital image processing.
  36.  
  37. The RISC-OS versions needs 2 Megabyte of memory at least, sorry.
  38.  
  39.  
  40. *************** Remarks on version 3.00: ************************
  41.  
  42. Compared to the first official RISC-OS2 version 2.10, the
  43. following changes were made:
  44.  
  45. - The menu command [Utils]>[Timer] is functioning again.
  46. - The menu command [Utils]>[Display]>[didisplay] is removed (this
  47.   command was of no use for the Archimedes).
  48. - The help text of command 'mcopy' was in error, this is fixed.
  49.   (The text in the manual was correct already).
  50. - The display of the help text of a menu command can be switched
  51.   on and off when the HELP button is clicked ("toggle" button),
  52.   this allows the adjustment of the parameters and the later
  53.   execution of the command after reading the help text.
  54. - A command handles parameters with values such as "automatic"
  55.   and "input-image" by replacing this human operator oriented
  56.   text during execution by the appropriate default value (being
  57.   the automatic calculated value or the image that was specified
  58.   as the input-image, respectively). Replacing a parameter by a
  59.   question-mark forces the command to prompt for an entry during
  60.   execution.
  61. - The Command-window is 'active' all the time, thus not depending
  62.   on the location of the mouse-pointer anymore.
  63.  
  64.  
  65. Additions (from 2.20 up):
  66.  
  67. - A new menu entry 'scaled' allows the selection/deselection of
  68.   automatic zooming of the display within a display-window.
  69. - A command 'affine <inp_im> <outp_im> <ref_im> <mouse_clicks>'
  70.   is available. Type 'affine ?' to run this command.
  71.  
  72.  
  73. Additions and Modifications (from 3.00 up):
  74.  
  75. Compared to AIM/2, the RISC OS 3 versions (starting at 3.00) have
  76. some important additions and modifications:
  77.  
  78. - Any rectangular image size is allowed
  79. - More (than the AIM) data filetypes are accepted:
  80.   AIM (type &004) with seperate header (type &010)
  81.   TCL (type &011), header included
  82.   Sprite import, 256-grey-level sprite (GreySprite) export
  83. - A selected portion (rectangle) of an image can be applied and
  84.   saved as a new image
  85. - A contrast stretch function is added
  86. - Improved Help function
  87. - Better interaction between AIM and RISC OS 3 applications
  88.  
  89. *****************************************************************
  90.  
  91.  
  92. THE FOLLOWING TEXT CAN BE OF SOME HELP WHEN YOU DON'T HAVE THE
  93. PRINTED DOCUMENTATION AVAILABLE. THIS TEXT IS NO MORE THAN A
  94. FIRST AID. WHEN YOU ARE JUST PLAYING AROUND IN IMAGE PROCESSING
  95. IT'S O.K. FOR YOU.
  96.  
  97. IF YOU DISCOVER SOME MORE INTEREST WHILE USING THIS PROGRAM, YOU
  98. MAY LIKE THE IDEA THAT YOU CAN ORDER FOR A SET OF PRINTED
  99. DOCUMENTATION, INCLUDING A FIRST INTRODUCTION IN THIS FIELD.
  100. (ADDRESSES OF 'LINDIS' AND 'ECD' CAN BE FOUND AT THE END OF THIS
  101. TEXT).
  102.  
  103. *********************** First aid manual ************************
  104.  
  105.  User interface.
  106.  
  107. The user interface of AIM consists of:
  108.  
  109. -RISCOS interface. Operations and parameters can be  selected  by 
  110. means of pop-up menus.  A choice from a menu results in a command 
  111. which is passed to the command interpreter. Image displays can be 
  112. moved and sized.
  113. Drag the image to a Display-Window (A, B, C or D).
  114. Drag the macro-file to one of the open AIM-Windows (including the
  115. Command Line Window) to start the execution of the macro.
  116.  
  117. -Command Line interpreter. Commands may be entered by typing. The
  118. location of the mouse-pointer is not critical anymore (v2.12 up).
  119. Use lower case! 
  120. A history mechanism is provided. Type  h.  To execute a  previous
  121. command, type  !#  (# = history-number of a previous command). 
  122.  
  123. -Sequences of commands can be given in a macro-file. A macro-file
  124. may be called within another macro-file up to 16 levels deep.
  125.  
  126.  
  127.  Images in AIM.
  128.  
  129. Up to four image memories are available in AIM.
  130. Standard AIM images have a size of 256 x 256 pixels (in AIM/3 all
  131. sizes are accepted), and are stored line by line from top left to
  132. bottom right.
  133. These standard images have a size of 65536 pixels, and are 8 bits
  134. deep - and are thus 64K in size.
  135. These 'image memories' are displayed on the  Archimedes screen in
  136. windows designated ‘A’, ‘B’, 'C' and ‘D’, which can be moved  and
  137. sized. They are shown as 256 x 256 pixels in a  limited number of
  138. greyshades, but a 'sigma-delta technique'  is used to improve the
  139. representation of the original 256 grey values.
  140. Be aware of the fact that a display in a window is no more than a
  141. 'as good as possible' (display-mode determined) representation of
  142. an image in memory.  (The image processing is always performed on
  143. the images).
  144. The  8 bitplanes of the  grey-value images  can also be used as 8
  145. 'binary images', on which  'Cellular Logic' and 'Bitplane Binary'
  146. operations may be performed.
  147. The bitplanes are numbered from 1(least) to 8(most significant).
  148. When an image is read from disk, all 8 bitplanes are read simult-
  149. aneously. The same holds when an image is written to disk.
  150. Hence, a single bitplane must be copied to all 8, before  writing
  151. the image to disk (the command 'mcopy' can do this for you).
  152.  
  153. If an AIM image does not have the standard size, a  headerfile is
  154. needed - in order that it may be read correctly.  This is a  file
  155. having the same name as the image file,  with a "+" added,  which
  156. describes the image width and height. The  header format used  is
  157. given in the Appendix of the Reference Manual.
  158. When an image file is written in the AIM format, a header file is
  159. always written.
  160. In AIM/3 the use of a new format, the 'TCL data format' (which is
  161. direct compatible with the  professional image processing package
  162. TCL-Image), is made possible and this format should be preferred.
  163. Moreover, 'GreySprites' (having a palette of 256 grey levels) are
  164. accepted.
  165. A TCL image file (with a header included) has file-type &011.  An
  166. AIM imagefile has file-type &004, a headerfile has file-type &010
  167. and a resource-file (in which the set-up is stored) has file-type
  168. &012.
  169.  
  170.  Installing and Running AIM/3
  171.  
  172. In this RISC OS 3 version of AIM,  the files on the  distribution
  173. disk #1 are organized in a single application directory !aim.
  174. The application directory !aim should be copied to a hard disk.
  175. Double-clicking with 'Select' on the icons of both the source and
  176. destination drives will open Filer windows. The aim directory may
  177. then be 'dragged' from the source to the destination window.
  178. Additional files are present on the accompanying disks,  read the
  179. 'Readme' files on those disks.
  180. AIM may be run by double-clicking with Select  on the application
  181. in the Filer window, to put an icon on the icon bar.  Now, an AIM
  182. imagefile may be dragged onto the icon or the application started
  183. "empty" by clicking on the icon.
  184. If a mode other than  Mode 27 or Mode 28 (the default mode) is in
  185. use, the best