Top | ![]() |
![]() |
![]() |
![]() |
Graphics compatibility checkGraphics compatibility check — Get information about system's graphics capabilities |
int | exit-status | Read / Write / Construct Only |
GPtrArray * | graphics-devices | Read / Write / Construct Only |
SrtGraphicsIssues | issues | Read / Write / Construct Only |
SrtGraphicsLibraryVendor | library-vendor | Read / Write / Construct Only |
char * | messages | Read / Write / Construct Only |
char * | multiarch-tuple | Read / Write / Construct Only |
char * | renderer-string | Read / Write / Construct Only |
SrtRenderingInterface | rendering-interface | Read / Write / Construct Only |
int | terminating-signal | Read / Write / Construct Only |
char * | version-string | Read / Write / Construct Only |
SrtWindowSystem | window-system | Read / Write / Construct Only |
char * | api-version | Read / Write / Construct Only |
char * | device-id | Read / Write / Construct Only |
char * | driver-name | Read / Write / Construct Only |
char * | driver-version | Read / Write / Construct Only |
SrtGraphicsIssues | issues | Read / Write / Construct Only |
char * | name | Read / Write / Construct Only |
SrtVkPhysicalDeviceType | type | Read / Write / Construct Only |
char * | vendor-id | Read / Write / Construct Only |
guint | vulkan-driver-id | Read / Write / Construct Only |
#define | SRT_GRAPHICS_ISSUES_INTERNAL_ERROR |
enum | SrtGraphicsIssues |
enum | SrtGraphicsLibraryVendor |
enum | SrtLoadableIssues |
enum | SrtWindowSystem |
#define | SRT_N_WINDOW_SYSTEMS |
enum | SrtRenderingInterface |
#define | SRT_N_RENDERING_INTERFACES |
enum | SrtVkPhysicalDeviceType |
GEnum ├── SrtGraphicsLibraryVendor ├── SrtRenderingInterface ├── SrtVkPhysicalDeviceType ╰── SrtWindowSystem GFlags ├── SrtGraphicsIssues ╰── SrtLoadableIssues GObject ├── SrtGraphics ╰── SrtGraphicsDevice
SrtGraphics is an opaque object representing a graphics capabilities.
This is a reference-counted object: use g_object_ref()
and
g_object_unref()
to manage its lifecycle.
SrtGraphicsDevice is an opaque object representing a single, physical or
virtual, GPU.
This is a reference-counted object: use g_object_ref()
and
g_object_unref()
to manage its lifecycle.
SrtGraphicsIssues
srt_graphics_device_get_issues (SrtGraphicsDevice *self
);
Return the problems found when testing self
.
const char *
srt_graphics_device_get_name (SrtGraphicsDevice *self
);
Return the device name of self
, or NULL
if it's not known.
Returns (nullable): A string indicating the device name.
const char *
srt_graphics_device_get_api_version (SrtGraphicsDevice *self
);
Return the API version used by self
, or NULL
if it's not known.
Returns (nullable): A string indicating the API version.
guint32
srt_graphics_device_get_vulkan_driver_id
(SrtGraphicsDevice *self
);
Return the VkDriverId
of the driver used by self
, or 0 if unknown.
const char *
srt_graphics_device_get_driver_name (SrtGraphicsDevice *self
);
Return the name of the driver used by self
, or NULL
if it's not known.
Returns (nullable): A string indicating the driver version.
const char *
srt_graphics_device_get_driver_version
(SrtGraphicsDevice *self
);
Return the driver version used by self
, or NULL
if it's not known.
Returns (nullable): A string indicating the driver version.
const char *
srt_graphics_device_get_vendor_id (SrtGraphicsDevice *self
);
Return the vendor ID of self
, or NULL
if it's not known.
Returns (nullable): A string indicating the vendor ID.
const char *
srt_graphics_device_get_device_id (SrtGraphicsDevice *self
);
Return the device ID of self
, or NULL
if it's not known.
Returns (nullable): A string indicating the device ID.
const char *
srt_graphics_device_get_messages (SrtGraphicsDevice *self
);
Return the diagnostic messages produced while checking self
device
drawing capabilities.
A string, which must not be freed,
or NULL
if there were no diagnostic messages.
[nullable][transfer none]
SrtVkPhysicalDeviceType
srt_graphics_device_get_device_type (SrtGraphicsDevice *self
);
Return the self
device type
const char *
srt_graphics_get_multiarch_tuple (SrtGraphics *self
);
Return the multiarch tuple representing the ABI of self
.
SrtGraphicsIssues
srt_graphics_get_issues (SrtGraphics *self
);
Return the problems found when loading self
.
gboolean srt_graphics_library_is_vendor_neutral (SrtGraphics *self
,SrtGraphicsLibraryVendor *vendor_out
);
Return whether the entry-point library for this graphics stack is vendor-neutral or vendor-specific.
Vulkan, VDPAU and VA-API are always vendor-neutral, so this function will always return TRUE
for them.
self |
A SrtGraphics object |
|
vendor_out |
Used to return a SrtGraphicsLibraryVendor object representing whether the entry-point library for this graphics stack is vendor-neutral or vendor-specific, and if vendor-specific, attempt to guess the vendor. |
[out][optional] |
SrtWindowSystem
srt_graphics_get_window_system (SrtGraphics *self
);
Return the window system tested on the given graphics object.
SrtRenderingInterface
srt_graphics_get_rendering_interface (SrtGraphics *self
);
Return the rendering interface which was tested on the given graphics object.
const char *
srt_graphics_get_version_string (SrtGraphics *self
);
Return the version string found when testing the given graphics.
const char *
srt_graphics_get_renderer_string (SrtGraphics *self
);
Return the renderer string found when testing the given graphics.
const char *
srt_graphics_get_messages (SrtGraphics *self
);
Return the diagnostic messages produced while checking this graphics stack, if any.
A string, which must not be freed,
or NULL
if there were no diagnostic messages.
[nullable][transfer none]
GList *
srt_graphics_get_devices (SrtGraphics *self
);
Return the list of graphics devices that have been found.
gchar *
srt_graphics_dup_parameters_string (SrtGraphics *self
);
Return a string indicating which window system and rendering interface were tested, for example "glx/gl" for "desktop" OpenGL on X11 via GLX, or "egl_x11/glesv2" for OpenGLES v2 on X11 via the Khronos Native Platform Graphics Interface (EGL).
int
srt_graphics_get_exit_status (SrtGraphics *self
);
Return the exit status of helpers when testing the given graphics.
int
srt_graphics_get_terminating_signal (SrtGraphics *self
);
Return the terminating signal used to terminate the helper if any.
#define SRT_GRAPHICS_ISSUES_INTERNAL_ERROR SRT_GRAPHICS_ISSUES_UNKNOWN
A bitfield with flags representing problems with the graphics stack, or
SRT_GRAPHICS_ISSUES_NONE
(which is numerically zero) if no problems
were detected.
In general, more bits set means more problems.
There are no problems |
||
An internal error occurred while checking graphics, or an unknown issue flag was encountered while reading a report |
||
Unable to load the necessary libraries and create rendering context |
||
The graphics renderer is software based |
||
The check for this graphics stack took too long to run and was terminated. This is likely to indicate that the graphics stack causes the process using it to hang. |
||
The drawing test failed |
A bitfield with flags representing problems with the loadables, or
SRT_LOADABLE_ISSUES_NONE
(which is numerically zero) if no problems
were detected.
In general, more bits set means more problems.
There are no problems |
||
An internal error occurred while checking the loadable, or an unknown issue flag was encountered while reading a report |
||
The API version of the JSON file is not supported yet |
||
Unable to parse the JSON file describing the loadable or unable to load the library |
||
This loadable, and another one, have a library path that points to the same library, and, if available, also the same name |
||
This driver is not fully compliant with the API spec, for example a Vulkan 1.3 portability driver |
These enums have been taken from the VkPhysicalDeviceType Vulkan specs. Please keep them in sync. https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VkPhysicalDeviceType.html
The GPU does not match any other available types |
||
The GPU is typically one embedded in or tightly coupled with the host |
||
The GPU is typically a separate processor connected to the host via an interlink. |
||
The GPU is typically a virtual node in a virtualization environment |
||
The GPU is typically running on the same processors as the host (software rendering such as llvmpipe) |
“exit-status”
property “exit-status” int
Exit status of helper(s) executed. 0 on success, positive on unsuccessful exit(), -1 if killed by a signal or not run at all.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Allowed values: >= -1
Default value: 0
“graphics-devices”
property“graphics-devices” GPtrArray *
List of #SrtGraphicsDevice, representing the graphical cards.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
“issues”
property“issues” SrtGraphicsIssues
Problems with the graphics stack.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
“library-vendor”
property“library-vendor” SrtGraphicsLibraryVendor
Which library vendor is currently in use.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Default value: SRT_GRAPHICS_LIBRARY_VENDOR_UNKNOWN
“messages”
property “messages” char *
Diagnostic messages produced while checking this graphics stack.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Default value: NULL
“multiarch-tuple”
property “multiarch-tuple” char *
Which multiarch tuple we are checking, for example x86_64-linux-gnu.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Default value: NULL
“renderer-string”
property “renderer-string” char *
Which renderer was found by checking.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Default value: NULL
“rendering-interface”
property“rendering-interface” SrtRenderingInterface
Which rendering interface we are checking.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Default value: SRT_RENDERING_INTERFACE_GL
“terminating-signal”
property “terminating-signal” int
Signal used to terminate helper process if any, 0 otherwise.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Allowed values: >= 0
Default value: 0
“version-string”
property “version-string” char *
Which version of graphics renderer was found from check.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Default value: NULL
“window-system”
property“window-system” SrtWindowSystem
Which window system we are checking.
Owner: SrtGraphics
Flags: Read / Write / Construct Only
Default value: SRT_WINDOW_SYSTEM_GLX
“api-version”
property “api-version” char *
Which API version is in use.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: NULL
“device-id”
property “device-id” char *
The device ID of the device.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: NULL
“driver-name”
property “driver-name” char *
Which device driver is in use.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: NULL
“driver-version”
property “driver-version” char *
Which driver version is in use.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: NULL
“issues”
property“issues” SrtGraphicsIssues
Problems with the graphics device card.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
“name”
property “name” char *
Which name the device has.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: NULL
“type”
property“type” SrtVkPhysicalDeviceType
Which type the device is.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: SRT_VK_PHYSICAL_DEVICE_TYPE_OTHER
“vendor-id”
property “vendor-id” char *
The vendor ID of the device.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: NULL
“vulkan-driver-id”
property“vulkan-driver-id” guint
Which device driver is in use, numerically equal to a VkDriverId.
Owner: SrtGraphicsDevice
Flags: Read / Write / Construct Only
Default value: 0