@voxel-pixel/entity 0.0.1-beta.0

package/BaseEntity.d.ts

@@ -0,0 +1,6 @@
+import { Entity } from "@voxel-pixel/core";
+declare class BaseEntity extends Entity {
+    uuid: any;
+    constructor(options?: Entity.ConstructorOptions);
+}
+export { BaseEntity };

package/BaseEntity.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { Entity } from "@voxel-pixel/core";
+import { generateUUID } from "@voxel-pixel/utils";
+class BaseEntity extends Entity {
+  constructor(options) {
+    super(options);
+    __publicField(this, "uuid", generateUUID());
+  }
+}
+export {
+  BaseEntity
+};

package/Circle/index.d.ts

@@ -0,0 +1,6 @@
+import { Container, EllipseGraphics } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity";
+declare class Circle extends SingleEntity {
+    constructor(container: Container, options: EllipseGraphics.ConstructorOptions);
+}
+export { Circle };

package/Circle/index.js

@@ -0,0 +1,14 @@
+import { CallbackProperty } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity.js";
+class Circle extends SingleEntity {
+  constructor(container, options) {
+    super(container);
+    this.instance = container.viewer.entities.add({
+      position: new CallbackProperty(() => this.getPosition(), false),
+      ellipse: options
+    });
+  }
+}
+export {
+  Circle
+};

package/Entity.d.ts

@@ -0,0 +1,12 @@
+import { Container, HeadingPitchRange, Entity as CesiumEntity, type PropertyBag } from "@voxel-pixel/core";
+declare abstract class Entity {
+    uuid: any;
+    protected container: Container;
+    instance?: CesiumEntity;
+    constructor(container: Container);
+    setProperties(properties: PropertyBag): void;
+    lookAtMe(offset?: HeadingPitchRange): void;
+    setVisible(visible: boolean): void;
+    destroy(): void;
+}
+export { Entity };

package/Entity.js

@@ -0,0 +1,35 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { generateUUID } from "@voxel-pixel/utils";
+class Entity {
+  constructor(container) {
+    __publicField(this, "uuid", generateUUID());
+    __publicField(this, "container");
+    __publicField(this, "instance");
+    this.container = container;
+  }
+  setProperties(properties) {
+    if (this.instance)
+      this.instance.properties = properties;
+  }
+  lookAtMe(offset) {
+    if (this.instance)
+      this.container.viewer.zoomTo(this.instance, offset);
+  }
+  setVisible(visible) {
+    if (this.instance)
+      this.instance.show = visible;
+  }
+  destroy() {
+    if (this.instance)
+      this.container.viewer.entities.remove(this.instance);
+    this.instance = void 0;
+  }
+}
+export {
+  Entity
+};

package/Group/index.d.ts

@@ -0,0 +1,36 @@
+import { Container, HeadingPitchRange } from "@voxel-pixel/core";
+import { Entity } from "../Entity";
+import { BaseEntity } from "../BaseEntity";
+import { SingleEntity } from "../SingleEntity";
+declare class Group {
+    protected container: Container;
+    constructor(container: Container);
+    /**
+     * 添加子集
+     * @param child
+     */
+    children: (Entity | BaseEntity | SingleEntity)[];
+    addChild(child: Entity | BaseEntity | SingleEntity): string;
+    /**
+       * 观看某个子集
+       * @param uuid
+       */
+    lookAtChild(uuid: string, offset?: HeadingPitchRange, height?: number): void;
+    /**
+     * 设置某个子集的显示状态
+     * @param uuid
+     */
+    setChildVisible(uuid: string, visible: boolean): void;
+    /**
+     * 设置显示状态
+     * @param visible 为true显示，false隐藏
+     */
+    setVisible(visible: boolean): void;
+    destroy(): void;
+    /**
+     * 销毁某个子集
+     * @param uuid
+     */
+    destroyChild(uuid: string): void;
+}
+export { Group };

package/Group/index.js

