BluPlusPlus 5.1.0

This is a major upgrade of BluPlusPlus. There are 32 improvements. The release notes are at http://bluplusplus.jalbum.net/doc/html/changes_history.htm

If you are upgrading an old version of BluPluPlus, you must read the release notes before installing; installation is not as simple as for previous releases.

Bug Fixes:
- Album generation failed if it contained a video and the setting "Slide / Video Slides Dimension" was blank (since 4.8).
- The Fixed Shape Filter was not working correctly. It produced small square images. It now produces images that match the image bounds.
- After submitting a viewer remark, if the user refreshed the page, the remark was submitted again.

ENHANCEMENT:
- A SkinModel class has been added.

BUG FIXES:
- Error when making an album "The specified background image <file path> does not exist." if the album contained a linked file.
- In the Frames settings, if the user changed Ratio and clicked Preview, the Frame Preview did not change.

DOCUMENTATION:
- The documentation has been moved to http://bluplusplus.jalbum.net/legacy_doc.
- There is a new section "Reference Guide / Frames(w/XBorderFilter) / Advanced examples". This was included with earlier releases, but it was not accessible from the menu, so most users probably overlooked it.

ENHANCEMENT:
- If a target audio or video file was open, a stack trace was added to system console, containing:
-> Error copying file! java.io.FileNotFoundException: <file path> (Access is denied)
This now produces no stack trace and a friendly message "Error copying file <file path>, probably because the target file is open".

BUG FIXES:
- If there was an external home, the first breadcrumb in slide pages linked to the wrong URL. This was caused by an old jAlbum bug. BPP contained a workaround for this. The bug was fixed in jAlbum 8.2, and this caused BPP to calculate the wrong URL. BPP's workaround has now been removed.
- On a non-HIDPI display, HIDPI thumbnails were too big.
- For linked images, the voice annotation audio file did not play.
- Error "Unterminated string constant" when viewing a slide page containing a thumbnail whose description contained a line break.
- Invalid HTML code: The page footer contained a table inside a <span> tag (since 4.4 or earlier). It has been changed to <div>.

Enhancement:
- Chained directories are supported.

Bug Fixes:
- java.lang.NullPointerException at PhotographicMetaInformation.calculateFocus35mm (since 4.5).
- 35mm equivalent focal length was not always shown.
- Don't show meta values that just contain spaces.
- Replaced all deprecated Java methods.

Enhancements:
- Page blending/fading only worked in IE8. A better technique is now used; this works in all web browsers.
- Variables can be entered in the "variables" panel in the image settings. Previously BPP ignored these. This replaces variables.properties, although variables.properties is still supported.

Bug Fixes:
- Slide pages always contained the title of the last image in the folder (since jAlbum 12.3).
- Folder variables were not inherited for linked images.
- The folder icons were wrong (since before jAlbum 9.6.1).
- XBorderFilter caused a NullPointerException when an album was opened (since 2007). Fixed in jAlbum 13.
- HTML pages contained invalid HTML 4.01 code.

Documentation:
- Context-sensitive help is available for the BluPlusPlus settings (since jAlbum 12.3).
- Some outdated sections in the documentation have been updated.
- As you scroll through the styles, a sample image for the selected style is shown.
- Hyperlinks are highlighted; previously they were not obvious unless you hovered over them.
- Documentation has been moved to the jAlbum website.

Known issues:
- Not compatible with jAlbum Video Support. In Preferences, do not select Video Support.

Note:
- The minimum required jAlbum version is 9.6.1. It may work with earlier versions, but I have not tested them. There is no reason to continue to use an earlier version.

Fixes:
- Compatible with all recent versions of jAlbum.
- Fixed: The version checker crashed if the installed jAlbum version was >= 10. This has been removed. Instead, the version checker in jAlbum verifies that a compatible version of jAlbum is used.
- Fixed: Slide pages always contained the last image in the index (since jAlbum 12.3).
- Fixed: The breadcrumb trail started with an extra dead link (since jAlbum 10).
- Fixed: Error message when album generation started: "java.lang.InstantiationException in BPPFrameHandler". This caused frames to be omitted.
- Fixed: Errors "Cannot convert 'null' to a Color" and "Invalid value for property shCol: 585858" if an elaborate_01 frame was used (since 2005).
- Fixed: java.lang.NullPointerException if the number of threads in Preferences was greater than 1.
- Fixed: Errors and warnings when the Java code was compiled.
- Fixed: Two resource leaks.
- Fixed: Dead links in the BluPlusPlus settings.
- cameras.properies is discarded. BluPlusPlus now uses a more recent cameras.properies that is bundled with jAlbum 9.6+.
- The calculation of the "35mm equivalent focal length" is discarded. Instead, the jAlbum variable "focalLength35mm" is used.
- Removed obsolete call to "showPrintingWarnings()" in init.bsh. This improves compatibility with recent versions of jAlbum.

- In the case any missing information in "cameras.properties" of
BluPlusPlus, the system-level "cameras.properties" which comes
pre-bundled with JAlbum will be used instead.
- Wrong 35mm Focal Length Multipliers in "cameras.properties" have been fixed.
- A problem with sending Viewer Remarks's notification e-mails, which was affecting some of the SMTP servers, has been resolved.
- Bug-Fix: The broken link from original image page to normal slide page has been fixed.
- A small typo in French translation has been fixed.