Changeset 77451 in vbox for trunk/src/VBox/Main/idl

Timestamp:

Feb 25, 2019 6:32:10 AM (6 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

129022

Message:

Devices/Graphics, pdm, Main: add out-of-range to host-side pointer reporting.
bugref:9376: Complete hardware cursor implementation in VMSVGA
The front-end can now send an out-of-range pointer event to say that the
pointer is outside of all guest windows. This can be useful when the cursor
is being drawn in software, as in this case it makes sense to hide it
altogether. The event is not yet passed down to the guest. Out-of-range,
like the already existing invalid data event (-1, -1) is passed as special
pointer co-ordinate values to avoid breaking API interfaces if this is
back-ported. A future change, not to be back-ported, will change the API to
get rid of the special values and do this cleanly.

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (1 diff)

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -17700 +17700 @@
         These coordinates are expressed in pixels and
         start from <tt>[1,1]</tt> which corresponds to the top left
-        corner of the virtual display.
+        corner of the virtual display.  The values <tt>[-1,-1]</tt> and
+        <tt>[0x7fffffff,0x7fffffff]</tt> have special meanings as
+        respectively "no data" (to signal that the host wishes to report
+        absolute pointer data in future) and "out of range" (the host
+        pointer is outside of all guest windows).
 
         <result name="E_ACCESSDENIED">