Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

New Parallax Control for Java (JavaFX)

DZone's Guide to

New Parallax Control for Java (JavaFX)

JavaFX now has a new parallax control that you can use within your own applications! See how it works and how you can get ahold of it.

· Java Zone ·
Free Resource

FlexNet Code Aware, a free scan tool for developers. Scan Java, NuGet, and NPM packages for open source security and open source license compliance issues.

Parallax is a visual effect where you combine two layered images moving at different speeds to achieve a sense of depth.

Think about when you're driving on the road and you see the trees close to you moving fast, whereas the trees that are further away will move in the same direction, but slower. The result is that you perceive the trees that are moving faster to be closer to you and the others to be further.

If you are a fan of video games, you've certainly seen this effect before: two images are placed one over the other, the background moves slower, and the foreground, which could be the player's avatar moves faster.

This is an often used trick in the video games world. It started to be used quite long ago — an example is the Super Mario video game series.

Image title

This effect has been adopted in the user interface area, where you can see it used on websites and also some applications.

Image title

My goal was to bring this to JavaFX in the form of a control where you could, through a simple API, add a parallax effect.

Parallax in a ListView

My primary objective was to bring this to the ListView, that is, have a control with an API similar to the ListView where you could set the background image and the list of items just like in the JavaFX ListView.

Implementing ParallaxListView

To have a parallax effect the items in the ListView — the cells — need to scroll at a faster rate than the background image.

This new control will use the JavaFX ListView with a transparent background, layered in front of a background image.

The first challenge is that the scroll of the JavaFX ListView is done through jumps. When you do a scroll action, the position will jump from the original position to the end position without going through the intermediate position values. This will break the effect, since there is no movement like in the real world, only a discrete set of positions. The objects in the foreground should move faster through a translation animation. Remember, this is about mimicking a real-world phenomenon, like the driving example I gave earlier, to give a sense of depth.

So, to accomplish this I had to implement my own ListView scrolling as well as the background scrolling. When scrolling, it animates through a set of positions.

Image title

Where to Get It

For now, you can get it here: https://github.com/dukke/parallax-list-view.

I decided to stick with JavaFX 8, as Java 9 is still relatively new and some folks might have not yet migrated. This way, Java 8 and Java 9 programs can use it.

I'm using a private API, namely VirtualFlow, but this has turned into a public API in JavaFX 9, so it will be easy to migrate the ParallaxListView code.

The test folder has an example of how to use the control. You have to scroll through the mouse wheel to see the effect.

Update: Check out the documentation page for more information -  https://pixelduke.com/fxparallax

Conclusion and Further Developments

The ParallaxListView can give a nice touch to your application, adding a bit of flair. However, don't overuse this effect.

In the next few days, I plan to add the following:

  • Add support for scrolling through the Scroll Bar.
  • Add API to change the height of the background image in relation to the foreground
  • Add the ability to specify the orientation of the ParallaxListView: Horizontal or Vertical
  • Add a documentation page
  • Also provide a general purpose control that lets you specify a background and an arbitrary scrollable foreground control.

 Scan Java, NuGet, and NPM packages for open source security and license compliance issues. 

Topics:
java ,javafx ,parallax ,control ,listview

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}