@glowjs/core 2022.6.21

package/dist/typings/base/Base.d.ts

@@ -0,0 +1,24 @@
+import { App } from '../core/App';
+import { EventDispatcher } from '../event/EventDispatcher';
+/**
+ * 基类
+ */
+export declare class Base extends EventDispatcher {
+    /**
+     * 应用
+     */
+    app: App;
+    /**
+     * 类名称
+     */
+    className: string;
+    /**
+     * 实例化一个基类对象
+     * @param app 应用
+     */
+    constructor(app: App);
+    /**
+     * 释放
+     */
+    dispose(): void;
+}

package/dist/typings/base/IDisposable.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 显式释放接口
+ */
+export interface IDisposable {
+    /**
+     * 释放
+     */
+    dispose(): void;
+}

package/dist/typings/camera/CameraCacheData.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 相机缓存数据
+ */
+export declare type CameraCacheData = {
+    /**
+     * 沿Y轴旋转角度下限
+     */
+    lowerAlphaLimit: number;
+    /**
+     * 沿Y轴旋转角度上限
+     */
+    upperAlphaLimit: number;
+    /**
+     * 沿X轴旋转角度下限
+     */
+    lowerBetaLimit: number;
+    /**
+     * 沿X轴旋转角度上限
+     */
+    upperBetaLimit: number;
+};

package/dist/typings/camera/CameraMgr.d.ts

