Configuring graphics and fonts

If you are running the Cleo Harmony, Cleo VLTrader, or Cleo LexiCom application on a Unix platform, you might need to adjust graphics- and font-related properties if the application is reporting related problems. Running in Headless mode eliminates any possible dependencies on X11 or XVFB. When Headless mode is enabled (the default for new installs), the other graphics and font settings cannot be changed. The corresponding XML property name is <Headlessmode>.

  1. Click the Graphcis/Fonts tab.
  2. Clear the Headless mode check box to enable edit mode for the other graphics and fonts settings.
  3. Select the Mixed settings check box to enable the properties below.
    Use platform graphics
    Property name: <UsePlatformGraphics>
    Description: Indicates to use native graphics environment rather than the application’s virtual graphics environment
    Default value: True if Solaris or HP-UX and JRE 1.5; False otherwise
    Use X11 DISPLAY environment variable
    Property name: <NeedX11DisplayVariable>
    Description: If access to X-Window is needed for native graphics environment
    Default value: True
    Property name: <X11DisplayVariableValue>
    Description: X11 server number and screen number.  If an X11 server is not available, it may be necessary to run Xvfb.
    Default value: 0.0
    Include application fonts
    Property name: <IncludeApplicationFonts>
    Description: Includes webserver/AjaxSwing/lib/fonts in font path.  Can only be False if <IncludeJreFonts> is True
    Default value: True
    Include JRE fonts
    Property name: <IncludeJreFonts>
    Description: Includes jre/lib/fonts in font path.  Can only be False if <IncludeApplicationFonts> is True
    Default value: True
    Reverse order in font path
    Property name: <ReverseOrderInFontPath>
    Description: Reverses order of above directories in font path
    Default value: False
    Use application font properties
    Property name: <UseApplicationFontProperties>
    Description: Indicates to use application’s font properties rather than JRE’s
    Default value: True, if Linux. False otherwise
    Use platform font
    Property name: <UsePlatformFont>
    Description: Indicates to use native font rather than JRE’s
    Default value: True, if AIX. False otherwise

    Xvfb (X virtual frame buffer) is an X11 server that performs all graphical operations in memory (http://en.wikipedia.org/wiki/Xvfb). Xvfb implementations are available on Linux, Solaris, AIX, and HP-UX. If needed, perhaps the easiest way to activate Xvfb is to start an Xvfb process just prior to starting the Cleo Harmony, Cleo VLTrader, or Cleo LexiCom application in the Harmonyd, VLTraderd, or LexiComd daemon script. The X11 server number and screen number are runtime parameters to Xvfb; the <X11DisplayVariableValue>

    above would need to be set to the same server and screen numbers.
    Note: If a native UI does not exist, you can use command line options to change any of the above settings.  For example:
    Harmonyc -p Local Listener\Web Browser –t <Service><IncludeApplicationFonts>False
    VLTraderc -p Local Listener\Web Browser –t <Service><IncludeApplicationFonts>False
    LexiComc -p Local Listener\Web Browser –t <Service><IncludeApplicationFonts>False
    • When Mixed settings is selected, the graphics and text settings can be a mixture of the VersaLex software's virtual environment and JVM runtime and operating system native environment.
    • When Application only settings is selected, all of the graphics and font settings shift to only those provided by the Cleo Harmony, Cleo VLTrader, or Cleo LexiCom software's virtual environment.
    • When Platform only settings is selected, all of the graphics and font settings shift to only those provided by the JVM runtime and operating system native environment. 

    For both Mixed settings and Platform only settings, if the Use X11 DISPLAY environment variable check box is selected, you should ensure the server and screen number are properly set.