home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / graphics / aim / Readme315 < prev   
Encoding:
Text File  |  1995-05-31  |  12.3 KB  |  304 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. Version 3.15 and up is RISC-OS 3.5 compatible.
  32.  
  33. AIM/3 runs fine in mode 21 or 28 (multi-scan or VGA),  although a
  34. standard monitor in mode 15 may be applied too (limited quality).
  35. Since version 3.15  is compatible with the resolutions offered by
  36. the RISC PC hardware, a true 256 greyshades display is possible.
  37.  
  38. AIM has been written in the C-language.  The main  purpose of the
  39. program is to experiment with digital image processing.
  40.  
  41. The RISC-OS versions needs 2 Megabyte of memory at least, sorry.
  42.  
  43.  
  44. ************* Remarks on version 3.00/3.15: *********************
  45.  
  46. Compared to the first official RISC-OS2 version 2.10, the
  47. following changes were made:
  48.  
  49. - The menu command [Utils]>[Timer] is functioning again.
  50. - The menu command [Utils]>[Display]>[didisplay] is removed (this
  51.   command was of no use for the Archimedes).
  52. - The help text of command 'mcopy' was in error, this is fixed.
  53.   (The text in the manual was correct already).
  54. - The display of the help text of a menu command can be switched
  55.   on and off when the HELP button is clicked ("toggle" button),
  56.   this allows the adjustment of the parameters and the later
  57.   execution of the command after reading the help text.
  58. - A command handles parameters with values such as "automatic"
  59.   and "input-image" by replacing this human operator oriented
  60.   text during execution by the appropriate default value (being
  61.   the automatic calculated value or the image that was specified
  62.   as the input-image, respectively). Replacing a parameter by a
  63.   question-mark forces the command to prompt for an entry during
  64.   execution.
  65. - The Command-window is 'active' all the time, thus not depending
  66.   on the location of the mouse-pointer anymore.
  67.  
  68.  
  69. Additions (from 2.20 up):
  70.  
  71. - A new menu entry 'scaled' allows the selection/deselection of
  72.   automatic zooming of the display within a display-window.
  73. - A command 'affine <inp_im> <outp_im> <ref_im> <mouse_clicks>'
  74.   is available. Type 'affine ?' to run this command.
  75.  
  76.  
  77. Additions and Modifications (from 3.00 up):
  78.  
  79. Compared to AIM/2, the RISC OS 3 versions (starting at 3.00) have
  80. some important additions and modifications:
  81.  
  82. - Any rectangular image size is allowed
  83. - More (than the AIM) data filetypes are accepted:
  84.   AIM (type &004) with seperate header (type &010)
  85.   TCL (type &011), header included
  86.   Sprite import, 256-grey-level sprite (GreySprite) export
  87. - A selected portion (rectangle) of an image can be applied and
  88.   saved as a new image
  89. - A contrast stretch function is added
  90. - Improved Help function
  91. - Better interaction between AIM and RISC OS 3 applications
  92.  
  93.  
  94. Additions (from 3.15 up):
  95.  
  96. - Multitasking
  97. - Improved display when used on a RISC-PC (VIDC20) machine
  98.   (dithering is using 16 in stead of 8 greyshades in appropriate
  99.   display modes)
  100.   
  101.  
  102. *****************************************************************
  103.  
  104.  
  105. THE FOLLOWING TEXT CAN BE OF SOME HELP WHEN YOU DON'T HAVE THE
  106. PRINTED DOCUMENTATION AVAILABLE. THIS TEXT IS NO MORE THAN A
  107. FIRST AID. WHEN YOU ARE JUST PLAYING AROUND IN IMAGE PROCESSING
  108. IT'S O.K. FOR YOU.
  109.  
  110. IF YOU DISCOVER SOME MORE INTEREST WHILE USING THIS PROGRAM, YOU
  111. MAY LIKE THE IDEA THAT YOU CAN ORDER FOR A SET OF PRINTED
  112. DOCUMENTATION, INCLUDING A FIRST INTRODUCTION IN THIS FIELD.
  113. (ADDRESSES OF 'LINDIS' AND 'ECD' CAN BE FOUND AT THE END OF THIS
  114. TEXT).
  115.  
  116. *********************** First aid manual ************************
  117.  
  118.  User interface.
  119.  
  120. The user interface of AIM consists of:
  121.  
  122. -RISCOS interface. Operations and parameters can be  selected  by 
  123. means of pop-up menus.  A choice from a menu results in a command 
  124. which is passed to the command interpreter. Image displays can be 
  125. moved and sized.
  126. Drag the image to a Display-Window (A, B, C or D).
  127. Drag the macro-file to one of the open AIM-Windows (including the
  128. Command Line Window) to start the execution of the macro.
  129.  
  130. -Command Line interpreter. Commands may be entered by typing. The
  131. location of the mouse-pointer is not critical anymore (v2.12 up).
  132. Use lower case! 
  133. A history mechanism is provided. Type  h.  To execute a  previous
  134. command, type  !#  (# = history-number of a previous command). 
  135.  
  136. -Sequences of commands can be given in a macro-file. A macro-file
  137. may be called within another macro-file up to 16 levels deep.
  138.  
  139.  
  140.  Images in AIM.
  141.  
  142. Up to four image memories are available in AIM.
  143. Standard AIM images have a size of 256 x 256 pixels (in AIM/3 all
  144. sizes are accepted), and are stored line by line from top left to
  145. bottom right.
  146. These standard images have a size of 65536 pixels, and are 8 bits
  147. deep - and are thus 64K in size.
  148. These 'image memories' are displayed on the  Archimedes screen in
  149. windows designated ‘A’, ‘B’, 'C' and ‘D’, which can be moved  and
  150. sized. They are shown as 256 x 256 pixels in a  limited number of
  151. greyshades, but a 'sigma-delta technique'  is used to improve the
  152. representation of the original 256 grey values.
  153. Be aware of the fact that a display in a window is no more than a
  154. 'as good as possible' (display-mode determined) representation of
  155. an image in memory.  (The image processing is always performed on
  156. the images).
  157. The  8 bitplanes of the  grey-value images  can also be used as 8
  158. 'binary images', on which  'Cellular Logic' and 'Bitplane Binary'
  159. operations may be performed.
  160. The bitplanes are numbered from 1(least) to 8(most significant).
  161. When an image is read from disk, all 8 bitplanes are read simult-
  162. aneously. The same holds when an image is written to disk.
  163. Hence, a single bitplane must be copied to all 8, before  writing
  164. the image to disk (the command 'mcopy' can do this for you).
  165.  
  166. If an AIM image does not have the standard size, a  headerfile is
  167. needed - in order that it may be read correctly.  This is a  file
  168. having the same name as the image file,  with a "+" added,  which
  169. describes the image width and height. The  header format used  is
  170. given in the Appendix of the Reference Manual.
  171. When an image file is written in the AIM format, a header file is
  172. always written.
  173. In AIM/3 the use of a new format, the 'TCL data format' (which is
  174. direct compatible with the  professional image processing package
  175. TCL-Image), is made possible and this format should be preferred.
  176. Moreover, 'GreySprites' (having a palette of 256 grey levels) are
  177. accepted.
  178. A TCL image file (with a header included) has file-type &011.  An
  179. AIM imagefile has file-type &004, a headerfile has file-type &010
  180. and a resource-file (in which the set-up is stored) has file-type
  181. &012.
  182.  
  183.  Installing and Running AIM/3
  184.  
  185. In this RISC OS 3 version of AIM,  the files on the  distribution
  186. disk #1 are organized in a single application directory !aim.
  187. The application directory !aim should be copied to a hard disk.
  188. Double-clicking with 'Select' on the icons of both the source and
  189. destination drives will open Filer windows. The aim directory may
  190. then be 'dragged' from the source to the destination window.
  191. Additional files are present on the accompanying disks,  read the
  192. 'Readme' files on those disks.
  193. AIM may be run by double-clicking with Select  on the application
  194. in the Filer window, to put an icon on the icon bar.  Now, an AIM
  195. imagefile may be dragged onto the icon or the application started
  196. "empty" by clicking on the icon.
  197. If a mode other than  Mode 27 or Mode 28 (the default mode) is in
  198. use, the best method of starting the AIM application is  to click
  199. on the appropriate resource-file in !aim.resources.  (AIM 'image'
  200. and other files are  normally stored within the !aim application.
  201. They may be reached by holding down the  Shift key, while double-
  202. clicking on the !aim directory icon in the Filer window).
  203. A file !aim.default allows modifications, affecting memory needs.
  204. In AIM/3 it is also possible to start the  application by double-
  205. clicking on an AIM- or TCL- datafile (image), provided the filing
  206. system has 'seen' the application.
  207.  
  208.  
  209.  Command interpreter.
  210.  
  211. It  is  not  necessary to give the  complete  command  name.  The 
  212. smallest number of letters (lower case!) which gives no ambiguity
  213. is  sufficient.
  214.  
  215. It is possible to edit your commands in a simple way. The delete- 
  216. key or the Backspace key deletes the last character.
  217. A sequence of commands which performs a certain operation may  be 
  218. grouped to a 'macro-file' and stored on disk.
  219.  
  220. Macro-files are executed by typing @macro-name.  A new macro-file 
  221. can  be  called within a macro-file and may be nested  up  to  16 
  222. levels  deep.  So typing @macro-name executes the macro-file.
  223. ESCAPE stops the  execution of a  macro-file and asks the user to
  224. continue or not. Typing   Q <CR>   aborts the  currently  running
  225. macro,  C <CR>  continues the macro ( <CR> = Return key).
  226. Default values are  used  when a parameter is not given.  When an
  227. erroneous value of a parameter is given,  the command interpreter
  228. asks for a correct value. If in this  case a return is given, the
  229. default value  is  used.
  230. This gives the  possibility to ask for a parameter value  when  a 
  231. macro-file is executed,  instead of using a  fixed value.  In the 
  232. macro-file for instance, a question mark (?) can be used  instead 
  233. of the parameter value to obtain this feature.
  234.  
  235. A  question mark (?) instead of a command  gives a  list  of  all 
  236. available commands.
  237.  
  238. A  star  (*)  indicates that the  remainder  of  the  commandline 
  239. consists of comments.
  240. Never have a 'blank line' in the macro-file, except at the end.
  241.  
  242.  
  243.  
  244.  Digitisers.
  245.  
  246. If a  Watford digitiser is attached to the Archimedes the command 
  247. 'watford' can be used to grab an image and transport it to an AIM
  248. image in memory.  Pressing  return  stops grabbing and keeps  the
  249. current image. Resolution is limited to 6 bits (64 grey levels).
  250.  
  251. Note: Some Wild Vision series of digitisers use the AIM format as
  252.       output format. You can use these digitisers as well, a  256
  253.       grey-value version is available.
  254.  
  255. Note: Scanner support is already available:
  256.       The professional EPSON 8 bit grey-value / 24bit colour flat
  257.       bed scanner GT-4000,GT-6000 (and software compatible types) 
  258.       are supported by Irlam and offer a GreySprite as one of the
  259.       possible output formats.
  260.  
  261.  
  262.  
  263. ****** Order for the 3-in-1 Manual (including revision 1) *******
  264.  
  265. This printed manual was written to help you in understanding what
  266. you are doing in Image Processing / Analysis and it gives you all
  267. the details of the AIM commands.
  268.                               
  269. Order for these +/- 120 pages of documentation containing
  270.  
  271. - a first Introduction in Image Processing,
  272. - the AIM Users Manual,
  273. - the AIM Reference Manual (describing the commands and options),
  274. - the update of the manual:
  275.   AIM Users Manual revision 1, including Ref.Manual revisions,
  276.  
  277. together with the latest version of AIM on disk.
  278.  
  279. In UK:
  280.    Lindis International Ltd., Wood Farm, Linstead Magna,
  281.    Halesworth, Suffolk IP19 0DU (UK)
  282.  
  283. Worldwide:
  284.    ECD Computers,
  285.    Business Park Zuidflank, Patrijsweg 76,
  286.    2289 EX  Rijswijk (Holland).
  287.  
  288.  
  289.  
  290. (Serious users: ask for TCL-Image information, available at
  291. Lindis and ECD).
  292.  
  293.  
  294. Suggestions, remarks (please, don't ask for the C-sources):
  295.  
  296.    Thom Hoeksma, Pattern Recognition Group,
  297.    Faculty of Applied Physics TUD,
  298.    Lorentzweg 1,
  299.    2628 CJ Delft (The Netherlands).
  300.  
  301.                                                         May 1995,
  302.                                                     Thom Hoeksma.
  303.  
  304.