@@ -0,0 +1,320 @@
+import { ArcRotateCamera } from '../runtime';
+import { Base } from '../base/Base';
+import { App } from '../core/App';
+import { Entity } from '../entity/Entity';
+import { CameraMode } from './CameraMode';
+import { CameraPerson } from './CameraPerson';
+import { OrthographicView } from './OrthographicView';
+/**
+ * 相机管理器
+ */
+export declare class CameraMgr extends Base {
+    /**
+     * 相机
+     */
+    camera: ArcRotateCamera;
+    private _updateObserver;
+    private _flyTween;
+    private _cache;
+    private _radiusLimit;
+    private _flyStartData;
+    private _flyEndData;
+    private _flyingData;
+    private _person;
+    /**
+     * 获取或设置跟随对象
+     */
+    followObj: Entity;
+    /**
+     * 实例化一个相机管理器对象
+     * @param app 应用
+     */
+    constructor(app: App);
+    /**
+     * 获取或设置人称
+     */
+    get person(): CameraPerson;
+    set person(value: CameraPerson);
+    /**
+     * 获取相机是否在飞行
+     */
+    get flying(): boolean;
+    /**
+     * 获取或设置近裁剪面距离
+     */
+    get near(): number;
+    set near(value: number);
+    /**
+     * 获取或设置远裁剪面距离
+     */
+    get far(): number;
+    set far(value: number);
+    /**
+     * 获取或设置是否开启相机操作（包括旋转、平移、缩放）
+     */
+    get inputEnabled(): boolean;
+    set inputEnabled(value: boolean);
+    /**
+     * 获取或设置旋转启用（仅左键，中键不禁用）
+     */
+    get enableRotate(): boolean;
+    set enableRotate(value: boolean);
+    /**
+     * 获取或设置缩放启用
+     */
+    get enableZoom(): boolean;
+    set enableZoom(value: boolean);
+    /**
+     * 获取或设置平移启用
+     */
+    get enablePan(): boolean;
+    set enablePan(value: boolean);
+    private _setButtonEnable;
+    /**
+     * 获取或设置相机沿Y轴的旋转角度（弧度）
+     */
+    get alpha(): number;
+    set alpha(value: number);
+    /**
+     * 获取或设置相机沿X轴的旋转角度（弧度）
+     */
+    get beta(): number;
+    set beta(value: number);
+    /**
+     * 获取或设置相机到目标点的半径
+     */
+    get radius(): number;
+    set radius(value: number);
+    /**
+     * 获取或设置目标点位置
+     */
+    get target(): [number, number, number];
+    set target(value: [number, number, number]);
+    /**
+     * 获取或设置相机位置
+     */
+    get position(): [number, number, number];
+    set position(value: [number, number, number]);
+    /**
+     * 获取或设置当前在Y轴上的惯性值。这个数字越大，相机停止的时间就越长。
+     */
+    get inertialAlphaOffset(): number;
+    set inertialAlphaOffset(value: number);
+    /**
+     * 获取或设置当前在X轴上的惯性值。这个数字越大，相机停止的时间就越长。
+     */
+    get inertialBetaOffset(): number;
+    set inertialBetaOffset(value: number);
+    /**
+     * 获取或设置Y轴上允许的最小角度。这可以帮助限制相机在场景中移动的方式。
+     */
+    get lowerAlphaLimit(): number;
+    set lowerAlphaLimit(value: number);
+    /**
+     * 获取或设置Y轴上允许的最大角度。这可以帮助限制相机在场景中移动的方式。
+     */
+    get upperAlphaLimit(): number;
+    set upperAlphaLimit(value: number);
+    /**
+     * 获取或设置X轴上允许的最小角度。这可以帮助限制相机在场景中移动的方式。
+     */
+    get lowerBetaLimit(): number;
+    set lowerBetaLimit(value: number);
+    /**
+     * 获取或设置X轴上允许的最大角度。这可以帮助限制相机在场景中移动的方式。
+     */
+    get upperBetaLimit(): number;
+    set upperBetaLimit(value: number);
+    /**
+     * 获取或设置相机与目标允许的最小距离(相机不能靠近)。这可以帮助限制相机在场景中移动的方式。
+     */
+    get lowerRadiusLimit(): number;
+    set lowerRadiusLimit(value: number);
+    /**
+     * 获取或设置相机与目标的最大允许距离(相机不能再远)。这可以帮助限制相机在场景中移动的方式。
+     */
+    get upperRadiusLimit(): number;
+    set upperRadiusLimit(value: number);
+    /**
+     * 获取或设置摄像机沿X轴平移期间使用的当前惯性值。
+     */
+    get inertialPanningX(): number;
+    set inertialPanningX(value: number);
+    /**
+     * 获取或设置摄像机沿Y轴平移期间使用的当前惯性值。
+     */
+    get inertialPanningY(): number;
+    set inertialPanningY(value: number);
+    /**
+     * 获取或设置在平移模式和捏/缩放模式下考虑相机的距离。基本上，如果你的手指移开超过这个距离，你会被认为在捏模式。
+     */
+    get pinchToPanMaxDistance(): number;
+    set pinchToPanMaxDistance(value: number);
+    /**
+     * 获取或设置相机可以平移的最大距离。这可以帮助相机始终在你的场景中。
+     */
+    get panningDistanceLimit(): number;
+    set panningDistanceLimit(value: number);
+    /**
+     * 获取或设置相机的平移目标
+     */
+    get panningOriginTarget(): [number, number, number];
+    set panningOriginTarget(value: [number, number, number]);
+    /**
+     * 获取或设置在平移过程中使用的惯性值。0表示停止惯性，1表示没有减速。
+     */
+    get panningInertia(): number;
+    set panningInertia(value: number);
+    /**
+     * 获取或设置指针沿X轴的角度灵敏度或摄像机旋转的速度。
+     */
+    get angularSensibilityX(): number;
+    set angularSensibilityX(value: number);
+    /**
+     * 获取或设置指针沿Y轴的角度灵敏度或摄像机旋转的速度。
+     */
+    get angularSensibilityY(): number;
+    set angularSensibilityY(value: number);
+    /**
+     * 获取或设置指针缩放精度或相机缩放的速度。
+     */
+    get pinchPrecision(): number;
+    set pinchPrecision(value: number);
+    /**
+     * 获取或设置指针缩放增量百分比或摄像机缩放的速度。如果不为0，则使用它来代替pinchDeltaPrecision。它定义了当前相机的百分比。缩放时使用的半径作为增量。
+     */
+    get pinchDeltaPercentage(): number;
+    set pinchDeltaPercentage(value: number);
+    /**
+     * 获取或设置指针使用自然缩放来覆盖缩放精度和缩放增量百分比。当usennaturalpinchzoom是真实的，多点触摸变焦将在这样的任何物体在飞机上的相机的目标点将缩放完美的手指运动。
+     */
+    get useNaturalPinchZoom(): boolean;
+    set useNaturalPinchZoom(value: boolean);
+    /**
+     * 获取或设置指针平移的灵敏度或相机移动的速度。
+     */
+    get panningSensibility(): number;
+    set panningSensibility(value: number);
+    /**
+     * 获取或设置鼠标滚轮精度或摄像机缩放的速度。
+     */
+    get wheelPrecision(): number;
+    set wheelPrecision(value: number);
+    /**
+     * 获取或设置鼠标滚轮增量百分比或摄像机缩放的速度。如果不为0，则使用它来代替pinchDeltaPrecision。它定义了当前相机的百分比。缩放时使用的半径作为增量。
+     */
+    get wheelDeltaPercentage(): number;
+    set wheelDeltaPercentage(value: number);
+    /**
+     * 通过zoomOn函数定义在一个特定的网格上缩放半径的大小。
+     */
+    get zoomOnFactor(): number;
+    set zoomOnFactor(value: number);
+    /**
+     * 定义相机位置的屏幕偏移量。
+     */
+    get targetScreenOffset(): [x: number, y: number];
+    set targetScreenOffset(value: [x: number, y: number]);
+    /**
+     * 允许相机完全反转。如果是假的，相机不能倒过来。
+     */
+    get allowUpsideDown(): boolean;
+    set allowUpsideDown(value: boolean);
+    get autoRotate(): boolean;
+    set autoRotate(value: boolean);
+    /**
+     * 获取或设置相机的模式，0=透视，1=正交
+     */
+    get mode(): CameraMode;
+    set mode(value: CameraMode);
+    /**
+     * 获取或设置正交投影的左边距
+     */
+    get orthoLeft(): number;
+    set orthoLeft(value: number);
+    /**
+     * 获取或设置正交投影的右边距
+     */
+    get orthoRight(): number;
+    set orthoRight(value: number);
+    /**
+     * 获取或设置正交投影的顶边距
+     */
+    get orthoTop(): number;
+    set orthoTop(value: number);
+    /**
+     * 获取或设置正交投影的底边距
+     */
+    get orthoBottom(): number;
+    set orthoBottom(value: number);
+    /**
+     * 获取正交投影的宽度
+     */
+    get orthoWidth(): number;
+    /**
+     * 获取正交投影的高度
+     */
+    get orthHeight(): number;
+    /**
+     * 从给定位置和目标重建角度(alpha, beta)和半径
+     */
+    rebuildAnglesAndRadius(): void;
+    /**
+     * 使用一个位置来定义当前相机的相关信息，如alpha, beta和半径
+     * @param position 定义要设置摄像机的位置
+     */
+    setPosition(position: [number, number, number]): void;
+    /**
+     * 定义相机应该查看的目标。这将自动调整alpha、beta和半径以适应新的目标。
+     * @param target 新目标
+     */
+    setTarget(target: [number, number, number]): void;
+    private _flyToFollowObj;
+    private _onPerspectiveUpdate;
+    private _onOrthographicUpdate;
+    private _onUpdate;
+    /**
+     * 更新限制（切换场景后调用）
+     */
+    updateLimit(): void;
+    /**
+     * 自适应观察指定物体
+     * @param obj 物体
+     * @param time 花费的时间，默认值500毫秒
+     * @param callback 完成回调函数
+     */
+    fit(obj: Entity, time?: number, callback?: () => void): void;
+    /**
+     * 飞行
+     * @param position 相机位置
+     * @param target 目标
+     * @param time 花费的时间，默认值2000毫秒
+     * @param callback 完成回调函数
+     */
+    flyTo(position: number[], target: number[], time?: number, callback?: () => void): void;
+    private _updateOrthographic;
+    /**
+     * 停止飞行
+     */
+    stopFlying(): void;
+    private _updateAngelLimit;
+    /**
+     * 切换到正交投影
+     * @param time 事件，默认500毫秒
+     * @param callback 回调函数，默认为空
+     * @param view 视图，默认顶视图
+     */
+    toOrthographic(time?: number, callback?: () => void, view?: OrthographicView): void;
+    /**
+     * 切换到透视投影
+     */
+    toPerspective(time?: number, callback?: () => void): void;
+    /**
+     * 释放
+     */
+    dispose(): void;
+    /**
+     * 打印日志
+     */
+    log(): void;
+}

