home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 5 / RISCWORLD_VOL5.iso / SOFTWARE / Issue5 / PD / THUMBCAT / ReadMe < prev    next >
Encoding:
Text File  |  2004-11-02  |  21.1 KB  |  420 lines
  1.                                  Thumbcat
  2.                                  ========
  3.  
  4. Title       : Image Catalogue
  5.  
  6. Author      : Malcolm Ripley
  7.  
  8. Version     : 4,2b
  9.  
  10. Location    : http://web.ukonline.co.uk/mripley 
  11.               (software section)
  12.  
  13. Description 
  14. -----------
  15.  
  16. This program is catalogues images in two formats both on-screen in normal
  17. RISCOS windows and HTML format.
  18.  
  19. Basic features are :
  20.  
  21. * Handles - Sprites , Drawfiles , AVI's (from digital cameras) , JPEG's ,
  22.   EXIF's 
  23.   plus any file formats recognised by ImageFS
  24.   plus any file formats recognised by ChangeFSI
  25. * Will build a catalogue of a directory tree of images.
  26. * Files dragged to the iconbar icon will be interpreted and then displayed 
  27.   in a detail view.
  28. * Directories dragged to the iconbar will be searched and all recognised 
  29.   images displayed in a thumbnail view.
  30. * Creates JPEG thumbnails for fast re-creation of a thumbnail view.
  31. * Essentially adopted the EXIF tags list for its own image database details.
  32. * Almost all tag values can be edited.  Some tags don't make sense to edit 
  33.   e.g. x-y dimensions !!  Please note that when an EXIf file is handled the 
  34.   embedded tags are extracted into the Thumbcat database and can thus be 
  35.   edited. The tags within the file remain unchanged. 
  36. * Thumbnail views behave similar to filer windows in that :
  37.   - Images can be copied (by dragging) or moved (by shift dragging) between 
  38.     views.
  39.   - Images can be copied and modified by adjust dragging. In this case an 
  40.     options window will pop up allowing you to choose simple rotations and 
  41.     reflections and to change the filetype of the copy.
  42. * Catalogues can be stored with images or remote from the images in a 
  43.   "pseudo" application.  The pseudo application can be relocated without loss
  44.   of functionality. Thus catalogues can be created of readonly sources.
  45. * HTML catalogues can be created. These will have relative links for 
  46.   catalogues with the images and absolute references for catalogues remote 
  47.   from the images.
  48. * Configurable thumbnail and detail views.
  49. * Thumbnails are self repairing once created.
  50. * Will print out multiple images per page in original aspect ratio and
  51.   standard photo sizes
  52. * Index/contact sheet printouts.
  53.  
  54. Subtle points
  55. -------------
  56.  
  57. The combination of dragging to the iconbar and adjust dragging to a filer 
  58. window allows thumbcat to translate a drawfile to a jpeg, for example. 
  59.  
  60. Problem Reporting
  61. =================
  62.  
  63. Please report any problems to myself, my details are at the bottom of this
  64. file.  I will also welcome any constructive recommendations but please
  65. refer to the future enhancements section first.
  66.  
  67. When reporting a bug please email the full error message. It would also
  68. be useful to reproduce the error whilst in debug mode and email me the
  69. logfile.  This can be done as follows:
  70. 1. From the iconbar menu display the info window and click 4 times on the 
  71.    application name.
  72. 2. Re-create the error.
  73. 3. Double click on the file "Findlogfile" which will open up the scrap
  74.    directory containg the log file.
  75. 4. Email me the logfile, the error message and description of what you
  76.    were doing.
  77.  
  78. Pre-Requisites
  79. ==============
  80.  
  81. SpriteExtend module with JPEG extension (released with RiscOS 3.6 onwards)
  82. CompressJpeg module (released with RiscOS 3.6 onwards)
  83. Toolbox Modules
  84.  
  85. If you have ImageFS running then ensure the following is set :
  86. * Filetypes - JPEG conversion inactive and all others set to auto.
  87. * Conversion - new sprite format, square pixel aspect,filename from parent, 90dpi resolution.
  88. * General - time before progress window set to 1000 csecs.
  89.  
  90. Future enhancememts
  91. ===================
  92.  
  93. These are being worked on now:
  94.  
  95. * Database queries. The result will be a view of images identical in 
  96.   appearance to a thumbnail view.  These types of views will refresh every 
  97.   time they are displayed i.e. the search criteria re-run. A database query 
  98.   result view can be saved/copied as a user view. 
  99. * Parent-child relationships to allow tracing of copied files
  100.  
  101. Maybe not the next release:
  102.  
  103. * Allow transformation of draw files.......as of aug 2004 probably not due
  104.   to the large amount of coding required which is distracting from the
  105.   intended scope of Thumbcat.
  106. * Validation of edited tag values.
  107. * Select imagefilerenderer to be used as a file converter
  108.  
  109. Known faults:
  110.  
  111. * Occasionally a "Font not Found" error pops up but I have not been able
  112.   to determine why...yet.
  113.  
  114. Licence and terms of use
  115. ========================  
  116. This program is copyright © Malcolm Ripley 2003. It has been released as
  117. FREEWARE. This means you can copy, distribute and make use of it as you see
  118. fit, provided you do not sell it. PD libraries may include it as long as they
  119. do not charge more for disks than is needed to cover costs.
  120.  
  121. I can accept no liability for data loss or other damages arising from the use
  122. of this product.
  123.  
  124. As of version 3.6a the IJG module jpegtran is included in the resource folder
  125. for use in lossless jpeg to jpeg translations.
  126.  
  127. Version History
  128. ===============
  129. v4.2b  - maker note handling for Fuji changed so that the default is the
  130.          most common, little endian, whereas the others are big endian.
  131.          Nice cock up Fuji !
  132.        - Exif decoding more robust in case of a maker note problem.
  133.        - The "show all tags" menu item now correctly shows the ticked or
  134.          unticked state.
  135.        - The "Modify Image" album menu option is now faded if the image is
  136.          read-only.
  137.        - Catalogues burnt onto a CD have their read/write flag ignored
  138.          (i.e. read-only)
  139.        - The vertical scroll bar restored on the create catalogue window.
  140.        - Catalogue repair option now possible from iconbar menu as well
  141.          as the original method.
  142.        - Repairing a catalogue with the assess missing tags option now
  143.          presereves existing data (! whoops)
  144. v4.2a  - Mistake with one of the set statements prevented the help from
  145.          being viewed.....depending on how and when wrt running thumbcat !
  146.        - images in the help have been shrunk considerable.
  147. v4,1   - Ability to convert an EXIF to "normal" JPEG and preserve the data
  148.          has been restored after accidentally preventing it in V3.6b.
  149.        - Contact sheet type printout of an album now possible.
  150.        - The catalogue creation and maintenance window has been improved.
  151.        - The ability to catalogue only the top level directory has been
  152.          restored.
  153.        - Improved progress window.
  154.        - Catalogues on "unavailable" volumes no longer causes a crash.
  155.        - Copying an image over itself (and deleting it !) is now trapped.
  156.        - Copying from the detail view has a had a few anomalies fixed.
  157.        - HTML manual now included. A crude first pass which will improve.
  158. v3.10a - Drawfile changed from v1.48 to 1.43 and not 1.38 to 1.35 ! 
  159.          whew : alcohol + sex + programming on the same day = dead brain cells.
  160.        - Added check in case printer driver not loaded.
  161.        - Added check in case drawfile destination not specified.
  162.        - Modified tag translation for an unsigned real number of zero so that
  163.          it does not generate an error (i.e. 0/0 !) - Nikon Coolpix 950 exif
  164.        - Also modified the signed real number tag for the same potential
  165.          problem.
  166.        - Country detection for Castle help was inserted at the wrong location
  167.          in the !Boot file causing problems with variable Thumbcat$Dir. Now
  168.          at the correct location.
  169.        - Added PNG filetype to the list of those handled by ChangeFSI hence
  170.          Thumbcat can now handle PNG's
  171. v3.9   - Very Long filenames now accepted when rotating an image inside Thumbcat
  172.        - Images can now be primted with options to allow standard size and/or
  173.          multiple images per page.
  174.        - Added a trap to identify the occasional error when closing Thumbcat
  175.          which tries to close a file called "FONT". Also added a trap to try
  176.          and identify when this "file" is supposedly opened ?!?
  177.        - Changed the Drawfile module check from v1.38 to v1.35
  178. v3.8c  - Fixed a problem if an EXIF is from an unknown camera maker e.g. a
  179.          CD from a photo shop.
  180.        - Improved interpretation of EXIF date tags.
  181.        - Help added to the iconbar menu
  182.        - Castles recommended help extension implemented although I have put the
  183.          help files inside a territory specific directory.
  184. v3.8b  - Added a limit in the EXIF tag procedure to ensure that problems and/or
  185.          too many tags no longer cause the program to crash
  186.        - Dragging to an application changed slightly so that by default no
  187.          external link is created. Pressing Alt-drag creates a link.
  188.        - External loads fixed so that dragging and dropping to positional
  189.          dependant applications like Ovation now works.
  190. v3.8a  - Changed the compressjpeg module version check from 0.06 to
  191.          0.05 for Iyonix users.
  192. V3.7   - No longer duplicates album displays at all times. Previously it
  193.          only prevented duplicates if the title matched the directory.
  194.        - Now loads an EXIF into an external application after pressing OK
  195.          on the warning message (! tch tch)
  196.        - Fix to the import of a large quantity of images most definitely 
  197.          fixed!
  198.        - Fixed the unnecessary re-creation of thumbnails for the second
  199.          and later images loaded into an extrnal application.
  200.        - Modules check in the !Run file has version numbers.
  201. v3.6b  - Preserves EXIF data for simple manipulation (by user demand !)
  202.        - uses jpegtran for all lossless jpeg to jpeg translations
  203.        - Menu behaviour over an album changed slightly so that if ONE image
  204.          is already selected and the menu button pressed whilst over a
  205.          different image then the selection switches.
  206.        - layout of all toolbox objects modified to allow system font to be
  207.          displayed without clipping.
  208.        - Copying an image when the detail thumbnail is missing no longer
  209.          generates an error.
  210.        - Importing a large quantity of images (>80) no longer generates an
  211.          error.
  212.        - Page numbers on empty albums now show 1 of 2 and 2 of 2 instead of
  213.          1 of 0 and 2 of 0
  214.        - The pointer for a catalogue has been tidied up so that it does not
  215.          change whilst over the total line.
  216. V3.6a  - Allows simple manipulation of bitmap style image within thumbcat 
  217.          i.e. rotate +90,-90,180 and mirror x or y
  218. V3.5   - Warning issued if an EXIF file is exported to an application since
  219.          it may result in the loss of data if the file is resaved as a JPEG
  220.        - Adding a child album on pages 3 onwards for a book style now works
  221.          correctly.
  222.        - HTML export fixed for case sensitive OS's.
  223.        - Pointer shape changes when over the catalogue tree view with red
  224.          borders for empty albums and green ones for non empty albums.
  225.        
  226. V3.4d  - Selected images now delete. Previously only the menu context but
  227.          unselected images could be deleted.
  228.        - Pressing menu over an album image now shows the image as being
  229.          selected.
  230.        - Loading an image into an application no longer results in an
  231.          initial (redundant) re-creation of thumbnails.
  232.        - The interval between externally loaded images being checked for
  233.          a change now correctly becomes progressively less frequent and
  234.          thus not consume resources for an image no longer being edited.
  235.  
  236. V3.4c  - Selection of images changed from inverted picture to a blue image
  237.          name. This now works for 32K and 16M colour screen modes.
  238.        - Images loaded in immediate mode using ChangeFSI previously reported 
  239.          an insufficient memory error.
  240.        
  241. V3.4b  - Catalogue order can now be modified at any time.
  242.        - Improved cell background compatibility for HTML exports
  243.        - Fixed problem with ".ile" handler not found for HTML export
  244.        - Eliminated spurious characters after a directory with no images, for 
  245.          the HTML export.
  246.        - Default HTML export is for a normal relative reference for 
  247.          compatibility with any platform.
  248.        - Select all works again !!!! (who'd be a programmer for a living I ask
  249.          you...hang on I am....now where's that lottery ticket)
  250.        
  251. V3.4a  - Dropping all catalogues now correctly list no catalogues !! and fades
  252.          the parent menu items.
  253.        - HTML export now uses canonicalise filenames for absolute references.
  254.        - HTML export options now allow export of originals and/or thumbnails.
  255.        - HTML export has the correct background colour of light grey.
  256.        - Clicking on the blank area of a book style where the last page has
  257.          empty slots, no longers crashes.
  258.  
  259. V3.3   - HTML export now possible and the look and feel reflects the users
  260.          choices but only for a filer style.
  261.        - Album within albums can now be created for unlinked/arbitrary lists of
  262.          images. This previously gave a misleading error of "duplicate album".
  263.        - Arbitrary lists now use canonicalised filenames, the only sensible 
  264.          option !
  265.        - Multiple image selection fixed to be identical to the way the filer
  266.          selects and deselects.
  267.        - Selection of images on pages 3 onwards fixed (the multiple selection
  268.          code buggered this up!)
  269.        - Clicking with adjust on the flip page icons in the book view behaves 
  270.          opposite to clicking with select
  271.  
  272. V3.2d  - Tag list of a an image from a view now displays
  273.        - Skins improved
  274.        - Multiple images in an album can now be copied/moved with a single drag
  275.        - Albums with the same name in the same catalogue can both be opened.
  276.  
  277. V3.2c  - Detail view now displays date and/or title according to user choice
  278.          instead of being the same as the album view...oops
  279.        - Images can be moved between albums again (bug introduced in colour
  280.          handling change in v3.1)
  281.        - Images at the top of the filer e.g adfs::$.image/jpg will now load.
  282.  
  283. V3.2b  - Fixes a failure to display an album if the dynamic area address is 
  284.          > 2Gb
  285.        - Fixes a nonsensical error of IM-1 due to a missing THEN clause, this
  286.          error occurs on RO5 Basic.
  287.        - Fixes an occasional  problem with relative addressing between images 
  288.          and the pseudo application.
  289.  
  290. V3.1   - Essentially a bug fixed version of 3.0 beta.
  291.        - ImageFS tested.
  292.        - Added the ability to convert an image to 256,32K and 16M colour sprites
  293.        - Closing of an album is much much faster
  294.        - All unhandled messages and toolbox events "switched off" thus freeing
  295.          a few CPU cycles.
  296.        - Allowable filetype conversion process fixed in the copy-modify window.
  297.  
  298. V3.0   - Faster.
  299.        - Maker note handling added for:
  300.          Olympus, Nikon, Fuji, Casio, Canon
  301.        - Database modified to store ALL non null tags. Databases from older 
  302.          versions of thumbcat will be automatically extended if any items are
  303.          edited.
  304.        - User selection of tags now defines those that are displayed in the 
  305.          various presentation screens.
  306.        - Book style presentation, with various user definable "styles".
  307.        - Each window opens at a slightly different location
  308.        - External files (dragged to Thumbcat for immediate viewing) now show 
  309.          only the user selected tags.
  310.        - A new variation of an album is now allowed, making 3 in total :
  311.          1. A linked album where the album contents matches an underlying RISCOS
  312.             directory.
  313.          2. A view where the images are a list from any album of any catalogue.
  314.          3. (new) An unlinked album where the images are from anywhere.  In this
  315.             case the images can be added and deleted without affecting the
  316.             original images. However the data for an image is held in a thumbcat          
  317.             database and can be edited.
  318.        - Original RISCOS directories or albums can be opened for any image from
  319.          the album menu.
  320.        - Data can be copied between data tag windows. Either one item or all
  321.          items.
  322.        - The detail window and tag data window have been split.  This is easier
  323.          to manage and looks neater with less blank space.
  324.        - The detail view is automatically a paused slideshow.
  325.        - Slideshow of catalogues, albums and views.  These will multitask.
  326.        - External linking for images being edited.
  327.        - The handling of DOS style extensions has been removed from the
  328.          thumbnails since the way the HTML catalogue works is being changed.
  329.        - I have now included two copies of thumbcat. One with the original
  330.          source code and a much smaller one without.
  331.  
  332. V2.4   - Fix to scrap directory reference method (I was on the wrong planet !)
  333.        - Fix to choices directory reference
  334.        - Fix to a bug in building a "remote" catalogue.
  335.        - Fix to the reading of the options file....kind of. This was due to an
  336.          omission from the exceptions files used when crunching the source 
  337.          Basic file.
  338.        - Greatly improved debug mode with far more detail (for me !)
  339.        - Fix to the album view of a "remote" catalogue when the remote volume
  340.          is not present.
  341.        - Missing volumes are now prompted for, whenever copying images, whereas
  342.          previously thumbcat reported a "problem when copying".
  343.        - Known remote catalogues are booted to ensure the album opens
  344.        - Fix to Iconspace which used to extend even if there was space.
  345.  
  346. v2.3   - maintains a list of all known catalogues
  347.        - Fix to transparent option which would be ignored if switched off 
  348.          unless you selected a colour. It now defaults to white.
  349.        - When creating a new album the "title" is now clear.
  350.        - Dragging external files into the album no longer reports the 
  351.          destination as being "read only" and stops the copy (whoops !!!!)
  352.        - When the list display had portrait and landscape images the display 
  353.          became corrupt when images were added to or moved from the list. Now 
  354.          fixed.
  355.        - Complete "internal" rewrite of thread data which improves response,
  356.          easier to maintain, more efficient memory usage etc etc
  357.        - Users choices all moved to Boot:Choices so they are preserved from
  358.          release to release.
  359.        - Tree-album list now orders correctly even if the user has edited
  360.          the contents by hand.
  361.        - Additional option of ordering calendar named directories before or 
  362.          after non calendar named directories e.g. jan-fab-andrew or 
  363.          andrew-jan-feb
  364.        - Tree menu now shows the "selected" album in the menu title.
  365.        - Album menu now shows the "selected" image in the menu title.
  366.        - User Views. A user view is a list of images from any album of any 
  367.          catalogue.
  368.        - multiple displays of the same catalogue, album and/or detail view no
  369.          longer occurs.  The existing version pops up to the top.
  370.        - Dragging of an image from a riscos directory that has already been 
  371.          catalogued
  372.          will reference the existing catalogue file and thumbnails i.e. much 
  373.          faster.
  374.        - It is now possible to set the Alias variable to have thumbcat load an
  375.          image into a detail view.
  376.          NB the previous two fixes in conjuction with select 3 would allow you
  377.          to use select 3 filer window as an album view and double click an 
  378.          image to get the thumbcat detail view with all the database details. 
  379.          You can drag from the detail view to an application for editing. 
  380.          NB in theory since I do not have select 3 but it works with RO4.
  381.        - Tag values can be edited directly in the detail window.
  382.        - directory list view(s) update when an image is moved or copied
  383.        - the moving or copying of duplicate images is now trapped.
  384.        - fix to title text in album view 
  385.  
  386. V2.2   - Titles with commas no longer cause problems with the list view.
  387.        - "slide" backgrounds on the thumbnail view can now be transparent.
  388.  
  389. V2.1   - Ensured the pseudo applications that contain catalogues start thumbcat
  390.        - When a directory was dragged to the iconbar and images were double 
  391.          clicked the second,third etc image created an error. Now fixed.
  392.        - Multiple "external" files and folders did not free all internal 
  393.          threads, now fixed.
  394.        - FixtoolsC which attempts to resolve problems with incorrect versions 
  395.          of toolbox modules in some !System folders has been reported to crash
  396.          on some machines. This has not been reproducable on my machine and so
  397.          an error trap has been built in to FixtoolsC so that any problems do
  398.          prevent thumbat from loading.  A full fix will be pursued.
  399.        - Fix to ensure some poor exifs don't crash THumbcat.
  400.  
  401. V2.0   - Handles sprites, drawfiles, jpegs and EXif's with no additional 
  402.          applications.  Handles all vector and bitmap images recognised by 
  403.          ImageFS and ChangeFSI, if present/running.
  404.        - Editable tag details.
  405.        - Filer-like image copying and moving facilities.
  406.        
  407. V1.0   - Never released due to a website problem. It only handled sprites, 
  408.          jpegs and AVI's without thumbnails. Only created an HTML
  409.          catalogue format.
  410.  
  411. Author Details
  412. ==============
  413. Name    : Malcolm Andrew Ripley
  414. Address : 7 MacNeill Gardens, East Kilbride, Glasgow , G74 4TS
  415. Email   : mripley@ukonline.co.uk (if emailing for the first time please
  416.           include my new sender keyword > terrier < in the subject line).
  417. Website : http://web.ukonline.co.uk/mripley
  418.  
  419.  
  420.