I am pleased to announce the 1.2 release of the WidgetFX project.  This brings the project up to speed with the latest JavaFX 1.2 release, and includes many bugfixes and improvements to the framework.

I want to thank all the widget authors who made an extra effort to port their widgets during the beta period so they would be available from day 1 on the new version.

So what are you running in your dock?

WidgetFX 1.2 Widgets

All these widgets are available and working today on the WidgetFX 1.2 release.  To run WidgetFX, simply go to the WidgetFX home page and click on the Launch Dock link: http://widgetfx.org/

Here is a list of the major changes in this release:

• Improved Performance – The widget dock, as well as all widgets will benefit from performance improvements in JavaFX 1.2.
• Built-in Layout – Widgets now have an onLayout() function that can be used to layout the top-level nodes.
• Signed Widgets – Widgets can now be signed with certificates to get out of the sandbox and gain access to system resources.
• Additional API Hooks – New event handlers for onShow and onHide.
• Macintosh Bugfixes – Transparency now works with the latest JDK (1.6.0_13), and dialog interaction issues have been fixed.

You too can be a widget author and win some free prizes in our widget development contest.  The deadline is July 31st with a grand prize of a year’s worth of free books donated by my publisher, Apress.

WidgetFX Developer Contest

Happy Widget Hacking!

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.

Thanks to the whole JFXtras team, and especially Steve Bixby, Jim Clarke, Dean Iverson, and Keith Combs, for making this release possible.

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!

http://code.google.com/p/jfxtras/downloads/list

Since JavaFX 1.1 is not binary compatible with the 1.0 JavaFX release, if you are doing any development with JavaFX 1.1 you will need to upgrade to the newly released version 0.3 of JFXtras.  Similarly, if you want to do any development on legacy JavaFX 1.0 applications, you will need to stick with JFXtras 0.2 or earlier.

The major feature in this release is the inclusion of a MigLayout wrapper that gives you all the power of MigLayout from within a native JavaFX syntax (a big thanks to Dean Iverson for making this happen).  Here is an example of Mig Docking in action:

MigLayout Docking Test

The intent is to keep both the JFXtras Grid and MigLayout as fully supported options for JavaFX layout.  The choice is yours which one to use!

Some other changes that went into this release as well include:

• Modified permissions in JFXWorker, JFXException, and JFXDialog from public-init to public-init protected
• Fixed alwaysOnTop support and added an icon workaround to JFXDialog
• Deprecated CacheSafeGroup now that the underlying bug has been fixed

This release made it in roughly 5 days total, but only 2 business days after the JavaFX 1.1 Release.  Special thanks to Keith Combs for packaging up the release!