@@ -0,0 +1,98 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { Entity } from "../Entity.js";
+import { BaseEntity } from "../BaseEntity.js";
+import { SingleEntity } from "../SingleEntity.js";
+class Group {
+  constructor(container) {
+    __publicField(this, "container");
+    /**
+     * 添加子集
+     * @param child 
+     */
+    __publicField(this, "children", []);
+    this.container = container;
+  }
+  addChild(child) {
+    this.children.push(child);
+    return child.uuid;
+  }
+  /**
+     * 观看某个子集
+     * @param uuid 
+     */
+  lookAtChild(uuid, offset, height) {
+    const child = this.children.find((item) => item.uuid === uuid);
+    if (child) {
+      if (child instanceof BaseEntity) {
+        this.container.viewer.zoomTo(child, offset);
+      } else if (child instanceof SingleEntity) {
+        child.lookAtMe(offset, height);
+      } else if (child instanceof Entity) {
+        child.lookAtMe(offset);
+      }
+    }
+  }
+  /**
+   * 设置某个子集的显示状态
+   * @param uuid 
+   */
+  setChildVisible(uuid, visible) {
+    const child = this.children.find((item) => item.uuid === uuid);
+    if (child) {
+      if (child instanceof BaseEntity) {
+        child.show = visible;
+      } else if (child instanceof Entity) {
+        child.setVisible(visible);
+      }
+    }
+  }
+  /**
+   * 设置显示状态
+   * @param visible 为true显示，false隐藏
+   */
+  setVisible(visible) {
+    this.children.forEach((item) => {
+      if (item instanceof BaseEntity) {
+        item.show = visible;
+      } else if (item instanceof Entity) {
+        item.setVisible(visible);
+      }
+    });
+  }
+  //销毁
+  destroy() {
+    for (let i = this.children.length - 1; i >= 0; i--) {
+      const entity = this.children[i];
+      if (entity instanceof BaseEntity) {
+        this.container.viewer.entities.remove(entity);
+      } else if (entity instanceof Entity) {
+        entity.destroy();
+      }
+    }
+    this.children = [];
+  }
+  /**
+   * 销毁某个子集
+   * @param uuid 
+   */
+  destroyChild(uuid) {
+    const idx = this.children.findIndex((item) => item.uuid === uuid);
+    if (idx !== -1) {
+      const child = this.children[idx];
+      if (child instanceof BaseEntity) {
+        this.container.viewer.entities.remove(child);
+      } else if (child instanceof Entity) {
+        child.destroy();
+      }
+    }
+    this.children.splice(idx, 1);
+  }
+}
+export {
+  Group
+};

package/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright © 2025-PRESENT voxel-pixel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/Line/index.d.ts

@@ -0,0 +1,7 @@
+import { Container, PolylineGraphics, Cartesian3 } from "@voxel-pixel/core";
+import { Entity } from "../Entity";
+declare class Line extends Entity {
+    positions: Cartesian3[];
+    constructor(container: Container, options: PolylineGraphics.ConstructorOptions);
+}
+export { Line };

package/Line/index.js

@@ -0,0 +1,23 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { CallbackProperty } from "@voxel-pixel/core";
+import { Entity } from "../Entity.js";
+class Line extends Entity {
+  constructor(container, options) {
+    super(container);
+    __publicField(this, "positions", []);
+    this.instance = container.viewer.entities.add({
+      polyline: {
+        ...options,
+        positions: new CallbackProperty(() => this.positions, false)
+      }
+    });
+  }
+}
+export {
+  Line
+};

package/Point/index.d.ts

@@ -0,0 +1,6 @@
+import { Container, PointGraphics } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity";
+declare class Point extends SingleEntity {
+    constructor(container: Container, options: PointGraphics.ConstructorOptions);
+}
+export { Point };

package/Point/index.js

@@ -0,0 +1,14 @@
+import { CallbackProperty } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity.js";
+class Point extends SingleEntity {
+  constructor(container, options) {
+    super(container);
+    this.instance = container.viewer.entities.add({
+      position: new CallbackProperty(() => this.getPosition(), false),
+      point: options
+    });
+  }
+}
+export {
+  Point
+};

package/Polygon/index.d.ts

@@ -0,0 +1,10 @@
+import { Container, PolygonGraphics, PolylineGraphics, Cartesian3 } from "@voxel-pixel/core";
+import { Entity } from "../Entity";
+interface IPolygonOptions extends PolygonGraphics.ConstructorOptions {
+    lineOption: PolylineGraphics.ConstructorOptions;
+}
+declare class Polgyon extends Entity {
+    positions: Cartesian3[];
+    constructor(container: Container, options: IPolygonOptions);
+}
+export { Polgyon };

package/Polygon/index.js

@@ -0,0 +1,30 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { CallbackProperty, PolygonHierarchy } from "@voxel-pixel/core";
+import { Entity } from "../Entity.js";
+class Polgyon extends Entity {
+  constructor(container, options) {
+    super(container);
+    __publicField(this, "positions", []);
+    const params = {
+      polygon: {
+        ...options,
+        hierarchy: new CallbackProperty(() => new PolygonHierarchy(this.positions), false)
+      }
+    };
+    if (options.lineOption) {
+      params.polyline = {
+        ...options.lineOption,
+        positions: new CallbackProperty(() => this.positions, false)
+      };
+    }
+    this.instance = container.viewer.entities.add(params);
+  }
+}
+export {
+  Polgyon
+};

package/SingleEntity.d.ts

