Reflections 3.0.2

Update links in skin.properties to new location on my jAlbum website.

After about a decade I have revived Reflections skin with new filters and features.

The following features are available in the ReflectionFilter:

- Show only reflection part of the image.
- Chain reflection filter (see example album at http://jalbum.net/a/1987822 )
- Allow reflecting up, down, left and right (used to be only down).
- You can still specify the ratio of the image to reflect (height/width).

The following features are available for the GradientPaintFilter:

- It's possible to paint the image before reflection.
- You can specify a different gradient paint direction (you can also synchronise it with the reflection direction).
- You can still specify opacity and ratio.
- You can change the gradient paint colours.
- Make it cyclic paint.
- Invert opacity (changes direction and makes darker)
- First default colour is black, second colour is #111111, can change both or neither or one (jAlbum colour selector available)
- Can swap colours with a click of a button
- Can restore colours back to default (individually or both)
- Can disable ReflectionFilter and still have paint filter enabled

The PhongFilter, which adds specular highlights, is disabled by default but has the following options (warning: changing these can add artefacts on images):
- Add before reflection; and if advanced option tick box is enabled you can change:
- Specular colour and multipliers (RGB)
- Ambient colour and multipliers (RGB)
- Diffuse colour and multipliers (RGB)
- Light colours and multipliers (RGB)
- Number of light sources
- Specular power
- There is a reset button for the specular/ambient/diffuse colours (and the multipliers) as well as the other options + reset all button.

The TranslucentFilter, also disabled by default, makes images translucent. The only option is of course the translucency.

Still uses the jQuery Exposure plugin for slides:

- You can disable slideshows, carousel and captions. If slideshow is enabled you can change the number of milliseconds in between each image.

- Stylesheet: Font size plus different colours depending on the style chosen.

The default settings are thus:

- PhongFilter and TranslucentFilter are disabled.
- ReflectionFilter: Chaining disabled, 100% ratio, down.
- GradientPaintFilter: Opacity 30%, sync direction with reflection direction, acyclic paint, opacity 30%, default colours as above. This means the reflection itself is painted but the original part is not.
- Stylesheet: Black
- Font size: 14
- Exposure jQuery plugin settings: Enable slideshow button (if started it has a delay of 3000m), enabled carousel and loops through slides.
- Style: Black

Notes/Warnings:

- Make sure to reload the skin or select a style specially to make sure that the variables are populated correctly, at first time for each album.
- Also make sure that you always force rebuild of the album or else filters might not be applied (or if you disabled they might still have the filters applied).
. Documentation is available but for the present not complete - this especially goes for the most complicated filter, the PhongFilter, because it's hard to explain and I'm very tired.
- The jAlbum version required might very well be lower but I do not know and for now I have the most up to date one. For one thing you have to have the most recent one (as of 1 September 2020): disabling filters for specific images. Better to simply have the most recent version anyway. Thank you to Dave for adding this feature!

Thank you again very much to jGromit, Rob M. and Chris Twist for helping me revive this after a decade of inactivity! Much appreciated.

* Major version change for major addition. New filter - called Phong Filter - which implements the phong illumination model. This allows for specular highlights which is what's seen with reflections on water. Different stylesheets in the skin use different diffuse components (see pictures for what I mean) and all have a white light (when specular highlights is enabled which it is by default).
* In addition, the Reflection Filter has a better (in my view) shading method. It is not enabled by default but I think it looks much cleaner and it is perhaps more easy on the darkness (meaning not as dark and easier to see reflection). The opacity option is for darkness - the lower the value, the faster it will get darker.
* Some other internal changes that won't effect usage.

Note that the phong filter is a bit more cpu intensive based on how it works, but everyone I've shown so far likes it a lot.

Let me know if there's any problems!

Thanks,
Cody

- Added hiResPath reference so that the hi-res linking will have a proper effect (only allowed when not reflecting as hi-res won't have filters applied).

* Bug fix: Last updated in index files not working correctly.
* Various updates: About skin and related.
* Allow hi-res IF reflection of images is disabled.

In addition to previous fixes (below), I also fixed another minor issue, as well as an issue with scaling of images (fixed dimensions option is iffy for different sized images).

The previous and more important fixes:

- When directories/folders existed in same location as loose images, the images were not selected properly on clicking them and therefore did not display.
- A minor issue with alternate text on some images in the slide pages.

This release fixes two bugs:

- When directories/folders existed in same location as loose images, the images were not selected properly on clicking them and therefore did not display.
- A minor issue with alternate text on some images in the slide pages.

- Remove now deprecated fileVariables reference; uses AlbumObjects instead.

- Update Exposure version.

Fixed bug in Reflection filter when height of reflection is not 100% (didn't show reflection properly).

- More space for longer captions (and fixed alignment issue in this case too).
- Updated Exposure version.
- Added options (for Exposure) loop (for slide pages) and fixed image sizes (scaling to the max image bounds you set in jAlbum settings).
- Fixed links in skin UI.

* Better selection of image linking mode (only sets to a different value if hi-res is selected ; this avoids overriding users choice except for the one the skin won't work with - hi res).
* Updated version in skin files.
* Changed skin to use black colour by default for the reflective shading (for contrast); still can choose whatever colour you like, however.

* Bug fix: Skin could potentially give an error if user selects hi-res (java resources being used up) in Jalbum 9.

* Bug fix: null captions in slide pages.
* Bug fix: 0 images in folders that only have sub-folders. Now also shows how many sub-folders are in a folder of the album.
* Bug fix: Alignment issues with different image and thumbnail sizes.
* Feature: You can now choose image size selection. Based on your system and how many images you are processing, you could run into trouble if you choose a value that's fairly high (this size is before image filtering). But now you can have larger images if you like.
* Feature: New Exposure version
* Feature: Exposure now creates thumbs for the slides and the size is up to you (default 80x80). See Exposure tab in UI.
* Feature: Paint colour of the reflections: synced one way from background colour to this colour (meaning you can change it but you don't have to if you like the background colour of the album).

As always, let me know if you have any issues!

Note about up-coming Jalbum 9: This skin will not support the hi-res option due to filters not being applied. The work around is to set the image dimensions higher but keep in mind the amount of resources it may need to reflect it.

* Change in colour selection; uses background colour.
* New themes - green, blue, red, grey (was light) and black (was dark).
* Simplified ui a bit.

* Bug fix - skin wouldn't save Exposure settings properly and always used default.
* New version of Exposure with Carousel feature! Enabled by default.
* ReflectionFilter now has an option to set the colour of the fade effect. You would possibly have to adjust the alpha range (also an option) so this may very well be for advanced users.
* Now using minified version of Exposure as well as only process the template once.
* Some other optimizations that may or may not be noticeable.

Take a moment to rediscover your past and reflect upon your images in a uniquely designed
photo album. With Reflections, you can reflect your images giving you a different view of
your photos, pictures or images. Includes a light and dark theme to get you started, or you
can make your own theme.

The slide pages use the Exposure jQuery plugin built by JAlbum's Kristoffer. The images are
reflected with a filter I wrote a while back. The Reflection filter will, by default settings,
darken the image as if it's against or on a dark glossly block. There's also a darken and brighten
filter that you can apply to the image as a whole or just the reflected part.

Skin complies with XHTML/CSS standard.

Includes localization support. Currently, besides English it supports Swedish, Spanish and Dutch. Any additional translations or improvements are welcome!