WhereIsIt? version 2013
Copyright (c) 1997-2013 Robert Galle
All Rights Reserved


GRAPHICS DESCRIPTION PLUGINS
============================
Graphics description is a supplemental plugins module for importing details
about most often used graphic file formats in use today. All plugins provide
details such as width, height, and color depth of the picture, and most
of them (GIF, JPG, TIFF, PSD, and PNG) can extract more detailed information
if available, as well.

Graphics formats supported for description importing:

Windows or OS/2 Bitmap Files (*.BMP)
CompuServe Bitmap Files (*.GIF)
JPEG Bitmap Files (*.JPG, *.JPEG, *.JFIF)
ZSoft Paintbrush Files (*.PCX)
TIFF Bitmap Files (*.TIF, *.TIFF)
PNG Bitmap Files (*.PNG)
Adobe Photoshop Files (*.PSD)
Targa Bitmap Files (*.TGA,*.VST)
Nikon Digital Camera Raw Files (*.NEF)
Canon Digital Camera Raw Files (*.CRW)
Zeiss LSM 5 Files (*.LSM)
Icon Files (*.ICO)

Digital Camera Support
----------------------
JPEG, TIFF, and CRW plugins include additional support to extract exposure 
information commonly embedded in images transferred from digital cameras. 
Please note however that not all cameras use the same format for storing
these details, and they are generally lost if image is edited. First two
plugins include support for the ISO-standardized EXIF format that is 
supported by most newer digital cameras today and by few different 
manufacturers, and are capable of exporting details such as camera model, 
shutter and aperture values, flash usage, focal length used etc. The CRW
plugin supports Canon's raw files, and its propriety CIFF description
format found in such files.


THUMBNAILS PLUGINS
==================
Thumbnail plugins can import smaller version of images to be stored in
catalog as a reference.

Graphics formats supported for thumbnails importing:

Bitmap Image Thumbnails (*.BMP, *.RLE, *.DIB)
CompuServe Image Thumbnails (*.GIF)
JPEG Image Thumbnails (*.JPG, *.JPEG, *.JFIF)
PNG Image Thumbnails (*.PNG)
ZSoft Paintbrush Image Thumbnails (*.PCX, *.PCC, *.SCR)
Kodak Photo-CD Image Thumbnails (*.PCD)
TIFF Image Thumbnails (*.TIF, *.TIFF, *.FAX)
Photoshop Image Thumbnails (*.PSD, *.PDD)
Targa Bitmap Thumbnails (*.TGA, *.ICB, *.VDA, *.VST)
SGI Image Thumbnails (*.SGI, *.BW, *.RGB *.RGBA)
Portable Pixel/Gray Map Image Thumbnails (*.PPM, *.PGM, *.PBM)
Autodesk Image Thumbnails (*.CEL, *.PIC)
Windows Metafile Thumbnails (*.WMF, *.EMF)
Icon Images (*.ICO)
Cursor Images (*.CUR, *.ANI)
Encapsulated PostScript Files (*.EPS)
Application Icons (*.EXE)
Disk Custom Icons (*.*)
MP3 Attached Picture Thumbnails (*.MP3) 
Adobe Illustrator Thumbnails (*.AI)
Canon EOS Digital Camera Raw Files (*.CRW)
Nikon Digital Camera Thumbnails (*.NEF)
Zeiss LSM 5 Thumbnails (*.LSM)
Maya IFF Thumbnails (*.IFF)
Folder Thumbnails (FOLDER.JPG, COVER*.JPG, COVER*.GIF, *FRONT*.JPG)
Office XML Document Thumbnails (*.DOCX,*.DOCM,*.DOTX,*.DOTM,*.XLSX,*.PPTX,
  *.ODT,*.ODS,*.ODP,*.ODG,*.ODB,*.ODF,*.SXW,*.SXC,*.SXD,*.SXI,*.SXM,*.SXG)
Gadgets and Widgets Thumbnails (*.GADGET, *.WIDGET, *.WDGT, *.WGT, *.AIR)
Windows Shell Thumbnails (*.*)
EPUB E-Books Cover Thumbnails (*.EPUB)

RUNTIME PLUGINS
===============
Runtime plugins are different from the others as they are not automatic and 
are not run at scanning time, but rathar later on user's request from a menu
option. Such plugins are interactive and typically require user's input.

"Internet Movie Database (IMDB)" plugin
  Imports detailed movie details from IMDB online archive, including cast,
  rating, plot outlines, user's comment, etc. If available, movie's cover
  image is also imported as thumbnail. Plugin is available for running on 
  video files, folders, and disks.