@@ -0,0 +1,9 @@
+import { Container, Cartesian3, HeadingPitchRange } from "@voxel-pixel/core";
+import { Entity } from "./Entity";
+declare abstract class SingleEntity extends Entity {
+    position: Cartesian3;
+    constructor(container: Container);
+    lookAtMe(offset?: HeadingPitchRange, height?: number): void;
+    protected getPosition(): any;
+}
+export { SingleEntity };

package/SingleEntity.js

@@ -0,0 +1,54 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { Cartesian3, Cartographic, sampleTerrainMostDetailed } from "@voxel-pixel/core";
+import { Entity } from "./Entity.js";
+class SingleEntity extends Entity {
+  constructor(container) {
+    super(container);
+    __publicField(this, "position");
+    this.position = new Cartesian3();
+  }
+  lookAtMe(offset, height) {
+    if (!this.instance)
+      return;
+    if (this.container.mountedTerrain) {
+      const cartographic = Cartographic.fromCartesian(this.position);
+      sampleTerrainMostDetailed(
+        this.container.viewer.scene.terrainProvider,
+        [cartographic]
+      ).then(([terrainPoint]) => {
+        const terrainHeight = Math.max(terrainPoint.height || 0, 0);
+        cartographic.height = terrainHeight + (height || 0);
+        this.container.viewer.camera.setView({
+          destination: Cartographic.toCartesian(cartographic),
+          orientation: offset || {
+            heading: Math.PI / 2,
+            pitch: -Math.PI / 2,
+            roll: 0
+          }
+        });
+      });
+    } else {
+      const cartographic = Cartographic.fromCartesian(this.position);
+      cartographic.height = height || 500;
+      this.container.viewer.camera.setView({
+        destination: Cartographic.toCartesian(cartographic),
+        orientation: offset || {
+          heading: Math.PI / 2,
+          pitch: -Math.PI / 2,
+          roll: 0
+        }
+      });
+    }
+  }
+  getPosition() {
+    return Cartesian3.clone(this.position);
+  }
+}
+export {
+  SingleEntity
+};

package/Sprite/index.d.ts

@@ -0,0 +1,6 @@
+import { Container, BillboardGraphics } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity";
+declare class Sprite extends SingleEntity {
+    constructor(container: Container, options: BillboardGraphics.ConstructorOptions);
+}
+export { Sprite };

package/Sprite/index.js

@@ -0,0 +1,14 @@
+import { CallbackProperty } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity.js";
+class Sprite extends SingleEntity {
+  constructor(container, options) {
+    super(container);
+    this.instance = container.viewer.entities.add({
+      position: new CallbackProperty(() => this.getPosition(), false),
+      billboard: options
+    });
+  }
+}
+export {
+  Sprite
+};

package/Text/index.d.ts

@@ -0,0 +1,6 @@
+import { Container, LabelGraphics } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity";
+declare class Text extends SingleEntity {
+    constructor(container: Container, options: LabelGraphics.ConstructorOptions);
+}
+export { Text };

package/Text/index.js

@@ -0,0 +1,14 @@
+import { CallbackProperty } from "@voxel-pixel/core";
+import { SingleEntity } from "../SingleEntity.js";
+class Text extends SingleEntity {
+  constructor(container, options) {
+    super(container);
+    this.instance = container.viewer.entities.add({
+      position: new CallbackProperty(() => this.getPosition(), false),
+      label: options
+    });
+  }
+}
+export {
+  Text
+};

package/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./BaseEntity";
+export * from "./Point";
+export * from "./Line";
+export * from "./Polygon";
+export * from "./Circle";
+export * from "./Sprite";
+export * from "./Text";
+export * from "./Group";

package/index.js

@@ -0,0 +1,18 @@
+import { BaseEntity } from "./BaseEntity.js";
+import { Point } from "./Point/index.js";
+import { Line } from "./Line/index.js";
+import { Polgyon } from "./Polygon/index.js";
+import { Circle } from "./Circle/index.js";
+import { Sprite } from "./Sprite/index.js";
+import { Text } from "./Text/index.js";
+import { Group } from "./Group/index.js";
+export {
+  BaseEntity,
+  Circle,
+  Group,
+  Line,
+  Point,
+  Polgyon,
+  Sprite,
+  Text
+};

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@voxel-pixel/entity",
+  "version": "0.0.1-beta.0",
+  "type": "module",
+  "main": "./index.js",
+  "description": "实体",
+  "author": "poggi",
+  "license": "MIT",
+  "typings": "./index.d.ts",
+  "peerDependencies": {
+    "@voxel-pixel/core": "0.0.1-beta.0",
+    "@voxel-pixel/utils": "0.0.1-beta.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}