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

Timestamp:

Aug 26, 2024 6:45:15 PM (9 months ago)

Author:

vboxsync

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

164584

Message:

Main: Added API for querying graphics features (2D Video / 3D Acceleration) of a specific graphics controller for a given platform and revamped the graphics controller attributes for 2D / 3D setters/getters to also use the new graphics features enumeration. Also, the system properties also now contain a dedicated API to query for graphics features (very basic for now, needs to be stuffed out). See SDK changelog for details. Added validation code when setting a specific graphics feature (which we never did before). bugref:10749

File:

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

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

@@ -5813 +5813 @@
   <interface
     name="IGraphicsAdapter" extends="$unknown"
-    uuid="f692806f-febe-4049-b476-1292a8e45b09"
+    uuid="13ee6eb4-06fe-406b-ad69-f6e08b0587a3"
     wsmap="managed"
     rest="managed"
@@ -5829 +5829 @@
     <attribute name="VRAMSize" type="unsigned long">
       <desc>Video memory size in megabytes.</desc>
-    </attribute>
-
-    <attribute name="accelerate3DEnabled" type="boolean" default="false">
-      <desc>
-        This setting determines whether VirtualBox allows this machine to make
-        use of the 3D graphics support available on the host.</desc>
-    </attribute>
-
-    <attribute name="accelerate2DVideoEnabled" type="boolean" default="false">
-      <desc>
-        This setting determines whether VirtualBox allows this machine to make
-        use of the 2D video acceleration support available on the host.</desc>
     </attribute>
 
@@ -5852 +5840 @@
       </desc>
     </attribute>
+
+    <method name="setFeature">
+      <desc>Sets a graphics controller feature.</desc>
+      <param name="feature" type="GraphicsFeature" dir="in">
+        <desc>
+          Graphics controller feature to set.
+        </desc>
+      </param>
+      <param name="enabled" type="boolean" dir="in">
+        <desc>
+          Whether to enable or disable the feature.
+        </desc>
+      </param>
+    </method>
+
+    <method name="isFeatureEnabled" const="yes">
+      <desc>Returns whether a particular feature is enabled for this adapter or not.</desc>
+      <param name="feature" type="GraphicsFeature" dir="in">
+        <desc>Feature to check for.</desc>
+      </param>
+      <param name="enabled" type="boolean" dir="return">
+        <desc>@c true if the feature is enabled, @c false if not.</desc>
+      </param>
+    </method>
 
   </interface>
@@ -6825 +6837 @@
     <const name="QemuRamFB" value="4">
       <desc>QEMU RAM based framebuffer based device.</desc>
+    </const>
+  </enum>
+
+  <enum
+    name="GraphicsFeature"
+    uuid="5cd900a5-ec77-4a08-8f8d-c0a36f462a7c"
+    >
+    <desc>Graphics features.</desc>
+    <const name="None"          value="0">
+      <desc>No feature specified, invalid.</desc>
+    </const>
+    <const name="Acceleration2DVideo" value="1">
+      <desc>2D video acceleration.</desc>
+    </const>
+    <const name="Acceleration3D" value="2">
+      <desc>3D acceleration.</desc>
     </const>
   </enum>
@@ -12881 +12909 @@
     name="IPlatformProperties"
     extends="$unknown"
-    uuid="a23502e4-cc54-490f-a344-c8ca8813f906"
+    uuid="5bae19d0-ca40-4ca2-a485-c8065190bbe5"
     wsmap="managed"
     rest="managed"
@@ -12960 +12988 @@
     </attribute>
 
-    <attribute name="supportedGraphicsControllerTypes" type="GraphicsControllerType" safearray="yes" readonly="yes">
+    <attribute name="supportedGfxControllerTypes" type="GraphicsControllerType" safearray="yes" readonly="yes">
       <desc>
         Returns an array of officially supported values for enum <link to="GraphicsControllerType"/>,
@@ -13169 +13197 @@
     </method>
 
+    <method name="getSupportedGfxFeaturesForType">
+      <desc>
+        Returns the supported features of a given graphics controller.
+      </desc>
+
+      <param name="graphicsControllerType" type="GraphicsControllerType" dir="in">
+        <desc>Graphics controller type to return features for.</desc>
+      </param>
+
+      <param name="supportedControllerFeatures" type="GraphicsFeature" safearray="yes" dir="return">
+        <desc>The graphics controller features which are valid.</desc>
+      </param>
+    </method>
+
     <method name="getDeviceTypesForStorageBus">
       <desc>Returns list of all the supported device types
@@ -13265 +13307 @@
     name="ISystemProperties"
     extends="$unknown"
-    uuid="c61e666e-34ab-403a-8160-78bd4512ca86"
+    uuid="925084b0-625f-422f-a67d-0ede1880a56c"
     wsmap="managed"
     rest="managed"
@@ -13630 +13672 @@
       <desc>
         Returns an array of officially supported values for enum <link to="ExportOptions"/>,
+        in the sense of what is e.g. worth offering in the VirtualBox GUI.
+      </desc>
+    </attribute>
+
+    <attribute name="supportedGraphicsFeatures" type="GraphicsFeature" safearray="yes" readonly="yes">
+      <desc>
+        Returns an array of officially supported values for enum <link to="GraphicsFeature"/>,
         in the sense of what is e.g. worth offering in the VirtualBox GUI.
       </desc>