Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: for the plan.

Jump to: navigation, search


< Scout‎ | Concepts
Revision as of 05:41, 30 September 2013 by Unnamed Poltroon (Talk) (API)

The Scout documentation has been moved to


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 The Scout documentation has been moved to (rayo theme), is designed to look exaclty like this Swing Look and Feel.


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.

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


The API is straight forward: The Swing plugin defines an interface: The Scout documentation has been moved to that needs to be implemented in your project:

public class MyRayoConfigurator implements ILookAndFeelConfigurator {
  private static final String XML_FILE = "customRayo.xml";
  public void configure() {
    System.setProperty("awt.useSystemAAFontSettings", "off");
    System.setProperty("swing.aatext", "false");
  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.


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

Scout Rayo alt color.png


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.


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

Back to the top