t3d-ez.gl 0.0.1

package/dist/types/core/PostProcessor/effects/SAOEffect.d.ts

@@ -0,0 +1,14 @@
+import { OutputPass } from "three/examples/jsm/postprocessing/OutputPass.js";
+import { SAOPass } from "three/examples/jsm/postprocessing/SAOPass.js";
+import { Pass } from "three/examples/jsm/postprocessing/Pass.js";
+import { PostProcessor } from "..";
+import { PotateEffect } from "./PotateEffect";
+export declare class SAOEffect extends PotateEffect {
+    name: string;
+    type: string;
+    passes: Map<string, Pass> | null;
+    saoPass: SAOPass;
+    outputPass: OutputPass;
+    constructor(postProcessor: PostProcessor);
+    dispose(): void;
+}

package/dist/types/core/PostProcessor/effects/UnrealBloomEffect.d.ts

@@ -0,0 +1,24 @@
+import { OutputPass } from "three/examples/jsm/postprocessing/OutputPass.js";
+import { Pass } from "three/examples/jsm/postprocessing/Pass.js";
+import { UnrealBloomPass } from "three/examples/jsm/postprocessing/UnrealBloomPass.js";
+import { Vector2 } from "three";
+import { PostProcessor } from "..";
+import { PotateEffect } from "./PotateEffect";
+interface IBloomEffectOptions {
+    strength: number;
+    radius: number;
+    threshold: number;
+    resolution?: Vector2;
+}
+export declare class UnrealBloomEffect extends PotateEffect {
+    name: string;
+    type: string;
+    passes: Map<string, Pass> | null;
+    unrealBloomPass: UnrealBloomPass;
+    outputPass: OutputPass;
+    params: IBloomEffectOptions;
+    constructor(postProcessor: PostProcessor, options?: IBloomEffectOptions);
+    setAttibutes(key: keyof typeof this.params, value: any): void;
+    dispose(): void;
+}
+export {};

package/dist/types/core/PostProcessor/effects/index.d.ts

@@ -0,0 +1,4 @@
+export { PotateEffect } from "./PotateEffect";
+export { SAOEffect } from "./SAOEffect";
+export { OutlineEffect } from "./OutlineEffect";
+export { UnrealBloomEffect } from "./UnrealBloomEffect";

package/dist/types/core/PostProcessor/index.d.ts

@@ -0,0 +1,21 @@
+import { WebGLRenderTarget } from "three";
+import { EffectComposer } from "three/examples/jsm/postprocessing/EffectComposer.js";
+import { SMAAPass } from "three/examples/jsm/postprocessing/SMAAPass.js";
+import { PotatoEngine } from "../WebGLEngine";
+import { PotateEffect } from "./effects";
+import { ShaderPass } from 'three/examples/jsm/postprocessing/ShaderPass.js';
+export declare class PostProcessor extends EffectComposer {
+    name: string;
+    type: string;
+    engine: PotatoEngine;
+    effects: Map<string, any>;
+    SmaaPass: SMAAPass;
+    gammaCorrectionShader: ShaderPass;
+    constructor(engine: PotatoEngine, renderTarget?: WebGLRenderTarget);
+    addEffect(effect: PotateEffect): void;
+    removeEffect(effect: PotateEffect): void;
+    open(): void;
+    close(): void;
+    dispose(): void;
+}
+export * from "./effects";

package/dist/types/core/Resource/ResourceManager.d.ts

