jfxtras.org Guest

I am pleased to announce the 0.5 release of JFXtras.  This release updates the project with JavaFX 1.2 support, plus includes a major overhaul of the Shapes, Borders, and Layouts.

You can grab the latest bits here:
http://code.google.com/p/jfxtras/downloads/list

And browse the Javadoc online.

Pure JavaFX Shapes

Why should you care that we spent months re-implementing all the Shapes from scratch in pure JavaFX code?  Well, here are a few reasons:

1. JavaFX 1.2 Compatibility - The JavaFX scene graph was pretty-much rewritten from the ground up in the 1.2 release, so porting the old Shape code was non-trivial.
2. Mobile Deployment - Yes, you can now draw stars, balloons, and reuleaux triangles on your new HTC Diamond.  (What, you didn’t pick up a JavaFX Mobile device at JavaOne?  Your loss…)
3. Richard Bair said to do it…  Rich isn’t the sort of guy you say no to, and he was pretty adament about the fact that we shouldn’t be hacking the scene graph directly.  Well, now we aren’t.  (although don’t let him know about our new hack to embed JavaFX in Swing…)

You can try out the new shapes by running the DrawJFXtras sample program from the Pro JavaFX Platform book (which has an entire chapter dedicated to the JFXtras project and other JavaFX FOSS):

Draw JFXtras Sample Application

Note:  When playing with the demo be careful using the balloon and rounded rectangle shapes.  They trigger a nasty bounds-detection bug that we still haven’t tracked down.

Thanks to my coworker, Steve Bixby for doing the rewrite in his spare time.  He was looking for a little project to learn JavaFX, and went way above and beyond!

Redesigned Borders

We also redesigned the JFXtras Borders from scratch.  Here are some of the new and noteworthy improvements:

• Improved performance – The borders render much more quickly, because they take advantage of the new layout infrastructure. This means you can layer and nest borders to your heart’s content without worrying about slow rendering or resizing.
• Developer-friendly properties – The border properties are still available via CSS, but can now easily be set using variables on the classes as well.
• Shape-to-Fit support – There is a new property on the border class called shapeToFit that allows you to choose between having the border fill the available width/height or hugging the component.

Layouts Reloaded

What JFXtras release would be complete without at least a partial layout rewrite?  Well, the JavaFX team didn’t leave us much of a choice here, given all the great work they did on layouts in JavaFX 1.2.

The good news is that Amy Fowler and I were mostly on the same wavelength, so the upgrade should be relatively painless.  Here are some of the reasons to use the new JFXtras layout classes:

• Take advantage of JavaFX 1.2 features – All the JFXtras layouts will honor layoutInfo constraints set on Nodes such as hpos, vpos, and managed.
• Plus Extended layout features – JFXtras layers fill, span, grow, and full support for resizable layouts.  Simply drop in the ResizableXXX replacement classes (ResizableScene, ResizableHBox, ResizableImageView, etc.) and forget about manual binding of layouts.
• Plus the JFXtras Defaults System – Most components want to be laid out a certain way.  For example, you usually want Labels left aligned and TextBoxes to grow horizontally.  JFXtras provides defaults for all the new JavaFX 1.2 controls so you don’t have to.
• And still the best Grids around – The JFXtras Grid and MigLayout have both been fully updated to work with JavaFX 1.2.  Combined together, you have the most powerful layout system available for JavaFX (or any RIA platform) period.

A great way to learn about the JFXtras layouts is by reading Chapter 8 of the Pro JavaFX Platform book.  It goes over a complex MediaExplorer Sample built from the ground up using all the JFXtras layouts from ResizableScene to Grid to MigLayout.

JavaFX Wrapper for Swing

Amy had a great blog that described how to makeover a JavaFX application by embedding Swing, but how about going the other direction?  With the new SceneToJComponent class, you can do exactly that from a standard API like this:

    public SceneToJComponentTest() {
        String sceneClass = "org.jfxtras.scene.SceneToJComponentScene";
        setDefaultCloseOperation(javax.swing.WindowConstants.EXIT_ON_CLOSE);
        setTitle("FX Panel Test");
        getContentPane().setLayout(new BorderLayout());
        JComponent theScene = SceneToJComponent.loadScene(sceneClass);
        getContentPane().add(new JLabel("JLabel: The following is a JavaFX Scene"), BorderLayout.NORTH);
        getContentPane().add(theScene, BorderLayout.CENTER);
        pack();
    }

This class allows you convert any JavaFX Scene to a Swing JComponent that can be embedded in a larger application, insulating you from future changes in the JavaFX internal APIs.

Full List of Features, Enhancements, and Changes

