@next2d/player 1.14.7 → 1.14.9

package/dist/player/next2d/geom/Transform.d.ts

@@ -0,0 +1,213 @@
+import { Rectangle } from "./Rectangle";
+import type { ColorTransform } from "./ColorTransform";
+import type { Matrix } from "./Matrix";
+import type { PlaceObjectImpl } from "../../../interface/PlaceObjectImpl";
+import type { DisplayObjectImpl } from "../../../interface/DisplayObjectImpl";
+import type { FilterArrayImpl } from "../../../interface/FilterArrayImpl";
+import type { BlendModeImpl } from "../../../interface/BlendModeImpl";
+import type { SurfaceFilterImpl } from "../../../interface/SurfaceFilterImpl";
+/**
+ * Transform クラスは、表示オブジェクトに適用されるカラー調整プロパティと 2 次元の変換オブジェクトへのアクセスを提供します。
+ * 変換時に、表示オブジェクトのカラーまたは方向と位置が、現在の値または座標から新しい値または座標に調整（オフセット）されます。
+ * Transform クラスは、表示オブジェクトおよびすべての親オブジェクトに適用されるカラー変換と 2 次元マトリックス変換に関するデータも収集します。
+ * concatenatedColorTransform プロパティと concatenatedMatrix プロパティを使用して、これらの結合された変換にアクセスできます。
+ * カラー変換を適用するには、ColorTransform オブジェクトを作成し、オブジェクトのメソッドとプロパティを使用してカラー調整を設定した後、
+ * colorTransformation プロパティ（表示オブジェクトの transform プロパティの）を新しい ColorTransformation オブジェクトに割り当てます。
+ * 2 次元変換を適用するには、Matrix オブジェクトを作成し、マトリックスの 2 次元変換を設定した後、表示オブジェクトの transform.matrix プロパティを新しい Matrix オブジェクトに割り当てます。
+ *
+ * The Transform class provides access to color adjustment properties and two--dimensional transformation objects that can be applied to a display object.
+ * During the transformation, the color or the orientation and position of a display object is adjusted (offset) from the current values or coordinates to new values or coordinates.
+ * The Transform class also collects data about color and two-dimensional matrix transformations that are applied to a display object and all of its parent objects.
+ * You can access these combined transformations through the concatenatedColorTransform and concatenatedMatrix properties.
+ * To apply color transformations: create a ColorTransform object,
+ * set the color adjustments using the object's methods and properties,
+ * and then assign the colorTransformation property of the transform property of the display object to the new ColorTransformation object.
+ * To apply two-dimensional transformations: create a Matrix object,
+ * set the matrix's two-dimensional transformation,
+ * and then assign the transform.matrix property of the display object to the new Matrix object.
+ *
+ * @example <caption>Example usage of Transform.</caption>
+ * // new Transform
+ * const {Transform} = next2d.geom;
+ * const transform   = new Transform(displayObject);
+ *
+ * @class
+ * @memberOf next2d.geom
+ */
+export declare class Transform {
+    private readonly _$displayObject;
+    private _$matrix;
+    private _$colorTransform;
+    _$blendMode: BlendModeImpl | null;
+    _$filters: FilterArrayImpl | null;
+    /**
+     * @param {DisplayObject} src
+     *
+     * @constructor
+     * @public
+     */
+    constructor(src: DisplayObjectImpl<any>);
+    /**
+     * 指定されたクラスのストリングを返します。
+     * Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class Transform]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @member  {string}
+     * @default next2d.geom.Transform
+     * @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.Transform
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description 表示オブジェクトのカラーを全体的に調整する値を格納している
+     *              ColorTransform オブジェクトです。
+     *              A ColorTransform object containing values that universally adjust
+     *              the colors in the display object.
+     *
+     * @member {ColorTransform}
+     * @public
+     */
+    get colorTransform(): ColorTransform;
+    set colorTransform(color_transform: ColorTransform);
+    /**
+     * @description この表示オブジェクトおよびルートレベルまでのすべての親オブジェクトに適用される、
+     *              結合されたカラー変換を表す ColorTransform オブジェクトです。
+     *              A ColorTransform object representing
+     *              the combined color transformations applied to the display object
+     *              and all of its parent objects, back to the root level.
+     *
+     * @member {ColorTransform}
+     * @readonly
+     * @public
+     */
+    get concatenatedColorTransform(): ColorTransform;
+    /**
+     * @description 表示オブジェクトの拡大 / 縮小、回転、および移動を変更する値を格納している
+     *              Matrix オブジェクトです。
+     *              A Matrix object containing values that alter the scaling,
+     *              rotation, and translation of the display object.
+     *
+     * @member {Matrix}
+     * @public
+     */
+    get matrix(): Matrix;
+    set matrix(matrix: Matrix);
+    /**
+     * @description この表示オブジェクトおよびルートレベルまでのそのすべての親オブジェクトの結合された
+     *              変換マトリックスを表す Matrix オブジェクトです。
+     *              A Matrix object representing the combined transformation matrixes
+     *              of the display object and all of its parent objects, back to the root level.
+     *
+     * @member {Matrix}
+     * @readonly
+     * @method
+     * @public
+     */
+    get concatenatedMatrix(): Matrix;
+    /**
+     * @description ステージ上の表示オブジェクトの境界を示す矩形を定義する Transform オブジェクトです。
+     *              A Transform object that defines the bounding rectangle of
+     *              the display object on the stage.
+     *
+     * @member {Transform}
+     * @readonly
+     * @method
+     * @public
+     */
+    pixelBounds(): Rectangle;
+    /**
+     * matrix プロパティから取得される Matrix の Matrix._$matrix と同じ値を返しますが、matrix プロパティと異なり Matrix を複製しません。
+     * 返される値は一時的に使用することのみできます。返される値の要素を直接更新してはいけません。返される値をプール（Util.$poolFloat32Array）してはいけません。
+     *
+     * @return {Float32Array}
+     * @method
+     * @private
+     */
+    _$rawMatrix(): Float32Array;
+    /**
+     * colorTransform プロパティから取得される ColorTransform の colorTransform._$colorTransform と同じ値を返しますが、colorTransform プロパティと異なり ColorTransform を複製しません。
+     * 返される値は一時的に使用することのみできます。返される値の要素を直接更新してはいけません。返される値をプール（Util.$poolFloat32Array）してはいけません。
+     *
+     * @return {Float32Array}
+     * @method
+     * @private
+     */
+    _$rawColorTransform(): Float32Array;
+    /**
+     * @param  {Float32Array} [matrix=null]
+     * @param  {Float32Array} [color_transform=null]
+     * @param  {array}        [filters=null]
+     * @param  {string}       [blend_mode=""]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$transform(matrix?: Float32Array | null, color_transform?: Float32Array | null, filters?: FilterArrayImpl | null, blend_mode?: BlendModeImpl | ""): void;
+    /**
+     * @param  {Float32Array} [matrix=null]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setMatrix(matrix?: Float32Array | number[] | null, place_object?: PlaceObjectImpl | null): void;
+    /**
+     * @param  {Float32Array} [color_transform=null]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setColorTransform(color_transform?: Float32Array | number[] | null, place_object?: PlaceObjectImpl | null): void;
+    /**
+     * @param  {array}  [filters=null]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setFilters(filters?: FilterArrayImpl | null, place_object?: PlaceObjectImpl | null): void;
+    /**
+     * @param  {array} surface_filter_list
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$buildFilter(surface_filter_list: SurfaceFilterImpl[]): FilterArrayImpl;
+    /**
+     * @param  {string} [blend_mode=""]
+     * @param  {object} [place_object=null]
+     * @return {void}
+     * @method
+     * @private
+     */
+    _$setBlendMode(blend_mode?: BlendModeImpl | "", place_object?: PlaceObjectImpl | null): void;
+}