"TV Series Database (TheTVDB)" plugin
  Imports detailed TV series and episodes information from TheTVDB.com online
  database. Information includes series and episodes overviews, cast, rating,
  network and airing information, posters and screenshots as thumbnails etc.
  Plugin is available for running on video files, folders, and disks.

"Import any picture as thumbnail" plugin
  A simple plugin that allow you to pick any cataloged file and folder, and
  use this plugin to assign it any supported image file as a thumbnail.
  Thumbnail preview and color adjustments are also available.
  
"Assign video frame as thumbnail" plugin
  A built-in video player with ability to capture any frame, and use it as a
  thumbnail in WhereIsIt.
    

LIMITATIONS
===========
Enhanced PostScript Files (*. EPS) and Adobe Illustrator Thumbnails (*.AI) 
plugins only handle files with available bitmap preview. Not all files of
those types may have a preview embedded. Adobe Illustrator files before
version 7 do not support thumbnails and will not be handled by this plugin.

"Assign video frame as thumbnail" plugin requires DirectX 8.1 or newer in 
order to be able to capture frames. It should go without saying that support
for different kind of files and formats highly depends on installed codecs
on the system. Additionally, some video codecs are not supported for capture,
mostly due to unsupported color space. Some codecs can be set to render video 
in RGB color space instead of YUV, and turning off rendering to overlay may 
help getting capture function available.


INSTALLING THE PLUGINS
======================
Just as any other plugin, DescGraphics.dll is expected be located in 
subfolder "Plugins" in WhereIsIt's main folder; for example, 
"C:\Program Files\WhereIsIt\Plugins". No other installation is necessary, 
the program will automatically detect and include plugins. You can enable, 
disable, or setup individual plugins in program's settings.

------------------------------------------------------------------------------

4.00 (6. February 2003)
-----------------------
+ Added Internet Movie Database (IMDB) runtime plugin.

4.01 (9. February 2003)
-----------------------
+ IMDB plugin: Added support for OFDb (DE) site, ability to directly enter
  movie's URL if known in advance, improved filtering of HTML tags from 
  imported descriptions.
 
4.02 (17. February 2003)
------------------------
+ IMDB plugin: Improved handling of international and special characters in 
  text imported from HTML data.
  
4.10 (19. April 2003)
---------------------
+ Added new runtime plugin: Assign any picture as thumbnail.

4.20 (14. May 2003)
-------------------
+ Added new video player runtime plugin (v0.10), with ability to assign
  any chosen video frame as a thumbnail for video file.

4.21 (26. May 2003)
-------------------
+ JPEG thumbnail plugin: Added support for CMYK JPEG files.

4.30 (9. June 2003)
-------------------
+ Improved EXIF and IPTC support with additional details and customizable 
  descriptions, adjusted OFDb support in the Internet Movie Database plugin 
  due to web site changes.

4.32 (2. September 2003)
------------------------
* Improved EXIF support, fixed resource leak in the Cursor Images plugin.

4.34 (2. September 2003)
------------------------
* Adjustments to the IMDB plugin to address recent URL format changes at IMDB
web site.

4.35 (16. December 2003)
------------------------
+ Added the Nixon NEF Raw Files thumbnails plugin.

4.36 (31. December 2003)
------------------------
+ IMDB plugin: Optimized for less user interaction.

4.37 (8. January 2004)
----------------------
* IMDB plugin: Adjusted for changed web pages on the IMDB web site.

4.38 (27. January 2004)
-----------------------
+ New description plugin extracting digital camera information in CIFF format 
from Canon raw files (CRW).

4.39 (1. February 2004)
-----------------------
* Fine tuned search results parsing for the IMDB plugin.

4.40 (16. February 2004)
------------------------
+ Added support for additional video file formats in IMDB and Video Player
  plugins.

4.41 (15. March 2004)
---------------------
* IMDB plugin: Changed URL encoding to be compatible with RFC 1738. This 
  allows using some more unusual characters in movie title queries.
+ IMDB plugin: Added support for importing movie thumbnails in GIF and PNG 
  formats. 99% of IMDB site has thumbnails in JPG format, however there are
  some movie entries with GIF thumbnails as well.

4.42 (13. April 2004)
---------------------
* IMDB plugin: added detection for server-side redirected URLs, in case of 
  IMDB site movies where search result didn't return the list of matches, 
  but the movie page directly. Such movies didn't offer most of the plot 
  outlines that were otherwise available.

4.43 (12. June 2004)
--------------------
* IMDB plugin: IMDB.com web site has had some changes in HTML format once 
  again, resulting in missing thumbnails and movie URLs. Plugin is updated.
  
4.44 (18. June 2004)
--------------------
+ Added Zeiss LSM 5 Thumbnails plugin.

4.45 (19. June 2004)
--------------------
+ Improved detection of 10-bit and 12-bit grayscale TIFF files packed as
  16-bit TIFF files.
  
