@yali-engine/render 0.0.0-stage → 0.4.0

package/dist/webgl2/program.js

@@ -0,0 +1,74 @@
+import { YaliError } from '@yali-engine/core';
+/**
+ * A linked GLSL ES 3.00 program from `tools/glsl-gen.mjs` (ADR-0070). GLSL ES 3.00 has no
+ * binding qualifiers, so naga reports each uniform block's and combined sampler's name and
+ * the WGSL binding it came from: each uniform block is bound to the binding point equal to
+ * its WGSL binding (the vertex and fragment stages' blocks for one binding share it), and
+ * each combined sampler gets a texture unit, where `bind` puts the binding's texture and the
+ * sampler binding's sampler object.
+ */
+export class GlProgram {
+    program;
+    /** Per texture unit: [texture binding, sampler binding or −1]. */
+    #units = [];
+    /** WGSL uniform bindings the program reads. */
+    #uniforms = [];
+    constructor(gl, label, src) {
+        const compile = (type, glsl, stage) => {
+            const s = gl.createShader(type);
+            gl.shaderSource(s, glsl);
+            gl.compileShader(s);
+            if (!gl.getShaderParameter(s, gl.COMPILE_STATUS) && !gl.isContextLost()) {
+                const log = gl.getShaderInfoLog(s);
+                throw new YaliError('GL_SHADER', `The ${label} ${stage} shader failed to compile: ${log}`, 'This is an engine bug (tools/glsl-gen.mjs output); report it with the message.');
+            }
+            return s;
+        };
+        const p = gl.createProgram();
+        gl.attachShader(p, compile(gl.VERTEX_SHADER, src.vs.glsl, 'vertex'));
+        gl.attachShader(p, compile(gl.FRAGMENT_SHADER, src.fs.glsl, 'fragment'));
+        gl.linkProgram(p);
+        if (!gl.getProgramParameter(p, gl.LINK_STATUS) && !gl.isContextLost()) {
+            throw new YaliError('GL_LINK', `The ${label} program failed to link: ${gl.getProgramInfoLog(p)}`, 'This is an engine bug (tools/glsl-gen.mjs output); report it with the message.');
+        }
+        this.program = p;
+        gl.useProgram(p);
+        for (const stage of [src.vs, src.fs]) {
+            for (const [, binding, name] of stage.uniforms) {
+                const index = gl.getUniformBlockIndex(p, name);
+                if (index === gl.INVALID_INDEX)
+                    continue; // optimized out
+                gl.uniformBlockBinding(p, index, binding);
+                if (!this.#uniforms.includes(binding))
+                    this.#uniforms.push(binding);
+            }
+            for (const [name, , texBinding, , samplerBinding] of stage.textures) {
+                const loc = gl.getUniformLocation(p, name);
+                if (!loc)
+                    continue;
+                gl.uniform1i(loc, this.#units.length);
+                this.#units.push([texBinding, samplerBinding]);
+            }
+        }
+    }
+    /** Makes the program current and binds `b`'s resources to its blocks and units. */
+    bind(gl, b) {
+        gl.useProgram(this.program);
+        for (const binding of this.#uniforms) {
+            const buf = b.uniforms.get(binding);
+            if (!buf)
+                throw new YaliError('GL_BINDING', `Uniform binding ${binding} has no buffer.`, 'This is an engine bug; report it.');
+            gl.bindBufferBase(gl.UNIFORM_BUFFER, binding, buf);
+        }
+        for (let unit = 0; unit < this.#units.length; unit++) {
+            const [tb, sb] = this.#units[unit];
+            const t = b.textures.get(tb);
+            if (!t)
+                throw new YaliError('GL_BINDING', `Texture binding ${tb} has no texture.`, 'This is an engine bug; report it.');
+            gl.activeTexture(gl.TEXTURE0 + unit);
+            gl.bindTexture(t.target, t.texture);
+            gl.bindSampler(unit, sb >= 0 ? (b.samplers.get(sb) ?? null) : null);
+        }
+    }
+}
+//# sourceMappingURL=program.js.map

package/dist/webgl2/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/webgl2/program.ts"],"names":[],"mappings":"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"}

package/dist/webgl2/renderer.d.ts

@@ -0,0 +1,128 @@
+import type { Component, World } from '@yali-engine/core';
+import type { OrbitCamera } from '../camera.ts';
+import { type SkyOptions } from '../environment.ts';
+import { type PaletteSource } from '../scene.ts';
+import type { ExtractedInstances } from '../extract.ts';
+import { LightPacker } from '../lights.ts';
+import { type MaterialStore, type MeshStore } from '../meshes.ts';
+import type { LightingOptions } from '../scene.ts';
+import type { TextureStore } from '../textures.ts';
+import { type ToneCurve } from '../tonemap.ts';
+import type { GradingOptions } from '../post-options.ts';
+import { type DebugLines } from '../debug-lines.ts';
+/** A frame read back as drawn (RGBA8, rows top to bottom). */
+export interface GlCapture {
+    readonly width: number;
+    readonly height: number;
+    readonly rgba: Uint8Array;
+}
+/** The sun's shadows on WebGL2: the cascade configuration (`fitCascades`). */
+export interface GlShadowConfig {
+    readonly cascades: number;
+    readonly size: number;
+    distance: number;
+    readonly splitLambda: number;
+    /** PCF grid radius in taps (`SunShadows.pcfRadius`). */
+    readonly pcfRadius: number;
+}
+/**
+ * The WebGL2 backend's renderer (M2 increment 8, ADR-0070): the WebGPU renderer's frame on
+ * GLSL ES 3.00 that naga translated from the same WGSL (`tools/glsl-gen.mjs`). The CPU culls
+ * and picks LODs (the extract's `runCulled`, ADR-0057) and bins the lights (`binLights`,
+ * identical to the GPU pass); the GPU draws:
+ *
+ * 1. the sun's shadow cascades into one depth atlas (`fitCascades`, the same fit);
+ * 2. the scene into a half-float HDR target, lit by the sun, the binned lights and the
+ *    environment cube (built here face by face with the same sky shaders);
+ * 3. the tone curve into an RGBA8 target, blitted to the canvas.
+ *
+ * Every offscreen pass renders with naga's clip-space adjustment (y flipped, z to −1..1), so
+ * render targets keep WebGPU's row order and fragment coordinates (row 0 at the top) and the
+ * shaders need no change; the flip reverses triangle winding, so front faces are clockwise
+ * here, and the final blit to the canvas flips back. WebGL2 has no base vertex and no base
+ * instance, so each draw re-points the attributes at its mesh's vertices and its instances.
+ */
+/**
+ * Whether this GPU ignores LINEAR filtering on depth comparisons (GLES allows it: the Galaxy
+ * F04's PowerVR returns 0 or 1, never a blend, so shadow edges step by a texel). One 1×1
+ * draw at startup: a 2×1 depth texture [0, 1] compared at its middle gives 0.5 when filtered.
+ */
+export declare function comparesNearestOnly(gl: WebGL2RenderingContext): boolean;
+export declare class GlRenderer {
+    #private;
+    readonly gl: WebGL2RenderingContext;
+    readonly cull: "cpu";
+    readonly path: "vertex";
+    readonly useBundles = false;
+    readonly staging: null;
+    readonly staticUploads = 0;
+    /** Instance bytes uploaded last frame (every visible record: the CPU cull rewrites them all). */
+    transformBytes: number;
+    shaderError: string;
+    capacity: number;
+    count: number;
+    visible: number;
+    errorPx: number;
+    lodBias: number;
+    minRadiusPx: number;
+    readonly stats: {
+        slots: number;
+        draws: number;
+        layouts: number;
+        meshes: number;
+        shaderBuilds: number;
+    };
+    /** The shading level (`SceneControls.shadingLevel`, ADR-0072). */
+    shadingLevel: number;
+    readonly shadingLevels: number;
+    readonly lighting: LightingOptions;
+    /** Tone mapping (`ToneMapper`'s knobs). */
+    exposure: number;
+    curve: ToneCurve;
+    /** Colour grading in the tone-mapping pass (ADR-0092), or null. */
+    grading: (Required<GradingOptions> & {
+        enabled: boolean;
+    }) | null;
+    readonly shadows: GlShadowConfig | null;
+    /** The packed lights (`render.lights.count`, `dropped`). */
+    readonly lights: LightPacker;
+    /** Whether the HDR and environment targets are half-float (else RGBA8: highlights clip). */
+    readonly hdr: boolean;
+    /**
+     * The draw tone-maps inline and renders straight into the RGBA8 target (T0's default,
+     * ADR-0071): no HDR target, no tone-mapping pass.
+     */
+    readonly inlineTone: boolean;
+    /** Where the skinned draws read their palette each frame (`@yali-engine/animation` sets it). */
+    paletteSource: PaletteSource | null;
+    constructor(gl: WebGL2RenderingContext, store: MeshStore, materials: MaterialStore, textures: TextureStore, capacity: number, shadows: GlShadowConfig | null, hdrTarget?: boolean, shadingLevels?: number);
+    /** Always ready: WebGL2 draws node materials as the standard material (ADR-0070). */
+    shadersReady(): Promise<void>;
+    /** GL programs compile when first drawn: nothing to wait for. */
+    drawClassesReady(): Promise<void>;
+    /** The current sky. */
+    get sky(): Readonly<Required<SkyOptions>>;
+    /** Changes the sky (unset fields keep their values) and rebuilds the environment. */
+    setSky(sky: SkyOptions): void;
+    /** Renders the sky into every level of the base cube, copies level 0 and prefilters the rest; projects SH9. */
+    buildEnvironment(): void;
+    writeCullParams(f32: Float32Array, at: number, camera: OrbitCamera, heightPx: number, widthPx?: number): void;
+    /** Instances drawn at each LOD (index 0 = full detail). A diagnostic: it allocates. */
+    drawnByLod(): number[];
+    /**
+     * Uploads this frame: the camera, the lights (packed and binned), the shadow fit, the
+     * materials and geometry that changed, and the CPU-culled instances from linear memory.
+     */
+    upload(heap: Uint8Array, u32: Uint32Array, x: ExtractedInstances | null, camera: OrbitCamera, width: number, height: number, world: World | null, Light: Component | null): void;
+    /** Draws the frame (shadows, scene, tone curve) and presents it to the canvas, `width × height`. */
+    render(width: number, height: number): void;
+    /** The next frame as drawn (rows top first: the offscreen targets have WebGPU's row order). */
+    capture(): Promise<GlCapture>;
+    /** Bytes of the geometry and instance buffers (the memory counter). */
+    get gpuBytes(): number;
+    /** GL buffers this renderer owns (the dispose leak check). */
+    get liveBuffers(): number;
+    /** Debug line segments drawn over the scene each frame (the render plugin's `render.debug`). */
+    debug: DebugLines | null;
+    destroy(): void;
+}