Product Documentation

Display issues

Sep 22, 2014
You may encounter the following display issues.

Incorrect keystrokes appear when I use the keyboard

If you are using a non-English language keyboard, the screen display may not match the keyboard input. In this case, you should specify the keyboard type and layout that you are using. For more information about specifying keyboards, see Control keyboard behavior.

I see excessive redrawing when moving seamless windows

Some window managers continuously report the new window position when moving a window, which can result in excessive redrawing. To fix this problem, switch the window manager to a mode that draws only window outlines when moving a window.

Running in seamless mode using different window managers

Seamless mode removes local window manager decorations, such as the title bar and borders, and instead uses decorations sent from the server. Different window managers use different ways of removing window decorations.

Receiver sets the _MOTIF_DECORATIONS hint to remove the decorations. It also sets the class of all seamless windows to “Wfica_Seamless”, so that a window manager that does not recognize the Motif hint can be directed to remove the decorations through resource file entries.

Icon compatibility

Receiver creates window icons that work with most window managers, but are not fully compatible with the X Inter-Client Communication Convention.

To provide full icon compatibility

  1. Open the wfclient.ini configuration file.
  2. Edit the following line in the [WFClient] section: UseIconWindow=True
  3. Save and close the file.

I have cursor visibility problems

The cursor can be difficult to see if it is the same or similar in color to the background. You can fix this by forcing areas of the cursor to be black or white.

To change the color of the cursor

  1. Open the wfclient.ini configuration file.
  2. Add one of the following lines to the [WFClient] section:

    CursorStipple=ffff,ffff (to make the cursor black)

    CursorStipple=0,0 (to make the cursor white)

  3. Save and close the file.

I experience color flashing on the screen

When you move the mouse into or out of a connection window, the colors in the non-focused window may start to flash. This is a known limitation when using the X Windows System with PseudoColor displays. If possible, use a higher color depth for the affected connection.

I experience rapid color changes with TrueColor displays

Users have the option of using 256 colors when connecting to a server. This option assumes that the video hardware has palette support to enable applications to rapidly change the palate colors to produce animated displays.

TrueColor displays have no facility to emulate the ability to produce animations by rapidly changing the palette. Software emulation of this facility is expensive both in terms of time and network traffic. To reduce this cost, Receiver buffers rapid palette changes, and updates the real palette only every few seconds.

Japanese characters display incorrectly on my screen

Receiver uses EUC-JP or UTF-8 character encoding for Japanese characters, while the server uses SJIS character encoding. Receiver does not translate between these character sets. This can cause problems displaying files that are saved on the server and viewed locally, or saved locally and viewed on the server. This issue also affects Japanese characters in parameters used in extended parameter passing.

I want to make a session that spans multiple monitors

Full-screen sessions span all monitors by default, but a command-line multi-monitor display control option, -span, is also available. It allows full-screen sessions to span multiple monitors.

Important: -span has no effect on Seamless or normal windowed sessions (including those in maximized windows).

The - span option has the following format:

-span [h][o][a|mon1[,mon2[,mon3,mon4]]]

If h is specified, a list of monitors is printed on stdout. And if that is the whole option value, wfica then exits.

If o is specified, the session window will have the override-redirect redirect attribute.

Caution: The use of this option value is not recommended. It is intended as a last resort, for use with uncooperative window managers. The session window will not be visible to the window manager, will not have an icon and can not be restacked. It can be removed only by ending the session.

If a is specified, Receiver tries to create a session that covers all monitors.

Receiver assumes that the rest of the -span option value is a list of monitor numbers. A single value selects a specific monitor, two values select monitors at the top-left and bottom-right corners of the required area, four specify monitors at the top, bottom, left and right edges of the area.

Assuming o was not specified, wfica will use the _NET_WM_FULLSCREEN_MONITORS message to request an appropriate window layout from the window manager, if it is supported. Otherwise, it will use size and position hints to request the desired layout.

The following command can be used to test for window manager support:

xprop -root | grep _NET_WM_FULLSCREEN_MONITORS

If there is no output, there is no support. If there is no support, you may need an override-redirect window. You can set up an override-redirect window using -span o.

To make a session that spans multiple monitors from the command line:

  1. At a command prompt, type: /opt/Citrix/ICAClient/wfica -span h A list of the numbers of the monitors currently connected to the user device is printed to stdout and wfica exits.
  2. Make a note of these monitor numbers.
  3. At a command prompt, type: /opt/Citrix/ICAClient/wfica -span [w[,x[,y,z]]] where w, x, y and z are monitor numbers obtained in step 1 above and the single value w, specifies a specific monitor, two values w and x specify monitors at the top-left and bottom-right corners of the required area, and four values w, x, y and z specify monitors at the top, bottom, left and right edges of the area.
    Important: You must define the WFICA_OPTS variable before starting selfservice or connecting to the Web interface through a browser. To do this, edit your profile file, normally found at $HOME/.bash_profile or $HOME/.profile, adding a line to define the WFICA_OPTS variable. For example:
     export WFICA_OPTS="-span a" 
    Note that this change affects both XenApp and XenDesktop sessions.

I cannot escape from a full-screen session to use local applications or another session

This occurs because the client-side system UI is hidden and the Keyboard Transparency feature disables the usual keyboard command, for example Alt+Tab, sending the command to the server instead.

To work around this, use CTRL+F2 to turn off the Keyboard Transparency feature temporarily until the focus next returns to the session window. An alternative workaround is to set TransparentKeyPassthrough to No in $ICAROOT/config/module.ini. This disables the Keyboard Transparency feature, however you may have to override the ICA file by adding this setting in the All_regions.ini file.