home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / comdemos / progs / imagebank / !ImageBank / !Help < prev    next >
Encoding:
Text File  |  1994-01-08  |  9.4 KB  |  261 lines

  1.  
  2. ImageBank 
  3. =========
  4.  
  5. ImageBank is a simple RISC OS compliant
  6. application to package up a number of JPEG images
  7. with browser + cataloguer + compressor + decompressor.
  8.  
  9. An image can be:-
  10.  
  11.  - added to the archive by dropping on the browser window.
  12.  - exported by dragging from the browser window.
  13.  - decompressed in to a window by double-clicking on it.
  14.  - deleted from the archive.
  15.  - renamed.
  16.  
  17. In addition a fuller description of the image can be saved and displayed along with the browse image.
  18.  
  19. Online help is provided via the Acorn !Help
  20. application.
  21.  
  22. This application will only run on RISCOS 3.10 or
  23. later.
  24.  
  25. This software is based in part on the work of
  26. the Independent JPEG Group. Version 4 release
  27. 10-Dec-92.
  28.  
  29. ICON BAR
  30. ========
  31.  
  32. Clicking on the ImageBank icon will open the root browser window.
  33.  
  34. Dragging a JPEG file to the icon will decompress it and display it in a window (but won't add it to the catalogue).
  35.  
  36. MENU
  37.  
  38.  - Info
  39. Opens a standard application information box.
  40.  
  41.  - Choices.Use fonts
  42. If this is selected then the Homerton.Medium font will be used in the browser windows, otherwise the system font will be used.
  43.  
  44.  - Choices.Browse size
  45. This allows you to set the maximum size of the browse images created when a new image is imported.
  46.  
  47.  - Choices.Quality
  48. This allows you to choose the quality level at which to compress. 100 is the highest value, 25 the practical lowest. A value of 75 usually gives good compression without any degradation being noticeable.
  49.  
  50.  - Choices.Optimise entropy
  51. If this is selected then extra time will be taken in compression. It will give an identical picture when decompressed but the compressed file size will be slightly smaller.
  52.  
  53.  - Save choices
  54. This saves the above choices plus some defaults for the browser windows (such as save type and sprite type).
  55.  
  56. BROWSER
  57. =======
  58.  
  59. Operation of the browser windows is closely modelled on that of the filer. So
  60.  
  61.  - Click SELECT
  62.       to select a single item.
  63.  - Click ADJUST
  64.       to toggle an item in and out of the selection.
  65.  
  66.  - Double click SELECT
  67.       on an image to decompress it and display it in a window.
  68.       on a directory to open a browser onto it.
  69.  - Double click ADJUST
  70.       as SELECT but closes the browser window afterwards.
  71.  
  72.  - SHIFT Double click SELECT
  73.       on a directory to close the directory browser.
  74.  - CTRL Double click SELECT
  75.       to open the info window for an object.
  76.  
  77.  - Click ADJUST on the close icon to close the browser and open its parent.
  78.  - SHIFT click ADJUST on the close icon to open the parent only.
  79.  
  80.  - Drag SELECT
  81.       between browser windows moves the selection from one browser to the other. Note that directories cannot be moved, however you can create a new directory (with the same as necessary) in the destination browser and copy all the images.
  82.       to a directory display or to another application will attempt to save the image to disc or to the application. The filetype used will be the one shown ticked in the Save submenu, and in the case of sprites the sprite type used will be that shown ticked in the Sprite submenu.
  83.  
  84.  - Drag ADJUST does the same as above but closes the browser wdinow afterwards.
  85.  
  86. Files can be dragged to the browser window also. Acceptable types are JPEG, Sprite (8 bit and above) and Clear.
  87.  
  88. If a JPEG file is dropped onto a browser window it ic copied into the catalogue store and decompressed to create a browse sprite which is then displayed in the browser.
  89.  
  90. If a Sprite or Clear file is dropped on a browser window then they will be compressed (using the options set in the iconbar Choices submenu) and a browse sprite created.
  91.  
  92. After decompression or compression the Info window will be opened so that you can enter a longer description of the image.
  93.  
  94.  
  95. MENU
  96.  
  97.  - Display.Icons
  98.  - Display.Full info
  99. Choose between two display methods as for a standard directory display.
  100.  
  101.  - Display.Sort by name
  102.  - Display.Sort by size
  103.  - Display.Sort by date
  104. Choose the sort method for this browser.
  105.  
  106.  - Image.Save JPEG
  107. This will save out the compressed image.
  108.  
  109.  - Image.Save sprite
  110. This leads to a further submenu giving the five different sprite types that can be saved. They are described in more detail below. Clicking on one of the menu items will select that as the default sprite save type.
  111.  
  112.  - Image.Save clear
  113. This will decompress the image to a 24 bit Clear file.
  114.  
  115. Clicking on any of the save menu items will select that type as the default filetype to be used when saving images by dragging directly out of the browser window.
  116.  
  117.  - Image.Rename
  118. Change the 10 character name displayed in Icon view and used as a default when saving.
  119.  
  120.  - Image.Info
  121. This leads to a dialogue box giving full information about the image or directory and allowing the long description to be altered.
  122.  
  123.  - Image.Delete
  124. This will delete a selection of images and directories. Note directories can only be deleted when empty.
  125.  
  126.  - Edit.Select all
  127. Select all objects in the browser.
  128.  
  129.  - Edit.Clear selection
  130. Clear the selection.
  131.  
  132.  - Edit.Copy
  133. Copy a selected image to the clipboard. From here it may be imported by any application that supports the clipboard protocol. The image can be exported as a JPEG, Sprite or Clear file depending on what the receiving application supports. If a sprite file is exported then the exact type of sprite file is determined by what is ticked in the sprite save submenu.
  134.  
  135.  - Edit.Paste
  136. Import an image from the clipboard.
  137.  
  138.  - New directory
  139. This will create a new directory in the browser with the given short name.
  140.  
  141.  - Open parent
  142. This will open the parent of this browser.
  143.  
  144.  
  145. DISPLAY
  146. =======
  147.  
  148.  - Save image
  149. Saves the image as displayed as a sprite file.
  150.  
  151.  - Zoom
  152. Allows you to zoom in and out of the image.
  153.  
  154. Click ADJUST on close icon to open parent browser (or filer window if displaying a JPEG file dropped on the iconbar) as with browser windows.
  155.  
  156. Note that the sprite displayed in this window is not affected by the default sprite type set in the menus. It will either be a standard palette 256 colour, 32 thousand colour or 16 million colour sprite depending on the current screen mode.
  157.  
  158. CATALOGUE INFORMATION
  159. =====================
  160.  
  161. Information on each image stored in the catalogue is as follows
  162.  
  163.  - Original filename of image imported (or task that exported it if it was saved directly from another application).
  164.  - Time and date image was imported.
  165.  - Dimensions of image.
  166.  - Resolution of image (pixels per inch). Note that JFIF files don't store any resolution or aspect ratio information. This means that a file created from a sprite with non-square pixels (eg MODE 15) will appear squashed vertically if decompressed by another application that didn't know this. ImageBank stores this information so that it can recreate the appropriate sprite type.
  167.  - Short name for Icon displays and saving.
  168.  - Long description for Full info displays.
  169.  - Quality factor used in compression. Again this value is not stored in a JFIF file so it is only known from images compressed by ImageBank. 
  170.  
  171. MEMORY
  172. ------
  173.  
  174. When compressing decompressing images, memory is temporarily
  175. allocated from the Wimp Free pool. If there is not
  176. enough then temporary files are created in a
  177. location given by the value of the system variable
  178. <Wimp$ScrapDir>. If you get messages about not
  179. being able to create temporary files then check
  180. that you have a !Scrap directory. In all cases it
  181. will need approx 200K above its wimpslot to run.
  182.  
  183. DECOMPRESSED IMAGES
  184. -------------------
  185.  
  186. Images can be decompressed to 6 different types of
  187. file from the Browser menu.
  188.  
  189. Standard:    This is a MODE 15 or 28 sprite with the
  190. standard 256 colour palette and can be viewed
  191. correctly in any 256 colour screen mode.
  192.  
  193. Grey:        This is a MODE 15 or 28 sprite with a
  194. palette consisting of 256 levels of grey. Although
  195. all the detail cannot be viewed on a standard
  196. Archimedes it can be printed on a monochrome
  197. printer with more detail than a standard palette
  198. sprite.
  199.  
  200. Optimised:   This is a MODE 15 or 28 sprite with a
  201. palette optimised to use the most common colours
  202. in the image to give the best possible 8 bit
  203. image. Unfortunately the only current way to view
  204. it correctly is with a 3rd party enhanced graphics
  205. card. It may however give better printed results
  206. on a colour printer than the standard palette
  207. sprite.
  208.  
  209. 32 thousand colours: This is a new format sprite and is
  210. a useful trade off between quality and file size.
  211.  
  212. 16 million colours:  This is a new format sprite and
  213. gives the best possible image that can be created.
  214.  
  215. Clear:       This is a 24 bit Clear file and
  216. cannot be viewed in this form. Clear files are a
  217. common interchange format for 24 bit graphics
  218. files on the Archimedes and most applications that
  219. can deal with 24 bit colour will be able to load a
  220. Clear file.
  221.  
  222.  
  223. VERSIONS
  224. --------
  225.  
  226. This application comes in two forms.
  227.  
  228. Full version - features as described above.
  229. Read only    - cannot save Clear files or
  230.                add new JPEG files to the archive.
  231.  
  232. The Read Only version is freely distributable as
  233. long as the following conditions are abided by.
  234.  
  235. 1) NONE of the files within the application are
  236.    removed or altered in any way. This includes
  237.    all images, code and data files.
  238.  
  239. 2) No charge is made.
  240.  
  241. Thus it may be uploaded to bulletin boards/archive
  242. servers/ftp sites. But it may NOT be distributed
  243. by PD libraries or anyone that else that charges
  244. for their services.
  245.  
  246. The Full version is only available from:-
  247.  
  248. Irlam Instruments Ltd.
  249. Brunel Institute for Bioengineering
  250. Brunel University
  251. Uxbridge
  252. Middlesex
  253. UB8 3PH
  254. 0895 811401
  255.  
  256. All software © Irlam Instruments Ltd. 1994 except
  257. those portions provided by the Independent JPEG
  258. Group.
  259.  
  260. eof ImageBank:!Help
  261.