For existing JFXtras users who want all the gory details that they will need to migrate their applications and take advantage of new features, here it is:

• JavaFX Wrapper for Swing:
  • The new SceneToJComponent class makes it easy to wrap your JavaFX user interface in a JComponent that you can use from any Swing UI
  • This insulates you from directly calling the JavaFX internal APIs, which may change in any release.
• JavaFX 1.2 Compatibility:
  • This breaks binary compatibility with old versions.  Please recompile all your code
• JSONHandler:
  • Enhanced variable name mapping support
• JFXtras Borders Changes:
  • Border child is now in a parameter called “node” rather than “content”
  • New shapeToFit property to choose between matching the container set width/height or wrapping the nested node
  • Properties are now exposed directly on the border classes in addition to being accessible from CSS.
  • Various border tweaks…  ShapeBorder is now used for clipping, TitledBorder has a line, etc.
• JFXtras Layout Changes:
  • HAlign/VAlign have been removed in favor of using the new built-in HPos/VPos classes.
  • Fill is not an orthoganal property in its own class used by ExtendedLayoutInfo (which extends LayoutInfo)
  • Grow and span are now on a new GridLayoutInfo class that extends ExtendedLayoutInfo
  • Layout contants are now all in the new LayoutConstants class (formerly GridContraints)
  • ResizableHBox/ResizableVBox have been updated with the new hpos/vpos/nodeHPos/nodeVPos parameters from HBox/VBox
  • ResizableScene now support nodeHPos/nodeVPos parameters
  • Deck now supports nodeHPos/nodeVPos parameters
  • Grid position default is LEFT/MIDDLE
  • Grid now supports nodeHPos/nodeVPos parameters
  • Grid now handles toFront/toBack correctly (and is the only layout in existence that does)
  • New DefaultLayout class for supporting the JFXtras defaults system
  • New JFXContainer class created to support JFXtras layout extensions
  • Removed org.jfxtras.layout.EmptyBorder.  User org.jfxtras.scene.border.EmptyBorder instead.
• Component Changes:
  • ScrollView now uses JavaFX ScrollBar and ClipView
• MigLayout Changes
  • MigLayout fixed to make it work with JavaFX 1.2.
  • MigLayout handles dynamic changes to node sizes and their layoutInfo’s managed flag
  • MigLayout code is no longer forked (thanks to nativearrary support in JavaFX!)
• JFXtras Shapes changes:
  • JFXtras Shapes are now defined as native JavaFX shapes
  • Shapes are generally more fault tolerant to invalid parameter values
  • Almond & Asterisk ‘width’ is now from left to right rather than left-to-center or center-to-right.
  • Asterisk arm width is now as specified (was twice as wide.)
  • ReuleauxTriangle is treated as a spherical object and has centerX, centerY, and radius, rather than x/y/width.
  • All shapes use native JavaFX transforms; specifically, angle of rotation is clockwise rather than counterclockwise as before.
  • All shapes rotate about their bounds center rather than around a starting point – as do all Path-based native JavaFX shapes.

Enjoy the new JFXtras Release!

The JFXtras project has been split into the following three subprojects:

• JFXtras Core – Contains everything you need to quickly and easily build rich JavaFX applications.  This includes Layouts, UI Controls, Shapes, Borders, Utilities, etc.
• JFXtras Test – This provides a comprehensive unit and UI test suite along with wrappers for running from the command line or a visual client (coming soon).
• JFXtras Samples – This is a new project dedicated to providing high quality JavaFX samples to teach the language and bootstrap innovation.  More on this coming in the next few weeks, but if you are interested in contributing or helping out let me know.

The release today is for JFXtras Core, which is now Java 1.5 compatible, and includes some brand new features courtesy of Jim Clarke.  This includes a wide assortment of styleable Borders:

New JFXtras Borders Support

As well as:

• Styleable ScrollBars and ScrollViews
• A JSON Handler to automagically populate JavaFX objects from a remote connection

Which is in addition to a whole slew of other cool features including:

• A new Constraints system for specifying how nodes are laid out with a uniform API
• Significant updates to the JFXtras Grid
• New resizable layouts including: ResizableCustomNode, ResizableImageView, ResizableMediaView, ResizableHBox, ResizableVBox, and updates to ResizableRectangle
• A new version of the Shapes library
• An ImageFix class that resolves backgroundLoading issues and an ImageUtility class to help with common operations
• Defect fixes for Shapes, Dialogs, and others

You can download the latest bits here:  http://code.google.com/p/jfxtras/downloads/list.  And also browse the online Javadocs.

Thanks to the whole JFXtras crew for putting together another huge release!