4.46 (2. July 2004)
-------------------
+ Improved Zeiss LSM 5 Thumbnails plugin.

4.47 (27. July 2004)
--------------------
+ Added Zeiss LSM 5 description plugin.

4.48 (13. August 2004)
----------------------
+ Updated JPEG image library, added support for JPEG CYYK images.

4.49 (20. August 2004)
----------------------
* IMDB plugin: Adjusted for changed web pages on the IMDB web site.

4.50 (7. November 2004)
-----------------------
+ Added a new option to JPEG and TIFF thumbnail plugins, allowing
  pictures to be rotated according to the EXIF tag, if available
+ Updated JPEG code, tweaked support for CYYK, CMYK JPEG files, and
  certain types of TIFF files (plane-separated).
+ Updated the "Assign Picture as Thumbnail" runtime plugin.
+ Updated IMDB plugin for latest changes on the OFDB.de web site.

4.51 (13. November 2004)
------------------------
* IMDB plugin: Adjusted for changed web pages on the IMDB web site.

4.52 (19. December 2004)
------------------------
+ Fine tuned EXIF orientation tag support in TIFF and JPEG files, added 
  photo orientation information to EXIF description text.
+ Enabled IPTC support for TIFF files.
* Fixed handling 16-bit grayscale TIFF images.  

4.53 (26. December 2004)
------------------------
* IMDB plugin: Adjusted for changed web pages on the IMDB web site.

4.54 (29. December 2004)
------------------------
* IMDB plugin: Cleaned up imported IMDB URL addresses.

4.60 (16. July 2005)
--------------------
* IMDB plugin: Adjusted for changed web pages on the IMDB web site.

4.61 (20. August 2005)
----------------------
* Minor adjustments to the Nikon NEF description plugin.

4.62 (22. August 2005)
----------------------
* IMDB plugin: Adjusted for changed search page on the IMDB web site.

4.63 (6. November 2005)
-----------------------
+ Updated support for .CR2 files in the Canon Digital Camera Raw Files 
  plugin
+ fine tuning of some other plugins.

4.70 (21. November 2005)
------------------------
+ Rewritten EXIF and IPTC support, allows for extracting of any available 
  EXIF or IPTC tag through tag numbers.
+ Improved data formatting for many EXIF tags.
+ Added support for EXIF makernote tags for several digital camera 
  manufacturers.
  
4.74 (4. March 2006)
--------------------  
+ Added new "Maya IFF Thumbnails" plugin, 
* Fixed processing of certain JPEG files for EXIF extraction, some JPEG files
  saved in a bit different file format failed to extract EXIF record.
* Adjusted processing and error handling for 16bps RLE compressed SGI files.  

4.76 (10. April 2006)
---------------------  
* Adjusted EXIF rotation handling.

4.77 (29. July 2006)
4.78 (27. August 2006)
----------------------  
* IMDB plugin: Adjusted for changed web pages on the IMDB web site.

4.80 (10. October 2006)
-----------------------  
+ Rewritten video player plugin with better support for capturing video frames 
  as thumbnails.

4.81 (29. November 2006)
------------------------
+ New PNG engine, with full transparency and interleaving support
+ Tweaked JPEG decoder settings for better quality
  
4.82 (19. February 2007)
------------------------
* Addressed several small memory leaks. 
* Fixed low quality of thumbnails imported from 8-bit colored PNG files.
* IMDB plugin: Adjusted for new design of IMDB web site.

4.85 (28. June 2007)
--------------------
* IMDB plugin: Adjusted for changed search results formatting on IMDB web site.

4.87 (9. October 2007)
----------------------
* All plugins support Unicode file names and Unicode descriptions

4.88 (5. December 2007)
-----------------------
* IMDB plugin: Adjusted for changed search results formatting on IMDB web site.

4.90 (28. January 2008)
-----------------------
* Improved resiliance to invalid or damaged files.

4.91 (19. February 2008)
------------------------
* Improved .ICO files thumbnails plugin, new .ICO description plugin.

4.92 (21. February 2008)
------------------------
* Adjusted IMDB plugin for changed web site layout on the OFDb web site.

4.93 (24. March 2008)
---------------------
* Adjusted IMDB plugin for changed web site layout on the OFDb web site.

4.94 (5. April 2008)
--------------------
+ Added new "Office XML Document Thumbnails" plugin, extracting available 
  thumbnails from MS Office OpenXML and OpenOffice.org documents.
  
4.95 (9. May 2008)
------------------  
* IMDB plugin: Adjusted for changes on IMDB web site.

4.96 (18. May 2008)
-------------------  
* Fixed custom formatted descriptions for several different description 
  plugins.