package/dist/typings/camera/CameraMode.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 相机模式
+ */
+export declare enum CameraMode {
+    /**
+     * 透视投影
+     */
+    Perspective = 0,
+    /**
+     * 正交投影
+     */
+    Orthographic = 1
+}

package/dist/typings/camera/CameraPerson.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 相机人称
+ */
+export declare enum CameraPerson {
+    /**
+     * 第一人称
+     */
+    FirstPerson = 1,
+    /**
+     * 第三人称
+     */
+    ThirdPerson = 2
+}

package/dist/typings/camera/CustomArcRotateCameraKeyboardMoveInput.d.ts

@@ -0,0 +1,28 @@
+import { ArcRotateCamera, ICameraInput } from '../runtime';
+import { CameraMgr } from './CameraMgr';
+import { KeyCode } from '../event/KeyCode';
+/**
+ * 自定义相机键盘输入
+ */
+export declare class CustomArcRotateCameraKeyboardMoveInput implements ICameraInput<ArcRotateCamera> {
+    camera: ArcRotateCamera;
+    mgr: CameraMgr;
+    keyLeft: KeyCode;
+    keyRight: KeyCode;
+    keyUp: KeyCode;
+    keyDown: KeyCode;
+    private _attached;
+    private _noPreventDefault;
+    private _isKeyLeftPressed;
+    private _isKeyRightPressed;
+    private _isKeyUpPressed;
+    private _isKeyDownPressed;
+    constructor();
+    getClassName(): string;
+    getSimpleName(): string;
+    attachControl(noPreventDefault?: boolean): void;
+    detachControl(): void;
+    checkInputs(): void;
+    private _onKeyDown;
+    private _onKeyUp;
+}

