Skip to content

GraphicsAPI reference

Class GraphicsCapabilityException

Namespace: MicroEngine.Graphics.Devices
Assembly: MicroEngine.Graphics.dll
Guide: The graphics device

The one typed error for a missing capability: names the operation, the device and what it lacks. Thrown at creation or recording time, never deferred to a draw.

C#
public sealed class GraphicsCapabilityException : NotSupportedException, ISerializable

Inheritance

object ← Exception ← SystemException ← NotSupportedException ← GraphicsCapabilityException

Implements

ISerializable

Inherited Members

Exception.GetBaseException(), Exception.ToString(), Exception.GetType(), Exception.TargetSite, Exception.Message, Exception.Data, Exception.InnerException, Exception.HelpLink, Exception.Source, Exception.HResult, Exception.StackTrace, object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Constructors

GraphicsCapabilityException(string, string, GraphicsFeatures, string?)

Creates the error.

C#
public GraphicsCapabilityException(string operation, string device, GraphicsFeatures missing, string? requirement = null)

Parameters

operation string

The operation, e.g. “CreatePipeline(depth)”.

device string

The backend name (Backend).

missing GraphicsFeatures

The undeclared feature, or None when the requirement is not a feature (a format, shader format or present mode: see requirement).

requirement string?

What exactly is missing, e.g. “TextureFormat.D24UnormS8 as DepthStencil”.

Properties

Device

The backend name.

C#
public string Device { get; }

Property Value

string

Missing

The undeclared feature, or None for a non-feature requirement.

C#
public GraphicsFeatures Missing { get; }

Property Value

GraphicsFeatures

Operation

The refused operation.

C#
public string Operation { get; }

Property Value

string

Requirement

The non-feature requirement (format and usage, shader format, present mode), when there is one.

C#
public string? Requirement { get; }

Property Value

string?