Jump to: navigation, search

Scout/Concepts/Rayo

< Scout‎ | Concepts
Revision as of 05:41, 30 September 2013 by Matthias.Nick.bsiag.com (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Scout
Wiki Home
Website
DownloadGit
Community
ForumsBlogTwitter
Bugzilla
Bugzilla


Description

Rayo is a swing look and feel for Eclipse Scout. It is designed to look and feel "different" than those boring grey windows from the 90s.

Window controls are rearranged or omitted intentionally to give the user a more clean and simple user interface. While the marketing departments likes this very much ("So simple, everyone can use it without teaching, you can't do anything wrong - and it's blue!"), it certainly limits the possibilites to the programmer. First, you usually do not programm any GUI code, but only "client model code" that is then mapped to the GUI automatically. This limits you to the possibilities the model offers. Second, not all of those model objects are supported by the Rayo LAF, because they would not fit in.

Its based on Synth Look and Feel. All the painting is delegated to components without requiring any code to be written in Rayo. That makes a skinnable Look and Feel that is configured in an XML property file.

The default theme of the RAP UI (rayo theme), is designed to look exaclty like this Swing Look and Feel.

Screenshot

Scout app gallery rayo.png

Use a custom XML

The Rayo look and feel (based on the Swing Synth Look And Feel) relies on configurations and images. Those are defined in a XML file, making this file a very central piece of code that define how the swing UI looks like. For some users, the choices made in the Rayo look and feel do not fit the requirements (for example a color choice). Exchanging the XML might be a possibly to fix the user interface.

Important.png
Required version
The API described here requires version 3.10.0 or bigger.


API

The API is straight forward: The Swing plugin defines an interface: I obj.pngILookAndFeelConfigurator that needs to be implemented in your project:

public class MyRayoConfigurator implements ILookAndFeelConfigurator {
 
  private static final String XML_FILE = "customRayo.xml";
 
  @Override
  public void configure() {
    JFrame.setDefaultLookAndFeelDecorated(true);
    JDialog.setDefaultLookAndFeelDecorated(true);
    System.setProperty("awt.useSystemAAFontSettings", "off");
    System.setProperty("swing.aatext", "false");
  }
 
  @Override
  public InputStream getConfigurationFile() {
    return getClass().getResourceAsStream(XML_FILE);
  }
}

The implementation references an XML file (customRayo.xml in this case) that is loaded as InputStream in the getConfigurationFile() method. (Note: in this example, the customRayo.xml must reside in the same folder where the .java files are)

This implementation needs to be registered as an extension for the ExtensionPoint defined in the Rayo plugin.

<extension
      point="org.eclipse.scout.rt.ui.swing.lafconfigurator">
   <configurator
         class="myapp.ui.swing.custom.MyRayoConfigurator">
   </configurator>
</extension>

In your XML file, you will be able to change colors:

Scout Rayo alt color.png

Limitations

The XML file references lots of images. Due to class loading issues, these images need to be located in the com.bsiag.scout.rt.ui.swing.laf.rayo.fragment. This means that you cannot easily change this image references. Notice that a lot of colors are defined with images. You will not be able to change the whole look and feel by just defining new values in the XML.

Maintenance

Be aware that if you copy-paste the original XML file, you will be responsible to merge further modifications of the file (bug fixes) in your project. The additional freedom provided by this mechanism has non-zero maintenance cost.

See also