Interface GPURequestAdapterOptions
forceFallbackAdapter?: boolean;
powerPreference?: GPUPowerPreference;
}
Index
Properties
Properties
Optional
forceFallbackAdapter
Optional
powerPreference
Optionally provides a hint indicating what class of adapter should be selected from
the system's available adapters.
The value of this hint may influence which adapter is chosen, but it must not
influence whether an adapter is returned or not.
Note:
The primary utility of this hint is to influence which GPU is used in a multi-GPU system.
For instance, some laptops have a low-power integrated GPU and a high-performance
discrete GPU. This hint may also affect the power configuration of the selected GPU to
match the requested power preference.
Note:
Depending on the exact hardware configuration, such as battery status and attached displays
or removable GPUs, the user agent may select different adapters given the same power
preference.
Typically, given the same hardware configuration and state and
powerPreference
, the user agent is likely to select the same adapter.
When set to
true
indicates that only a fallback adapter may be returned. If the user agent does not support a fallback adapter, will cause GPU#requestAdapter to resolve tonull
. Note: GPU#requestAdapter may still return a fallback adapter if GPURequestAdapterOptions#forceFallbackAdapter is set tofalse
and either no other appropriate adapter is available or the user agent chooses to return a fallback adapter. Developers that wish to prevent their applications from running on fallback adapters should check the GPUAdapter.GPUAdapter#isFallbackAdapter attribute prior to requesting a GPUDevice.