Mirage 10.0.0

BUG FIXES
- Rolled back the change for Web Locations with cross-origin framing, because it prevented other Web Locations from displaying. (since 9.3)
- A linked album did not have a button to return to the master album. (since 9.2)

Fixed 2 recent bugs that just affect old versions of jAlbum. If you use jAlbum 12 or later, you don't need this update.

BUG FIXES:
- Error "Unknown class: MgSkin" when opening an album in jAlbum 11.6.17, although the album does open successfully. (since 9.2)
- Album generation error in old versions of jAlbum: "Exception caused by line 6: java.lang.NoSuchFieldError: rootFolder". (since 9.3)

CORRECTION Feb 12, 2020
There were some errors in the documentation. A corrected document is available at http://ctwist.jalbum.net/doc/mirage/Mirage.pdf

BUG FIXES
- Sometimes a YouTube video caused an exception when making the album. There are two types of URL to play a YouTube video; only one of these worked.
- If a Web Location linked to a web server that prohibited cross-origin framing, the embedded web page content did not display and no error message was shown. It is not possible to override this restriction. The user is now shown an error message and a button that opens the page in a separate window. Alternatively, you can prevent this error by choosing the Mirage option "New window".
- If "Chain directories" was enabled, sometimes the "next slide" or "previous slide" button opened a non-existent page.
- If "Chain directories" was enabled, sometimes the "next slide" or "previous slide" button was not shown when chaining should have continued.
- In the past, variants were randomly shown in index pages (instead of in slide pages). I haven't seen this since Mirage 8, but that could be because I have a faster computer, or maybe my previous fix worked. Anyway, I moved the code that excludes variants to the beginning of the album generation process (instead of as each folder is processed). If there was a remaining problem, this should fix it.
- If an album object name contained a special character, slide page navigation sometimes failed.
- If an album object was a Windows 10 shortcut in the user's Documents folder, the shortcut was not evaluated correctly.
- The list of album generation messages is scrollable. Previously, some messages may not have been visible.
- There was an unnecessary 20px space at the bottom of the page if the widget bar was hidden.

ENHANCEMENTS
- Removed a restriction for multi-page indexes. You were only able to scroll through the slides for the current index page. It wasn't a very good idea.
- In the Mirage album settings, you can set the width and padding of comments, so that they don't use all the available screen width. Comments below the image do not extend beyond the image edges, unless the image is very narrow. Padding above the comment is also customisable.
- Removed the setting "Allow spaces in file names". Spaces are always allowed.
- During album generation, a "Making album" window shows the album object that is in progress. This did not show Mirage-specific album objects (e.g. variants), which sometimes suggested that generation was slow or stuck. Now all types of album object are shown.

DOCUMENTATION
- Descriptions of Mirage settings were in Mirage.pdf and online help. Now these are documented once. In Mirage.pdf, this has been replaced by hyperlinks to the online help.

COMPATIBILITY:
- Java 8 or later is required.
- This is the final version of Mirage that supports:
Windows XP, Vista
Internet Explorer 8, 9, 10

BUG FIXES:
- Error "java.lang.NoClassDefFoundError: net/jalbum/filters/LogoFilter" when making an album in jAlbum 11.6 or earlier. (since 9.1)
- Video generation failed in jAlbum 12.7 and earlier. (since 9.1)
- An embedded linked web page sometimes opened in a separate browser tab.
- Better balancing of the number of thumbnails in the two columns of variants.
- Embedded web pages were in a small window in IE8. (since 9)

COMPATIBILITY
- Java 7 or later is required.

ENHANCEMENTS
- Previously, a video that was smaller than the image bounds played at its actual size. It now zooms to the image bounds.
- The thumbnail for a variant video contains a "play" icon.
- Opera plays MP4 videos natively, instead of using Flash.

