-
Notifications
You must be signed in to change notification settings - Fork 19
/
Copy path00readme.txt
82 lines (46 loc) · 3.06 KB
/
00readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
DisplayX Virtual Display Software
=================================
Licence
-------
DisplayX may be used freely for research and academic work.
However, the DisplayX software remains the Copyright of tSoniq. DisplayX may not be used in a commercial
application without prior approval.
For more information contact [email protected] or visit http://tsoniq.com.
Description
-----------
DisplayX is a virtual display driver for MacOSX, offering the following capabilities:
- dynamic display configuration and control from the application level
- high performance data capture via Quartz display streaming
- supports MacOSX 10.6 or later
- integrated application installer/uninstaller
- supports multiple display units (via build option)
The sample application provides a window that shows the content of a virtual display in real-time. To test,
run the application and click 'Connect' to connect the virtual display and shows its contents. Once connected,
the display resolution and arrangement/mirroring can be configured via System Preferences exactly as for a
conventional 2nd physical display.
Please note that by default Quartz will select the highest permitted resolution when the display is connected.
If this is too high to read successfully (for example, when trying to use System Preferences to set the display
resolution), the resolution can be reset to a default level via the 'Reset Resolution' display command.
The c++ class DisplayXFBInterface provides the application interface to the display driver. Please see the
doxygen markup for a description of the available methods. Driver configuration and state structures are defined
in DisplayXFBShared.h.
Driver Installation and Removal
-------------------------------
The demonstration application includes an example installer and uninstaller. It will prompt to install
and restart the computer if it contains a newer driver than is currently installed.
To uninstall both driver and application, select "Uninstall..." from the application menu.
Building and Code-signing
-------------------------
The supplied project requires Xcode 5.1 and can be used on MacOSX 10.8 or later.
The "DXDemo" target in the project will build both the kernel extension and the demonstration application.
For earlier OS support the Quartz DisplayStream API used by the demonstration application should be replaced with
alternative code that uses direct access to the framebuffer memory. The driver and installation process support
MacOSX 10.6 or later.
The kernel extension can be code-signed by entering the SHA1 hash for the appropriate certificate
in DisplayX.xcconfig. Without an appropriate certificate the extension will cause security warnings on
installation and any system reboot. The application code-signing can be made in the standard way.
The virtual display count and per-display VRAM can also be configured in DisplayX.xcconfig.
About tSoniq
------------
tSoniq is a Barcelona based software consultancy specialising in MacOS and iOS application and driver development.
For more information on what we offer, please visit http://tsoniq.com.