tools: Add intel-virtual-output to extend the local desktop with remote outputs

Based on the original implementation (hybrid-screenclone) by
Tomáš Janoušek, and Bumblebee integration by Kevin Puetz.

intel-virtual-output utilizes local VirtualHeads to present a contiguous
desktop to the local display manager, but maps the drawing on those
outputs to the remote display, and provides bidirectional RandR proxy so
that you can resize the remote display and configure it within your
desktop. The remote display should also send hotplug events back to the
local desktop, for reconfiguration on the fly.

Ideally the remote display is a discrete GPU on the same host so that we
can use local Shared Memory transport and avoid sending data over the
wire (though it will work in that setup). Ideally you would have userptr
support to provide zero-copy rendering between the GPUs, or have dma-buf
(in which case you would be using PRIME). For remote rendering, no
compression is done so this fares worse than VNC.

Signed-off-by: Chris Wilson <chris@chris-wilson.co.uk>

Makefile.am

@@ -20,7 +20,7 @@
 
 ACLOCAL_AMFLAGS = ${ACLOCAL_FLAGS} -I m4
 
-SUBDIRS = man xvmc src
+SUBDIRS = man xvmc src tools
 
 MAINTAINERCLEANFILES = ChangeLog INSTALL
 

configure.ac

@@ -166,6 +166,8 @@ fi
 PKG_CHECK_MODULES(X11, [x11 xrender xext pixman-1], [x11=yes], [x11=no])
 AM_CONDITIONAL(HAVE_X11, test x$x11 = xyes)
 
+PKG_CHECK_MODULES(TOOL, [xrandr xdamage xfixes xcursor xtst xext x11], [tools=yes], [tools=no])
+
 AH_TOP([#include "xorg-server.h"])
 
 # Define a configure option for an alternate module directory
@@ -574,6 +576,7 @@ AC_CONFIG_FILES([
                 xvmc/shader/mc/Makefile
                 xvmc/shader/vld/Makefile
 		test/Makefile
+		tools/Makefile
 ])
 AC_OUTPUT
 

test/Makefile.am

@@ -44,5 +44,5 @@ vsync.avi: mkvsync.sh
 clean-vsync-avi:
 	rm -rf vsync.avi .build.tmp
 
-EXTRA_DIST = README mkvsync.sh tearing.mp4
+EXTRA_DIST = README mkvsync.sh tearing.mp4 virtual.conf
 clean-local: clean-vsync-avi

test/virtual.conf

@@ -0,0 +1,36 @@
+Section "Device"
+	Identifier "Device0"
+	Driver "intel"
+	Option "ZaphodHeads" "LVDS1"
+	Option "VirtualHeads" "1"
+	BusID "PCI:0:2:0"
+	Screen 0
+EndSection
+
+Section "Device"
+	Identifier "Device1"
+	Driver "intel"
+	Option "ZaphodHeads" "HDMI1"
+	BusID "PCI:0:2:0"
+	Screen 1
+EndSection
+
+Section "Screen"
+	Identifier "Screen0"
+	Device "Device0"
+EndSection
+
+Section "Screen"
+	Identifier "Screen1"
+	Device "Device1"
+EndSection
+
+Section "ServerFlags"
+	Option "AutoAddGPU" "False"
+EndSection
+
+Section "ServerLayout"
+	Identifier "ServerLayout0"
+	Screen 0 "Screen0" 0 0
+	Screen 1 "Screen1" 0 0
+EndSection

tools/.gitignore

@@ -0,0 +1 @@
+intel-virtual-output

tools/Makefile.am

@@ -0,0 +1,44 @@
+#  Copyright 2005 Adam Jackson.
+#
+#  Permission is hereby granted, free of charge, to any person obtaining a
+#  copy of this software and associated documentation files (the "Software"),
+#  to deal in the Software without restriction, including without limitation
+#  on the rights to use, copy, modify, merge, publish, distribute, sub
+#  license, and/or sell copies of the Software, and to permit persons to whom
+#  the Software is furnished to do so, subject to the following conditions:
+#
+#  The above copyright notice and this permission notice (including the next
+#  paragraph) shall be included in all copies or substantial portions of the
+#  Software.
+#
+#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+#  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
+#  ADAM JACKSON BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+#  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+#  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+AM_CFLAGS = \
+	@CWARNFLAGS@ \
+	@TOOL_CFLAGS@ \
+	@NOWARNFLAGS@ \
+	$(NULL)
+
+bin_PROGRAMS = intel-virtual-output
+
+intel_virtual_output_SOURCES = \
+	virtual.c \
+	$(NULL)
+
+intel_virtual_output_LDADD = @TOOL_LIBS@
+
+drivermandir = $(DRIVER_MAN_DIR)
+driverman_DATA = intel-virtual-output.$(DRIVER_MAN_SUFFIX)
+
+EXTRA_DIST = intel-virtual-output.man
+CLEANFILES = $(driverman_DATA)
+
+# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure
+SUFFIXES = .$(DRIVER_MAN_SUFFIX) .man
+.man.$(DRIVER_MAN_SUFFIX):
+	$(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@

tools/intel-virtual-output.man

@@ -0,0 +1,34 @@
+.\" shorthand for double quote that works everywhere.
+.ds q \N'34'
+.TH intel-virtual-output  __drivermansuffix__ __vendorversion__
+.SH NAME
+intel-virtual-output \- Utility for connecting the Integrated Intel GPU to discrete outputs
+.SH SYNOPSIS
+.nf
+.B "Section \*qDevice\*q"
+.BI "  Identifier \*q"  devname \*q
+.B  "  Driver \*qintel\*q"
+.B  "  Option \*qVirtualHeads\*q" \*q<number>\*q
+\ \ ...
+.B EndSection
+.B ""
+.B "intel-virtual-output [<remote display>] <output name>..."
+.fi
+.SH DESCRIPTION
+.B intel-virtual-output
+is a utility for Intel integrated graphics chipsets on hybrid systems.
+The tool connects pre-allocated VirtualHeads to a remote output, allowing
+the primary display to extend onto the remote outputs.
+
+.SH REPORTING BUGS
+
+The xf86-video-intel driver is part of the X.Org and Freedesktop.org
+umbrella projects.  Details on bug reporting can be found at
+http://www.intellinuxgraphics.org/how_to_report_bug.html.  Mailing
+lists are also commonly used to report experiences and ask questions
+about configuration and other topics.  See lists.freedesktop.org for
+more information (the xorg@lists.freedesktop.org mailing list is the
+most appropriate place to ask X.Org and driver related questions).
+
+.SH "SEE ALSO"
+intel(__drivermansuffix__), __xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)