4.97 (30. May 2008)
-------------------  
+ Improved XML parser
+ Added "XML Paper Specification Documents" description plugin, extracting 
  documentproperties form *.XPS files.
* Added new "Gadgets and Widgets" description plugin, extracting file 
  description from several different gadgets and widget files, including 
  Vista Sidebar gadgets, Yahoo widgets, Adobe AIR widgets,...
* Adjusted handling OfDb user comments in the IMDB plugin

4.98 (13. June 2008)
--------------------  
+ Added support for storing plugin's settings in configuration file instead 
  of system registry.

5.00 (2. October 2008)
----------------------  
* Fixed a problem with incorrect custom formatted descriptions.

5.01 (17. November 2008)
------------------------  
+ IMDB plugin: Updated user interface, removed progress window flickering, 
    new file name filtering, improved quality of imported thumbnails.
    
5.02 (1. December 2008)
-----------------------  
+ IMDB plugin: Updated for handling multiple items at once.
+ Import any picture as thumbnail plugin: Updated for handling multiple 
  items at once.
  
5.03 (13. December 2008)
-----------------------  
+ IMDB plugin: Updated for modified search results page on the IMDB site.

5.10 (13. January 2009)
-----------------------
+ IMDB plugin: Added ability to run other description plugins.

5.20 (4. June 2009)
-----------------------
Added new runtime plugin: TV Series Database (TheTVDB)

5.30 (10. July 2009)
--------------------
Added XMP metadata support in several different description plugins.

5.31 (24. July 2009)
--------------------
TV Series Database (TheTVDB) plugin updated to version 1.10, improvements to
series title/episode detection, additional options for improved batch 
processing with less user input.

5.33 (20. August 2009)
----------------------
IMDB plugin, TheTVDB plugin: added options to import formatted movie/series/
episode titles as alias names, several other minor changes and fixes.

5.36 (9. November 2009)
-----------------------
IMDB plugin, TheTVDB plugin: better file name filtering and title/episode 
detection, Improved Unicode support, improved OFDB support.
  
5.37 (23. November 2009)
------------------------
IMDB plugin: Updated for changes on IMDB site's search results page.

5.38 (6. January 2010)
----------------------
IMDB plugin: Updated for additional filtering of unnecessary HTML tags.

5.40 (14. January 2010)
-----------------------
IMDB plugin: Added support for importing information from international 
IMDB sites in different languages (German, Spanish, French, Italian, 
Portuguese)
  
5.41 (18. February 2010)
------------------------  
Added new thumbnails plugin, Windows Shell Thumbnails.

5.43 (19. March 2010)
---------------------  
IMDB plugin: Updated for changes on IMDB site, fixed large thumbnails 
importing. Optimized the Windows Shell Thumbnails performance.
  
5.44 (26. May 2010)
-------------------  
TV Series Database (TheTVDB) plugin updated to support special episodes.

5.50 (23. July 2010)
--------------------
Rewritten Video Player for capturing video frames as thumbnails to version 
2.0, now running on Windows Vista and Windows 7 as well.

5.51 (9. September 2010)
------------------------
Updated TheTVDB plugin; added a workaround for an apparent bug in the XML
data structure returned by TheTVDB.com, preventing retreival of details 
about individual episodes.

5.52 (21. September 2010)
-------------------------  
IMDB plugin: Updated for large scale changes on the IMDB web site, featuring 
a completely new web site design. Note that the new design is not yet by 
default accessible to all users, and plugin currently supports both old and
new IMDB design. Languages other than English are not tested at this time 
since the new design is not yet available for other languages. Beta version.

5.56 (4. April 2011)
--------------------
Updated IMDB and TheTVDB plugins for handling additional details, improved
error resistance in several other plugins.

5.57 (21. June 2011)
--------------------
Updated IMDB plugin to support new techniques recently used on the IMDB
web site, for example AJAX loading of details like user comments.

5.58 (4. August 2011)
--------------------
Updated IMDB plugin for changes on the IMDB web site.

5.62 (13. January 2012)
-----------------------
Updated IMDB plugin for changes on the IMDB web site.

5.65 (24. May 2012)
-------------------
Integrated CorelDRAW Thumbnails plugin and added support for CorelDRAW X4 and 
newer .CDR files.

5.70 (3. September 2012)
------------------------
Added EPUB E-Books Cover Thumbnails plugin.

5.71-5.75 (27. July 2013)
-------------------------
Updated IMDB plugin for a new search page on the IMDB web site

----------------------------------------------------------------------------
The DescAPI and DescGraphics.dll module are a part of the WhereIsIt software
package and as such a copyrighted material. Using or distributing these 
librarires for any purpose other than running them as a part of WhereIsIt 
is prohibited and in violation of copyright laws.
----------------------------------------------------------------------------