home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / a271_1 / Readme300 < prev   
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 method of starting the AIM application is  to click
  186. on the appropriate resource-file in !aim.resources.  (AIM 'image'
  187. and other files are  normally stored within the !aim application.
  188. They may be reached by holding down the  Shift key, while double-
  189. clicking on the !aim directory icon in the Filer window).
  190. A file !aim.default allows modifications, affecting memory needs.
  191. In AIM/3 it is also possible to start the  application by double-
  192. clicking on an AIM- or TCL- datafile (image), provided the filing
  193. system has 'seen' the application.
  194.  
  195.  
  196.  Command interpreter.
  197.  
  198. It  is  not  necessary to give the  complete  command  name.  The 
  199. smallest number of letters (lower case!) which gives no ambiguity
  200. is  sufficient.
  201.  
  202. It is possible to edit your commands in a simple way. The delete- 
  203. key or the Backspace key deletes the last character.
  204. A sequence of commands which performs a certain operation may  be 
  205. grouped to a 'macro-file' and stored on disk.
  206.  
  207. Macro-files are executed by typing @macro-name.  A new macro-file 
  208. can  be  called within a macro-file and may be nested  up  to  16 
  209. levels  deep.  So typing @macro-name executes the macro-file.
  210. ESCAPE stops the  execution of a  macro-file and asks the user to
  211. continue or not. Typing   Q <CR>   aborts the  currently  running
  212. macro,  C <CR>  continues the macro ( <CR> = Return key).
  213. Default values are  used  when a parameter is not given.  When an
  214. erroneous value of a parameter is given,  the command interpreter
  215. asks for a correct value. If in this  case a return is given, the
  216. default value  is  used.
  217. This gives the  possibility to ask for a parameter value  when  a 
  218. macro-file is executed,  instead of using a  fixed value.  In the 
  219. macro-file for instance, a question mark (?) can be used  instead 
  220. of the parameter value to obtain this feature.
  221.  
  222. A  question mark (?) instead of a command  gives a  list  of  all 
  223. available commands.
  224.  
  225. A  star  (*)  indicates that the  remainder  of  the  commandline 
  226. consists of comments.
  227. Never have a 'blank line' in the macro-file, except at the end.
  228.  
  229.  
  230.  
  231.  Digitisers.
  232.  
  233. If a  Watford digitiser is attached to the Archimedes the command 
  234. 'watford' can be used to grab an image and transport it to an AIM
  235. image in memory.  Pressing  return  stops grabbing and keeps  the
  236. current image. Resolution is limited to 6 bits (64 grey levels).
  237.  
  238. Note: Some Wild Vision series of digitisers use the AIM format as
  239.       output format. You can use these digitisers as well, a  256
  240.       grey-value version is available.
  241.  
  242. Note: Scanner support is already available:
  243.       The professional EPSON 8 bit grey-value / 24bit colour flat
  244.       bed scanner GT-4000,GT-6000 (and software compatible types) 
  245.       are supported by Irlam and offer a GreySprite as one of the
  246.       possible output formats.
  247.  
  248.       And more will come... See 'Coming AIM/3 versions'.
  249.  
  250.  
  251. ****** Order for the 3-in-1 Manual (including revision 1) *******
  252.  
  253. This printed manual was written to help you in understanding what
  254. you are doing in Image Processing / Analysis and it gives you all
  255. the details of the AIM commands.
  256.                               
  257. Order for these +/- 120 pages of documentation containing
  258.  
  259. - a first Introduction in Image Processing,
  260. - the AIM Users Manual,
  261. - the AIM Reference Manual (describing the commands and options),
  262. - the update of the manual:
  263.   AIM Users Manual revision 1, including Ref.Manual revisions,
  264.  
  265. together with the latest version of AIM on disk.
  266.  
  267. In UK:
  268.    Lindis International Ltd., Wood Farm, Linstead Magna,
  269.    Halesworth, Suffolk IP19 0DU (UK)
  270.  
  271. Worldwide:
  272.    ECD Computers Delft BV, Voldersgracht 25-26,
  273.    2611 EV Delft (Holland).
  274.  
  275.  
  276. (Serious users: ask for TCL-Image information, available at
  277. Lindis and ECD).
  278.  
  279.  
  280. ********************* Coming AIM/3 versions *********************
  281. *                                                               *
  282. * A coming version of AIM/3 will get some more edit funtions    *
  283. * like pasting and merging. However, AIM is an Image Analysing  *
  284. * package and not intended for graphical manipulations.         *
  285. *                                                               *
  286. * A direct interface to ScanLight Video 256 is planned to be    *
  287. * developed in co-operation with Computer Concepts.             *
  288. *                                                               *
  289. *****************************************************************
  290.  
  291.  
  292. Suggestions, remarks (please, don't ask for the C-sources):
  293.  
  294.    Thom Hoeksma, Pattern Recognition Group,
  295.    Faculty of Applied Physics TUD,
  296.    Lorentzweg 1,
  297.    2628 CJ Delft (The Netherlands).
  298.  
  299.                                                    November 1993,
  300.                                                     Thom Hoeksma.
  301.  
  302.