BUG FIXES
- Error "java.util.MissingResourceException" when opening a folder's settings. (since 9)
- A variant Zoomify image caused error "java.lang.IndexOutOfBoundsException". (since 9)
- Slide pages had an unnecessary margin at the bottom. (since 9)
- If "Process only updated subdirectories" was selected, some JavaScript and CSS files may have been corrupt and some videos may not have played.
- A web location's label was sometimes shown, instead of the title.
- An embedded web location was sometimes taller than the slide page.
- A video's poster was sometimes the .thm thumbnail file from the camera instead of the frame that was selected in jAlbum.
- A non-MP4 video did not play if "Do not re-encode" was selected. (since jAlbum 13.1)
- Recent versions of Opera were identified as Chrome. This caused videos to fail.
- Sometimes an index page contained a superfluous "parent index page" button.
- Some filters were not applied to variant images.
- Variant videos were not trimmed.
- Error "java.io.IOException: Error during video creation" when generating an existing variant video if the target video was open. Now a friendly message is shown and album generation continues.
- Keyboard navigation of variants did not work. (since 8)
- The help button in the Mirage settings caused an error message in system console: "java.net.URISyntaxException: Illegal character in opaque part at index 2". However the help page did display correctly.

ENHANCEMENTS:
- You do not need to provide the thumbnail and dimensions for a YouTube or Vimeo video. These are determined automatically.
- The thumbnail for a linked web page is usually determined automatically.
- YouTube and Vimeo videos are larger. Previously their dimensions were the same as the embedded video dimensions on the YouTube or Vimeo web page. Now their dimensions are determined by the "image bounds" album setting.
- A linked web page is embedded in a slide page, instead of opening in a separate web browser tab. This allows you to stay in the album while you view an external web page. You can override this behaviour and open the web page in a separate tab.
- The jAlbum 14 "Web Location" feature is supported. This provides a simpler technique for adding YouTube videos, Vimeo videos, linked albums and web pages to an album. Web Locations behave in almost the same way as shortcuts, which Mirage already supports.

BUG FIX:
- Panoramic thumbnails had a wrong width.

Bug Fix:
- Error java.io.FileNotFoundException, sometimes, if an album contained a Zoomify image.

Bug Fixes:
- Album generation always failed with error "Cannot register variables for url.png". (since jAlbum 14)
- YouTube videos could not play in full screen mode. (since 8)
- YouTube videos did not play in IE8. (since 8)

The documentation in version 8 was old. This version contains the updated version of Mirage.pdf.

MAJOR ENHANCEMENTS
- The YouTube IFrame Player is used, instead of the deprecated YouTube Flash player.
- Zoomify HTML5 is supported (Free, Express and Pro versions). Zoomify Flash is deprecated.
- A slideshow can be played for the variants on a slide page. This supports all types of album object (images, videos, etc.). This is enabled by an album setting. To skip the current album object, click the next thumbnail. To stop the slideshow, click any other thumbnail.
- A lot of improvements to the styles. There is greater contrast between the colours. Buttons are slightly larger. Widget bar colours are customised for each style. More space around index page numbers. All GIF buttons and icons have been replaced by PNG files.
- Swiping is more reliable. It is available on the entire page, instead of specific areas. A drag does not cause a swipe action.
- Chained Directories are supported (requires jAlbum 12.2; 13.8 is recommended).
- HiDPI images are supported (requires jAlbum 13.7).

MINOR ENHANCEMENTS
- The video background colour matches the style.
- The video poster is shown for at least 2 seconds. Previously it sometimes appeared for a fraction of a second.
- Better balancing of the number of thumbnails in the two columns of variants.
- The list of index page numbers includes "next" and "previous" arrows.
- A sub-folder can be selected as the folder thumbnail.
- Improved method for automatically selecting a folder thumbnail.
- All IE6/7 hacks have been removed.

BUG FIXES
- YouTube and Vimeo videos may not have played over a secure connection.
- On a single-page index, a superfluous word "Page" was shown (since jAlbum 13.7).
- Background colours were sometimes wrong.
- A panorama's thumbnail was sometimes not tall enough.
- The comment below a superimposed image was too low.
- If the page contained variants, the comment below the image was too narrow.
- A linked shortcut caused java.io.FileNotFoundException.
- An invalid shortcut caused Upload to fail, with error "info.cqs.remotefs.RemoteFSException: 4: Socket closed already."
- The poster was not shown for an FLV video.
- Sometimes variants were shown on an index page. I don't know why. I have added a fix to prevent this.
- java.io.FileNotFoundException may have occurred if a sub-folder did not contain meta.properties.
- "java.io.IOException: Incorrect function" if a shortcut album object referred to a non-existent file.
- If an index page button contained a relative URL, the button only worked in the root index.
- A user-entered link on the index page that started with "www." caused an invalid link. Now this is prefixed with "http://". (Not really a bug, but a helper)
- The text in an index page button was sometimes the wrong colour.
- Minor bugs that I did not document.