@@ -0,0 +1,25 @@
+import { LoadingManager, Texture } from "three";
+import { GLTF } from "./types";
+import { IPotatoEngine } from "../WebGLEngine/types/index";
+type rsManagerType = {
+    url: string;
+    loadingManager?: LoadingManager;
+};
+export declare class ResourceManager {
+    type: string;
+    engine: IPotatoEngine;
+    LoaderMaps: Map<string, import("three/examples/jsm/loaders/GLTFLoader").GLTFLoader | import("three/examples/jsm/loaders/RGBELoader").RGBELoader | import("three").TextureLoader>;
+    RESOURCE_TYPE: Readonly<{
+        GLTF: "GLTF_MODEL";
+        HDR: "HDR";
+        TEXTURE: "TEXTURE";
+    }>;
+    constructor(engine: IPotatoEngine);
+    loadGLTF(options?: rsManagerType, onLoad?: <T extends GLTF>(result: T) => void): void;
+    loadGLTFAsync(options?: rsManagerType): Promise<GLTF>;
+    loadHDR(options?: rsManagerType, onLoad?: <T extends Texture>(result: T) => void): void;
+    loadHDRAsync(options?: rsManagerType): Promise<Texture>;
+    loadTexture(options?: rsManagerType, onLoad?: <T extends Texture>(result: T) => void): void;
+    loadTextureAsync(options?: rsManagerType): Promise<Texture>;
+}
+export {};

package/dist/types/core/Resource/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ResourceManager";
+export { RESOURCE_TYPE } from "./types";
+export * from "./loaders";

package/dist/types/core/Resource/loaders.d.ts

@@ -0,0 +1,6 @@
+import { TextureLoader } from 'three';
+import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { RGBELoader } from 'three/examples/jsm/loaders/RGBELoader.js';
+export { GLTFLoader };
+type loadType = GLTFLoader | RGBELoader | TextureLoader;
+export declare const LoaderMaps: Map<string, loadType>;

package/dist/types/core/Resource/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * resource types
+ */
+import { AnimationClip, Group, Camera } from "three";
+export declare const RESOURCE_TYPE: Readonly<{
+    GLTF: "GLTF_MODEL";
+    HDR: "HDR";
+    TEXTURE: "TEXTURE";
+}>;
+export interface GLTF {
+    animations: AnimationClip[];
+    scene: Group;
+    scenes: Group[];
+    cameras: Camera[];
+    asset: {
+        copyright?: string | undefined;
+        generator?: string | undefined;
+        version?: string | undefined;
+        minVersion?: string | undefined;
+        extensions?: any;
+        extras?: any;
+    };
+    userData: Record<string, any>;
+}

package/dist/types/core/WebGLEngine/index.d.ts

