home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / thumbnail / !Thumbnail / !Help < prev    next >
Encoding:
Text File  |  1996-07-07  |  37.5 KB  |  907 lines

  1.  
  2.  
  3.            Thumbnail                  © copyright, Ian Palmer 1994, 1995, 1996
  4.            =========
  5.  
  6.  
  7. IMPORTANT
  8. =========
  9.  
  10. Thumbnail is SHAREWARE, it is NOT free software. Continued use requires
  11. registration, see the end of this file for details of the user licence.
  12.  
  13.  
  14.  
  15. Introduction
  16. ------------
  17.           
  18. Thumbnail provides you with a convenient way of searching for a picture from a
  19. library of pictures by providing 'Thumbnail' versions of the pictures that
  20. can be viewed quickly and easily.
  21.  
  22. Thumbnail requires Acorn's ChangeFSI application as it uses this for
  23. converting different file formats to a convenient format.
  24.  
  25. Thumbnail also provides support for producing thumbnails of Draw and Artworks
  26. files. Thus it can provide a very convenient way of looking at clipart for
  27. the Draw/Artworks files you want without having to load all the draw files
  28. into !Draw, !ArtWorks or !AWViewer. Now Thumbnail also provides support for
  29. Replay files.
  30.  
  31. Thumbnail maintains thumbnail versions of pictures and draw files within a
  32. directory structure, complete with descriptions and details of where the
  33. original file is located, so you can easily access the original file directly
  34. from thumbnail. All Thumbnail pictures are stored at 16bpp (or 32 bpp) and
  35. dithered to either 256 colour or 16 colour when needed for display.
  36.  
  37. Thumbnail can be run from either hard disc or floppy, although hard disc is
  38. better speedwise. Because Thumbnail allows you to store the original pictures
  39. separately from the thumbnails you could easily create one (or two) index
  40. discs (containing thumbnails), each index disc indexing many discs of
  41. pictures. Alternatively you could have one central index on hard disc and
  42. have all the original pictures on floppies, allowing you to get an idea of
  43. what pictures you want (from the thumbnails) without having to use the
  44. floppies until you actually want to load the picture.
  45.  
  46.  
  47. Running Thumbnail for the first time 
  48. ------------------------------------
  49.  
  50. The first time you run Thumbnail it is important to configure it to run
  51. correctly. The most important thing to do is 'teach' it where to find
  52. ChangeFSI (so that in future ChangeFSI does not have to be 'seen' by the
  53. filer). To do this simply drag the ChangeFSI application to Thumbnail's icon
  54. on the iconbar.
  55.  
  56. Next you need to set up a few preferences, to do this select 'Config' from
  57. Thumbnail's main menu.
  58.  
  59.  
  60. Configuration
  61. -------------
  62.  
  63. The Configure window contains several options :
  64.  
  65.  
  66.   Max Size - defines the maximum size for the thumbnail pictures. This can
  67.              be anything from 15x15 to 80x80 pixels.
  68.              
  69.   Max 
  70.   Display 
  71.   Width    - This defines the number of thumbnail pictures that will be
  72.              placed across a row of a display window.
  73.              
  74.   Open
  75.   Root     - When set the root directory is opened as soon as you run the
  76.              application, otherwise you will need to click SELECT on the icon
  77.              bar icon to see the root directory.
  78.              
  79.   New
  80.   ChangeFSI- Versions of ChangeFSI 0.95 and later can handle output to
  81.              32bpp sprites. Using these makes the process of producing
  82.              thumbnails faster. Thus if you have a new version (0.95 or
  83.              later) set this option.
  84.              
  85.              However using this option can require a lot of disc space
  86.              (in !Scrap) for a temporary file during processing. Not
  87.              setting this option reduces disc space needed to approx. 1/4.
  88.              
  89.   Slides   - There are two different display types available within directory
  90.              viewers. The default is a display similar to the standard
  91.              RISC OS filer. Setting this option changes the display to
  92.              appear like a collection of photograph slides.
  93.              
  94.   Full
  95.   Scroll   - By default display windows only have a vertical scroll bar
  96.              but setting this option marked them have both scroll bars.
  97.              
  98.   Auto
  99.   Display  - This option makes Thumbnail automatically set the display
  100.              option (see below) according to the current mode. This means
  101.              that in modes of 16 or less colours a 16 colour sprite will
  102.              be created for display, in 256 colour modes a 256 colour
  103.              sprite will be created, and in 16bpp and 32bpp modes a 32K
  104.              colour sprite will be created.
  105.              
  106.   Auto
  107.   Update   - Automatic update of scan file (see below).
  108.   
  109.   Update
  110.   Path     - If this option is set then when ever you try to create a
  111.              thumbnail which already exists in the thumbnail directory,
  112.              then only information (path, file size, etc.) will be
  113.              updated. If not set then the thumbnail will be recreated.
  114.              Thus by setting this option you can easily and quickly
  115.              keep your thumbnail collection up to date by simply dragging
  116.              directories to Thumbnail and it will only process fully those
  117.              that are new.
  118.              
  119.   Bell     - When set Thumbnail will beep when it has finished processing
  120.              all thumbnails waiting.
  121.              
  122.   Relative
  123.   Path     - This option, when set, will make Thumbnail store (as well as
  124.              the full path to the original file) a relative path to the
  125.              original file. This means that if you move Thumbnail AND the
  126.              original files so they remain relatively in the same location
  127.              Thumbnail will still be able to locate the original files.
  128.              (See 'Relative Paths' section for more details).
  129.              
  130.   Display
  131.   Sprite   - This option dictates whether then a sprite file (in Thumbnail)
  132.              is ADJUST double clicked (to view it) the sprite file is simply
  133.              run (and thus usually passed to !Paint) or whether Thumbnail
  134.              should display the sprite itself. If selected Thumbnail will
  135.              display the sprite.
  136.              
  137.   Display  - You can set the display to be either 16, 256 or 32K colour.
  138.              This defines what type of sprite thumbnail should create
  139.              when displaying a thumbnail picture.
  140.              256 colour produces the best results (even when viewed in a 16
  141.              colour mode), but 16 colour will take up less memory.
  142.              The 32K colour option is only available on Risc PC machines
  143.              and will produce the best results in 16bpp and 32bpp modes.
  144.              
  145.   Storage  - This sets whether Thumbnail should store thumbnails (on disc)
  146.              as 16 bpp or 32 bpp data. The default is 16 bpp, and there isn't
  147.              any real reason to change this as setting 32 bpp will make
  148.              little difference to image display quality, but will make
  149.              the files twice as large.
  150.              
  151.              Under this you can also elect for thumbnails to be compressed
  152.              when stored, providing a good level of compression at little
  153.              extra cost (see below). Compression requires RISC OS 3.
  154.              Please note that compression can only be used when you have
  155.              selected 16 bpp storage.
  156.                           
  157.              
  158. When the settings are to your liking 'Save' the options to save the
  159. configuration so that the options take effect on future runs of Thumbnail, or
  160. select 'OK' to make the changes temporary.
  161.  
  162. Note: These settings can be changed at any time. However, changing the 'Max
  163. Size' setting only alters new thumbnails created after the setting has been
  164. changed; but the display setting makes no difference to the stored
  165. thumbnails, only the display versions.
  166.  
  167. Thumbnails created at 32 bpp can be later 'compressed' to 16 bpp using the
  168. 'Picture Information' window.
  169.  
  170.  
  171.  
  172. Thumbnail directories
  173. ---------------------
  174.  
  175. Thumbnail stores its thumbnail pictures within a directory structure within
  176. its own application directory. To view the top level directory (called
  177. 'Thumbnail:$') simply click SELECT on the Thumbnail icon on the iconbar.
  178.  
  179. This directory viewer (which is NOT a filer viewer, although it is similar in
  180. some respects) is initially empty. In this directory you can place either
  181. further directories and/or thumbnail pictures.
  182.  
  183.  
  184.  
  185. Creating a directory
  186. --------------------
  187.  
  188. To create a directory simply press MENU over the Thumbnail directory viewer
  189. you want to create the directory in. A menu will pop up containing a 'New
  190. Directory' submenu entry (among others) which works just like in the standard
  191. filer.
  192.  
  193.  
  194. Moving between directory viewers
  195. --------------------------------
  196.  
  197. This is performed in a similar way to the standard filer. Opening a viewer
  198. containing a large number of thumbnails can take a little while, as the
  199. thumbnail pictures will need to be read and dithered to the correct display
  200. type.
  201.  
  202. When you close a thumbnail viewer the memory taken up by the display sprites
  203. will be freed, thus reopening the directory will require the thumbnails to be
  204. read again.
  205.  
  206.  
  207. Creating a thumbnail picture
  208. ----------------------------
  209.  
  210. To create a thumbnail picture simply drag the picture file you want to use to
  211. any of the Thumbnail directory viewers. Thumbnail will then produce a
  212. thumbnail version of that picture and place it within that viewer. The
  213. thumbnail will be given the same file name as the original picture file
  214. (although you can change this later). The conversion process is done in two
  215. stages, each producing an hourglass, the first converting the picture from
  216. the original file format (GIF, JPEG, etc.) (using ChangeFSI) to a 32bpp
  217. sprite, and then the second is the rescaling of the 32bpp sprite to a 16bpp
  218. thumbnail version.
  219.  
  220. During processing an information window is displayed showing the filename of
  221. the current file being processed. This window also contains an icon marked
  222. 'Pause', selecting this will cause Thumbnail to pause processing (after
  223. finishing the current one) until you select the icon again.
  224.  
  225. You can drag multiple files to Thumbnail and also directories, and Thumbnail
  226. will queue all items dragged to it and process them in order.
  227.  
  228. If you drag a directory to a Thumbnail viewer then a directory will be
  229. created (if not already there) with the same name and all the contents of
  230. that directory (including further subdirectories) will have thumbnail
  231. pictures placed in the thumbnail directory.
  232.  
  233.  
  234. Is that it?
  235. -----------
  236.  
  237. Nope. Thumbnail provides a great deal more than simply providing a system for
  238. viewing thumbnail pictures within a directory structure. It also provides
  239. access to the original file, and the ability to add descriptions of the
  240. pictures and also search the pictures for those whose descriptions contain
  241. certain words.
  242.  
  243.  
  244. The Picture Information Window
  245. ------------------------------
  246.  
  247. If you double click (with SELECT) on any thumbnail picture you will be shown
  248. an information window about that picture. This window contains many things :
  249.  
  250.   Top left   - The thumbnail and thumbnail name (as in the directory viewer).
  251.   
  252.   Top centre - The size of the original picture in pixels, and an icon
  253.                (see below).
  254.                
  255.   Top Right  - 6 radio icons for selecting output type (see below).
  256.   
  257.   Centre     - The full path name of the original file.
  258.   
  259.   Below      - A writable icon marked 'Description' and information about
  260.                the thumbnail (size in pixels and bytes, and storage);
  261.                plus an icon marked 'Update'.
  262.                
  263.   Bottom     - Contains information about the thumbnail (size, number of
  264.                bites and whether it is 16 or 32 bpp).
  265.  
  266. The 'Update' icon updates the description stored with the thumbnail to match
  267. the description in the 'Description' icon.
  268.  
  269. The icon in the top centre allows you to easily drag the original file to
  270. another application without having to locate it in the directory structure.
  271. Also by setting the radio icons (top right) you can also get the file
  272. converted to a convenient format as well :
  273.  
  274.   As stored  - Transfers the file as is, in original GIF, JPEG or whatever.
  275.   256 Sprite - Converts to a standard 256 colour sprite (dithered)
  276.   32 bpp     - Converts to 32bpp sprite.
  277.   16 bpp     - Converts to 16bpp sprite
  278.   16 colour  - Converts to a dithered 16 colour sprite (you need to be in
  279.                a 16 colour mode).
  280.   256 grey   - Converts to a 256 grey scale sprite.
  281.   
  282.  
  283. Note: You can also transfer the original file in the 'As stored' state by
  284. simply dragging the directory viewer thumbnail picture to the relevant
  285. application.
  286.  
  287. The icon marked 'Compress', which  will be greyed out for 16 bpp thumbnails,
  288. will convert a 32 bpp thumbnail to a 16 bpp thumbnail.
  289.  
  290.  
  291. Viewing a picture in full
  292. -------------------------
  293.  
  294. If you double click on a thumbnail using ADJUST then Thumbnail will attempt
  295. to bring you a viewing of the picture in full.
  296.  
  297. The process Thumbnail uses is detailed here, although you don't need to
  298. understand the process. First thumbnail broadcasts a message (Data_Open) to
  299. all currently running tasks to see it they want to handle it. If none of the
  300. tasks accept the file then Thumbnail checks to see if a run action has been
  301. defined for that file type (via an Alias$@RunType variable). If is has then
  302. Thumbnail will act upon that variable. Finally if all else fails, Thumbnail
  303. will pass the picture (unless it is a Draw or ArtWorks file) to ChangeFSI
  304. (running it if it isn't already running) to display.
  305.  
  306.  
  307. Opening the directory which contains a picture file
  308. ---------------------------------------------------
  309.  
  310. If you want to open the directory viewer for the directory containing the
  311. original file for a given thumbnail picture, simply double click on the
  312. thumbnail picture using ADJUST whilst also holding down either ALT key.
  313.  
  314.  
  315. Renaming and Deleting
  316. ---------------------
  317.  
  318. Pressing MENU over a directory viewer thumbnail will cause a menu top pop up
  319. where one of the entries is a submenu with the name of the thumbnail (or
  320. directory). This contains options for getting the information window (same as
  321. double clicking), renaming and deleting the item.
  322.  
  323.  
  324. Moving or copying an item
  325. -------------------------
  326.  
  327. You can move or copy an item (either a thumbnail or a directory) by simply
  328. dragging it from one viewer window to another in the same way as the filer.
  329.  
  330. Thus plain dragging from one Thumbnail viewer to another will copy that item,
  331. while dragging while holding down SHIFT will move an item.
  332.  
  333. If you 'copy' a directory to a standard filer window then a slave Thumbnail
  334. application will be created in that directory (if one is not already present)
  335. and the directory (and contents) will be copied to the root directory of
  336. that slave application.
  337.  
  338.  
  339. Merging two Thumbnail applications
  340. ----------------------------------
  341.  
  342. If you have two Thumbnail applications and wish to merge the contents of one
  343. into the other you can perform this simply by double clicking on the
  344. Thumbnail application you wish to merge (this makes it the current Thumbnail
  345. application) and drag the directories in the root directory to the filer
  346. window containing the Thumbnail application you wish to merge with (the
  347. destination Thumbnail application).
  348.  
  349. The directories in the current Thumbnail application will now be copied to
  350. the destination Thumbnail application.
  351.  
  352.  
  353. Performing a Scan
  354. -----------------
  355.  
  356. Both the main menu and the directory viewer menus contain entries called
  357. 'Scan'. This builds up a special file (used in searches) which contains
  358. information about all the thumbnails. After the scan you are presented with a
  359. window detailing how many files and directories you have and the total size
  360. of all the thumbnails stored.
  361.  
  362.  
  363. Automatic Update of Scan file
  364. -----------------------------
  365.  
  366. If you set the 'Auto Update' icon in the configuration then the scan file will
  367. be automatically updated by Thumbnail each time you perform any operation
  368. which would otherwise have made the scan file out of date. The only
  369. disadvantage of setting this option is that with a large scan file on a slow
  370. device updating may take time, thus the option is not set by default.
  371.  
  372. With automatic updating you should, if starting with an upto date scan file,
  373. not need to perform future scans unless you make alterations to the thumbnail
  374. data file from outside Thumbnail (see below).
  375.  
  376.  
  377. Performing a Search
  378. -------------------
  379.  
  380. The 'Search' window is reached by selecting the 'Search' option on the menus.
  381. This window contains a writable icon for entering the search string, an
  382. option for making the search ignore case and also a message stating how upto
  383. date the 'Scan' file is. If it is out of date you really need to perform a
  384. scan before doing a search, as an out of date scan file will not produce a
  385. completely correct search.
  386.  
  387. When you perform a search the scan file will be scanned and a special
  388. directory viewer will be displayed containing thumbnails of those that match
  389. the search. The search viewer is similar to the standard directory viewer but
  390. limited in that you can't bring up a menu on that window, nor drag files to
  391. it; however you can bring up the information window on any of the thumbnails.
  392.  
  393. You can not perform a null search, and also the search viewer is limited to
  394. 77 items (same as a directory). Entering a special search string of '¤'
  395. (or '¬' on a Risc PC) will search out all the thumbnails which have a null
  396. description (according to the Scan file).
  397.  
  398. There are also options for including the filename of the thumbnail in the
  399. search (ie. treat the filename as part of the description) and also an option
  400. for splitting the search string into words and searching for the words
  401. separately in the description.
  402.  
  403. With this last option you can also specify (in the icon marked 'Match') how
  404. many of the words need to be located for the search to work. The default is
  405. '1', thus if any words match then the thumbnail will be placed in the result
  406. window, with '2' two words must be in the description, etc.
  407.  
  408.  
  409. Draw Files
  410. ----------
  411.  
  412. As an added bonus Thumbnail is able to produce thumbnail pictures for many
  413. draw files as well as all the formats handled by ChangeFSI. There are a few
  414. limitations however. First the size information (in the picture information
  415. window) is fairly meaningless. Also when transferring the draw file (using the
  416. information window) with anything other than 'As stored' selected it will be
  417. converted to the relevant sprite but scaled to a maximum of 400x400 pixels
  418. (it is this size that appears in the size icon in the information window).
  419.  
  420. Please note that draw files saved under !Draw in RISC OS 2 will not work in
  421. Thumbnail (as the file will not contain the information needed to work out
  422. how to scale the picture). To solve this problem load the draw file into
  423. !Draw under RISC OS 3 (or later) and resave the file.
  424.  
  425. The above (concerning draw files created under RISC OS 2) does not apply if
  426. you have a copy of Acorn's 'DrawFile' module (inside your !System modules
  427. directory). If you have this file Thumbnail will use it instead of its own
  428. routines (which also means processing will be faster).
  429.  
  430.  
  431.  
  432. ArtWorks Files
  433. --------------
  434.  
  435. Thumbnail handles ArtWorks files in a similar way to Draw files, and again the
  436. 'size' information is meaningless. Also with ArtWorks files a little care
  437. needs to be taken when creating the thumbnails due to the ArtWorks renderer.
  438.  
  439. You can only create ArtWorks thumbnails when you are in any mode.
  440. Ideally, however, you should be in a 256 colour mode as this will usually
  441. produce better thumbnails.
  442.  
  443. If you do create thumbnails of ArtWorks files in a 16 (or less) colour mode
  444. you may notice the screen colours change for a short while during the
  445. rendering of the ArtWorks file, this is quite normal (and is needed to fool
  446. the renderer). It is not advised to create thumbnails of ArtWorks files in a
  447. mode with fewer then 16 colours.
  448.  
  449. On a Risc PC the best results will be obtained by creating the thumbnails
  450. whilst in a 16bpp or 32bpp mode (32 thousand or 16 million colour modes).
  451.  
  452.  
  453.  
  454. Replay Files
  455. ------------
  456.  
  457. Thumbnail has support for Replay files, whereby the initial title sprite is
  458. used for creating the thumbnail picture. 
  459.  
  460. In order to create a thumbnail for a Replay movie file, Thumbnail needs
  461. access to the 'extract' tool which is stored in the !ARMovie application. As
  462. long as this application has been 'seen' by the filer, Thumbnail will be able
  463. to locate the necessary tool.
  464.  
  465. Double clicking on ADJUST for a replay thumbnail will run the replay movie as
  466. if the file itself was double clicked (as with other file types). Using the
  467. information window to perform a conversion (eg. to 256 colour sprite) will
  468. cause the title sprite to be used in the conversion.
  469.  
  470.  
  471.  
  472. ProCAD & CADet Files
  473. --------------------
  474.  
  475. Thumbnail supports files from Minerva's CAD products (ProCAD and CADet) in a
  476. similar way to ArtWorks and Draw files (see above). As with Draw & ArtWorks
  477. files, the size information is fairly meaningless.
  478.  
  479.  
  480.  
  481. Squashed files
  482. --------------
  483.  
  484. Thumbnail has limited support for files which have been compressed using
  485. Acorn's !Squash utility. Any squashed files dragged to a Thumbnail directory
  486. viewer will be processed correctly and a thumbnail created.
  487.  
  488.  
  489.  
  490. Compression
  491. -----------
  492.  
  493. The compression of thumbnails for storage is provided by the Squash module
  494. within RISC OS 3, and can give between 50 and 75% saving on disc storage (but
  495. does require a more memory when loading thumbnails).
  496.  
  497. The icon marked 'Compress' on the picture information window will compress a
  498. thumbnail (storage) by making sure it is at 16 bpp (as opposed to 32 bpp) and
  499. also compress the thumbnail, but only if the 'Compress' option is selected in
  500. the configuration.
  501.  
  502.  
  503. Thumbnail and SparkFS
  504. ---------------------
  505.  
  506. There is a problem which can occur with pictures stored in archives under
  507. SparkFS (and possible other compression schemes). Sometimes Thumbnail will
  508. produce an error when trying to produce a thumbnail of a picture stored under
  509. such a compression scheme (eg. 'ChangeFSI failed to load ....'). This error
  510. is often produced because ChangeFSI claims all available memory during
  511. processing leaving none available for the compression filling system.
  512.  
  513. To overcome this problem you need to make sure the compression system has
  514. enough memory available to it before producing the thumbnail. With SparkFS
  515. you do this by configuring its minimum memory allocation such that it is
  516. large enough.
  517.  
  518.  
  519. Thumbnail Slave Applications 
  520. ----------------------------
  521.  
  522. With a very large collection of pictures and clip art, it may be that you
  523. wish to store thumbnail viewers in separate locations (some on floppy discs,
  524. some on hard discs, etc.).
  525.  
  526. Rather than duplicate the complete !Thumbnail application for each copy
  527. (which would take up about 300k) you can create a 'Thumbnail Slave
  528. Application' which takes up just over 1k of space. Then, as long as the main
  529. Thumbnail application is either running or has been 'seen' you can use this
  530. slave version as if it was a full version.
  531.  
  532. To create a slave application, simply select the 'Slave' option from the main
  533. menu. A window will pop up containing an icon which you should drag to the
  534. directory in which you wish to install the slave application, and the slave
  535. will be created.
  536.  
  537. Note: All slave applications must be called '!Thumbnail', and only one
  538. thumbnail application (either real or slave) can be active at one time. If you
  539. double click on an application another is running then the one you are
  540. looking at will be closed down, and the new one will be used.
  541.  
  542.  
  543. Relative Paths
  544. --------------
  545.  
  546. If you select the 'Relative Path' option on the configuration window then
  547. Thumbnail will store extra information with the thumbnails. This information
  548. details the location of the original file relative to the thumbnail
  549. application directory (or slave application directory if appropriate).
  550.  
  551. This means that if you move both the thumbnail application and the original
  552. files so that they remain relatively in the same location, Thumbnail will
  553. still be able to locate the original files.
  554.  
  555. Where relative paths are available, Thumbnail will use the relative path in
  556. preference to the absolute path (which is always stored) if the file can be
  557. accessed by that path, otherwise it defaults to the absolute path.
  558.  
  559. This means that if you move just the Thumbnail application it will also still
  560. be able to locate the original files.
  561.  
  562.  
  563. Thumbnail Correction
  564. --------------------
  565.  
  566. Sometimes you will get a thumbnail that is difficult to see, for example it
  567. may be too dark, too bright, etc. Thumbnail allows you to make small
  568. corrections to individual thumbnails.
  569.  
  570. To correct a thumbnail open the Picture Information window on that thumbnail
  571. picture (double click SELECT on the thumbnail picture). Using the window
  572. toggle icon (top right) make the information window full sized. At the bottom
  573. of the window will now be a line :
  574.  
  575.                         _____                    _____
  576.    Correction :  Add : |_____|       Multiply : |_____|       Try
  577.    
  578.  
  579. The 'Add' icon will (by default) contain the value 0, the 'Multiply' icon
  580. will contain 1.
  581.  
  582. By altering the values you will make Thumbnail perform an extra process when
  583. producing the display thumbnail picture.
  584.  
  585. Both operations work on the intensity of the picture, multiply will multiply
  586. the pixel intensity by a constant, and add will add a constant value to the
  587. intensity of the pixels.
  588.  
  589. For example to brighten a picture place a positive value in the 'Add' icon,
  590. to darken place a negative value in the 'Add' icon. The 'Add' icon must
  591. contain a whole number between -256 and 256 (typically a value between -64
  592. and 64 will be useful, values outside this range will usually be fairly
  593. useless).
  594.  
  595. To increase the contrast of a picture place a value >1 in the 'Multiply'
  596. icon, a value between 0 and 1 will reduce the contrast. The value in the
  597. 'Multiply' icon is a real number between 0 and (about) 4 (although the is no
  598. set limit). Typically values between 0.5 and 2 will be useful.
  599.  
  600. Gamma correction can be achieved by using a negative multiply value. In this
  601. case the multiply value is made positive, and then used as the input to the
  602. gamma correction function. Gamma correction performs a nonlinear brightening
  603. operation. A gamma value of 1 (-1 placed in the multiply icon) produces no
  604. change, values above 1 tend to brighten, values below 1 darken.
  605.  
  606. As a guide, for thumbnails that are too dark try the following values in the
  607. 'Multiply' icon : -1.5, -2, -2.5 (these will brighten with increasing
  608. effect).
  609.  
  610. You can combine add and multiply operations, in which case Thumbnail will
  611. perform the multiply then the add.
  612.  
  613. To see the results of changing the values select the 'Try' icon. Thumbnail
  614. will then reprocess the thumbnail picture and display the result in the
  615. display icon at the top left of the information window.
  616.  
  617. Once you are happy with the display, select the 'Update' icon and your
  618. settings will be saved with the thumbnail for future use.
  619.  
  620. Entering values in the add and multiply icons won't alter the stored
  621. thumbnail data in any way, it only alters how that data is handled when
  622. Thumbnail creates a display sprite. Thus you can not damage a thumbnail
  623. permanently by trying out values.
  624.  
  625. NOTE: When trying out different values for the add and multiply icons make
  626. sure that you have not altered the 'Display' setting in the configuration
  627. window (or changed mode with 'Auto Display' set) as this will confuse
  628. Thumbnail and may cause it to crash.
  629.  
  630.  
  631. Thumbnail on a Risc PC
  632. ----------------------
  633.  
  634. Thumbnail will work perfectly well on a Risc PC, although there is one minor
  635. problem associated with the '32k colour' display option. With this option set
  636. (or the 'Auto Display' option set where display thumbnails are created in
  637. either a 32 thousand or 16 million colour mode) the thumbnails will not
  638. appear if you are in a 256 (or less) colour mode. This would appear to be a
  639. problem with RISC OS 3.5 and may be resolved in future OS releases.
  640.  
  641. In the mean time if you are using a 256 (or less) colour mode you should not
  642. set the '32k colour' option. The best option is to set the 'Auto Display'
  643. option (which will pick the best option for the current mode), but if you
  644. subsequently change mode you may need to close the Thumbnail display windows
  645. and reopen them again in order to see the thumbnails.
  646.  
  647. Thumbnail uses the new display sprite for signifying that a directory is
  648. open. On pre Risc PC machines you can use this effect by defining a sprite
  649. called 'directory' and placing it in the WIMP sprite pool.
  650.  
  651.  
  652. Thumbnail with long filenames
  653. -----------------------------
  654.  
  655. Thumbnail now has limited support for files with longer filenames that are
  656. currently supported by ADFS (eg. users of !LongFiles). Internally Thumbnail
  657. does not support filenames longer than 10 characters (ie. thumbnail file
  658. names can not be longer than 10 characters) however the source files can now
  659. be longer than 10 characters (Thumbnail will truncate the file name when
  660. creating the thumbnail picture).
  661.  
  662.  
  663. General Notes & Tips
  664. --------------------
  665.  
  666. Note that when adding items to a directory they will initially be placed at
  667. the end of the directory viewer (at the bottom). However in future viewings
  668. the directory will be in alphabetical order.
  669.  
  670. When you delete an item from a directory its icons will be greyed out whilst
  671. that directory viewer is on screen.
  672.  
  673.  
  674. As to what size you should make thumbnail pictures, this is something that
  675. needs some consideration. The bigger the thumbnails the more detail of the
  676. original picture they can contain, but they also take more storage space, and
  677. more memory to store whilst being displayed.
  678.  
  679. To give an indication of likely storage costs, consider the following
  680. examples of two example files converted to thumbnails of differing sizes
  681. using 16bpp compressed storage :
  682.  
  683.  
  684.       Size set        Picture1        Picture2
  685.       
  686.       80 x 80         4179            2742
  687.       
  688.       64 x 64         3036            2009
  689.       
  690.       48 x 48         1814            1426
  691.       
  692.       32 x 32         1033             819
  693.       
  694.  
  695. The 'Size set' shows the size configured as the maximum size, and the file
  696. sizes are in bytes. Picture1 is a GIF file, Picture2 a draw file.
  697.  
  698. As can be seen a jump from 32x32 to 80x80 (a 6.25 times jump in area) results
  699. in just a 4 times jump for picture1 and a 3.33 jump for picture2.
  700.  
  701. For reference, the uncompressed size for an 80x80 Picture1 is 10662 bytes
  702. (for 16 bpp).
  703.  
  704. Because Thumbnail has its own directory structure for storing the thumbnail
  705. pictures, the directory structure does not need to map that of your storage
  706. of the actual pictures. Indeed thumbnails in the same Thumbnail directory
  707. viewer could relate to pictures on different discs.
  708.  
  709. JPEG loading is handled by software from the 'Independent JPEG Group's  JPEG
  710. software' which has been altered to provide support for Thumbnail's own use.
  711.  
  712.  
  713. Thumbnail Structure
  714. -------------------
  715.  
  716. The thumbnail directory structure is contained in a standard RISC OS
  717. directory structure within the application directory. The directory structure
  718. starts in a directory called 'Root'. This means that if you need to perform
  719. any operations on any of the stored thumbnails, etc (for example a file
  720. exists in a thumbnail directory that crashed the application) you can perform
  721. the operation using the standard RISC OS filer.
  722.  
  723.  
  724. Registration of Thumbnail & User Licence
  725. ----------------------------------------
  726.  
  727. Thumbnail version 1.40, © copyright Ian Palmer 1994, 1995, 1996.
  728.  
  729. ArtWorks Rendering Modules © Computer Concepts Ltd.
  730.  
  731. ProCAD/CADet Rendering Modules © Minerva Software Ltd.
  732.  
  733. The term 'program' refers to the executable and all associated data
  734. (excluding the ArtWorks Rendering Modules and ProCAD/CADet Rendering Modules).
  735.  
  736. The author reserves the right to take action against any person, or company,
  737. that acts in such a way as to break the terms specified in this user licence.
  738.  
  739. This program is supplied 'as is', without express or implied warranty.
  740. No representations are made about the suitability of this software for
  741. any purpose. The author can not accept liability for any loss or damage
  742. resulting from the use of this program.
  743.  
  744. All rights reserved.
  745.  
  746. NOTE: Registration of 'Image' (the Image progressing package by the same
  747. author) covers the registration of Thumbnail. Therefore if you register for
  748. Image there is no need to register for Thumbnail.
  749.  
  750.  
  751.                                  Distribution
  752.                                  ------------
  753.                                  
  754. This version of the program may be freely distributed, subject to the terms
  755. below. This permission to distribute only applies to the version stated
  756. above, and may be withdrawn at any time.
  757.  
  758. Terms of distribution :
  759.  
  760.   1. The program must be distributed intact, including this (and all other)
  761.      copyright message(s).
  762.      
  763.   2. The program can only be distributed in such a way that no commercial
  764.      gain, or advantage, is made thorough its distribution. Distribution
  765.      'costs' may be charged, insofar that these charges are reasonable.
  766.      
  767.   3. The program must NOT be supplied with, or part of, a commercial package
  768.      without the express permission of the author. 
  769.      
  770.   4. The program must NOT distributed with thumbnail pictures contained
  771.      within the application. Thumbnail pictures can only be distributed
  772.      within slave Thumbnail applications or 'Read-Only' versions (with
  773.      permission).
  774.      
  775.   5. The author reserves the right to refuse any individual, or company,
  776.      permission to distribute this program.
  777.      
  778.      
  779.  
  780.                                     Use
  781.                                     ---
  782.                                     
  783. Permission is hereby granted to allow any person, group, body, or company to
  784. use this program, subject to the following terms :
  785.  
  786.  
  787.   1. The program is supplied "as is", without express or implied warranty.
  788.      No representations are made about the suitability of this software for
  789.      any purpose.
  790.      
  791.   2. This version of the program is SHAREWARE, as such continued use
  792.      requires registration (see below).
  793.      
  794.   3. The author reserves the right to refuse any person, or company,
  795.      permission to use this program.
  796.      
  797.  
  798.      
  799.                              Acknowledgements
  800.                              ----------------
  801.  
  802. JPEG loading is handled by software from the 'Independent JPEG Group's  
  803. JPEG software' which has been altered to provide support for Thumbnail's
  804. own use.
  805.  
  806. TIFF Loading uses libtiff:
  807.  * Copyright (c) 1988, 1989, 1990, 1991 Sam Leffler
  808.  * Copyright (c) 1991 Silicon Graphics, Inc.
  809.  *
  810.  * Permission to use, copy, modify, distribute, and sell this software and 
  811.  * its documentation for any purpose is hereby granted without fee, provided
  812.  * that (i) the above copyright notices and this permission notice appear in
  813.  * all copies of the software and related documentation, and (ii) the names of
  814.  * Sam Leffler and Silicon Graphics may not be used in any advertising or
  815.  * publicity relating to the software without the specific, prior written
  816.  * permission of Sam Leffler and Silicon Graphics.
  817.  
  818.                  
  819.                         ArtWorks Rendering Modules
  820.                         --------------------------
  821.                         
  822. The ArtWorks rendering modules supplied with this program are copyright
  823. Computer Concepts Ltd. They must not be incorporated in any other programs
  824. without the permission of Computer Concepts Ltd.
  825.  
  826. The modules are distributed with Thumbnail with the kind permission of
  827. Computer Concepts Ltd.
  828.      
  829.  
  830.                       ProCAD/CADet Rendering Modules
  831.                       ------------------------------
  832.                         
  833. The ProCAD and CADet rendering modules supplied with this program are copyright
  834. Minerva Software Ltd. They must not be incorporated in any other programs
  835. without the permission of Minerva Software Ltd.
  836.  
  837. The modules are distributed with Thumbnail with the kind permission of
  838. Minerva Software Ltd.
  839.  
  840.  
  841.      
  842.                                 Registration
  843.                                 ------------
  844.                                  
  845.  
  846. This program is SHAREWARE. This means that you can try it out for a period of
  847. one month, after which you must register if you wish to continue using the
  848. program.
  849.  
  850. Registration not only entitles the user to permission to use the program
  851. after the one month period, it also entitles them to upgrades to later
  852. versions.
  853.  
  854. Registration costs just £5 (Free to all registered users of 'Image'). All
  855. registrations must be in pounds sterling (cash or cheque (made payable to
  856. 'I.J. Palmer') drawn on a U.K. bank - other forms of payment only by prior
  857. agreement).
  858.  
  859. To register simply send your payment to :
  860.  
  861.   Mr. I.J.Palmer,
  862.   40 Birch Crescent,
  863.   Aylesford,
  864.   Kent.  ME20 7QE.
  865.   England.
  866.   
  867.  
  868. enquiries can also be sent to the above address, 
  869. or via E-mail to : ian_palmer@ilink.demon.co.uk
  870.  
  871. Future versions can be obtained (by registered users) by sending a blank
  872. 3.5in disc (formatted) to the address above, with 50p return p&p (Stamps
  873. acceptable) (UK only, overseas the charge is £1).
  874.  
  875.  
  876.  
  877.                               Commercial Use
  878.                               --------------
  879.                               
  880. The above registration details ONLY apply for personal use of Thumbnail. If
  881. you wish to use Thumbnail for commercial use then you need to register for a
  882. separate user licence.
  883.  
  884. An example of when this separate licence needs to be applied for is if you
  885. distribute a collection of clipart (or pictures, etc) and wish to use
  886. Thumbnail for a catalogue of these pictures. It makes no difference whether
  887. the clipart (pictures, etc) are distributed for commercial gain or freely.
  888.  
  889. Public Domain libraries can apply for the separate licence (for catalogues,
  890. etc. - no need for licence for plain distribution of Thumbnail as supplied)
  891. at a special rate of just £10 so long as use is limited to the distribution
  892. of catalogues of freeware/PD clipart/pictures (ie. no commercial items).
  893.  
  894. The full price for commercial use is £20.
  895.  
  896. You MUST apply for the commercial use licence BEFORE you start using
  897. Thumbnail for commercial use. With the commercial use licence you will
  898. receive a special 'read only' version of Thumbnail which can be distributed
  899. with a catalogue contained within it. The 'read only' version has the
  900. advantage of being much smaller in size (approx. 80k).
  901.  
  902. To register simply send £20 (or £10 for PD libraries, as above) to the
  903. address above with a blank 3.5in disc (formatted) and an extra 50p (for
  904. return p&p), and you will receive the latest version AND the 'read only'
  905. version which can be distributed.
  906.  
  907.