@next2d/geom 1.14.20

package/dist/Point.js

@@ -0,0 +1,274 @@
+import { $Math, $clamp, $SHORT_INT_MIN, $SHORT_INT_MAX } from "@next2d/share";
+/**
+ * Point オブジェクトは 2 次元の座標系の位置を表します。
+ * x は水平方向の軸を表し、y は垂直方向の軸を表します。
+ *
+ * The Point object represents a location in a two-dimensional coordinate system,
+ * where x represents the horizontal axis and y represents the vertical axis.
+ *
+ * @example <caption>Example usage of Point.</caption>
+ * // new Point
+ * const {Point} = next2d.geom;
+ * const point   = new Point();
+ *
+ * @class
+ * @memberOf next2d.geom
+ */
+export class Point {
+    /**
+     * @param {number} [x=0]
+     * @param {number} [y=0]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(x = 0, y = 0) {
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$x = 0;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$y = 0;
+        // setup
+        this.x = x;
+        this.y = y;
+    }
+    /**
+     * 指定されたクラスのストリングを返します。
+     * Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Point]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class Point]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @member  {string}
+     * @default next2d.geom.Point
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.geom.Point";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return {string}
+     * @method
+     * @public
+     */
+    toString() {
+        return `(x=${this.x}, y=${this.y})`;
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @member  {string}
+     * @default next2d.geom.Point
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.geom.Point";
+    }
+    /**
+     * @description (0,0) からこのポイントまでの線のセグメントの長さです。
+     *              The length of the line segment from (0,0) to this point.
+     *
+     * @member  {number}
+     * @default 0
+     * @readonly
+     * @public
+     */
+    get length() {
+        return $Math.sqrt($Math.pow(this.x, 2) + $Math.pow(this.y, 2));
+    }
+    /**
+     * @description ポイントの水平座標です。
+     *              The horizontal coordinate of the point.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get x() {
+        return this._$x;
+    }
+    set x(x) {
+        this._$x = $clamp(+x, $SHORT_INT_MIN, $SHORT_INT_MAX, 0);
+    }
+    /**
+     * @description ポイントの垂直座標です。
+     *              The vertical coordinate of the point.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get y() {
+        return this._$y;
+    }
+    set y(y) {
+        this._$y = $clamp(+y, $SHORT_INT_MIN, $SHORT_INT_MAX, 0);
+    }
+    /**
+     * @description このポイントの座標に他のポイントの座標を加算して、新しいポイントを作成します。
+     *              Adds the coordinates of another point
+     *              to the coordinates of this point to create a new point.
+     *
+     * @param   {Point} v
+     * @returns {Point}
+     * @method
+     * @public
+     */
+    add(v) {
+        return new Point(this.x + v.x, this.y + v.y);
+    }
+    /**
+     * @description この Point オブジェクトのコピーを作成します。
+     *              Creates a copy of this Point object.
+     *
+     * @returns {Point}
+     * @method
+     * @public
+     */
+    clone() {
+        return new Point(this.x, this.y);
+    }
+    /**
+     * @description すべてのポイントデータを、ソース Point オブジェクトから、
+     *              呼び出し元の Point オブジェクトにコピーします。
+     *              Copies all of the point data from
+     *              the source Point object into the calling Point object.
+     *
+     * @param   {Point} source_point
+     * @returns void
+     * @public
+     */
+    copyFrom(source_point) {
+        this._$x = source_point._$x;
+        this._$y = source_point._$y;
+    }
+    /**
+     * @description point1 と point2 との距離を返します。
+     *              Returns the distance between point1 and point2.
+     *
+     * @param  {Point} point1
+     * @param  {Point} point2
+     * @return {number}
+     * @method
+     * @static
+     */
+    static distance(point1, point2) {
+        return $Math.sqrt($Math.pow(point1._$x - point2._$x, 2)
+            + $Math.pow(point1._$y - point2._$y, 2));
+    }
+    /**
+     * @description 2 つのポイントが等しいかどうかを判別します。
+     *              Determines whether two points are equal.
+     *
+     * @param  {Point} to_compare
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    equals(to_compare) {
+        return this._$x === to_compare._$x && this._$y === to_compare._$y;
+    }
+    /**
+     * @description 2 つの指定されたポイント間にあるポイントを判別します。
+     *              Determines a point between two specified points.
+     *
+     * @param  {Point}  point1
+     * @param  {Point}  point2
+     * @param  {number} f
+     * @return {Point}
+     * @static
+     */
+    static interpolate(point1, point2, f) {
+        return new Point(point1.x + (point2.x - point1.x) * (1 - f), point1.y + (point2.y - point1.y) * (1 - f));
+    }
+    /**
+     * @description (0,0) と現在のポイント間の線のセグメントを設定された長さに拡大 / 縮小します。
+     *              Scales the line segment between (0,0) and the current point to a set length.
+     *
+     * @param  {number} thickness
+     * @return {void}
+     * @method
+     * @public
+     */
+    normalize(thickness) {
+        const length = this.length;
+        this.x = this.x * thickness / length;
+        this.y = this.y * thickness / length;
+    }
+    /**
+     * @description Point オブジェクトを指定された量だけオフセットします。
+     *              Offsets the Point object by the specified amount.
+     *
+     * @param  {number} dx
+     * @param  {number} dy
+     * @return {Point}
+     * @method
+     * @public
+     */
+    offset(dx, dy) {
+        this.x += dx;
+        this.y += dy;
+    }
+    /**
+     * @description 極座標ペアを直交点座標に変換します。
+     *              Converts a pair of polar coordinates to a Cartesian point coordinate.
+     *
+     * @param  {number} len
+     * @param  {number} angle
+     * @return {Point}
+     * @method
+     * @static
+     */
+    static polar(len, angle) {
+        return new Point(len * $Math.cos(angle), len * $Math.sin(angle));
+    }
+    /**
+     * @description Point のメンバーを指定の値に設定します。
+     *              Sets the members of Point to the specified values
+     *
+     * @param  {number} xa
+     * @param  {number} ya
+     * @return {void}
+     * @method
+     * @public
+     */
+    setTo(xa, ya) {
+        this.x = xa;
+        this.y = ya;
+    }
+    /**
+     * @description このポイントの座標から他のポイントの座標を減算して、新しいポイントを作成します。
+     *              Subtracts the coordinates of another point
+     *              from the coordinates of this point to create a new point.
+     *
+     * @param  {Point} v
+     * @return {Point}
+     * @method
+     * @public
+     */
+    subtract(v) {
+        return new Point(this.x - v.x, this.y - v.y);
+    }
+}

