Overview

Monocle is an experimental implementation of the Glass windowing component of JavaFX. It's targeted at simple embedded systems that do not have an underlying window system. It is an ongoing effort.

Description of Monocle components

This is hard to read in the web interface, so you'll want to download the PDF if you are interested in Monocle's inner workings.

How to build Monocle

If you build OpenJFX for embedded Linux/ARM platforms from the 8u-dev repository then you get a functioning Monocle as well. You can also build it for Linux/x86 using the x86egl compile target (build with -PCOMPILE_TARGETS=x86egl on a system with GLESv2 and EGL development libraries installed). This builds the embedded stack for the Linux desktop; it is not the same as the GTK implementation of Glass. You cannot currently build any of the graphical implementations of Monocle for desktop windowing systems.

How to run Monocle

Since Monocle is an experimental implementation of Glass, it is not the default on any platform. To select it you run Java with the system property -Djavafx.platform=monocle on embedded platforms. This selects the Monocle implementation of Glass and sets other JavaFX options to match the embedded stack.

You can also select one of the specific back-ends of Monocle with the system property monocle.platform. Not all Monocle back-ends work with all Prism back-ends, so you might need to set prism.order as well.

monocle.platform	prism.order options	Hardware on which this might work
`OMAP`	`es2` (default) or `sw`	BeagleBoard xM. Note that the es2 pipeline requires PowerVR graphics drivers, which are only available on soft float configurations of Linux on the BeagleBoard.
`OMAPX11`	`es2`	BeagleBoard (might require additional Prism changes)
`X11`	`es2`	BeagleBoard (might require additional Prism changes); Linux/x86 desktop
`Linux`	`sw` or `es2`	Any Linux system with the sw renderer. Will run on Freescale i.MX6 with the es2 renderer if you have Vivante framebuffer drivers installed.
`Headless`	`sw`	Any system

If you are running the desktop build of JavaFX or OpenJFX then your only monocle option is Headless. Desktop JavaFX does not support the javafx.platform system property, but you can select Monocle with:
-Dglass.platform=Monocle -Dmonocle.platform=Headless -Dprism.order=sw

Status

What's working:

Mouse input and accelerated rendering on X11
Accelerated rendering on Freescale i.MX6 and BeagleBoard xM
Mouse input with Linux device nodes
Software rendering to /dev/fb0
Cursors on OMAP3. Almost mostly working on Freescale i.MX6.
Much of HelloSanity is working on BeagleBoard xM
Synthesis of mouse events on single-point touch screens

What's not working:

Window location in software rendering
VirtualKeyboard isn't getting events
Popups have some sizing issues

What's not done yet:

Touch, key input
Freescale i.MX6 Cursor
Dispman port
Android port
DirectFB port
Nested event loops
Drag and drop
Window input grabbing
Robot input and capture
Unification with Prism's platform recognition