@openglobus/og 0.28.7 → 1.0.0-rc2

package/lib/quadTree/EntityCollectionNode.d.ts

@@ -1,13 +1,13 @@
-import { EntityCollection } from '../entity/EntityCollection';
-import { Extent } from '../Extent';
-import { LonLat } from '../LonLat';
-import { Node } from "../quadTree/Node";
-import { Planet } from "../scene/Planet";
-import { Sphere } from '../bv/Sphere';
-import { Segment } from "../segment/Segment";
-import { Vector } from "../layer/Vector";
-import { Entity } from "../entity/Entity";
-import { EntityCollectionsTreeStrategy } from "./EntityCollectionsTreeStrategy";
+import { EntityCollection } from "../entity/EntityCollection";
+import { Extent } from "../Extent";
+import { LonLat } from "../LonLat";
+import type { Node } from "../quadTree/Node";
+import type { Planet } from "../scene/Planet";
+import { Sphere } from "../bv/Sphere";
+import type { Segment } from "../segment/Segment";
+import type { Vector } from "../layer/Vector";
+import type { Entity } from "../entity/Entity";
+import type { EntityCollectionsTreeStrategy } from "./EntityCollectionsTreeStrategy";
 export type NodesDict = Record<number, Node>;
 /**
  * @todo: remove planet parameter. It's already available in the layer.

package/lib/quadTree/EntityCollectionsTreeStrategy.d.ts

@@ -1,9 +1,9 @@
-import { Vector } from "../layer/Vector";
-import { EntityCollectionNode } from "./EntityCollectionNode";
-import { Entity } from "../entity/Entity";
-import { EntityCollection } from "../entity/EntityCollection";
+import type { Vector } from "../layer/Vector";
+import type { EntityCollectionNode } from "./EntityCollectionNode";
+import type { Entity } from "../entity/Entity";
+import type { EntityCollection } from "../entity/EntityCollection";
 import { QueueArray } from "../QueueArray";
-import { QuadTreeStrategy } from "./QuadTreeStrategy";
+import type { QuadTreeStrategy } from "./QuadTreeStrategy";
 export declare class EntityCollectionsTreeStrategy {
     _layer: Vector;
     /**

package/lib/quadTree/QuadTreeStrategy.d.ts

@@ -9,10 +9,7 @@ import { Extent } from "../Extent";
 import { EntityCollectionsTreeStrategy } from "./EntityCollectionsTreeStrategy";
 import { PlanetCamera } from "../camera";
 import { EventsHandler } from "../Events";
-export type QuadTreeStrategyEventsList = [
-    "rendercompleted",
-    "terraincompleted"
-];
+export type QuadTreeStrategyEventsList = ["rendercompleted", "terraincompleted"];
 export interface QuadTreeStrategyParams {
     planet: Planet;
     name?: string;
@@ -49,6 +46,7 @@ export declare class QuadTreeStrategy {
     _fadingNodes: Map<number, Node>;
     _fadingNodesInFrustum: Node[][];
     _fadingOpaqueSegments: Segment[];
+    _transparentSegments: Segment[];
     /**
      * Current visible minimal zoom index planet segment.
      * @public
@@ -94,6 +92,7 @@ export declare class QuadTreeStrategy {
     get terrainReady(): boolean;
     protected _checkRendercompleted(): void;
     protected _initEvents(): void;
+    protected _updateRenderedNodesInFrustumArray(camera: PlanetCamera): void;
     init(camera: PlanetCamera): void;
     clearRenderedNodes(): void;
     protected _clearRenderedNodeList(): void;

package/lib/quadTree/earth/EarthEntityCollectionNodeLonLat.d.ts

@@ -1,9 +1,9 @@
-import { EarthEntityCollectionsTreeStrategy } from "./EarthEntityCollectionsTreeStrategy";
+import type { EarthEntityCollectionsTreeStrategy } from "./EarthEntityCollectionsTreeStrategy";
 import { Extent } from "../../Extent";
-import { Planet } from "../../scene/Planet";
+import type { Planet } from "../../scene/Planet";
 import { LonLat } from "../../LonLat";
-import { Entity } from "../../entity/Entity";
-import { EntityCollection } from "../../entity/EntityCollection";
+import type { Entity } from "../../entity/Entity";
+import type { EntityCollection } from "../../entity/EntityCollection";
 import { EntityCollectionNode } from "../EntityCollectionNode";
 import type { NodesDict } from "../EntityCollectionNode";
 export declare class EarthEntityCollectionNodeLonLat extends EntityCollectionNode {

package/lib/quadTree/earth/EarthEntityCollectionsTreeStrategy.d.ts

@@ -1,10 +1,10 @@
 import { EntityCollectionNode } from "../EntityCollectionNode";
 import { EarthEntityCollectionNodeLonLat } from "./EarthEntityCollectionNodeLonLat";
-import { Vector } from "../../layer/Vector";
-import { Entity } from "../../entity/Entity";
-import { EntityCollection } from "../../entity/EntityCollection";
+import type { Vector } from "../../layer/Vector";
+import type { Entity } from "../../entity/Entity";
+import type { EntityCollection } from "../../entity/EntityCollection";
 import { EntityCollectionsTreeStrategy } from "../EntityCollectionsTreeStrategy";
-import { QuadTreeStrategy } from "../QuadTreeStrategy";
+import type { QuadTreeStrategy } from "../QuadTreeStrategy";
 export declare class EarthEntityCollectionsTreeStrategy extends EntityCollectionsTreeStrategy {
     protected _entityCollectionsTree: EntityCollectionNode;
     protected _entityCollectionsTreeNorth: EarthEntityCollectionNodeLonLat;

package/lib/renderer/AtmosphereDeferredShading.d.ts

@@ -0,0 +1,12 @@
+import { PhongDeferredShading } from "./PhongDeferredShading";
+import type { Renderer } from "./Renderer";
+import type { Atmosphere } from "../control/atmosphere/Atmosphere";
+import type { AtmosphereParameters } from "../shaders/atmos/atmos";
+export declare class AtmosphereDeferredShading extends PhongDeferredShading {
+    protected _atmosphere: Atmosphere;
+    protected _atmosParams: AtmosphereParameters;
+    constructor(renderer: Renderer, atmosphere: Atmosphere, atmosParams: AtmosphereParameters);
+    init(): void;
+    dispose(): void;
+    protected _deferredShadingPASS(): void;
+}

package/lib/renderer/IDeferredShadingPass.d.ts

@@ -0,0 +1,8 @@
+export interface IDeferredShadingPass {
+    init(): void;
+    beginPass(): void;
+    endPass(): void;
+    applyLighting(): void;
+    resize(width: number, height: number): void;
+    dispose(): void;
+}

package/lib/renderer/ITransparencyPass.d.ts

@@ -0,0 +1,8 @@
+export interface ITransparencyPass {
+    init(): void;
+    beginPass(): void;
+    endPass(): void;
+    resolve(): void;
+    resize(width: number, height: number): void;
+    dispose(): void;
+}

package/lib/renderer/PhongDeferredShading.d.ts

@@ -0,0 +1,16 @@
+import { Framebuffer } from "../webgl/Framebuffer";
+import type { IDeferredShadingPass } from "./IDeferredShadingPass";
+import type { Renderer } from "./Renderer";
+export declare class PhongDeferredShading implements IDeferredShadingPass {
+    protected _renderer: Renderer;
+    protected _framebuffer: Framebuffer | null;
+    constructor(renderer: Renderer);
+    init(): void;
+    beginPass(): void;
+    endPass(): void;
+    applyLighting(): void;
+    resize(width: number, height: number): void;
+    dispose(): void;
+    protected _applyDeferredDepth(): void;
+    protected _deferredShadingPASS(): void;
+}

package/lib/renderer/Renderer.d.ts

@@ -2,17 +2,22 @@ import { Camera } from "../camera/Camera";
 import { Control } from "../control/Control";
 import type { IBaseInputState, RendererEventsHandler } from "./RendererEvents";
 import { EntityCollection } from "../entity/EntityCollection";
-import { Framebuffer, Multisample } from "../webgl/index";
+import { Framebuffer, Multisample, ShaderProgram } from "../webgl/index";
 import { FontAtlas } from "../utils/FontAtlas";
 import { Handler } from "../webgl/Handler";
-import type { WebGLBufferExt } from "../webgl/Handler";
-import { LabelWorker } from "../entity/LabelWorker";
-import { RenderNode } from "../scene/RenderNode";
+import type { WebGLBufferExt, WebGLTextureExt } from "../webgl/Handler";
+import { LabelWorker } from "../entity/label/LabelWorker";
+import { Scene } from "../scene/Scene";
+import type { IDeferredShadingPass } from "./IDeferredShadingPass";
+import type { ITransparencyPass } from "./ITransparencyPass";
+import { TextureResourceManager } from "../utils/TextureResourceManager";
+import type { RendererTextureRequest } from "../utils/TextureResourceManager";
 import { TextureAtlas } from "../utils/TextureAtlas";
 import { Vec2 } from "../math/Vec2";
 import { Vec3 } from "../math/Vec3";
 import type { NumberArray3 } from "../math/Vec3";
 import { Vec4 } from "../math/Vec4";
+import type { NumberArray4 } from "../math/Vec4";
 export interface IRendererParams {
     controls?: Control[];
     msaa?: number;
@@ -22,6 +27,10 @@ export interface IRendererParams {
     exposure?: number;
     dpi?: number;
     clearColor?: [number, number, number, number];
+    lightPosition?: NumberArray3;
+    lightAmbient?: NumberArray3;
+    lightDiffuse?: NumberArray3;
+    lightSpecular?: NumberArray4;
 }
 interface IPickingObject {
     _pickingColor?: Vec3;
@@ -33,37 +42,49 @@ interface IFrameCallbackHandler {
     sender: any;
 }
 /**
- * Represents high level WebGL context interface that starts WebGL handler working in real time.
+ * High-level WebGL interface that runs the WebGL handler in real time.
  * @class
- * @param {Handler} handler - WebGL handler context.
- * @param {Object} [params] - Renderer parameters:
- * @fires RendererEventsHandler<RendererEventsType>#draw
- * @fires RendererEventsHandler<RendererEventsType>#resize
- * @fires RendererEventsHandler<RendererEventsType>#mousemove
- * @fires RendererEventsHandler<RendererEventsType>#mousestop
- * @fires RendererEventsHandler<RendererEventsType>#lclick
- * @fires RendererEventsHandler<RendererEventsType>#rclick
- * @fires RendererEventsHandler<RendererEventsType>#mclick
- * @fires RendererEventsHandler<RendererEventsType>#ldblclick
- * @fires RendererEventsHandler<RendererEventsType>#rdblclick
- * @fires RendererEventsHandler<RendererEventsType>#mdblclick
- * @fires RendererEventsHandler<RendererEventsType>#lup
- * @fires RendererEventsHandler<RendererEventsType>#rup
- * @fires RendererEventsHandler<RendererEventsType>#mup
- * @fires RendererEventsHandler<RendererEventsType>#ldown
- * @fires RendererEventsHandler<RendererEventsType>#rdown
- * @fires RendererEventsHandler<RendererEventsType>#mdown
- * @fires RendererEventsHandler<RendererEventsType>#lhold
- * @fires RendererEventsHandler<RendererEventsType>#rhold
- * @fires RendererEventsHandler<RendererEventsType>#mhold
- * @fires RendererEventsHandler<RendererEventsType>#mousewheel
- * @fires RendererEventsHandler<RendererEventsType>#touchstart
- * @fires RendererEventsHandler<RendererEventsType>#touchend
- * @fires RendererEventsHandler<RendererEventsType>#touchcancel
- * @fires RendererEventsHandler<RendererEventsType>#touchmove
- * @fires RendererEventsHandler<RendererEventsType>#doubletouch
- * @fires RendererEventsHandler<RendererEventsType>#touchleave
- * @fires RendererEventsHandler<RendererEventsType>#touchenter
+ * @param {Handler | string | HTMLCanvasElement} handler - WebGL handler instance or canvas target selector/element.
+ * @param {IRendererParams} [params={}] - Renderer parameters:
+ *     - controls: Control instances to add to the renderer
+ *     - msaa: MSAA (Multi-Sample Anti-Aliasing) level
+ *     - autoActivate: Start rendering automatically after creation
+ *     - fontsSrc: Path to font resources
+ *     - gamma: Gamma correction value
+ *     - exposure: HDR exposure value
+ *     - dpi: Device pixel ratio
+ *     - clearColor: RGBA clear color array
+ *     - lightPosition: Light position `[x, y, z]`
+ *     - lightAmbient: Light ambient color `[r, g, b]`
+ *     - lightDiffuse: Light diffuse color `[r, g, b]`
+ *     - lightSpecular: Light specular `[r, g, b, shininess]`
+ * @fires draw - Triggered before each frame is rendered.
+ * @fires resize - Triggered when the canvas is resized.
+ * @fires mousemove - Triggered when the mouse moves over the canvas.
+ * @fires mousestop - Triggered when the mouse stops moving.
+ * @fires lclick - Triggered on left mouse button click.
+ * @fires rclick - Triggered on right mouse button click.
+ * @fires mclick - Triggered on middle mouse button click.
+ * @fires ldblclick - Triggered on left mouse button double-click.
+ * @fires rdblclick - Triggered on right mouse button double-click.
+ * @fires mdblclick - Triggered on middle mouse button double-click.
+ * @fires lup - Triggered when the left mouse button is released.
+ * @fires rup - Triggered when the right mouse button is released.
+ * @fires mup - Triggered when the middle mouse button is released.
+ * @fires ldown - Triggered when the left mouse button is pressed.
+ * @fires rdown - Triggered when the right mouse button is pressed.
+ * @fires mdown - Triggered when the middle mouse button is pressed.
+ * @fires lhold - Triggered while the left mouse button is held.
+ * @fires rhold - Triggered while the right mouse button is held.
+ * @fires mhold - Triggered while the middle mouse button is held.
+ * @fires mousewheel - Triggered on mouse wheel scroll.
+ * @fires touchstart - Triggered on touch start.
+ * @fires touchend - Triggered on the touch end.
+ * @fires touchcancel - Triggered on touch cancel.
+ * @fires touchmove - Triggered on touch move.
+ * @fires doubletouch - Triggered on double touch.
+ * @fires touchleave - Triggered when touch leaves the canvas.
+ * @fires touchenter - Triggered when touch enters the canvas.
  */
 export interface HTMLDivElementExt extends HTMLDivElement {
     attributions?: HTMLElement;
@@ -75,6 +96,9 @@ declare class Renderer {
      * @type {HTMLElement | null}
      */
     div: HTMLDivElementExt | null;
+    protected _topLeftContainer: HTMLDivElement;
+    protected _topRightContainer: HTMLDivElement;
+    protected _bottomRightContainer: HTMLDivElement;
     /**
      * WebGL handler context.
      * @public
@@ -88,15 +112,15 @@ declare class Renderer {
     /**
      * Render nodes drawing queue.
      * @public
-     * @type {Array.<RenderNode>}
+     * @type {Array.<Scene>}
      */
-    _renderNodesArr: RenderNode[];
+    _scenesArr: Scene[];
     /**
      * Render nodes store for the comfortable access by the node name.
      * @public
-     * @type {Object.<RenderNode>}
+     * @type {Object.<Scene>}
      */
-    renderNodes: Record<string, RenderNode>;
+    scenes: Record<string, Scene>;
     /**
      * Current active camera.
      * @public
@@ -133,7 +157,7 @@ declare class Renderer {
      */
     protected _pickingCallbacks: IFrameCallbackHandler[];
     /**
-     * Picking objects(labels and billboards) framebuffer.
+     * Picking objects (labels and billboards) framebuffer.
      * @public
      * @type {Framebuffer}
      */
@@ -146,15 +170,16 @@ declare class Renderer {
     depthFramebuffer: Framebuffer | null;
     protected _msaa: number;
     protected _internalFormat: string;
-    protected _format: string;
-    protected _type: string;
+    protected _depthComponent: string;
     protected _depthRefreshRequired: boolean;
-    sceneFramebuffer: Framebuffer | Multisample | null;
-    protected blitFramebuffer: Framebuffer | null;
+    forwardFramebuffer: Multisample | null;
+    protected hdrFramebuffer: Framebuffer | null;
+    deferredShadingPass: IDeferredShadingPass;
+    transparencyPass: ITransparencyPass;
     protected toneMappingFramebuffer: Framebuffer | null;
     protected _initialized: boolean;
     /**
-     * Texture atlas for the billboards images.
+     * Texture atlas for the billboard images.
      * @public
      * @type {TextureAtlas}
      */
@@ -166,99 +191,125 @@ declare class Renderer {
      */
     fontAtlas: FontAtlas;
     /**
-     * Texture atlas for the rays, polylines and strips entities.
+     * Texture atlas for the rays, polylines, and strips entities.
      * @public
      * @type {TextureAtlas}
      */
     strokeTextureAtlas: TextureAtlas;
     protected _entityCollections: EntityCollection[][];
     protected _currentOutput: string;
-    protected _fnScreenFrame: Function | null;
     labelWorker: LabelWorker;
     screenDepthFramebuffer: Framebuffer | null;
     screenFramePositionBuffer: WebGLBufferExt | null;
     screenTexture: Record<string, WebGLTexture>;
     outputTexture: WebGLTexture | null;
-    protected _readPickingBuffer: () => void;
     clearColor: Float32Array;
+    protected _textureResourceManager: TextureResourceManager;
+    _lightPosition: Float32Array;
+    _lightAmbient: Float32Array;
+    _lightDiffuse: Float32Array;
+    _lightSpecular: Float32Array;
     constructor(handler: Handler | string | HTMLCanvasElement, params?: IRendererParams);
     enableBlendOneSrcAlpha(): void;
+    set lightAmbient(lightAmbient: NumberArray3 | Float32Array);
+    get lightAmbient(): NumberArray3;
+    set lightDiffuse(lightDiffuse: NumberArray3 | Float32Array);
+    get lightDiffuse(): NumberArray3;
+    set lightSpecular(lightSpecular: NumberArray4 | Float32Array);
+    get lightSpecular(): NumberArray4;
     enableBlendDefault(): void;
+    enableBlendWoit(): void;
+    /**
+     * Sets depth compare and clear value for the camera (reverse-Z vs classic).
+     * Pass null to restore the classic depth state:
+     * depthFunc(LESS), clearDepth(1), and clip-control NEGATIVE_ONE_TO_ONE.
+     */
+    applyDepthForCamera(camera?: Camera | null): void;
     setRelativeCenter(c?: Vec3): void;
     /**
-     * Sets renderer events activity.
-     * @param {Boolean} activity - Events activity.
+     * Enables or disables renderer events.
+     * @public
+     * @param {boolean} activity - Events activity flag.
      */
     setEventsActivity(activity: boolean): void;
     addDepthCallback(sender: any, callback: Function): number;
     removeDepthCallback(id: number): void;
     /**
-     * Adds picking rendering callback function.
-     * @param {object} sender - Callback context.
-     * @param {Function} callback - Rendering callback.
-     * @returns {Number} Handler id
+     * Adds a picking render callback.
+     * @public
+     * @param {any} sender - Callback context.
+     * @param {Function} callback - Render callback function.
+     * @returns {number} Callback ID.
      */
     addPickingCallback(sender: any, callback: Function): number;
     /**
-     * Removes picking rendering callback function.
-     * @param {Number} id - Handler id to remove.
+     * Removes a picking render callback.
+     * @public
+     * @param {number} id - Callback ID to remove.
      */
     removePickingCallback(id: number): void;
     getPickingObject<T>(r: number, g: number, b: number): T;
     getPickingObjectArr<T>(arr: NumberArray3 | Uint8Array): T;
     getPickingObject3v<T>(vec: Vec3 | Vec4): T;
     /**
-     * Assign picking color to the object.
+     * Assigns a picking color to an object.
      * @public
-     * @param {Object} obj - Object that presume to be picked.
+     * @param {Object} obj - Object that receives a picking color.
      */
     assignPickingColor<T>(obj: T & IPickingObject): void;
     /**
-     * Removes picking color from object.
+     * Removes the picking color from an object.
      * @public
-     * @param {Object} obj - Object to remove picking color.
+     * @param {Object} obj - Object to clear the picking color from.
      */
     clearPickingColor<T>(obj: T & IPickingObject): void;
+    get viewportWidth(): number;
+    get viewportHeight(): number;
+    get internalFormat(): string;
+    get depthComponent(): string;
     /**
-     * Get the client width.
+     * Returns the canvas client width.
      * @public
-     * @returns {number} -
+     * @returns {number}
      */
     getWidth(): number;
     /**
-     * Get the client height.
+     * Returns the canvas client height.
      * @public
-     * @returns {number} -
+     * @returns {number}
      */
     getHeight(): number;
     /**
-     * Get center of the canvas
+     * Returns the canvas viewport center.
      * @public
-     * @returns {Vec2} -
+     * @returns {Vec2}
      */
-    getCenter(): Vec2;
+    getViewportCenter(): Vec2;
     /**
-     * Get center of the screen viewport
+     * Adds a control to the renderer.
      * @public
-     * @returns {Vec2} -
-     */
-    getClientCenter(): Vec2;
-    /**
-     * Add the given control to the renderer.
      * @param {Control} control - Control.
      */
     addControl(control: Control): void;
     /**
-     * Add the given controls array to the planet node.
+     * Adds an array of controls to the renderer.
+     * @public
      * @param {Array.<Control>} cArr - Control array.
      */
     addControls(cArr: Control[]): void;
     /**
-     * Remove control from the renderer.
-     * @param {Control} control  - Control.
+     * Removes a control from the renderer.
+     * @public
+     * @param {Control} control - Control.
      */
     removeControl(control: Control): void;
     isInitialized(): boolean;
+    protected _appendControlContainers(): void;
+    acquireTexture(params: RendererTextureRequest): WebGLTextureExt | null;
+    releaseTexture(texture: WebGLTextureExt | null | undefined): void;
+    topLeftContainer(): HTMLDivElement;
+    topRightContainer(): HTMLDivElement;
+    bottomRightContainer(): HTMLDivElement;
     /**
      * Renderer initialization.
      * @public
@@ -269,42 +320,42 @@ declare class Renderer {
     setCurrentScreen(screenName: string): void;
     _resizeStart(): void;
     _resizeEnd(): void;
-    removeNode(renderNode: RenderNode): void;
+    removeNode(scene: Scene): void;
     /**
-     * Adds render node to the renderer.
+     * Adds a scene to the renderer.
      * @public
-     * @param {RenderNode} renderNode - Render node.
+     * @param {Scene} scene - Scene.
      */
-    addNode(renderNode: RenderNode): void;
-    protected _initializeRenderNodes(): void;
+    addScene(scene: Scene): void;
+    protected _initializeScenes(): void;
     /**
-     * Adds render node to the renderer before specific node.
+     * Adds a scene to the renderer before a specific node.
      * @public
-     * @param {RenderNode} renderNode - Render node.
-     * @param {RenderNode} renderNodeBefore - Insert before the renderNodeBefore node.
+     * @param {Scene} scene - Render node.
+     * @param {Scene} sceneBefore - Insert before the sceneBefore node.
      */
-    addNodeBefore(renderNode: RenderNode, renderNodeBefore: RenderNode): void;
+    addSceneBefore(scene: Scene, sceneBefore: Scene): void;
     /**
-     * Adds render nodes array to the renderer.
+     * Adds scenes to the renderer.
      * @public
-     * @param {Array.<RenderNode>} nodesArr - Render nodes array.
+     * @param {Array.<Scene>} nodesArr - Render nodes array.
      */
-    addNodes(nodesArr: RenderNode[]): void;
-    getMaxMSAA(internalFormat: string): any;
+    addScenes(nodesArr: Scene[]): void;
+    getMaxMSAA(internalFormat: string): number;
     getMSAA(): number;
     /**
-     * TODO: replace with cache friendly linked list by BillboardHandler, LabelHandler etc.
+     * TODO: replace with cache-friendly linked list by BillboardHandler, LabelHandler etc.
      */
     enqueueEntityCollectionsToDraw(ecArr: EntityCollection[], depthOrder?: number): void;
     /**
      * Forces the depth buffer to be refreshed in the next frame.
-     * Has effect for terrain altitude estimate precision.
+     * Has an effect for terrain altitude estimate precision.
      */
     markForDepthRefresh(): void;
-    /**
-     * @protected
-     */
-    protected _drawEntityCollections(depthOrder: number): void;
+    protected _drawGBufferEntityCollections(depthOrder: number): void;
+    protected _drawForwardEntityCollections(depthOrder: number): void;
+    protected _drawTransparentEntityCollections(depthOrder: number): void;
+    protected _drawTransparentEntityCollectionsForward(depthOrder: number): void;
     protected _drawPickingEntityCollections(depthOrder: number): void;
     protected _drawDepthEntityCollections(depthOrder: number): void;
     protected _clearEntityCollectionQueue(depthOrder: number): void;
@@ -313,9 +364,7 @@ declare class Renderer {
      * @public
      */
     draw(): void;
-    getImageDataURL(type?: string, quality?: number): string;
-    protected _screenFrameMSAA(): void;
-    protected _screenFrameNoMSAA(): void;
+    protected _screenFrame(): void;
     /**
      * Draw picking objects framebuffer.
      * @private
@@ -323,8 +372,7 @@ declare class Renderer {
     protected _drawPickingBuffer(depthOrder: number): void;
     protected _drawDepthBuffer(depthOrder: number): void;
     protected _readDepthBuffer(callback?: () => void): void;
-    protected _readPickingBuffer_webgl1(): void;
-    protected _readPickingBuffer_webgl2(): void;
+    protected _readPickingBuffer(): void;
     readPickingColor(x: number, y: number, outColor: NumberArray3 | Uint8Array): void;
     readDepth(x: number, y: number, outDepth: NumberArray3 | Float32Array): void;
     /**
@@ -351,5 +399,24 @@ declare class Renderer {
      */
     start(): void;
     destroy(): void;
+    /**
+     * Adds a shader program to the renderer if it has not been added yet.
+     * @public
+     * @param {ShaderProgram} program - ShaderProgram instance.
+     */
+    addProgram(program: ShaderProgram): void;
+    /**
+     * Adds one or more programs to the renderer.
+     * Supports both individual programs and nested program arrays.
+     * @public
+     * @param {...(ShaderProgram | ShaderProgram[])} programs - ShaderProgram list.
+     */
+    addPrograms(...programs: (ShaderProgram | ShaderProgram[])[]): void;
+    /**
+     * Alias for {@link Renderer.addPrograms}.
+     * @public
+     * @param {...(ShaderProgram | ShaderProgram[])} programs - ShaderProgram list.
+     */
+    addShaders(...programs: (ShaderProgram | ShaderProgram[])[]): void;
 }
 export { Renderer };

package/lib/renderer/RendererEvents.d.ts

@@ -7,13 +7,17 @@ import { Renderer } from "./Renderer";
 import { PointerHandler, type PointerEventExt } from "../input/PointerHandler";
 import { Vec2 } from "../math/Vec2";
 import { Vec3 } from "../math/Vec3";
+import { Ray } from "../math/Ray";
 export type RendererEventsHandler = RendererEvents & EventsHandler<RendererEventsType>;
 export declare function createRendererEvents(renderer: Renderer): RendererEvents;
 export type RendererEventsType = [
     "projchanged",
     "changerelativecenter",
     "draw",
-    "drawtransparent",
+    "forwardpass",
+    "postforwardpass",
+    "transparentpass",
+    "gbufferpass",
     "postdraw",
     "resize",
     "resizeend",
@@ -66,6 +70,12 @@ export interface IBaseInputState {
     prev_y: number;
     /** Screen touch position world direction. */
     direction: Vec3;
+    /**
+     * World-space picking ray.
+     * Perspective: origin is camera.eye.
+     * Orthographic: origin is per-pixel on the view plane, direction is camera forward.
+     */
+    ray: Ray;
     /** Current touched(picking) object. */
     pickingObject: any | null;
     /** Renderer instance. */
@@ -106,9 +116,9 @@ export interface IMouseState extends IBaseInputState {
     middleButtonClick: boolean;
     /** Mouse has just stopped now. */
     justStopped: boolean;
-    /** Mose double click delay response time.*/
+    /** Mouse double-click delay response time. */
     doubleClickDelay: number;
-    /** Mose click delay response time.*/
+    /** Mouse click delay response time. */
     clickDelay: number;
     /** Mouse wheel. */
     wheelDelta: number;
@@ -125,9 +135,9 @@ export interface ITouchState extends IBaseInputState {
     touchCancel: boolean;
     /** Touched twice.*/
     doubleTouch: boolean;
-    /** Double touching responce delay.*/
+    /** Double-touch response delay. */
     doubleTouchDelay: number;
-    /** Double touching responce radius in screen pixels.*/
+    /** Double-touch response radius in screen pixels. */
     doubleTouchRadius: number;
     /** Currently touching.*/
     touching: boolean;