GUACAMOLE-288: Add support for multi-monitor connections on RDP.

[corentin-soriano]

Anyone who wishes can test and feedback will be appreciated!

Requires using this branch on guacamole-server: apache/guacamole-server#560

• Display each monitor in separate window.
• Secondary windows automatically resize to the dimensions of the main window.
• Display user consent button to switch all window on fullscreen when the main window fullscreen is enabled.
• All monitors are on the size of the main window and ordered from left to right (left monitor is the primary).
• Handle CTRL+ALT+SHIFT in secondary monitors (open the menu on the main window).
• Close secondary monitor on client disconnect.
• Admin can limit the usage of multi-monitors on each connection.
• Drag and drop between windows without having to release the click and resume on the other side.

Admin settings:

Add new monitor:

Multiple monitors opened:

[stephzero1]

wow this is huge! i will test asap

[neandrake]

Exciting. Could you write up the technical implementation here? Here's what I gather from looking at the changes here and in the guacamole-server pull request.

• It looks like all the drawing instructions will now set an optional x-offset for the base/default layer. All other layers are relative to the base layer which is why they don't need the x-offset (correct?).
• A new optional parameter is added to the size instruction for indicating number of monitors.
• A new optional parameter for maximum number of secondary monitors is added to the connection parameters.

That leads me to understand,

1. There is a constraint that monitors must be laid out horizontally and be the same dimension.
2. Each window/tab/connection to the server is receiving graphical updates for all monitors but only displaying the subset for its selected monitor.

Could you clarify if that is correct? If so, how is each tab specifying which monitor/offset to use?

[corentin-soriano]

Exciting. Could you write up the technical implementation here? Here's what I gather from looking at the changes here and in the guacamole-server pull request.

• It looks like all the drawing instructions will now set an optional x-offset for the base/default layer. All other layers are relative to the base layer which is why they don't need the x-offset (correct?).

Only the main layer is affected by the offset because the others (eg: mouse) are relative to the browser window instead of the remote screen.

• A new optional parameter is added to the size instruction for indicating number of monitors.

With FreeRDP, the number of monitors is set via the display update channel (the same as for the dimensions). The setting is optional for backward compatibility.

• A new optional parameter for maximum number of secondary monitors is added to the connection parameters.

You can define it in your user-mapping.xml or in guacamole settings with a jdbc extension:

<param name="secondary-monitors">3</param>

In the example above I can open 3 additional monitors and then the button is grayed out (guacd would ignore the instruction):

That leads me to understand,

1. There is a constraint that monitors must be laid out horizontally and be the same dimension.

For now, all monitors have the same dimensions but there is client-side scaling if one of the windows needs to have different dimensions:

2. Each window/tab/connection to the server is receiving graphical updates for all monitors but only displaying the subset for its selected monitor.

Exactly, each window displays its visible part according to its x-offset. Each time a monitor is added/removed, an instruction is sent by sendMonitorsInfos() to all the windows to know their new position (allow to close a middle window).
The x-offset corresponds to the position * width of the monitor.

Could you clarify if that is correct? If so, how is each tab specifying which monitor/offset to use?

Secondary windows knows their position thanks to an ID defined in the route:

In the screenshot above:

• Main window is at the position 0 => x-offset = 0*width = 0 px
• monitor with ID 3 is at the position 1 => x-offset = 1*width.

Does this answer your questions?