@next2d/player 1.14.7 → 1.14.8

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

@@ -0,0 +1,470 @@
+import { BitmapFilter } from "./BitmapFilter";
+import { BlurFilter } from "./BlurFilter";
+import { $clamp, $Deg2Rad, $getArray, $Math, $toColorInt, $intToR, $intToG, $intToB } from "../../util/RenderUtil";
+/**
+ * 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 class DropShadowFilter extends BitmapFilter {
+    _$blurFilter;
+    _$distance;
+    _$angle;
+    _$color;
+    _$alpha;
+    _$strength;
+    _$inner;
+    _$knockout;
+    _$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 = 4, angle = 45, color = 0, alpha = 1, blur_x = 4, blur_y = 4, strength = 1, quality = 1, inner = false, knockout = false, hide_object = false) {
+        super();
+        /**
+         * @type {BlurFilter}
+         * @default BlurFilter
+         * @private
+         */
+        this._$blurFilter = new BlurFilter(blur_x, blur_y, quality);
+        /**
+         * @type {number}
+         * @default 4
+         * @private
+         */
+        this._$distance = 4;
+        /**
+         * @type {number}
+         * @default 45
+         * @private
+         */
+        this._$angle = 45;
+        /**
+         * @type {number}
+         * @default 0
+         * @private
+         */
+        this._$color = 0;
+        /**
+         * @type {number}
+         * @default 1
+         * @private
+         */
+        this._$alpha = 1;
+        /**
+         * @type {number}
+         * @default 1
+         * @private
+         */
+        this._$strength = 1;
+        /**
+         * @type {boolean}
+         * @default false
+         * @private
+         */
+        this._$inner = false;
+        /**
+         * @type {boolean}
+         * @default false
+         * @private
+         */
+        this._$knockout = false;
+        /**
+         * @type {boolean}
+         * @default false
+         * @private
+         */
+        this._$hideObject = false;
+        // setup
+        this.distance = distance;
+        this.angle = angle;
+        this.color = color;
+        this.alpha = alpha;
+        this.strength = strength;
+        this.inner = inner;
+        this.knockout = knockout;
+        this.hideObject = hide_object;
+    }
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class DropShadowFilter]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class DropShadowFilter]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.filters.DropShadowFilter
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.filters.DropShadowFilter";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object DropShadowFilter]
+     * @method
+     * @public
+     */
+    toString() {
+        return "[object DropShadowFilter]";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.filters.DropShadowFilter
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.filters.DropShadowFilter";
+    }
+    /**
+     * @description アルファ透明度の値です。
+     *              The alpha transparency value for the color.
+     *
+     * @member  {number}
+     * @default 1
+     * @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 シャドウの角度
+     *              The angle of the shadow.
+     *
+     * @member  {number}
+     * @default 45
+     * @public
+     */
+    get angle() {
+        return this._$angle;
+    }
+    set angle(angle) {
+        angle %= 360;
+        if (angle !== this._$angle) {
+            this._$angle = $clamp(angle, -360, 360, 45);
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description 水平方向のぼかし量。
+     *              The amount of horizontal blur.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get blurX() {
+        return this._$blurFilter.blurX;
+    }
+    set blurX(blur_x) {
+        this._$blurFilter.blurX = blur_x;
+    }
+    /**
+     * @description 垂直方向のぼかし量。
+     *              The amount of vertical blur.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get blurY() {
+        return this._$blurFilter.blurY;
+    }
+    set blurY(blur_y) {
+        this._$blurFilter.blurY = blur_y;
+    }
+    /**
+     * @description グローのカラー
+     *              The color of the glow.
+     *
+     * @member  {number}
+     * @default 4
+     * @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 シャドウのオフセット距離です。
+     *              The offset distance for the shadow, in pixels.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get distance() {
+        return this._$distance;
+    }
+    set distance(distance) {
+        distance = $clamp(+distance, -255, 255, 4);
+        if (distance !== this._$distance) {
+            this._$distance = distance;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description オブジェクトが非表示であるかどうかを示します。
+     *              Indicates whether or not the object is hidden.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get hideObject() {
+        return this._$hideObject;
+    }
+    set hideObject(hide_object) {
+        if (hide_object !== this._$hideObject) {
+            this._$hideObject = !!hide_object;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description グローが内側グローであるかどうか
+     *              Specifies whether the glow is an inner glow.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get inner() {
+        return this._$inner;
+    }
+    set inner(inner) {
+        if (inner !== this._$inner) {
+            this._$inner = !!inner;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description オブジェクトにノックアウト効果を適用するかどうか
+     *              Specifies whether the object has a knockout effect.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get knockout() {
+        return this._$knockout;
+    }
+    set knockout(knockout) {
+        if (knockout !== this._$knockout) {
+            this._$knockout = !!knockout;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description ぼかしの実行回数です。
+     *              The number of times to perform the blur.
+     *
+     * @member  {number}
+     * @default 1
+     * @public
+     */
+    get quality() {
+        return this._$blurFilter.quality;
+    }
+    set quality(quality) {
+        this._$blurFilter.quality = quality;
+    }
+    /**
+     * @description インプリントの強さまたは広がりです。
+     *              The strength of the imprint or spread.
+     *
+     * @member  {number}
+     * @default 1
+     * @public
+     */
+    get strength() {
+        return this._$strength;
+    }
+    set strength(strength) {
+        strength = $clamp(strength | 0, 0, 255, 0);
+        if (strength !== this._$strength) {
+            this._$strength = strength;
+            this._$doChanged();
+        }
+    }
+    /**
+     * @description オブジェクトのコピーを返します。
+     *              Returns a copy of this filter object.
+     *
+     * @return {DropShadowFilter}
+     * @method
+     * @public
+     */
+    clone() {
+        return new DropShadowFilter(this._$distance, this._$angle, this._$color, this._$alpha, this._$blurFilter.blurX, this._$blurFilter.blurY, this._$strength, this._$blurFilter.quality, this._$inner, this._$knockout, this._$hideObject);
+    }
+    /**
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$toArray() {
+        return $getArray(5, this._$distance, this._$angle, this._$color, this._$alpha, this._$blurFilter.blurX, this._$blurFilter.blurY, this._$strength, this._$blurFilter.quality, this._$inner, this._$knockout, this._$hideObject);
+    }
+    /**
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    _$isUpdated() {
+        return this._$updated || this._$blurFilter._$isUpdated();
+    }
+    /**
+     * @param  {Rectangle} rect
+     * @param  {number}    [x_scale=null]
+     * @param  {number}    [y_scale=null]
+     * @return {Rectangle}
+     * @method
+     * @private
+     */
+    _$generateFilterRect(rect, x_scale = 0, y_scale = 0) {
+        let clone = rect.clone();
+        if (!this._$canApply()) {
+            return clone;
+        }
+        clone = this
+            ._$blurFilter
+            ._$generateFilterRect(clone, x_scale, y_scale);
+        const radian = this._$angle * $Deg2Rad;
+        const x = $Math.cos(radian) * this._$distance * 2;
+        const y = $Math.sin(radian) * this._$distance * 2;
+        clone.x = $Math.min(clone.x, x);
+        clone.width += $Math.abs(x);
+        clone.y = $Math.min(clone.y, y);
+        clone.height += $Math.abs(y);
+        return clone;
+    }
+    /**
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$canApply() {
+        return this._$alpha > 0 && this._$strength > 0 && this._$blurFilter._$canApply();
+    }
+    /**
+     * @param  {CanvasToWebGLContext} context
+     * @param  {Float32Array} matrix
+     * @return {WebGLTexture}
+     * @method
+     * @private
+     */
+    _$applyFilter(context, matrix) {
+        const manager = context.frameBuffer;
+        const currentAttachment = manager.currentAttachment;
+        if (!currentAttachment) {
+            throw new Error("the current attachment is null.");
+        }
+        // reset
+        context.setTransform(1, 0, 0, 1, 0, 0);
+        if (!this._$canApply()) {
+            return manager.getTextureFromCurrentAttachment();
+        }
+        const baseWidth = currentAttachment.width;
+        const baseHeight = currentAttachment.height;
+        const baseOffsetX = context._$offsetX;
+        const baseOffsetY = context._$offsetY;
+        const blurTexture = this
+            ._$blurFilter
+            ._$applyFilter(context, matrix, false);
+        const blurWidth = blurTexture.width;
+        const blurHeight = blurTexture.height;
+        const blurOffsetX = context._$offsetX;
+        const blurOffsetY = context._$offsetY;
+        const offsetDiffX = blurOffsetX - baseOffsetX;
+        const offsetDiffY = blurOffsetY - baseOffsetY;
+        const xScale = $Math.sqrt(matrix[0] * matrix[0] + matrix[1] * matrix[1]);
+        const yScale = $Math.sqrt(matrix[2] * matrix[2] + matrix[3] * matrix[3]);
+        // shadow point
+        const radian = this._$angle * $Deg2Rad;
+        const x = $Math.cos(radian) * this._$distance * xScale;
+        const y = $Math.sin(radian) * this._$distance * yScale;
+        // dropShadow canvas
+        const w = this._$inner ? baseWidth : blurWidth + $Math.max(0, $Math.abs(x) - offsetDiffX);
+        const h = this._$inner ? baseHeight : blurHeight + $Math.max(0, $Math.abs(y) - offsetDiffY);
+        const width = $Math.ceil(w);
+        const height = $Math.ceil(h);
+        const fractionX = (width - w) / 2;
+        const fractionY = (height - h) / 2;
+        const baseTextureX = this._$inner ? 0 : $Math.max(0, offsetDiffX - x) + fractionX;
+        const baseTextureY = this._$inner ? 0 : $Math.max(0, offsetDiffY - y) + fractionY;
+        const blurTextureX = this._$inner ? x - blurOffsetX : (x > 0 ? $Math.max(0, x - offsetDiffX) : 0) + fractionX;
+        const blurTextureY = this._$inner ? y - blurOffsetY : (y > 0 ? $Math.max(0, y - offsetDiffY) : 0) + fractionY;
+        let type;
+        let knockout;
+        if (this._$inner) {
+            type = "inner";
+            knockout = this._$knockout || this._$hideObject;
+        }
+        else if (!this._$knockout && this._$hideObject) {
+            type = "full";
+            knockout = true;
+        }
+        else {
+            type = "outer";
+            knockout = this._$knockout;
+        }
+        context._$bind(currentAttachment);
+        context._$applyBitmapFilter(blurTexture, width, height, baseWidth, baseHeight, baseTextureX, baseTextureY, blurWidth, blurHeight, blurTextureX, blurTextureY, true, type, knockout, this._$strength, null, null, null, $intToR(this._$color, this._$alpha, true), $intToG(this._$color, this._$alpha, true), $intToB(this._$color, this._$alpha, true), this._$alpha, 0, 0, 0, 0);
+        context._$offsetX = baseOffsetX + baseTextureX;
+        context._$offsetY = baseOffsetY + baseTextureY;
+        manager.releaseTexture(blurTexture);
+        return manager.getTextureFromCurrentAttachment();
+    }
+}

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

@@ -0,0 +1,204 @@
+import { BitmapFilter } from "./BitmapFilter";
+import type { FilterQualityImpl } from "../../../interface/FilterQualityImpl";
+import type { Rectangle } from "../geom/Rectangle";
+import type { CanvasToWebGLContext } from "../../../webgl/CanvasToWebGLContext";
+/**
+ * GlowFilter クラスを使用すると、表示オブジェクトにグロー効果を適用できます。
+ * グローのスタイルには複数のオプションがあり、内側グロー、外側グロー、ノックアウトモードなどがあります。
+ * グローフィルターは、distance プロパティと angle プロパティを 0 に設定したドロップシャドウフィルターによく似ています。
+ *
+ * The GlowFilter class lets you apply a glow effect to display objects.
+ * You have several options for the style of the glow, including inner or outer glow and knockout mode.
+ * The glow filter is similar to the drop shadow filter with the distance
+ * and angle properties of the drop shadow filter set to 0.
+ *
+ * @class
+ * @memberOf next2d.filters
+ * @extends  BitmapFilter
+ */
+export declare class GlowFilter extends BitmapFilter {
+    private readonly _$blurFilter;
+    private _$color;
+    private _$alpha;
+    private _$strength;
+    private _$inner;
+    private _$knockout;
+    /**
+     * @param   {number}  [color=0xFF0000]
+     * @param   {number}  [alpha=1]
+     * @param   {number}  [blur_x=6]
+     * @param   {number}  [blur_y=6]
+     * @param   {number}  [strength=2]
+     * @param   {int}     [quality=1]
+     * @param   {boolean} [inner=false]
+     * @param   {boolean} [knockout=false]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(color?: number, alpha?: number, blur_x?: number, blur_y?: number, strength?: number, quality?: FilterQualityImpl, inner?: boolean, knockout?: boolean);
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class GlowFilter]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.filters.GlowFilter
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object GlowFilter]
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.filters.GlowFilter
+     * @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 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 グローが内側グローであるかどうか
+     *              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 {GlowFilter}
+     * @method
+     * @public
+     */
+    clone(): GlowFilter;
+    /**
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$toArray(): any[];
+    /**
+     * @return {boolean}
+     * @method
+     * @public
+     */
+    _$isUpdated(): boolean;
+    /**
+     * @param  {Rectangle} rect
+     * @param  {number}    [x_scale=0]
+     * @param  {number}    [y_scale=0]
+     * @return {Rectangle}
+     * @method
+     * @private
+     */
+    _$generateFilterRect(rect: Rectangle, x_scale?: number, y_scale?: number): Rectangle;
+    /**
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$canApply(): boolean;
+    /**
+     * @param  {CanvasToWebGLContext} context
+     * @param  {array}  matrix
+     * @return {WebGLTexture}
+     * @method
+     * @private
+     */
+    _$applyFilter(context: CanvasToWebGLContext, matrix: Float32Array): WebGLTexture;
+}