@@ -0,0 +1,43 @@
+import { Scene, PerspectiveCamera, WebGLRenderer, Camera, OrthographicCamera } from "three";
+import { IPotatoEngineParameters, IPotatoEngine } from "./types/index";
+import { ControlsManager, CONTROL_TYPE } from "../Controls/index";
+import { ResourceManager } from "../Resource/ResourceManager";
+import { PostProcessor } from "../PostProcessor";
+import { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
+import { MarkerHtmlUI } from "../MarkerHtmlUI";
+type TrunParams = (params: {
+    sceneGraph: Scene;
+    camera: Camera;
+    renderer: WebGLRenderer;
+}) => void;
+declare class PotatoEngine implements IPotatoEngine {
+    container: HTMLElement;
+    activeCanvas: HTMLCanvasElement | null;
+    parameters: IPotatoEngineParameters;
+    renderScopes: Set<TrunParams>;
+    sceneGraph: Scene;
+    camera: PerspectiveCamera | OrthographicCamera;
+    controls: OrbitControls;
+    renderer: WebGLRenderer;
+    VERSION: string;
+    CONTROL_TYPE: typeof CONTROL_TYPE;
+    resourceManager: ResourceManager;
+    controlsManager: ControlsManager;
+    plugins: Map<string, any>;
+    isPostProcessing: boolean;
+    markerHtmlUI: MarkerHtmlUI;
+    postProcessor: PostProcessor;
+    private animateTimer;
+    constructor(parameters?: IPotatoEngineParameters);
+    create(parameters: IPotatoEngineParameters): Promise<this>;
+    static createScene(parameters: IPotatoEngineParameters): Scene<import("three").Object3DEventMap>;
+    static createCamera(parameters: IPotatoEngineParameters, container: HTMLElement): PerspectiveCamera | OrthographicCamera;
+    static createRenderer(parameters: IPotatoEngineParameters, container?: HTMLElement): WebGLRenderer;
+    runRenderLoop(handler?: TrunParams): void;
+    addRunScope(handler: TrunParams): void;
+    attachControl(type: any): OrbitControls | undefined;
+    stopRenderLoop(): void;
+    regieterPlugin(name: string, plugin: any): void;
+    private initEngineInfo;
+}
+export { PotatoEngine };

package/dist/types/core/WebGLEngine/types/index.d.ts

@@ -0,0 +1,25 @@
+import { Scene, Camera, WebGLRenderer } from "three";
+export interface IPotatoEngineParameters {
+    container: HTMLElement | string;
+    antialias?: boolean;
+    alpha?: boolean;
+    backgroundColor?: number | string;
+    camera?: string;
+    isPostProcessing?: boolean;
+}
+export interface IPotatoEngine {
+    create(parameters: IPotatoEngineParameters): Promise<IPotatoEngine>;
+    runRenderLoop(handler?: (parameters: {
+        sceneGraph: Scene;
+        camera: Camera;
+        renderer: WebGLRenderer;
+    }) => void): void;
+    addRunScope(handler: (parameters: {
+        sceneGraph: Scene;
+        camera: Camera;
+        renderer: WebGLRenderer;
+    }) => void): void;
+}
+export interface IPlugin {
+    name: string;
+}

package/dist/types/core/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./Meshes/index";
+export * from "./WebGLEngine/index";
+export * from "./Controls/index";
+export * from "./Lights/index";
+export * from "./Resource/index";
+export * from "./Materials/index";
+export * from "./DynamicSky/index";
+export * from "./Map/index";
+export * from "./Physics/index";

package/dist/types/helpers/InfiniteGridHelper.d.ts

@@ -0,0 +1,5 @@
+import * as THREE from 'three';
+declare class InfiniteGridHelper extends THREE.Mesh {
+    constructor(size1: number, size2: number, color: THREE.Color, distance: number, axes?: string);
+}
+export { InfiniteGridHelper };

package/dist/types/helpers/index.d.ts

@@ -0,0 +1 @@
+export { InfiniteGridHelper } from './InfiniteGridHelper';

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Potato.js Authors
+ * Potato.js extends from Three.js
+ * Carry out the second expansion and creation
+ */
+export * from "./utils/index";
+export * from "./core/index";
+export * from "./types/index";
+export * from "./core/PostProcessor/index";
+export * from './helpers/index';

package/dist/types/types/PostProcessor/index.d.ts

@@ -0,0 +1,5 @@
+import { WebGLRenderer, WebGLRenderTarget } from "three";
+export interface IPostProcessorPrames {
+    renderer: WebGLRenderer;
+    renderTarget?: WebGLRenderTarget;
+}

package/dist/types/types/index.d.ts

@@ -0,0 +1 @@
+export * from "./PostProcessor";

package/dist/types/utils/FpsMeter/index.d.ts

@@ -0,0 +1,16 @@
+import Stats from "three/examples/jsm/libs/stats.module.js";
+import { IPotatoEngine } from "../../core/WebGLEngine/types/index";
+type PerStatsType = {
+    container?: HTMLElement;
+    engine?: IPotatoEngine;
+};
+export declare class PerformanceStats {
+    name: string;
+    options: PerStatsType;
+    stats: Stats;
+    container: HTMLElement;
+    constructor(options?: PerStatsType);
+    init(container: HTMLElement): void;
+    updateEngine(engine: IPotatoEngine): void;
+}
+export {};

package/dist/types/utils/Logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Logger Class for logging messages to the console.
+ */
+interface ILogger {
+    [key: string]: any;
+    log: (...args: any[]) => void;
+    info: (msg: string) => void;
+}
+declare const Logger: ILogger;
+export { Logger };

package/dist/types/utils/index.d.ts

@@ -0,0 +1,42 @@
+import { Logger } from "./Logger";
+export * from "./FpsMeter/index";
+import { Texture } from "three";
+import { PotatoEngine } from "../core/WebGLEngine";
+import * as THREE from 'three';
+export declare function setDefaultEnvironment(engine: PotatoEngine): void;
+/**
+ * 节流函数（定时器实现）
+ * @param func 需要节流的函数
+ * @param delay 节流的时间间隔（毫秒）
+ * @returns 节流后的函数
+ */
+export declare function throttleTimer(func: (...args: any[]) => void, delay: number): (this: any, ...args: any[]) => void;
+/**
+ * 加载hdr贴图到场景中
+ * @param texture THREE.Texture
+ * @param engine VirtuEngine
+ * @param isBg boolean
+ */
+export declare function loadHdrToScene(texture: Texture, engine: PotatoEngine, isBg?: boolean): Texture<unknown> | null;
+export declare function getContainerElement(cube: HTMLElement | string): HTMLElement;
+/**
+ * 相机移动动画
+ * @param position
+ * @param target
+ * @param index
+ * @param ease
+ * @param startCallback
+ * @param comleteCallback
+ */
+export declare function flyTo(engine: PotatoEngine, position?: THREE.Vector3, target?: THREE.Vector3, index?: number, ease?: string, startCallback?: () => void, comleteCallback?: () => void): void;
+/**
+ * 聚焦到具体模型位置函数
+ * @param target
+ * @param duration
+ * @param disScale
+ * @returns
+ */
+export declare function focusTo(engine: PotatoEngine, target: THREE.Object3D | undefined | null, duration?: number): void;
+export declare function disposeApp(engine: PotatoEngine | null): void;
+export declare function destroyModel(engine: PotatoEngine | null, model: THREE.Object3D): void;
+export { Logger };

package/dist/utils/FpsMeter/index.cjs.js

@@ -0,0 +1 @@
+"use strict";var t=require("../../node_modules/.pnpm/three@0.182.0/node_modules/three/examples/jsm/libs/stats.module.cjs.js"),e=require("../Logger.cjs.js");const s={container:document.body};exports.PerformanceStats=class{name="Potato.Stat.js";options={};stats;container=document.body;constructor(e={}){this.options={...s,...e};const{container:o,engine:n}=this.options;this.stats=new t,o&&this.init(o),n&&this.updateEngine(n)}init(t){t?(this.container=t,this.container.style.setProperty("position","relative"),this.stats.dom.style.setProperty("position","absolute"),this.container.appendChild(this.stats.dom)):e.Logger.error("PerformanceStats","container is no define")}updateEngine(t){t.addRunScope(()=>this.stats.update())}};

package/dist/utils/FpsMeter/index.esm.js

@@ -0,0 +1 @@
+import t from"../../node_modules/.pnpm/three@0.182.0/node_modules/three/examples/jsm/libs/stats.module.esm.js";import{Logger as s}from"../Logger.esm.js";const e={container:document.body};class o{name="Potato.Stat.js";options={};stats;container=document.body;constructor(s={}){this.options={...e,...s};const{container:o,engine:n}=this.options;this.stats=new t,o&&this.init(o),n&&this.updateEngine(n)}init(t){t?(this.container=t,this.container.style.setProperty("position","relative"),this.stats.dom.style.setProperty("position","absolute"),this.container.appendChild(this.stats.dom)):s.error("PerformanceStats","container is no define")}updateEngine(t){t.addRunScope(()=>this.stats.update())}}export{o as PerformanceStats};

package/dist/utils/Logger.cjs.js

@@ -0,0 +1 @@
+"use strict";const r={log(...r){},info(r){},warn(...r){},error(...r){}};exports.Logger=r;

package/dist/utils/Logger.esm.js

@@ -0,0 +1 @@
+const o={log(...o){},info(o){},warn(...o){},error(...o){}};export{o as Logger};

package/dist/utils/index.cjs.js

@@ -0,0 +1 @@
+"use strict";var e=require("../node_modules/.pnpm/three@0.182.0/node_modules/three/build/three.module.cjs.js"),n=require("../node_modules/.pnpm/three@0.182.0/node_modules/three/examples/jsm/environments/RoomEnvironment.cjs.js"),o=require("../node_modules/.pnpm/gsap@3.14.2/node_modules/gsap/index.cjs.js"),t=require("../node_modules/.pnpm/three@0.182.0/node_modules/three/build/three.core.cjs.js");function r(e,n){const o=(e,n=!1)=>{if(e){if(n&&e.children)for(const t of e.children)o(t,n),e.remove(t);if((e instanceof t.Mesh||e instanceof t.Line||e instanceof t.Points)&&e.geometry){if(e.geometry.dispose(),!e.material)return;const n=Array.isArray(e.material)?e.material:[e.material];for(const e of n){for(const n in e){const o=e[n];o&&"object"==typeof o&&"minFilter"in o&&o.dispose()}e&&"function"==typeof e.dispose&&e.dispose()}}}};o(n,!0),e&&e.sceneGraph&&e.sceneGraph.remove(n)}exports.destroyModel=r,exports.disposeApp=function(e){e&&(e.sceneGraph.children.forEach(n=>r(e,n)),e.renderer.forceContextLoss(),e.renderer.dispose(),e=null)},exports.flyTo=function(e,n=new t.Vector3(0,1,0),r=new t.Vector3(0,0,0),s,i="ease",a,c){s=s||0,i=i||"ease";const{x:l,y:d,z:m}=n;e&&o.gsap.to(e.camera.position,{ease:i,duration:1.2,delay:2.02*s,x:l,y:d,z:m,onStart(){a&&a()},onUpdate(){const{x:n,y:o,z:t}=r;e.camera.lookAt(n,o,t),e.controls.target.set(n,o,t),e.controls.update()},onComplete(){c&&c()}})},exports.focusTo=function(e,n,r=.8){if(!e)return;if(!n)return;let s=1;const i=new t.Vector3,a=new t.Vector3,c=new t.Box3;c.setFromObject(n),!1===c.isEmpty()?(c.getCenter(i),s=c.getBoundingSphere(new t.Sphere).radius):(i.setFromMatrixPosition(n.matrixWorld),s=.1),a.set(0,.1,1),a.applyQuaternion(e.camera.quaternion),a.multiplyScalar(2.8*s);const l=(new t.Vector3).copy(i).add(a);o.gsap.to(e.camera.position,{x:l.x,y:l.y,z:l.z,duration:r,ease:"easeInOut",onUpdate(){e.controls.target.copy(i)},onComplete(){e.controls.target.copy(i)}})},exports.getContainerElement=function(e){let n;if(e instanceof HTMLCanvasElement)n=e.parentElement,document.body.removeChild(e);else if(e instanceof HTMLElement)n=e;else if("string"==typeof e){const o=document.querySelector(e);o?o instanceof HTMLCanvasElement?(n=o.parentElement,document.body.removeChild(o)):n=o instanceof HTMLElement?o:document.body:n=document.body}else n=document.body;return n},exports.loadHdrToScene=function(n,o,t=!1){let r=null;if(o?.renderer){const s=new e.PMREMGenerator(o.renderer);s.compileEquirectangularShader(),r=s.fromEquirectangular(n).texture,s.dispose(),o.sceneGraph&&(o.sceneGraph.environment=r,t&&(o.sceneGraph.background=r))}return r},exports.setDefaultEnvironment=function(o){o.sceneGraph.environment=new e.PMREMGenerator(o.renderer).fromScene(new n.RoomEnvironment).texture},exports.throttleTimer=function(e,n){let o=null;return function(...t){o||(e.apply(this,t),o=setTimeout(()=>{o=null},n))}};

package/dist/utils/index.esm.js

@@ -0,0 +1 @@
+import{PMREMGenerator as e}from"../node_modules/.pnpm/three@0.182.0/node_modules/three/build/three.module.esm.js";import{RoomEnvironment as n}from"../node_modules/.pnpm/three@0.182.0/node_modules/three/examples/jsm/environments/RoomEnvironment.esm.js";import{gsap as o}from"../node_modules/.pnpm/gsap@3.14.2/node_modules/gsap/index.esm.js";import{Vector3 as t,Box3 as r,Sphere as s,Mesh as i,Line as a,Points as m}from"../node_modules/.pnpm/three@0.182.0/node_modules/three/build/three.core.esm.js";function c(o){o.sceneGraph.environment=new e(o.renderer).fromScene(new n).texture}function l(e,n){let o=null;return function(...t){o||(e.apply(this,t),o=setTimeout(()=>{o=null},n))}}function d(n,o,t=!1){let r=null;if(o?.renderer){const s=new e(o.renderer);s.compileEquirectangularShader(),r=s.fromEquirectangular(n).texture,s.dispose(),o.sceneGraph&&(o.sceneGraph.environment=r,t&&(o.sceneGraph.background=r))}return r}function u(e){let n;if(e instanceof HTMLCanvasElement)n=e.parentElement,document.body.removeChild(e);else if(e instanceof HTMLElement)n=e;else if("string"==typeof e){const o=document.querySelector(e);o?o instanceof HTMLCanvasElement?(n=o.parentElement,document.body.removeChild(o)):n=o instanceof HTMLElement?o:document.body:n=document.body}else n=document.body;return n}function p(e,n=new t(0,1,0),r=new t(0,0,0),s,i="ease",a,m){s=s||0,i=i||"ease";const{x:c,y:l,z:d}=n;e&&o.to(e.camera.position,{ease:i,duration:1.2,delay:2.02*s,x:c,y:l,z:d,onStart(){a&&a()},onUpdate(){const{x:n,y:o,z:t}=r;e.camera.lookAt(n,o,t),e.controls.target.set(n,o,t),e.controls.update()},onComplete(){m&&m()}})}function f(e,n,i=.8){if(!e)return;if(!n)return;let a=1;const m=new t,c=new t,l=new r;l.setFromObject(n),!1===l.isEmpty()?(l.getCenter(m),a=l.getBoundingSphere(new s).radius):(m.setFromMatrixPosition(n.matrixWorld),a=.1),c.set(0,.1,1),c.applyQuaternion(e.camera.quaternion),c.multiplyScalar(2.8*a);const d=(new t).copy(m).add(c);o.to(e.camera.position,{x:d.x,y:d.y,z:d.z,duration:i,ease:"easeInOut",onUpdate(){e.controls.target.copy(m)},onComplete(){e.controls.target.copy(m)}})}function y(e){e&&(e.sceneGraph.children.forEach(n=>h(e,n)),e.renderer.forceContextLoss(),e.renderer.dispose(),e=null)}function h(e,n){const o=(e,n=!1)=>{if(e){if(n&&e.children)for(const t of e.children)o(t,n),e.remove(t);if((e instanceof i||e instanceof a||e instanceof m)&&e.geometry){if(e.geometry.dispose(),!e.material)return;const n=Array.isArray(e.material)?e.material:[e.material];for(const e of n){for(const n in e){const o=e[n];o&&"object"==typeof o&&"minFilter"in o&&o.dispose()}e&&"function"==typeof e.dispose&&e.dispose()}}}};o(n,!0),e&&e.sceneGraph&&e.sceneGraph.remove(n)}export{h as destroyModel,y as disposeApp,p as flyTo,f as focusTo,u as getContainerElement,d as loadHdrToScene,c as setDefaultEnvironment,l as throttleTimer};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "t3d-ez.gl",
+  "version": "0.0.1",
+  "description": "",
+  "main": "./dist/t3d-ez.gl.cjs.js",
+  "module": "./dist/t3d-ez.gl.esm.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/t3d-ez.gl.esm.js"
+    }
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c rollup.config.js"
+  },
+  "keywords": [
+    "three",
+    "webgl"
+  ],
+  "author": "hunhunzhang",
+  "license": "ISC",
+  "packageManager": "pnpm@10.6.5",
+  "devDependencies": {
+    "@types/d3-geo": "^3.1.0",
+    "rollup-plugin-dts": "^6.2.1",
+    "rollup-plugin-terser": "^7.0.2"
+  },
+  "dependencies": {
+    "d3-geo": "^3.1.1"
+  }
+}