GPU | RiveCN - Rive 中文站

📄️ BufferUsageArg

一个缓冲区用途，或用途数组。数组形式预留给未来的多用途标志；目前仅支持一个用途。

📄️ Canvas

一个 Rive 2D 渲染器画布。使用 .image 配合 renderer:drawImage()。

📄️ GPUBindGroup

预烘焙的资源绑定，可在多个绘制调用中重用。避免每次绘制都创建新的绑定组——对 3D 场景性能至关重要。持有所有绑定资源（Buffer、TextureView、Sampler）的强引用，在 BindGroup 生命周期内保持它们存活。

📄️ GPUBindGroupLayout

公开的 BindGroupLayout — 描述 BindGroup 遵循的契约，以及管线为其某个 @group(N) 插槽引用的契约。

一个 GPU 画布 —— 1× 呈现目标，作用类似于 WebGPU surface texture。使用 .image 配合 rendererbeginRenderPass({ color = {{ loadOp = 'clear', storeOp = 'store', ... }} }) 渲染到它。MSAA 需要由用户自行分配 GPUTexture.new({ sampleCount = N, renderTarget = true }) 作为显式 color view，并将画布的 colorView() 设置为 resolveTarget。其格式始终为 'rgba8unorm'，在延迟分配纹理的 deferred canvas 上也会报告该格式。

📄️ GPUColor

RGBA 清除颜色，范围 0–1（例如，{0, 0, 0, 1} 表示不透明黑色）。支持超过 1.0 的 HDR 值用于浮点渲染目标。使用 Color.toFloat() 从打包的 ARGB 颜色转换。

📄️ GPUFeatures

可选的 GPU 功能。由 context:features() 返回。

📄️ GPUPipeline

已编译的 GPU 渲染管线（着色器 + 固定功能状态）。

📄️ GPURenderPass

活跃的渲染通道。在调用 finish() 之前执行所有绘制调用。

📄️ GPUSampler

GPUTextureView 在共享的 "rive/gpu_types" 内建中声明（在 rive/image 之前加载），以便使用统一的单一名义类型——无论是 Image:view() 还是 GPU 渲染通道 API。描述纹理在着色器中如何被采样。

📄️ GPUTarget

渲染 pass 可以绘制到的目标。它不保证可采样，也不保证帧与帧之间保留内容；GPUCanvas 同时提供这两点。

📄️ GPUTexture

GPU 纹理（二维、立方体、三维或数组）。

📄️ LoadOp

在渲染通道开始时要对附件执行的操作。

📄️ PipelineStage

一个管线阶段：可以是 Shader，也可以是 WebGPU 风格的 { module = Shader, entryPoint = name }。Shader 的 @vertex/@fragment 函数是可选择的入口点；省略 entryPoint 时会使用该阶段的第一个入口点（类似 WebGPU）。

📄️ PrimitiveTopology

GPU 图元装配拓扑。

📄️ RenderPassDesc

用于 canvas:beginRenderPass 的渲染 pass 描述符。必须包含至少一个颜色附件或一个 depthStencil 附件。所有附件（颜色视图 + 深度）必须共享一个 sampleCount，按 WebGPU 规则推导——pass 的 sampleCount 从视图中推断，而不是显式声明。