@forgeax/engine-render-graph 0.1.7 → 0.1.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/.tsbuildinfo +1 -1
- package/dist/__tests__/texture-dimensions-lifecycle.unit.test.d.ts +2 -0
- package/dist/__tests__/texture-dimensions-lifecycle.unit.test.d.ts.map +1 -0
- package/dist/__tests__/texture-dimensions.unit.test.d.ts +2 -0
- package/dist/__tests__/texture-dimensions.unit.test.d.ts.map +1 -0
- package/dist/builder.d.ts.map +1 -1
- package/dist/compiled-graph.d.ts +7 -2
- package/dist/compiled-graph.d.ts.map +1 -1
- package/dist/errors.d.ts +14 -0
- package/dist/errors.d.ts.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +250 -110
- package/dist/index.mjs.map +1 -1
- package/dist/resource-registry.d.ts +2 -0
- package/dist/resource-registry.d.ts.map +1 -1
- package/dist/types.d.ts +39 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +4 -4
- package/src/__tests__/render-graph-builder.unit.test.ts +32 -1
- package/src/__tests__/render-graph.unit.test.ts +15 -0
- package/src/__tests__/texture-dimensions-lifecycle.unit.test.ts +95 -0
- package/src/__tests__/texture-dimensions.unit.test.ts +99 -0
- package/src/builder.ts +191 -10
- package/src/compiled-graph.ts +21 -0
- package/src/errors.ts +22 -0
- package/src/index.ts +4 -0
- package/src/pipeline/__tests__/color-value-domain.test.ts +8 -0
- package/src/resource-registry.ts +10 -0
- package/src/types.ts +40 -0
|
@@ -2,6 +2,8 @@ import type { TextureFormat } from '@forgeax/engine-rhi';
|
|
|
2
2
|
import { type CapMissingDetail, type DanglingReadDetail, type DuplicateResourceDetail, RenderGraphError, type Result } from './errors.js';
|
|
3
3
|
import type { ColorTargetDescriptor, ColorTargetSize, ResourceDescriptor, ResourceLifetime } from './graph.js';
|
|
4
4
|
import type { ColorValueDomain } from './pipeline/color-value-domain.js';
|
|
5
|
+
/** Check the only allocation/view dimension combinations supported by WebGPU. */
|
|
6
|
+
export declare function isTextureViewDimensionCompatible(allocationDimension: GPUTextureDimension, viewDimension: GPUTextureViewDimension | undefined): boolean;
|
|
5
7
|
/**
|
|
6
8
|
* Per-resource GPU allocation metadata carried through compile.
|
|
7
9
|
* When the resource was registered via addColorTarget, colorTarget
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../src/resource-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAG5B,gBAAgB,EAChB,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;CAC5D;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IASzF;;;;OAIG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAmB1C;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IA8B1F,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,QAAQ;IAMhB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI3C,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAIpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC;CAG3C;AAGD,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC"}
|
|
1
|
+
{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../src/resource-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAG5B,gBAAgB,EAChB,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,iFAAiF;AACjF,wBAAgB,gCAAgC,CAC9C,mBAAmB,EAAE,mBAAmB,EACxC,aAAa,EAAE,uBAAuB,GAAG,SAAS,GACjD,OAAO,CAIT;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;CAC5D;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IASzF;;;;OAIG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAmB1C;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IA8B1F,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,QAAQ;IAMhB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI3C,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAIpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC;CAG3C;AAGD,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC"}
|
package/dist/types.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { Buffer, ComputePassDescriptor, RhiCommandEncoder, RhiComputePassEncoder, RhiDevice, RhiRenderPassEncoder, Texture, TextureFormat, TextureView } from '@forgeax/engine-rhi';
|
|
2
2
|
import type { RenderGraphError, Result } from './errors.js';
|
|
3
|
+
import type { ColorValueDomain } from './pipeline/color-value-domain.js';
|
|
3
4
|
declare const graphTextureBrand: unique symbol;
|
|
4
5
|
declare const graphTextureViewBrand: unique symbol;
|
|
5
6
|
declare const graphBufferBrand: unique symbol;
|
|
@@ -24,10 +25,14 @@ export type GraphExtent = 'surface' | 'half-surface' | {
|
|
|
24
25
|
export interface GraphTextureDescriptor {
|
|
25
26
|
readonly format: TextureFormat;
|
|
26
27
|
readonly size: GraphExtent;
|
|
28
|
+
/** Additional RHI usage required by an external diagnostic consumer. */
|
|
29
|
+
readonly usage?: number | undefined;
|
|
27
30
|
readonly mipLevelCount?: number | undefined;
|
|
28
31
|
readonly sampleCount?: number | undefined;
|
|
29
32
|
readonly dimension?: GPUTextureDimension | undefined;
|
|
30
33
|
readonly viewFormats?: readonly TextureFormat[] | undefined;
|
|
34
|
+
/** Explicit semantic color domain; never inferred from the attachment format. */
|
|
35
|
+
readonly domain?: ColorValueDomain | undefined;
|
|
31
36
|
}
|
|
32
37
|
export interface ImportedTextureDescriptor extends GraphTextureDescriptor {
|
|
33
38
|
readonly usage: number;
|
|
@@ -51,7 +56,7 @@ export interface ImportedBufferDescriptor extends GraphBufferDescriptor {
|
|
|
51
56
|
readonly usage: number;
|
|
52
57
|
}
|
|
53
58
|
export type GraphBufferAccess = 'uniform-read' | 'storage-read' | 'storage-write' | 'storage-read-write' | 'indirect-read' | 'vertex-read' | 'index-read' | 'copy-src' | 'copy-dst';
|
|
54
|
-
export type GraphTextureAccess = 'sampled-read' | 'storage-read' | 'storage-write' | 'storage-read-write' | 'color-attachment' | 'depth-stencil-read' | 'depth-stencil-write' | 'copy-src' | 'copy-dst';
|
|
59
|
+
export type GraphTextureAccess = 'sampled-read' | 'storage-read' | 'storage-write' | 'storage-read-write' | 'sampled-storage-read-write' | 'color-attachment' | 'depth-stencil-read' | 'depth-stencil-write' | 'copy-src' | 'copy-dst';
|
|
55
60
|
export type GraphAccess = {
|
|
56
61
|
readonly resource: GraphBuffer;
|
|
57
62
|
readonly usage: GraphBufferAccess;
|
|
@@ -129,6 +134,23 @@ export interface GraphAccessInfo {
|
|
|
129
134
|
readonly resource: string;
|
|
130
135
|
readonly usage: GraphBufferAccess | GraphTextureAccess;
|
|
131
136
|
}
|
|
137
|
+
/** Detached physical allocation facts for one compiled graph resource. */
|
|
138
|
+
export type CompiledResourceDescriptor = {
|
|
139
|
+
readonly kind: 'texture';
|
|
140
|
+
readonly format: TextureFormat;
|
|
141
|
+
/** Explicit semantic color domain retained in detached graph facts. */
|
|
142
|
+
readonly domain?: ColorValueDomain | undefined;
|
|
143
|
+
/** Authored extent retained so consumers can validate the allocation contract. */
|
|
144
|
+
readonly size: GraphExtent;
|
|
145
|
+
readonly width: number;
|
|
146
|
+
readonly height: number;
|
|
147
|
+
readonly depthOrArrayLayers: number;
|
|
148
|
+
readonly mipLevelCount: number;
|
|
149
|
+
readonly sampleCount: number;
|
|
150
|
+
} | {
|
|
151
|
+
readonly kind: 'buffer';
|
|
152
|
+
readonly size: number;
|
|
153
|
+
};
|
|
132
154
|
export interface CompiledRenderGraphInfo {
|
|
133
155
|
readonly passes: readonly {
|
|
134
156
|
readonly name: string;
|
|
@@ -141,10 +163,26 @@ export interface CompiledRenderGraphInfo {
|
|
|
141
163
|
readonly label: string;
|
|
142
164
|
readonly kind: GraphResourceKind;
|
|
143
165
|
readonly origin: GraphResourceOrigin;
|
|
166
|
+
readonly descriptor: CompiledResourceDescriptor;
|
|
144
167
|
readonly firstUse: number | null;
|
|
145
168
|
readonly lastUse: number | null;
|
|
146
169
|
readonly derivedUsage: number;
|
|
170
|
+
/** Stable compile-local identity of the physical RHI allocation. */
|
|
171
|
+
readonly physicalAllocationKey?: string | undefined;
|
|
172
|
+
/** Descriptor-derived byte size when the format is uncompressed and known. */
|
|
173
|
+
readonly byteSize?: number | undefined;
|
|
174
|
+
/** Texture format retained for producer-owned resource inspection. */
|
|
175
|
+
readonly format?: TextureFormat | undefined;
|
|
176
|
+
/** Texture allocation facts retained for capability/lifetime inspection. */
|
|
177
|
+
readonly dimension?: GPUTextureDimension | undefined;
|
|
178
|
+
readonly extent?: {
|
|
179
|
+
readonly width: number;
|
|
180
|
+
readonly height: number;
|
|
181
|
+
readonly depthOrArrayLayers: number;
|
|
182
|
+
} | undefined;
|
|
147
183
|
}[];
|
|
184
|
+
/** Monotonic graph generation assigned when this graph was compiled. */
|
|
185
|
+
readonly generation: number;
|
|
148
186
|
}
|
|
149
187
|
export interface RenderGraphFrame {
|
|
150
188
|
readonly encoder: RhiCommandEncoder;
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACpB,OAAO,EACP,aAAa,EACb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@forgeax/engine-render-graph",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.20",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -22,12 +22,12 @@
|
|
|
22
22
|
"LICENSE"
|
|
23
23
|
],
|
|
24
24
|
"dependencies": {
|
|
25
|
-
"@forgeax/engine-rhi": "0.1.
|
|
26
|
-
"@forgeax/engine-types": "0.1.
|
|
25
|
+
"@forgeax/engine-rhi": "0.1.20",
|
|
26
|
+
"@forgeax/engine-types": "0.1.20",
|
|
27
27
|
"@webgpu/types": "^0.1.71"
|
|
28
28
|
},
|
|
29
29
|
"devDependencies": {
|
|
30
|
-
"@forgeax/engine-rhi-null": "0.1.
|
|
30
|
+
"@forgeax/engine-rhi-null": "0.1.20"
|
|
31
31
|
},
|
|
32
32
|
"forgeax": {
|
|
33
33
|
"metrics": {
|
|
@@ -121,6 +121,37 @@ describe('RenderGraphBuilder resource and temporal contracts', () => {
|
|
|
121
121
|
if (compiled.ok) expect(compiled.value.inspect().passes).toEqual([]);
|
|
122
122
|
});
|
|
123
123
|
|
|
124
|
+
it('deep freezes compiled texture extent objects', () => {
|
|
125
|
+
const graph = new RenderGraphBuilder<Frame>();
|
|
126
|
+
const texture = value(
|
|
127
|
+
graph.createTexture('sized', {
|
|
128
|
+
format: 'rgba8unorm',
|
|
129
|
+
size: { width: 7, height: 5, depthOrArrayLayers: 2 },
|
|
130
|
+
}),
|
|
131
|
+
);
|
|
132
|
+
const view = graph.view(texture).unwrap();
|
|
133
|
+
graph.addRasterPass('write-sized', {
|
|
134
|
+
accesses: [{ resource: view, usage: 'color-attachment' }],
|
|
135
|
+
colorAttachments: [{ view, loadOp: 'clear', storeOp: 'store' }],
|
|
136
|
+
encode: () => undefined,
|
|
137
|
+
});
|
|
138
|
+
const compiled = graph.compile({ device: mockDevice(), surfaceSize: { width: 1, height: 1 } });
|
|
139
|
+
expect(compiled.ok).toBe(true);
|
|
140
|
+
if (!compiled.ok) return;
|
|
141
|
+
const resource = compiled.value.inspect().resources.find(({ label }) => label === 'sized');
|
|
142
|
+
expect(resource).toBeDefined();
|
|
143
|
+
if (resource?.descriptor.kind !== 'texture') return;
|
|
144
|
+
expect(Object.isFrozen(resource.descriptor)).toBe(true);
|
|
145
|
+
expect(Object.isFrozen(resource.descriptor.size)).toBe(true);
|
|
146
|
+
const snapshot = JSON.stringify(resource);
|
|
147
|
+
try {
|
|
148
|
+
(resource.descriptor.size as { width: number }).width = 99;
|
|
149
|
+
} catch {
|
|
150
|
+
// Frozen snapshots reject mutation in strict mode.
|
|
151
|
+
}
|
|
152
|
+
expect(JSON.stringify(resource)).toBe(snapshot);
|
|
153
|
+
});
|
|
154
|
+
|
|
124
155
|
it('accepts imported first-read and rejects graph-created first-read', () => {
|
|
125
156
|
const importedGraph = new RenderGraphBuilder<Frame>();
|
|
126
157
|
const imported = value(
|
|
@@ -234,7 +265,7 @@ describe('RenderGraphBuilder resource and temporal contracts', () => {
|
|
|
234
265
|
const encoder = {
|
|
235
266
|
...mockEncoder(),
|
|
236
267
|
beginRenderPass: (descriptor: GPURenderPassDescriptor) => {
|
|
237
|
-
clearValue = descriptor.colorAttachments[0]?.clearValue;
|
|
268
|
+
clearValue = Array.from(descriptor.colorAttachments)[0]?.clearValue;
|
|
238
269
|
return { end: () => undefined } as never;
|
|
239
270
|
},
|
|
240
271
|
} as unknown as RhiCommandEncoder;
|
|
@@ -99,6 +99,21 @@ import { RenderGraph } from '../graph.js';
|
|
|
99
99
|
const result = graph.compile({ backendKind: 'null', caps });
|
|
100
100
|
expect(result.ok).toBe(true);
|
|
101
101
|
});
|
|
102
|
+
|
|
103
|
+
it('preserves explicit domain separately from format and view metadata', () => {
|
|
104
|
+
const graph = graphWithTargets('display-encoded', 'display-encoded');
|
|
105
|
+
graph.addPass('present', {
|
|
106
|
+
reads: ['source'],
|
|
107
|
+
writes: ['destination'],
|
|
108
|
+
colorConnections: [{ source: 'source', destination: 'destination' }],
|
|
109
|
+
} as never);
|
|
110
|
+
const result = graph.compile({ backendKind: 'null', caps });
|
|
111
|
+
expect(result.ok).toBe(true);
|
|
112
|
+
expect(graph.listResources().map((resource) => resource.key)).toEqual([
|
|
113
|
+
'source',
|
|
114
|
+
'destination',
|
|
115
|
+
]);
|
|
116
|
+
});
|
|
102
117
|
});
|
|
103
118
|
|
|
104
119
|
describe('whole-graph retirement', () => {
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { RhiDevice, TextureView } from '@forgeax/engine-rhi';
|
|
2
|
+
import { describe, expect, it } from 'vitest';
|
|
3
|
+
import { RenderGraphBuilder } from '../builder.js';
|
|
4
|
+
import type { RenderGraphFrame } from '../types.js';
|
|
5
|
+
|
|
6
|
+
interface Frame extends RenderGraphFrame {}
|
|
7
|
+
|
|
8
|
+
function caps(storageTexture: boolean): RhiDevice['caps'] {
|
|
9
|
+
return {
|
|
10
|
+
backendKind: 'null',
|
|
11
|
+
compute: true,
|
|
12
|
+
storageBuffer: true,
|
|
13
|
+
storageTexture,
|
|
14
|
+
timestampQuery: false,
|
|
15
|
+
timestampPeriodNanoseconds: null,
|
|
16
|
+
indirectDrawing: false,
|
|
17
|
+
textureCompressionBc: false,
|
|
18
|
+
textureCompressionEtc2: false,
|
|
19
|
+
textureCompressionAstc: false,
|
|
20
|
+
multiDrawIndirect: false,
|
|
21
|
+
pushConstants: false,
|
|
22
|
+
textureBindingArray: false,
|
|
23
|
+
samplerAliasing: true,
|
|
24
|
+
firstInstanceIndirect: false,
|
|
25
|
+
rgba16floatRenderable: true,
|
|
26
|
+
rg11b10ufloatRenderable: true,
|
|
27
|
+
float32Filterable: true,
|
|
28
|
+
maxColorAttachments: 8,
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function mockDevice(storageTexture: boolean): RhiDevice {
|
|
33
|
+
return {
|
|
34
|
+
caps: caps(storageTexture),
|
|
35
|
+
limits: {} as never,
|
|
36
|
+
features: new Set() as never,
|
|
37
|
+
queue: { onSubmittedWorkDone: async () => undefined } as never,
|
|
38
|
+
createTexture: () => ({ ok: true, value: {} as never }),
|
|
39
|
+
createTextureView: () => ({ ok: true, value: {} as TextureView }),
|
|
40
|
+
destroyTexture: () => ({ ok: true, value: undefined }),
|
|
41
|
+
destroyBuffer: () => ({ ok: true, value: undefined }),
|
|
42
|
+
} as unknown as RhiDevice;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
describe('RenderGraph texture dimension lifecycle', () => {
|
|
46
|
+
it('returns a structured capability result for unsupported storage texture access', () => {
|
|
47
|
+
const graph = new RenderGraphBuilder<Frame>();
|
|
48
|
+
const texture = graph.createTexture('volume-storage', {
|
|
49
|
+
format: 'rgba8unorm',
|
|
50
|
+
size: { width: 2, height: 2, depthOrArrayLayers: 2 },
|
|
51
|
+
dimension: '3d',
|
|
52
|
+
});
|
|
53
|
+
expect(texture.ok).toBe(true);
|
|
54
|
+
if (!texture.ok) return;
|
|
55
|
+
const view = graph.view(texture.value, { dimension: '3d' });
|
|
56
|
+
expect(view.ok).toBe(true);
|
|
57
|
+
if (!view.ok) return;
|
|
58
|
+
graph.addCopyPass('seed', {
|
|
59
|
+
accesses: [{ resource: view.value, usage: 'copy-dst' }],
|
|
60
|
+
encode: () => undefined,
|
|
61
|
+
});
|
|
62
|
+
graph.addComputePass('write-volume', {
|
|
63
|
+
accesses: [{ resource: view.value, usage: 'storage-write' }],
|
|
64
|
+
encode: () => undefined,
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
const result = graph.compile({
|
|
68
|
+
device: mockDevice(false),
|
|
69
|
+
surfaceSize: { width: 1, height: 1 },
|
|
70
|
+
});
|
|
71
|
+
expect(result.ok).toBe(false);
|
|
72
|
+
if (result.ok) return;
|
|
73
|
+
expect(result.error.code).toBe('capability-missing');
|
|
74
|
+
expect(result.error.detail).toMatchObject({ capability: 'storage-texture' });
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
it('rejects a non-positive volume extent with structured descriptor detail', () => {
|
|
78
|
+
const graph = new RenderGraphBuilder<Frame>();
|
|
79
|
+
const texture = graph.createTexture('invalid-volume', {
|
|
80
|
+
format: 'rgba8unorm',
|
|
81
|
+
size: { width: 2, height: 2, depthOrArrayLayers: 0 },
|
|
82
|
+
dimension: '3d',
|
|
83
|
+
});
|
|
84
|
+
expect(texture.ok).toBe(true);
|
|
85
|
+
if (!texture.ok) return;
|
|
86
|
+
const result = graph.compile({
|
|
87
|
+
device: mockDevice(true),
|
|
88
|
+
surfaceSize: { width: 1, height: 1 },
|
|
89
|
+
});
|
|
90
|
+
expect(result.ok).toBe(false);
|
|
91
|
+
if (result.ok) return;
|
|
92
|
+
expect(result.error.code).toBe('resource-descriptor-invalid');
|
|
93
|
+
expect(result.error.detail).toMatchObject({ resourceLabel: 'invalid-volume', field: 'size' });
|
|
94
|
+
});
|
|
95
|
+
});
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { ok, type RhiDevice, type Texture, type TextureView } from '@forgeax/engine-rhi';
|
|
2
|
+
import { describe, expect, it } from 'vitest';
|
|
3
|
+
import { RenderGraphBuilder } from '../builder.js';
|
|
4
|
+
import type { RenderGraphFrame } from '../types.js';
|
|
5
|
+
|
|
6
|
+
interface Frame extends RenderGraphFrame {}
|
|
7
|
+
|
|
8
|
+
function device(overrides: Partial<RhiDevice> = {}): RhiDevice {
|
|
9
|
+
return {
|
|
10
|
+
caps: {
|
|
11
|
+
backendKind: 'null',
|
|
12
|
+
compute: true,
|
|
13
|
+
storageBuffer: true,
|
|
14
|
+
storageTexture: true,
|
|
15
|
+
timestampQuery: false,
|
|
16
|
+
timestampPeriodNanoseconds: null,
|
|
17
|
+
indirectDrawing: true,
|
|
18
|
+
textureCompressionBc: false,
|
|
19
|
+
textureCompressionEtc2: false,
|
|
20
|
+
textureCompressionAstc: false,
|
|
21
|
+
multiDrawIndirect: false,
|
|
22
|
+
pushConstants: false,
|
|
23
|
+
textureBindingArray: false,
|
|
24
|
+
samplerAliasing: true,
|
|
25
|
+
firstInstanceIndirect: false,
|
|
26
|
+
rgba16floatRenderable: true,
|
|
27
|
+
rg11b10ufloatRenderable: true,
|
|
28
|
+
float32Filterable: true,
|
|
29
|
+
maxColorAttachments: 8,
|
|
30
|
+
},
|
|
31
|
+
limits: {} as never,
|
|
32
|
+
features: new Set() as never,
|
|
33
|
+
queue: { onSubmittedWorkDone: async () => undefined } as never,
|
|
34
|
+
createTexture: () => ok({} as Texture),
|
|
35
|
+
createTextureView: () => ok({} as TextureView),
|
|
36
|
+
destroyTexture: () => ok(undefined),
|
|
37
|
+
destroyBuffer: () => ok(undefined),
|
|
38
|
+
...overrides,
|
|
39
|
+
} as unknown as RhiDevice;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
describe('RenderGraph texture dimension contract', () => {
|
|
43
|
+
it('keeps 2d-array and 3d allocation dimensions through graph-owned resources', () => {
|
|
44
|
+
const created: unknown[] = [];
|
|
45
|
+
const views: unknown[] = [];
|
|
46
|
+
const graph = new RenderGraphBuilder<Frame>();
|
|
47
|
+
const arrayTexture = graph.createTexture('layers', {
|
|
48
|
+
format: 'rgba8unorm',
|
|
49
|
+
size: { width: 2, height: 2, depthOrArrayLayers: 3 },
|
|
50
|
+
dimension: '2d',
|
|
51
|
+
});
|
|
52
|
+
const volumeTexture = graph.createTexture('volume', {
|
|
53
|
+
format: 'rgba8unorm',
|
|
54
|
+
size: { width: 2, height: 2, depthOrArrayLayers: 3 },
|
|
55
|
+
dimension: '3d',
|
|
56
|
+
});
|
|
57
|
+
expect(arrayTexture.ok && volumeTexture.ok).toBe(true);
|
|
58
|
+
if (!arrayTexture.ok || !volumeTexture.ok) return;
|
|
59
|
+
const arrayView = graph.view(arrayTexture.value, { dimension: '2d-array' });
|
|
60
|
+
const volumeView = graph.view(volumeTexture.value, { dimension: '3d' });
|
|
61
|
+
expect(arrayView.ok && volumeView.ok).toBe(true);
|
|
62
|
+
if (!arrayView.ok || !volumeView.ok) return;
|
|
63
|
+
graph.addCopyPass('seed-array', {
|
|
64
|
+
accesses: [{ resource: arrayView.value, usage: 'copy-dst' }],
|
|
65
|
+
encode: () => undefined,
|
|
66
|
+
});
|
|
67
|
+
graph.addCopyPass('seed-volume', {
|
|
68
|
+
accesses: [{ resource: volumeView.value, usage: 'copy-dst' }],
|
|
69
|
+
encode: () => undefined,
|
|
70
|
+
});
|
|
71
|
+
const compiled = graph.compile({
|
|
72
|
+
device: device({
|
|
73
|
+
createTexture: (descriptor: unknown) => {
|
|
74
|
+
created.push(descriptor);
|
|
75
|
+
return ok({} as Texture);
|
|
76
|
+
},
|
|
77
|
+
createTextureView: (_texture: Texture, descriptor: unknown) => {
|
|
78
|
+
views.push(descriptor);
|
|
79
|
+
return ok({} as TextureView);
|
|
80
|
+
},
|
|
81
|
+
}),
|
|
82
|
+
surfaceSize: { width: 1, height: 1 },
|
|
83
|
+
});
|
|
84
|
+
expect(compiled.ok).toBe(true);
|
|
85
|
+
expect(created).toEqual(
|
|
86
|
+
expect.arrayContaining([
|
|
87
|
+
expect.objectContaining({
|
|
88
|
+
dimension: '2d',
|
|
89
|
+
size: { width: 2, height: 2, depthOrArrayLayers: 3 },
|
|
90
|
+
}),
|
|
91
|
+
expect.objectContaining({
|
|
92
|
+
dimension: '3d',
|
|
93
|
+
size: { width: 2, height: 2, depthOrArrayLayers: 3 },
|
|
94
|
+
}),
|
|
95
|
+
]),
|
|
96
|
+
);
|
|
97
|
+
expect(views).toEqual(expect.arrayContaining([{ dimension: '2d-array' }, { dimension: '3d' }]));
|
|
98
|
+
});
|
|
99
|
+
});
|