接口 WebGpuFlags

interface WebGpuFlags {
    adapter: unknown;
    forceFallbackAdapter?: boolean;
    powerPreference?: "high-performance" | "low-power";
    profiling: {
        mode?: "default" | "off";
        ondata?: ((data) => void);
    };
    profilingMode?: "default" | "off";
    validateInputContent?: boolean;
    device: Promise<unknown>;
}

属性

adapter forceFallbackAdapter? powerPreference? profiling profilingMode? validateInputContent?

访问器

device

属性

adapter

adapter: unknown

设置或获取 WebGPU 的适配器。

设置此属性仅在创建第一个 WebGPU 推理会话之前有效。该值将用作底层 WebGPU 后端创建 GPU 设备的 GPU 适配器。

如果未设置此属性，则在创建第一个 WebGPU 推理会话后，可以通过 getter 获取此属性。该值将是底层 WebGPU 后端创建的 GPU 适配器。

在 TypeScript 中使用时，此属性的类型是 "@webgpu/types" 中定义的 GPUAdapter。

已废弃

不再推荐使用此属性。最新的 WebGPU 规范添加了 GPUDevice.adapterInfo (https://www.w3.org/TR/webgpu/#dom-gpudevice-adapterinfo)，它允许从设备获取适配器信息。当它可用时，无需设置/获取 adapter 属性。

可选 forceFallbackAdapter

forceFallbackAdapter?: boolean

设置或获取强制回退适配器标志。

设置此属性仅在创建第一个 WebGPU 推理会话之前有效。该值将用作 navigator.gpu.requestAdapter() 的选项。

有关更多详细信息，请参阅 https://gpuweb.github.io/gpuweb/#dictdef-gpurequestadapteroptions。

默认值

undefined

已废弃

如果要使用特定的回退选项，请创建您自己的 GPUAdapter，使用它创建 GPUDevice 实例，并设置 device 属性。

可选 powerPreference

powerPreference?: "high-performance" | "low-power"

设置或获取电源偏好。

设置此属性仅在创建第一个 WebGPU 推理会话之前有效。该值将用作 navigator.gpu.requestAdapter() 的选项。

有关更多详细信息，请参阅 https://gpuweb.github.io/gpuweb/#dictdef-gpurequestadapteroptions。

默认值

undefined

已废弃

如果要使用特定的电源偏好，请创建您自己的 GPUAdapter，使用它创建 GPUDevice 实例，并设置 device 属性。

profiling

profiling: {
    mode?: "default" | "off";
    ondata?: ((data) => void);
}

设置或获取性能分析配置。

类型声明

  • 可选 mode?: "default" | "off"

    设置或获取性能分析模式。

    默认值

    'off'

  • 可选 ondata?: ((data) => void)

    设置或获取接收到性能分析数据时的回调函数。如果未设置，性能分析数据将打印到控制台。

      • (data): void

      • 设置或获取接收到性能分析数据时的回调函数。如果未设置，性能分析数据将打印到控制台。

        参数

        返回 void

可选 profilingMode

profilingMode?: "default" | "off"

设置或获取性能分析模式。

已废弃

请改用 env.webgpu.profiling.mode。如果设置了 env.webgpu.profiling.mode，则此属性将被忽略。

可选 validateInputContent

validateInputContent?: boolean

设置或获取是否验证输入内容。

默认值

false

访问器

device

  • get device(): Promise<unknown>

  • 设置或获取 WebGPU 的 GPU 设备。

    访问此属性有 3 种有效场景：

    • 在创建第一个 WebGPU 推理会话之前设置一个值。该值将由 WebGPU 后端用于执行计算。如果该值不是 GPUDevice 对象，则会抛出错误。
    • 在创建第一个 WebGPU 推理会话之前获取该值。这将尝试创建一个新的 GPUDevice 实例。返回一个解析为 GPUDevice 对象的 Promise。
    • 在创建第一个 WebGPU 推理会话之后获取该值。返回一个已解析的 Promise，指向 WebGPU 后端使用的 GPUDevice 对象。

    返回 Promise<unknown>

  • set device(value): void

  • 参数

    • value: unknown

    返回 void

设置

成员可见性

主题

在此页面上

使用 TypeDoc 生成