@vaitosoi/minejs 0.2.1 → 0.2.2

package/dist/base/aabb.d.ts

@@ -0,0 +1,197 @@
+import { BitSet } from "./bitset";
+import { AxisCycle, BaseAxis, BaseVec3, Direction, Vec3 } from "./direction";
+import { BlockHitResult } from "./block";
+export interface BaseAABB {
+    minX: number;
+    minY: number;
+    minZ: number;
+    maxX: number;
+    maxY: number;
+    maxZ: number;
+}
+export declare class AABB implements BaseAABB {
+    minX: number;
+    minY: number;
+    minZ: number;
+    maxX: number;
+    maxY: number;
+    maxZ: number;
+    static readonly EntityBoundingBoxes: Record<string, AABB>;
+    /**
+     * Construct bounding box from entity namespace or type ID
+     * @param type Entity namespace or type ID
+     * @returns
+     */
+    static fromEntityType(type: string | number): AABB;
+    /**
+     * Construct bounding box from given rectangle
+     * @param height
+     * @param width
+     * @returns
+     */
+    static fromDimension(height: number, width: number): AABB;
+    /**
+     * Construct bounding box from base interface
+     * @param aabb
+     * @returns
+     */
+    static fromAABB(aabb: BaseAABB): AABB;
+    constructor(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number);
+    /**
+     * Return a copy
+     * @returns
+     */
+    copyBase(): BaseAABB;
+    /**
+     * Check if two AABB is equal
+     * @param aabb
+     * @returns
+     */
+    equal(aabb: AABB): boolean;
+    /**
+     * Expand AABB toward a Vector
+     */
+    expandTowards(x: number, y: number, z: number): AABB;
+    expandTowards(aabb: Vec3): AABB;
+    /**
+     * Shift this AABB by a given vector, or on the other word, shift each axis by given value
+     */
+    move(x: number, y: number, z: number): AABB;
+    move(aabb: BaseVec3): AABB;
+    /**
+     * Is two AABB intersect each other
+     */
+    isIntersect(other: AABB): boolean;
+    /**
+     * Get min value of an Axis
+     */
+    min(axis: BaseAxis): number;
+    /**
+     * Get max value of an Axis
+     */
+    max(axis: BaseAxis): number;
+    /**
+     * Cliping math. Find smallest distance to reach a face of this Shape, which contain multiple AABB.
+     */
+    static clip(aabbs: AABB[], from: Vec3, to: BaseVec3, pos: BaseVec3): BlockHitResult | null;
+    /**
+     * Cliping math. Find smallest distance to reach a face of this AABB.
+     */
+    static getDirection(aabb: BaseAABB, from: BaseVec3, delta: BaseVec3, direction_: Direction | null, scaleRef: [number]): Direction | null;
+    /**
+     * Calculate the clipping distance
+     */
+    static clipPoint(direction: Direction | null, newDiretion: Direction, scaleRef: [number], delta: {
+        a: number;
+        b: number;
+        c: number;
+    }, point: number, minB: number, maxB: number, minC: number, maxC: number, fromA: number, fromB: number, fromC: number): Direction | null;
+}
+/**
+ * Basically, a VoxelShape it a set of multiple AABB.
+ *
+ * For example, a VoxelShape of a stair is constructed from 2 AABB, lower half and upper half.
+ */
+export declare class VoxelShape {
+    xs: number[];
+    ys: number[];
+    zs: number[];
+    static Empty: VoxelShape;
+    /**
+     * Construct VoxelShape from an AABB
+     */
+    static fromBox(bb: BaseAABB): VoxelShape;
+    /**
+     * Merge two VoxelShape using `OR` operatior
+     */
+    static or(a: VoxelShape, b: VoxelShape): VoxelShape;
+    static createMerger(first: number[], second: number[]): IndexMerger;
+    private storage;
+    constructor(xs: number[], ys: number[], zs: number[], cells: boolean[][][] | BitSet);
+    /**
+     * Make a copy
+     */
+    copy(): VoxelShape;
+    /**
+     * Map an (X, Y, Z) index into storage or bitset index
+     */
+    private getIndex;
+    /**
+     * Get coords acording to each axis
+     */
+    getCoords(axis: BaseAxis): number[];
+    /**
+     * Is the cell at these index filled
+     */
+    isFullWide(transform: AxisCycle, x: number, y: number, z: number): boolean;
+    isFullWide(x: number, y: number, z: number): boolean;
+    /**
+     * Get the number of cells of an axis
+     */
+    getSize(axis: BaseAxis): number;
+    /**
+     * Real-world to cells index.
+     *
+     * The binary search mean: `Find the smallest number that larger than the provided coords`
+     */
+    findIndex(axis: BaseAxis, coords: number): number;
+    /**
+     * Cells index to real world position
+     */
+    get(axis: BaseAxis, index: number): number;
+    /**
+     * Is the whole shape is empty
+     *
+     * One cells filled, or return true, mean this is not empty
+     */
+    isEmpty(): boolean;
+    /**
+     * Shift this Voxel shape by a given vector, or on the other word, shift each axis by given value
+     */
+    move(x: number, y: number, z: number): VoxelShape;
+    move(position: BaseVec3): VoxelShape;
+    /**
+     * Collision math.
+     *
+     * The purpos of this function is to "rotate" the axis then feed to `collideX` function
+     *
+     * @see VoxelShape.collideX
+     */
+    collide(axis: BaseAxis, moving: AABB, distance: number): number;
+    /**
+     * Collision math.
+     *
+     * I don't know how to explain this D:
+     */
+    collideX(transform: AxisCycle, moving: AABB, distance: number): number;
+    /**
+     * Clipping math
+     *
+     * I don't know how to explain this either D:
+     */
+    clip(from: Vec3, to: Vec3, pos: BaseVec3): BlockHitResult | null;
+    /**
+     * Convert this VoxelShape into AABBs
+     */
+    toAABBs(): AABB[];
+    private forAllBoxes;
+    private isZStripFull;
+    private isXZRectangleFull;
+    private clearZStrip;
+}
+/**
+ * Helper class to do collision math
+ *
+ * @hidden
+ */
+export declare class Shapes {
+    static collide(axis: BaseAxis, moving: AABB, shapes: VoxelShape[], distance: number): number;
+}
+type IndexMergerConsumer = (i1: number, i2: number, ir: number) => void;
+declare abstract class IndexMerger {
+    abstract forMergedIndex(consumer: IndexMergerConsumer): void;
+    abstract get size(): number;
+    abstract get list(): number[];
+}
+export {};
+//# sourceMappingURL=aabb.d.ts.map

package/dist/base/aabb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aabb.d.ts","sourceRoot":"","sources":["../../src/base/aabb.ts"],"names":[],"mappings":"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"}