package/dist/Rectangle.d.ts

@@ -0,0 +1,364 @@
+import { Point } from "./Point";
+/**
+ * Rectangle オブジェクトは、その位置（左上隅のポイント (x, y) で示される)、および幅と高さで定義される領域です。
+ * Rectangle クラスの x、y、width、および height の各プロパティは、互いに独立しているため、
+ * あるプロパティの値を変更しても、他のプロパティに影響はありません。
+ * ただし、right プロパティと bottom プロパティはこれら 4 つのプロパティと不可分に関連しています。
+ * 例えば、right プロパティの値を変更すると width プロパティの値も変更されます。
+ * bottom プロパティの値を変更すると、height プロパティの値も変更されます。
+ *
+ * A Rectangle object is an area defined by its position,
+ * as indicated by its top-left corner point (x, y) and by its width and its height.
+ * The x, y, width, and height properties of the Rectangle class are independent of each other;
+ * changing the value of one property has no effect on the others. However,
+ * the right and bottom properties are integrally related to those four properties.
+ * For example, if you change the value of the right property, the value of the width property changes;
+ * if you change the bottom property, the value of the height property changes.
+ *
+ * @example <caption>Example usage of Rectangle.</caption>
+ * // new Rectangle
+ * const {Rectangle} = next2d.geom;
+ * const rectangle   = new Rectangle(0, 0, 100, 100);
+ *
+ * @class
+ * @memberOf next2d.geom
+ */
+export declare class Rectangle {
+    private _$x;
+    private _$y;
+    private _$width;
+    private _$height;
+    /**
+     * @param   {number} [x=0]
+     * @param   {number} [y=0]
+     * @param   {number} [width=0]
+     * @param   {number} [height=0]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(x?: number, y?: number, width?: number, height?: number);
+    /**
+     * 指定されたクラスのストリングを返します。
+     * Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Rectangle]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @member  {string}
+     * @default next2d.geom.Rectangle
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return {string}
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @member  {string}
+     * @default next2d.geom.Rectangle
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description y プロパティと height プロパティの合計です。
+     *              The sum of the y and height properties.
+     *
+     * @member {number}
+     * @public
+     */
+    get bottom(): number;
+    set bottom(bottom: number);
+    /**
+     * @description Rectangle オブジェクトの右下隅の位置で、
+     *              right プロパティと bottom プロパティの値で決まります。
+     *              The location of the Rectangle object's bottom-right corner,
+     *              determined by the values of the right and bottom properties.
+     *
+     * @member {Point}
+     * @public
+     */
+    get bottomRight(): Point;
+    set bottomRight(point: Point);
+    /**
+     * @description 矩形の高さ（ピクセル単位）です。
+     *              The height of the rectangle, in pixels.
+     *
+     * @member {number}
+     * @public
+     */
+    get height(): number;
+    set height(height: number);
+    /**
+     * @description 矩形の左上隅の x 座標です。
+     *              The x coordinate of the top-left corner of the rectangle.
+     *
+     * @member {number}
+     * @public
+     */
+    get left(): number;
+    set left(left: number);
+    /**
+     * @description x プロパティと width プロパティの合計です。
+     *              The sum of the x and width properties.
+     *
+     * @member {number}
+     * @public
+     */
+    get right(): number;
+    set right(right: number);
+    /**
+     * @description Rectangle オブジェクトのサイズで、
+     *              width プロパティと height プロパティの値を持つ Point オブジェクトとして表現されます。
+     *              The size of the Rectangle object,
+     *              expressed as a Point object with the values of the width and height properties.
+     *
+     * @member {Point}
+     * @public
+     */
+    get size(): Point;
+    set size(point: Point);
+    /**
+     * @description 矩形の左上隅の y 座標です。
+     *              The y coordinate of the top-left corner of the rectangle.
+     *
+     * @member {number}
+     * @public
+     */
+    get top(): number;
+    set top(top: number);
+    /**
+     * @description Rectangle オブジェクトの左上隅の位置で、
+     *              そのポイントの x 座標と y 座標で決まります。
+     *              The location of the Rectangle object's top-left corner,
+     *              determined by the x and y coordinates of the point.
+     *
+     * @member {Point}
+     * @public
+     */
+    get topLeft(): Point;
+    set topLeft(point: Point);
+    /**
+     * @description 矩形の幅（ピクセル単位）です。
+     *              The width of the rectangle, in pixels.
+     *
+     * @member {number}
+     * @public
+     */
+    get width(): number;
+    set width(width: number);
+    /**
+     * @description 矩形の左上隅の x 座標です。
+     *              The x coordinate of the top-left corner of the rectangle.
+     *
+     * @member {number}
+     * @public
+     */
+    get x(): number;
+    set x(x: number);
+    /**
+     * @description 矩形の左上隅の y 座標です。
+     *              The y coordinate of the top-left corner of the rectangle.
+     *
+     * @member {number}
+     * @public
+     */
+    get y(): number;
+    set y(y: number);
+    /**
+     * @description 元の Rectangle オブジェクトと x、y、width、および height の各プロパティの値が同じである、
+     *              新しい Rectangle オブジェクトを返します。
+     *              Returns a new Rectangle object with the same values for the x, y, width,
+     *              and height properties as the original Rectangle object.
+     *
+     * @return {Rectangle}
+     * @method
+     * @public
+     */
+    clone(): Rectangle;
+    /**
+     * @description 指定されたポイントがこの Rectangle オブジェクトで定義される矩形領域内にあるかどうかを判別します。
+     *              Determines whether the specified point is contained within
+     *              the rectangular region defined by this Rectangle object.
+     *
+     * @param  {number} x
+     * @param  {number} y
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    contains(x: number, y: number): boolean;
+    /**
+     * @description 指定されたポイントがこの Rectangle オブジェクトで定義される矩形領域内にあるかどうかを判別します。
+     *              Determines whether the specified point is contained within
+     *              the rectangular region defined by this Rectangle object.
+     *
+     * @param  {Point}   point
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    containsPoint(point: Point): boolean;
+    /**
+     * @description rect パラメーターで指定された Rectangle オブジェクトがこの Rectangle オブジェクト内にあるかどうかを判別します。
+     *              Determines whether the Rectangle object specified by
+     *              the rect parameter is contained within this Rectangle object.
+     *
+     * @param  {Rectangle} rect
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    containsRect(rect: Rectangle): boolean;
+    /**
+     * @description すべての矩形データを、ソース Rectangle オブジェクトから、
+     *              呼び出し元の Rectangle オブジェクトにコピーします。
+     *              Copies all of rectangle data from
+     *              the source Rectangle object into the calling Rectangle object.
+     *
+     * @param  {Rectangle} source_rect
+     * @return {void}
+     * @method
+     * @public
+     */
+    copyFrom(source_rect: Rectangle): void;
+    /**
+     * @description toCompare パラメーターで指定されたオブジェクトが
+     *              この Rectangle オブジェクトと等しいかどうかを判別します。
+     *              Determines whether the object specified
+     *              in the toCompare parameter is equal to this Rectangle object.
+     *
+     * @param  {Rectangle} to_compare
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    equals(to_compare: Rectangle): boolean;
+    /**
+     * @description Rectangle オブジェクトのサイズを、指定された量（ピクセル単位）だけ大きくします。
+     *              Increases the size of the Rectangle object by the specified amounts, in pixels.
+     *
+     * @param  {number} dx
+     * @param  {number} dy
+     * @return void
+     * @method
+     * @public
+     */
+    inflate(dx: number, dy: number): void;
+    /**
+     * @description Rectangle オブジェクトのサイズを大きくします。
+     *              Increases the size of the Rectangle object.
+     *
+     * @param  {Point} point
+     * @return {void}
+     * @method
+     * @public
+     */
+    inflatePoint(point: Point): void;
+    /**
+     * @description toIntersect パラメーターで指定された Rectangle オブジェクトが
+     *              この Rectangle オブジェクトと交差する場合に、交差領域を Rectangle オブジェクトとして返します。
+     *              If the Rectangle object specified in the toIntersect parameter intersects
+     *              with this Rectangle object, returns the area of intersection as a Rectangle object.
+     *
+     * @param  {Rectangle} to_intersect
+     * @return {Rectangle}
+     * @method
+     * @public
+     */
+    intersection(to_intersect: Rectangle): Rectangle;
+    /**
+     * @description toIntersect パラメーターで指定されたオブジェクトが
+     *              この Rectangle オブジェクトと交差するかどうかを判別します。
+     *              Determines whether the object specified
+     *              in the toIntersect parameter intersects with this Rectangle object.
+     *
+     * @param  {Rectangle} to_intersect
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    intersects(to_intersect: Rectangle): boolean;
+    /**
+     * @description この Rectangle オブジェクトが空かどうかを判別します。
+     *              Determine if this Rectangle object is empty.
+     *
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    isEmpty(): boolean;
+    /**
+     * @description Rectangle オブジェクトの位置（左上隅で決定される）を、指定された量だけ調整します。
+     *              Adjusts the location of the Rectangle object,
+     *              as determined by its top-left corner, by the specified amounts.
+     *
+     * @param  {number} dx
+     * @param  {number} dy
+     * @return {void}
+     * @method
+     * @public
+     */
+    offset(dx: number, dy: number): void;
+    /**
+     * @description Point オブジェクトをパラメーターとして使用して、Rectangle オブジェクトの位置を調整します。
+     *              Adjusts the location of the Rectangle object using a Point object as a parameter.
+     *
+     * @param  {Point} point
+     * @return {void}
+     * @method
+     * @public
+     */
+    offsetPoint(point: Point): void;
+    /**
+     * @description Rectangle オブジェクトのすべてのプロパティを 0 に設定します。
+     *              Sets all properties of the Rectangle object to 0.
+     *
+     * @return {void}
+     * @method
+     * @public
+     */
+    setEmpty(): void;
+    /**
+     * @description Rectangle のメンバーを指定の値に設定します。
+     *              Sets the members of Rectangle to the specified values
+     *
+     * @param  {number} x
+     * @param  {number} y
+     * @param  {number} width
+     * @param  {number} height
+     * @return {void}
+     * @method
+     * @public
+     */
+    setTo(x: number, y: number, width: number, height: number): void;
+    /**
+     * @description 2 つの矩形間の水平と垂直の空間を塗りつぶすことにより、
+     *              2 つの矩形を加算して新しい Rectangle オブジェクトを作成します。
+     *              Adds two rectangles together to create a new Rectangle object,
+     *              by filling in the horizontal and vertical space between the two rectangles.
+     *
+     * @param  {Rectangle} to_union
+     * @return {Rectangle}
+     * @method
+     * @public
+     */
+    union(to_union: Rectangle): Rectangle;
+}