@next2d/player 1.14.7 → 1.14.8

package/dist/player/next2d/filters/DisplacementMapFilter.js

@@ -0,0 +1,381 @@
+import { BitmapFilter } from "./BitmapFilter";
+import { $clamp, $getArray, $intToB, $intToG, $intToR, $Math, $toColorInt } from "../../util/RenderUtil";
+/**
+ * DisplacementMapFilter クラスは、指定された BitmapData オブジェクト（置き換えマップイメージと言います）
+ * のピクセル値を使用して、オブジェクトの置き換え（変位）を実行します。
+ *
+ * The DisplacementMapFilter class uses the pixel values from the specified
+ * BitmapData object (called the displacement map image) to perform a displacement of an object.
+ *
+ * @class
+ * @memberOf next2d.filters
+ * @extends  BitmapFilter
+ */
+export class DisplacementMapFilter extends BitmapFilter {
+    _$mapBitmap;
+    _$mapPoint;
+    _$componentX;
+    _$componentY;
+    _$scaleX;
+    _$scaleY;
+    _$mode;
+    _$color;
+    _$alpha;
+    /**
+     * @param {BitmapData} [map_bitmap = null]
+     * @param {Point}      [map_point = null]
+     * @param {number}     [component_x = 0]
+     * @param {number}     [component_y = 0]
+     * @param {number}     [scale_x = 0.0]
+     * @param {number}     [scale_y = 0.0]
+     * @param {string}     [mode = DisplacementMapFilterMode.WRAP]
+     * @param {number}     [color = 0]
+     * @param {number}     [alpha = 0.0]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(map_bitmap = null, map_point = null, component_x = 0, component_y = 0, scale_x = 0, scale_y = 0, mode = "wrap", color = 0, alpha = 0) {
+        super();
+        /**
+         * @type {BitmapData}
+         * @default null
+         * @private
+         */
+        this._$mapBitmap = null;
+        /**
+         * @type {Point}
+         * @default null
+         * @private
+         */
+        this._$mapPoint = null;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$componentX = 0;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$componentY = 0;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$scaleX = 0;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$scaleY = 0;
+        /**
+         * @type {string}
+         * @default DisplacementMapFilterMode.WRAP
+         * @private
+         */
+        this._$mode = "wrap";
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$color = 0;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$alpha = 0;
+        // setup
+        this.mapBitmap = map_bitmap;
+        this.mapPoint = map_point;
+        this.componentX = component_x;
+        this.componentY = component_y;
+        this.scaleX = scale_x;
+        this.scaleY = scale_y;
+        this.mode = mode;
+        this.color = color;
+        this.alpha = alpha;
+    }
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class DisplacementMapFilter]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class DisplacementMapFilter]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.filters.DisplacementMapFilter
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.filters.DisplacementMapFilter";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object DisplacementMapFilter]
+     * @method
+     * @public
+     */
+    toString() {
+        return "[object DisplacementMapFilter]";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.filters.DisplacementMapFilter
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.filters.DisplacementMapFilter";
+    }
+    /**
+     * @description アルファ透明度の値です。
+     *              The alpha transparency value for the color.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get alpha() {
+        return this._$alpha;
+    }
+    set alpha(alpha) {
+        alpha = $clamp(+alpha, 0, 1, 0);
+        if (alpha !== this._$alpha) {
+            this._$alpha = alpha;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description 範囲外置き換えの場合に使用する色を指定します。
+     *              Specifies what color to use for out-of-bounds displacements.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get color() {
+        return this._$color;
+    }
+    set color(color) {
+        color = $clamp($toColorInt(color), 0, 0xffffff, 0);
+        if (color !== this._$color) {
+            this._$color = color;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description x の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。
+     *              Describes which color channel to use in the map image to displace the x result.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get componentX() {
+        return this._$componentX;
+    }
+    set componentX(component_x) {
+        if (component_x !== this._$componentX) {
+            this._$componentX = component_x;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description y の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。
+     *              Describes which color channel to use in the map image to displace the y result.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get componentY() {
+        return this._$componentY;
+    }
+    set componentY(component_y) {
+        if (component_y !== this._$componentY) {
+            this._$componentY = component_y;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description 置き換えマップデータが含まれる BitmapData オブジェクトです。
+     *              A BitmapData object containing the displacement map data.
+     *
+     * @member  {BitmapData}
+     * @default null
+     * @public
+     */
+    get mapBitmap() {
+        return this._$mapBitmap;
+    }
+    set mapBitmap(map_bitmap) {
+        if (map_bitmap !== this._$mapBitmap) {
+            this._$mapBitmap = map_bitmap;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description マップイメージの左上隅を基準としたターゲット表示オブジェクトの
+     *              左上隅のオフセットが含まれる値です。
+     *              A value that contains the offset of the upper-left corner
+     *              of the target display object from the upper-left corner of the map image.
+     *
+     * @member  {Point}
+     * @default null
+     * @public
+     */
+    get mapPoint() {
+        return this._$mapPoint;
+    }
+    set mapPoint(map_point) {
+        if (map_point !== this._$mapPoint) {
+            this._$mapPoint = map_point;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description フィルターのモードです。
+     *              The mode for the filter.
+     *
+     * @member  {string}
+     * @default DisplacementMapFilterMode.WRAP
+     * @public
+     */
+    get mode() {
+        return this._$mode;
+    }
+    set mode(mode) {
+        if (mode !== this._$mode) {
+            this._$mode = mode;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description マップ計算の x 置き換え結果を拡大 / 縮小する場合に使用する乗数です。
+     *              The multiplier to use to scale the x displacement result from the map calculation.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get scaleX() {
+        return this._$scaleX;
+    }
+    set scaleX(scale_x) {
+        scale_x = $clamp(+scale_x, -0xffff, 0xffff, 0);
+        if (scale_x !== this._$scaleX) {
+            this._$scaleX = scale_x;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description マップ計算の y 置き換え結果を拡大 / 縮小する場合に使用する乗数です。
+     *              The multiplier to use to scale the y displacement result from the map calculation.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get scaleY() {
+        return this._$scaleY;
+    }
+    set scaleY(scale_y) {
+        scale_y = $clamp(+scale_y, -0xffff, 0xffff, 0);
+        if (scale_y !== this._$scaleY) {
+            this._$scaleY = scale_y;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description オブジェクトのコピーを返します。
+     *              Returns a copy of this filter object.
+     *
+     * @return {DisplacementMapFilter}
+     * @method
+     * @public
+     */
+    clone() {
+        return new DisplacementMapFilter(this._$mapBitmap, this._$mapPoint, this._$componentX, this._$componentY, this._$scaleX, this._$scaleY, this._$mode, this._$color, this._$alpha);
+    }
+    /**
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$toArray() {
+        return $getArray(4, this._$mapBitmap, this._$mapPoint, this._$componentX, this._$componentY, this._$scaleX, this._$scaleY, this._$mode, this._$color, this._$alpha);
+    }
+    /**
+     * @param  {Rectangle} rect
+     * @return {Rectangle}
+     * @method
+     * @private
+     */
+    _$generateFilterRect(rect) {
+        return rect;
+    }
+    /**
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$canApply() {
+        return this._$mapBitmap !== null
+            && this._$componentX > 0 && this._$componentY > 0
+            && this._$scaleX !== 0 && this._$scaleY !== 0;
+    }
+    /**
+     * @param  {CanvasToWebGLContext} context
+     * @param  {Float32Array}  matrix
+     * @return {WebGLTexture}
+     * @method
+     * @private
+     */
+    _$applyFilter(context, matrix) {
+        this._$updated = false;
+        const manager = context.frameBuffer;
+        const currentAttachment = manager.currentAttachment;
+        // reset
+        context.setTransform(1, 0, 0, 1, 0, 0);
+        const texture = manager
+            .getTextureFromCurrentAttachment();
+        if (!this._$canApply()
+            || !currentAttachment
+            || !this._$mapBitmap) {
+            return texture;
+        }
+        const mapTexture = this._$mapBitmap.getTexture();
+        if (!mapTexture) {
+            return texture;
+        }
+        // matrix to scale
+        const xScale = $Math.sqrt(matrix[0] * matrix[0] + matrix[1] * matrix[1]);
+        const yScale = $Math.sqrt(matrix[2] * matrix[2] + matrix[3] * matrix[3]);
+        context._$applyDisplacementMapFilter(texture, mapTexture, texture.width / xScale, texture.height / yScale, this._$mapPoint, this._$componentX, this._$componentY, this._$scaleX, this._$scaleY, this._$mode, $intToR(this._$color, this._$alpha, true), $intToG(this._$color, this._$alpha, true), $intToB(this._$color, this._$alpha, true), this._$alpha);
+        manager.releaseAttachment(currentAttachment, true);
+        return manager.getTextureFromCurrentAttachment();
+    }
+}

package/dist/player/next2d/filters/DropShadowFilter.d.ts

@@ -0,0 +1,240 @@
+import { BitmapFilter } from "./BitmapFilter";
+import type { FilterQualityImpl } from "../../../interface/FilterQualityImpl";
+import type { Rectangle } from "../geom/Rectangle";
+import type { CanvasToWebGLContext } from "../../../webgl/CanvasToWebGLContext";
+/**
+ * DropShadowFilter クラスは、ドロップシャドウを表示オブジェクトに追加します。
+ * シャドウアルゴリズムは、ぼかしフィルターで使用するのと同じボックスフィルターに基づいています。
+ * ドロップシャドウのスタイルには複数のオプションがあり、内側シャドウ、外側シャドウ、ノックアウトモードなどがあります。
+ *
+ * The DropShadowFilter class lets you add a drop shadow to display objects.
+ * The shadow algorithm is based on the same box filter that the blur filter uses.
+ * You have several options for the style of the drop shadow, including inner
+ * or outer shadow and knockout mode.
+ *
+ * @class
+ * @memberOf next2d.filters
+ * @extends  BitmapFilter
+ */
+export declare class DropShadowFilter extends BitmapFilter {
+    private _$blurFilter;
+    private _$distance;
+    private _$angle;
+    private _$color;
+    private _$alpha;
+    private _$strength;
+    private _$inner;
+    private _$knockout;
+    private _$hideObject;
+    /**
+     * @param   {number}  [distance=4]
+     * @param   {number}  [angle=45]
+     * @param   {number}  [color=0]
+     * @param   {number}  [alpha=1]
+     * @param   {number}  [blur_x=4]
+     * @param   {number}  [blur_y=4]
+     * @param   {number}  [strength=1]
+     * @param   {number}  [quality=1]
+     * @param   {boolean} [inner=false]
+     * @param   {boolean} [knockout=false]
+     * @param   {boolean} [hide_object=false]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(distance?: number, angle?: number, color?: number, alpha?: number, blur_x?: number, blur_y?: number, strength?: number, quality?: FilterQualityImpl, inner?: boolean, knockout?: boolean, hide_object?: boolean);
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class DropShadowFilter]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.filters.DropShadowFilter
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object DropShadowFilter]
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.filters.DropShadowFilter
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description アルファ透明度の値です。
+     *              The alpha transparency value for the color.
+     *
+     * @member  {number}
+     * @default 1
+     * @public
+     */
+    get alpha(): number;
+    set alpha(alpha: number);
+    /**
+     * @description シャドウの角度
+     *              The angle of the shadow.
+     *
+     * @member  {number}
+     * @default 45
+     * @public
+     */
+    get angle(): number;
+    set angle(angle: number);
+    /**
+     * @description 水平方向のぼかし量。
+     *              The amount of horizontal blur.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get blurX(): number;
+    set blurX(blur_x: number);
+    /**
+     * @description 垂直方向のぼかし量。
+     *              The amount of vertical blur.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get blurY(): number;
+    set blurY(blur_y: number);
+    /**
+     * @description グローのカラー
+     *              The color of the glow.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get color(): number;
+    set color(color: number);
+    /**
+     * @description シャドウのオフセット距離です。
+     *              The offset distance for the shadow, in pixels.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get distance(): number;
+    set distance(distance: number);
+    /**
+     * @description オブジェクトが非表示であるかどうかを示します。
+     *              Indicates whether or not the object is hidden.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get hideObject(): boolean;
+    set hideObject(hide_object: boolean);
+    /**
+     * @description グローが内側グローであるかどうか
+     *              Specifies whether the glow is an inner glow.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get inner(): boolean;
+    set inner(inner: boolean);
+    /**
+     * @description オブジェクトにノックアウト効果を適用するかどうか
+     *              Specifies whether the object has a knockout effect.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get knockout(): boolean;
+    set knockout(knockout: boolean);
+    /**
+     * @description ぼかしの実行回数です。
+     *              The number of times to perform the blur.
+     *
+     * @member  {number}
+     * @default 1
+     * @public
+     */
+    get quality(): FilterQualityImpl;
+    set quality(quality: FilterQualityImpl);
+    /**
+     * @description インプリントの強さまたは広がりです。
+     *              The strength of the imprint or spread.
+     *
+     * @member  {number}
+     * @default 1
+     * @public
+     */
+    get strength(): number;
+    set strength(strength: number);
+    /**
+     * @description オブジェクトのコピーを返します。
+     *              Returns a copy of this filter object.
+     *
+     * @return {DropShadowFilter}
+     * @method
+     * @public
+     */
+    clone(): DropShadowFilter;
+    /**
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$toArray(): any[];
+    /**
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    _$isUpdated(): boolean;
+    /**
+     * @param  {Rectangle} rect
+     * @param  {number}    [x_scale=null]
+     * @param  {number}    [y_scale=null]
+     * @return {Rectangle}
+     * @method
+     * @private
+     */
+    _$generateFilterRect(rect: Rectangle, x_scale?: number, y_scale?: number): Rectangle;
+    /**
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$canApply(): boolean;
+    /**
+     * @param  {CanvasToWebGLContext} context
+     * @param  {Float32Array} matrix
+     * @return {WebGLTexture}
+     * @method
+     * @private
+     */
+    _$applyFilter(context: CanvasToWebGLContext, matrix: Float32Array): WebGLTexture;
+}