@react-x11/components 0.1.0 → 0.2.1

package/dist/three/renderer-direct.d.ts

@@ -0,0 +1,102 @@
+type GL = any;
+import type { BufferGeometry } from './geometries.js';
+import type { Camera, Scene } from './objects.js';
+import type { TextureImage } from './materials.js';
+import type { FrameCamera } from './renderer-indirect.js';
+export interface CompiledProgram {
+    program: unknown;
+    uniform(name: string): unknown;
+    attribute(name: string): number;
+}
+/**
+ * Per-surface GPU state for the direct backend: one buffer set per geometry,
+ * one program per material configuration, one texture per image.
+ */
+export declare class DirectRenderer {
+    readonly backend = "direct";
+    private geometries;
+    private programs;
+    private textures;
+    private failed;
+    private wireWarned;
+    private _usable;
+    camera: FrameCamera | null;
+    /** A shader that will not build is reported here, once per source. */
+    onError: ((err: Error & {
+        code?: string;
+    }) => void) | null;
+    render(gl: GL, scene: Scene, camera: Camera, size: {
+        width: number;
+        height: number;
+    }): boolean;
+    /**
+     * Does this context have the GL entry points a material needs? It can
+     * genuinely lack them: ntk passes the `x11-dri` addon's table straight
+     * through, so the context is only as complete as the addon installed. The
+     * failure without this check is a `TypeError` from inside a draw call,
+     * which names nothing a consumer could act on.
+     */
+    private usable;
+    /**
+     * Lights as flat arrays in view space, which is where the shader works.
+     * Transformed here rather than in the shader for the same reason
+     * fixed-function GL transforms them when they are set: once per frame
+     * beats once per fragment.
+     */
+    private lightUniforms;
+    private drawObject;
+    private drawMesh;
+    /** One draw of `buffers` at `world`, as whichever primitive. */
+    private drawOne;
+    private bindAttributes;
+    /**
+     * Upload a geometry once and keep it on the GPU. The indirect backend
+     * compiles geometry into a display list for exactly the same reason —
+     * never send the vertices twice — and the cache is keyed the same way, by
+     * object identity and version.
+     */
+    private geometryFor;
+    private releaseGeometry;
+    /**
+     * The unique-edge index that draws `node` as a wireframe. The indirect
+     * backend flips one server-side switch (`PolygonMode LINE`); ES 2 has no
+     * polygon modes, so this backend does what three.js's `WireframeGeometry`
+     * does — every triangle edge once, drawn as `LINES` over the same vertex
+     * buffers. Built on first use, cached until the geometry rebuilds.
+     */
+    private wireframeFor;
+    /** Compile once per material configuration, reuse for every mesh using it. */
+    private programFor;
+    /** Lent to the post-processor, so a pass that will not build is reported
+     * exactly the way a material that will not build is. */
+    compile(gl: GL, source: {
+        vertex: string;
+        fragment: string;
+    }, signature: string, kind: string): {
+        program: unknown;
+    } | CompiledProgram;
+    /**
+     * A shader that will not build is reported once and then skipped.
+     * Throwing would take down a render that is otherwise fine, and repeating
+     * it every frame would bury the message it came with — the compiler's own
+     * log, the only thing that says what to fix.
+     */
+    report(signature: string, message: string, code?: string): void;
+    /** `<shaderPass uniforms>` reads like a `<shaderMaterial>`'s. */
+    setUniform(gl: GL, location: unknown, value: unknown): void;
+    private applyMaterial;
+    /** Blending, culling and depth writes — the state a material implies. */
+    private applyDrawState;
+    private cameraPosition;
+    /**
+     * Upload an image once and bind it to a texture unit. `map` is an ntk
+     * `Image`, or anything with `{ width, height, data }` in RGBA byte order —
+     * the same contract the indirect renderer takes.
+     */
+    textureFor(gl: GL, image: TextureImage): number;
+    /** A removed geometry's buffers are no longer needed on the GPU. */
+    forget(gl: GL, node: BufferGeometry): void;
+    dispose(gl: GL): void;
+}
+export {};
+//# sourceMappingURL=renderer-direct.d.ts.map

package/dist/three/renderer-direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-direct.d.ts","sourceRoot":"","sources":["../../src/three/renderer-direct.ts"],"names":[],"mappings":"AAkBA,KAAK,EAAE,GAAG,GAAG,CAAC;AAId,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,MAAM,EAMN,KAAK,EAEN,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAY,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAY3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAiN1D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAYD;;;GAGG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,YAAY;IAE5B,OAAO,CAAC,UAAU,CAGd;IACJ,OAAO,CAAC,QAAQ,CAA6D;IAC7E,OAAO,CAAC,QAAQ,CAGZ;IACJ,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,OAAO,CAAsB;IAErC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;IAClC,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAElE,MAAM,CACJ,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAgBT;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IA2Bd;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAqFrB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,QAAQ;IA+DhB,gEAAgE;IAChE,OAAO,CAAC,OAAO;IA8Bf,OAAO,CAAC,cAAc;IAkBtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAyFnB,OAAO,CAAC,eAAe;IAWvB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IA+CpB,8EAA8E;IAC9E,OAAO,CAAC,UAAU;IAuClB;4DACwD;IACxD,OAAO,CACL,EAAE,EAAE,EAAE,EACN,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,eAAe,CAoDxC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,SAAqB,GAAG,IAAI,CAS1E;IAED,iEAAiE;IACjE,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAE1D;IAED,OAAO,CAAC,aAAa;IAiGrB,yEAAyE;IACzE,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,cAAc;IAStB;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAqC9C;IAED,oEAAoE;IACpE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAOzC;IAED,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAgBpB;CACF"}