home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / thump_2 / !Thump / !Help < prev    next >
Text File  |  1997-10-19  |  9KB  |  210 lines
  1.                                      T h u m p
  2.                                     ===========
  3.                               version 1.00,  17-10-97
  4.                                   by Rick Hudson
  5.  
  6.  
  7. This software is FreeWare. It must only be distrubuted in its original form
  8. and there must be no charge for it (except possibly for covering media
  9. costs).
  10.  
  11.  
  12. What is Thump?
  13. --------------
  14.  
  15. Thump is a JPEG thumbnail browser. Thump differs from most other thumbnail
  16. applications in that it does not build and store a special set of thumbnails
  17. - it generates them in real time as you browse the directory structure.
  18. Because of the real-time nature it is suitable for sets of images that change
  19. from time to time because there is no thumbnail library to be outdated.
  20.  
  21. Of course this has limitations. One is that Thump can only view JPEGs
  22. (because the the OS can render JPEGs reasonaby quickly) - and there are no
  23. plans to ever change that. Another is that displays are not instananeous and
  24. that may be annoying.
  25.  
  26. It is also possible to attach captions (or descriptions) and keywords to
  27. images although there isn't a search facility yet (it's planned though).
  28.  
  29. What is it called Thump? I dunno. It just is. Maybe because it's spelt almost
  30. like Thumb.
  31.  
  32.  
  33. How is it used?
  34. ---------------
  35.  
  36. Probably the only non-obvious thing is how to get things started. The program
  37. is launched as normal and it installs itself on the icon bar. To view a
  38. directory you need to drag one to Thump's icon bar icon. First Thump collects
  39. information on the JPEGs in the directory (this may take a few seconds if
  40. there are lots of JPEGs) and the display opens with blank rectangles where
  41. the images will go and folder icons for any sub-directories found. Thump will
  42. then proceed to fill in the blanks by drawing the JPEG thumbnails in the
  43. background. Whenever the window needs to be redrawn (parts become visible
  44. again) the blank rectangles will be shown until it can get around to
  45. redrawing the thumbnail again.
  46.  
  47. Clicking with Select on a folder icon will open a new display as above.
  48. Clicking with Adjust does the same but closes the old display.
  49.  
  50. Clicking with Select on a thumbnail shows the full-size image and clicking
  51. with Adjust opens the caption edit dbox.
  52.  
  53. Popping up a menu in a thumbnail display results in this menu:
  54.  
  55.   Display       >
  56.   File 'xxx'    >
  57.   Open parent
  58.   
  59. The Display submenu is similar to the filer's (although no sorting options
  60. are available) providing options resulting in a display also similar to the
  61. filer:
  62.  
  63.   Large images      Grid of largish images with leafname underneath
  64.   Small images      Grid of small images with leafname to the right
  65.   Full info         Single column of images with name, caption & keywords
  66.  
  67. The File (or dir.) submenu is this:
  68.  
  69.   View              View full image with internal JPEG viewer
  70.   External view     View full image with external program (Filer_Run)
  71.   Edit info         Open dbox for editing caption
  72.  
  73. Open parent opens the directory above the current one. Clicking adjust on the
  74. window's close icon also opens the parent but that also closes the current
  75. display.
  76.  
  77. Ordinarily Thump loads all the JPEGs into memory for thumbnailing purposes.
  78. If there is insufficient memory the JPEGs will not be loaded and will be
  79. accessed from disc whenever redrawing is required.
  80.  
  81. When the internal viewer shows a thumbnail it will just show the image from
  82. the thumbnail buffer if it is present. If not present it will allocate a
  83. buffer for the image, load it and display it from that. If the buffer cannot
  84. be claimed it will be rendered directly from disc. If an image is being
  85. rendered from the thumnail buffer and you subsequently close the window
  86. containing the thumbnail the full size image will revert to disc rendering.
  87.  
  88.  
  89. Attributing information to images
  90. ---------------------------------
  91.  
  92. The caption editor is straightforward. It is opened by clicking adjust on a
  93. thumbnail image or by selecting 'edit info' from the menu. The current
  94. caption and keywords are shown and can be edited. Clicking on save saves the
  95. information to disc, cancel discards anything you have have done, and view
  96. displays the full size picture. Clicking on the thumbnail also displays the
  97. full image.
  98.  
  99. You can also attach desriptions to directories (only via the menu). Text may
  100. be dropped on to the fields from another program (usually an editor) or file.
  101.  
  102. At present the keywords field is technically the same as the caption but the
  103. idea is to describe the picture in the caption but enter significant features
  104. into the keywords with a view to searching for a type of picture. There is no
  105. set format for keywords field but I recommend you use the following guidlines
  106. in case the search engine later depends on it.
  107.  
  108.   - keywords should be separated by commas
  109.   - spaces should not be used
  110.  
  111. eg italy,historic-place
  112.  
  113. Information is associated with images based on characteristics of the file
  114. only and not the name or location. This means if you move the file or even
  115. rename it, it will retain its description when you see it in its new place.
  116.  
  117.  
  118. Searching for pictures
  119. ----------------------
  120.  
  121. The search dbox is opened from the icon-bar menu. Enter words to search for
  122. separated by spaces. Use quotes if you want to search for a phrase that has a
  123. space in it.
  124.  
  125. Clicking 'Match all' will only select an image if all the words you entered
  126. appear in the text. 'Match any' selects images if one or more words match. In
  127. logic terms 'Match all' is like putting an 'AND' between each word and 'Match
  128. any' is like putting an 'OR' between them.
  129.  
  130. Choosing 'Description' will look for words in the caption field and choosing
  131. 'Keywords' will look for words in the keywords field. Enabling both will
  132. find pictures with words appearing in either field.
  133.  
  134. Searching is quite rapid and a result display will open when the results are
  135. available. Images are not cached in the thumbnail display so they will be
  136. rendered from disc.
  137.  
  138. Only pictures that are in the information database can be selected. A picture
  139. does not enter the database until you click save in the caption editor.
  140.  
  141. At present, if Thump finds a picture in its database that no longer exists
  142. (ie it has been moved or deleted) then you will just see a question icon in
  143. the display. There are plans to add the option of searching the disc for such
  144. missing pictures. In order for Thump to perform searches it stores the last
  145. known location of images for this purpose only. If Thump sees the image in
  146. another place as you browse around you will still see the same description
  147. and keywords because the matching mechanism for this uses characteristics of
  148. the file itself rather than the location. Such changes are updated
  149. automatically when they are detected.
  150.  
  151.  
  152. Preferences
  153. -----------
  154.  
  155. Opening the preferences dbox from the icon bar reveals some things you can
  156. control. The Save, Set and Cancel buttons do the use things. Clicking Save or
  157. Set with Adjust keeps the dbox open whereas clicking with Select closes it.
  158.  
  159.   - Display mode. Determines which format newly opened thumbnail directories
  160.     are shown in.
  161.     
  162.   - Thumbnail size. The size of the thumbnail is the currently shown display
  163.     mode. Only the dimensions for the mode shown are stored when you click
  164.     Save or Set.
  165.  
  166.   - Thumbnail render. Selects one of the available rendering modes. Dithering
  167.     improves the display quality if less than 16 milion colours are
  168.     available. Error diffused dithering only applies to 256 colour modes and
  169.     makes better use of the palette.
  170.   
  171.   - Image render. Selects the rendering mode for the full-sized images in the
  172.     same way as thumbnail rendering (above).
  173.   
  174.   - Image buffer. Selects the storage method for full-sized images:
  175.       * 'From thumbnail' uses the thumbnail display's buffer if available
  176.       * 'Use buffer' forces a separate buffer to be used
  177.       * 'From file' uses no static memory and uses the data on disc
  178.     If the preferred buffer cannot be used then the next one on the list if
  179.     used instead.
  180.  
  181.   - Buffer thumbnails in memory. Selects whether to keep all the images in
  182.     memory or not. When disabled, very little memory is used, initial
  183.     directory opening is faster and redraw has a small speed penalty
  184.     accompanied by some disc activity.
  185.   
  186.   - Respond to dataopen. When enabled Thump will repsond to double-clicks on
  187.     JPEGs and render them. Disable it if you use another viewer.
  188.     
  189.   - Use external viewer. When enabled, displaying of full-sized images will
  190.     be passed to an external viewer. Thump won't pick up on the render
  191.     request if 'Repsond to dataopen' is enabled.
  192.  
  193.   - One image at a time. When enabled, all other full size images will be
  194.     closed before opening a new one. Saves closing them manually all the
  195.     time.
  196.  
  197. Version history
  198. ---------------
  199.  
  200. 1.01 (17/10/97) - added preferences dbox
  201.                 - changed info format (already!) to assist in searching
  202.                 - added searching facility
  203.  
  204. 1.00 (17/10/97) - first version
  205.  
  206.  
  207.  
  208. rick@actrix.gen.nz
  209. http://www.geocities.com/CapeCanaveral/Lab/6722/thump.html
  210.