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

Timestamp:

Jul 16, 2013 3:27:24 AM (12 years ago)

Author:

vboxsync

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

87278

Message:

Devices/Input: most of the Main plumbing for guest multi-touch.

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (4 diffs)

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

@@ -14297 +14297 @@
     </attribute>
 
+    <attribute name="multiTouchSupported" type="boolean" readonly="yes">
+      <desc>
+        Whether the guest OS supports multi-touch event reporting.
+        <note>
+          You can use the <link to="IMouseCapabilityChangedEvent"/>
+          event to be instantly informed about changes of this attribute
+          during virtual machine execution.
+        </note>
+        <see><link to="#putMouseEvent"/></see>
+      </desc>
+    </attribute>
+
     <attribute name="needsHostCursor" type="boolean" readonly="yes">
       <desc>
@@ -20214 +20226 @@
   </interface>
 
+  <enum
+    name="GuestMouseEventMode"
+    uuid="ef172985-7e36-4297-95be-e46396968d66"
+    >
+
+    <desc>
+      The mode (relative, absolute, multi-touch) of a pointer event.
+      TODO: a clear pattern seems to be emerging that we should usually have
+      multiple input devices active for different types of reporting, so we
+      should really have different event types for relative (including wheel),
+      absolute (not including wheel) and multi-touch events.
+    </desc>
+
+    <const name="Relative" value="0">
+      <desc>
+        Relative event.
+      </desc>
+    </const>
+
+    <const name="Absolute" value="1">
+      <desc>
+        Absolute event.
+      </desc>
+    </const>
+
+    <const name="MultiTouch" value="2">
+      <desc>
+        Multi-touch event.
+      </desc>
+    </const>
+  </enum>
+
   <interface
     name="IGuestMouseEvent" extends="IReusableEvent"
@@ -20223 +20267 @@
     </desc>
 
-    <attribute name="absolute" type="boolean" readonly="yes">
-      <desc>
-        If this event is relative or absolute.
+    <attribute name="mode" type="GuestMouseEventMode" readonly="yes">
+      <desc>
+        If this event is relative, absolute or multi-touch.
       </desc>
     </attribute>
@@ -20253 +20297 @@
     </attribute>
 
+    <attribute name="contact" type="long" readonly="yes">
+      <desc>
+        The multi-touch contact identifier.  This remains valid as long as a
+        touch is in progress and can and should be re-used after a touch has
+        terminated (see @a buttons).
+      </desc>
+    </attribute>
+
     <attribute name="buttons" type="long" readonly="yes">
       <desc>
-        Button state bitmask.
+        Button state bitmask.  Multi-touch events should have the first bit set
+        as long as the touch is in progress and terminate with an event with no
+        bits set.
       </desc>
     </attribute>