package/dist/typings/camera/CustomArcRotateCameraMouseWheelInput.d.ts

@@ -0,0 +1,17 @@
+import { ArcRotateCamera, ICameraInput } from '../runtime';
+import { CameraMgr } from './CameraMgr';
+/**
+ * 自定义鼠标滚轮输入
+ */
+export declare class CustomArcRotateCameraMouseWheelInput implements ICameraInput<ArcRotateCamera> {
+    camera: ArcRotateCamera;
+    private _attached;
+    private _noPreventDefault;
+    mgr: CameraMgr;
+    constructor();
+    getClassName(): string;
+    getSimpleName(): string;
+    attachControl(noPreventDefault?: boolean): void;
+    detachControl(): void;
+    private _onWheel;
+}

package/dist/typings/camera/FlyData.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 飞行数据
+ */
+export declare type FlyData = {
+    /**
+     * 目标X坐标值
+     */
+    targetX: number;
+    /**
+     * 目标Y坐标值
+     */
+    targetY: number;
+    /**
+     * 目标Z坐标值
+     */
+    targetZ: number;
+    /**
+     * 半径
+     */
+    radius: number;
+    /**
+     * 沿Y轴的旋转角度
+     */
+    alpha: number;
+    /**
+     * 沿Z轴的旋转角度
+     */
+    beta: number;
+};

package/dist/typings/camera/OrthographicView.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 正交视图
+ */
+export declare enum OrthographicView {
+    /**
+     * 顶视图
+     */
+    Top = 1,
+    /**
+     * 前视图
+     */
+    Front = 2,
+    /**
+     * 后视图
+     */
+    Back = 4
+}

package/dist/typings/core/App.d.ts

@@ -0,0 +1,139 @@
+import { RunTime, Scene } from '../runtime';
+import { Entity } from '../entity/Entity';
+import { CameraMgr } from '../camera/CameraMgr';
+import { EffectMgr } from '../effect/EffectMgr';
+import { EventDispatcher } from '../event/EventDispatcher';
+import { EventMgr } from '../event/EventMgr';
+import { GUIMgr } from '../gui/GUIMgr';
+import { LevelMgr } from '../entity/LevelMgr';
+import { ResPool } from '../res/ResPool';
+import { AppOptions } from './AppOptions';
+import { Size } from './Size';
+import { MaterialMgr } from '../material/MaterialMgr';
+import { EntityType } from '../entity/EntityType';
+import { Component } from '../entity/component/Component';
+/**
+ * 应用
+ */
+export declare class App extends EventDispatcher {
+    private _cursor;
+    version: string;
+    /**
+     * 是否编辑器模式
+     */
+    _isEditor: boolean;
+    /**
+     * 实体字典
+     */
+    _entityMap: Map<string, Entity>;
+    /**
+     * 所有组件对象
+     */
+    readonly allComponents: Component[];
+    /**
+     * 场景
+     */
+    _scene: Scene;
+    /**
+     * DOM容器
+     */
+    container: HTMLDivElement;
+    /**
+     * 根路径
+     */
+    readonly basePath: string;
+    /**
+     * 项目文件地址
+     */
+    projectFile: string;
+    /**
+     * 授权文件地址
+     */
+    licenseFile: string;
+    /**
+     * 画布大小
+     */
+    size: Size;
+    /**
+     * 画布
+     */
+    canvas: HTMLCanvasElement;
+    /**
+     * 运行时
+     */
+    runTime: RunTime;
+    /**
+     * 材质管理器
+     */
+    materialMgr: MaterialMgr;
+    /**
+     * 相机管理器
+     */
+    cameraMgr: CameraMgr;
+    /**
+     * 效果管理器
+     */
+    effectMgr: EffectMgr;
+    /**
+     * 资源池
+     */
+    resPool: ResPool;
+    /**
+     * 层级管理器
+     */
+    levelMgr: LevelMgr;
+    /**
+     * GUI管理器
+     */
+    guiMgr: GUIMgr;
+    /**
+     * 事件管理器
+     */
+    eventMgr: EventMgr;
+    /**
+     * 是否已加载
+     */
+    loaded: boolean;
+    /**
+     * 选项
+     */
+    options: AppOptions;
+    /**
+     * 是否为移动端
+     */
+    readonly isMobile: boolean;
+    /**
+     * 实例化一个应用对象
+     * @param options 选项
+     */
+    constructor(options: AppOptions);
+    /**
+     * 获取或设置指针样式（与CSS一致）
+     */
+    get cursor(): string;
+    set cursor(value: string);
+    /**
+     * 注册默认事件
+     * @param levelBack 是否注册层级后退事件，默认true
+     */
+    registerDefaultEvents(levelBack?: boolean): void;
+    /**
+     * 加载项目
+     */
+    load(): Promise<void>;
+    /**
+     * 根据ID获取实体对象
+     * @param id 实体ID
+     * @returns 实体对象
+     */
+    getEntityById(id: string): Entity | undefined;
+    /**
+     * 创建实体
+     * @param type 实体类型
+     */
+    create(type: EntityType | string): Entity;
+    /**
+     * 释放
+     */
+    dispose(): void;
+}

package/dist/typings/core/AppOptions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * App选项
+ */
+export declare type AppOptions = {
+    /**
+     * DOM容器
+     */
+    container: HTMLDivElement;
+    /**
+     * 项目文件地址
+     */
+    projectFile?: string;
+    /**
+     * 授权文件地址
+     */
+    licenseFile?: string;
+    /**
+     * 根路径
+     */
+    basePath?: string;
+    /**
+     * 是否启用天空盒子，默认启用
+     */
+    skyBox?: boolean;
+    /**
+     * 科技风建筑，默认false
+     */
+    technologyBuilding?: boolean;
+};

package/dist/typings/core/Size.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 尺寸
+ */
+export declare type Size = {
+    /**
+     * 宽度
+     */
+    width: number;
+    /**
+     * 高度
+     */
+    height: number;
+};

package/dist/typings/core/create.d.ts

@@ -0,0 +1,9 @@
+import { Entity } from '../entity/Entity';
+import { App } from './App';
+import { EntityType } from '../entity/EntityType';
+/**
+ * 创建实体
+ * @param app 应用对象
+ * @param type 实体类型
+ */
+export declare function create(app: App, type: EntityType | string): Entity;

package/dist/typings/core/version.d.ts

@@ -0,0 +1 @@
+export declare const version: string;