@next2d/player 1.14.7 → 1.14.8

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

@@ -0,0 +1,180 @@
+import { BitmapFilter } from "./BitmapFilter";
+import { $Array, $getArray } from "../../util/RenderUtil";
+/**
+ * ColorMatrixFilter クラスを使用すると、表示オブジェクトにぼかし効果を適用できます。
+ * ぼかし効果は、イメージの細部をぼかします。ソフトフォーカスがかかっているように見えるぼかしから、
+ * 半透明ガラスを通してイメージを見るようにかすんで見えるガウスぼかしまで作成できます。
+ * このフィルターの quality プロパティを低く設定すると、ソフトフォーカスがかかっているように見えるぼかしになります。
+ * quality プロパティを高く設定すると、ガウスぼかしフィルターに似たものになります。
+ *
+ * The ColorMatrixFilter class lets you apply a blur visual effect to display objects.
+ * A blur effect softens the details of an image.
+ * You can produce blurs that range from a softly unfocused look to a Gaussian blur,
+ * a hazy appearance like viewing an image through semi-opaque glass.
+ * When the quality property of this filter is set to low, the result is a softly unfocused look.
+ * When the quality property is set to high, it approximates a Gaussian blur filter.
+ *
+ * @class
+ * @memberOf next2d.filters
+ * @extends  BitmapFilter
+ */
+export class ColorMatrixFilter extends BitmapFilter {
+    _$matrix;
+    /**
+     * @param {array} [matrix=null]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(matrix = null) {
+        super();
+        /**
+         * @type {array}
+         * @default {array}
+         * @private
+         */
+        this._$matrix = [
+            1, 0, 0, 0, 0,
+            0, 1, 0, 0, 0,
+            0, 0, 1, 0, 0,
+            0, 0, 0, 1, 0
+        ];
+        // setup
+        this.matrix = matrix;
+    }
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class ColorMatrixFilter]
+     * @method
+     * @static
+     */
+    static toString() {
+        return "[class ColorMatrixFilter]";
+    }
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.filters.ColorMatrixFilter
+     * @const
+     * @static
+     */
+    static get namespace() {
+        return "next2d.filters.ColorMatrixFilter";
+    }
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object ColorMatrixFilter]
+     * @method
+     * @public
+     */
+    toString() {
+        return "[object ColorMatrixFilter]";
+    }
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.filters.ColorMatrixFilter
+     * @const
+     * @public
+     */
+    get namespace() {
+        return "next2d.filters.ColorMatrixFilter";
+    }
+    /**
+     * @description 4×5 カラー変換用の20個のアイテムの配列
+     *              An array of 20 items for 4x5 color transform.
+     *
+     * @member  {array}
+     * @default null
+     * @public
+     */
+    get matrix() {
+        return this._$matrix;
+    }
+    set matrix(matrix) {
+        if (!matrix || !$Array.isArray(matrix) || matrix.length !== 20) {
+            return;
+        }
+        for (let idx = 0; idx < 20; ++idx) {
+            if (matrix[idx] === this._$matrix[idx]) {
+                continue;
+            }
+            this._$doChanged();
+            break;
+        }
+        this._$matrix = matrix;
+    }
+    /**
+     * @description オブジェクトのコピーを返します。
+     *              Returns a copy of this filter object.
+     *
+     * @return {ColorMatrixFilter}
+     * @method
+     * @public
+     */
+    clone() {
+        return new ColorMatrixFilter(this._$matrix);
+    }
+    /**
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$toArray() {
+        return $getArray(2, this._$matrix);
+    }
+    /**
+     * @param  {Rectangle} rect
+     * @return {Rectangle}
+     * @method
+     * @private
+     */
+    _$generateFilterRect(rect) {
+        return rect;
+    }
+    /**
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$canApply() {
+        return true;
+    }
+    /**
+     * @param  {CanvasToWebGLContext} context
+     * @return {WebGLTexture}
+     * @method
+     * @private
+     */
+    _$applyFilter(context) {
+        this._$updated = false;
+        const manager = context.frameBuffer;
+        const currentAttachment = manager.currentAttachment;
+        // reset
+        context.setTransform(1, 0, 0, 1, 0, 0);
+        const texture = manager
+            .getTextureFromCurrentAttachment();
+        const width = texture.width;
+        const height = texture.height;
+        // new buffer
+        const targetTextureAttachment = manager
+            .createTextureAttachment(width, height);
+        context._$bind(targetTextureAttachment);
+        // apply
+        context.reset();
+        context._$applyColorMatrixFilter(texture, this._$matrix);
+        // reset
+        manager.releaseAttachment(currentAttachment, true);
+        return manager.getTextureFromCurrentAttachment();
+    }
+}

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

@@ -0,0 +1,210 @@
+import { BitmapFilter } from "./BitmapFilter";
+import type { Rectangle } from "../geom/Rectangle";
+import type { CanvasToWebGLContext } from "../../../webgl/CanvasToWebGLContext";
+/**
+ * ConvolutionFilter クラスを使用すると、マトリックス畳み込みフィルター効果を適用できます。
+ * 畳み込みでは、入力イメージ内のピクセルを、隣接するピクセルと組み合わせて、イメージを作成します。
+ * 畳み込みを使用すると、ぼかし、エッジ検出、シャープ、エンボス、ベベルなど、幅広いイメージ効果を実現できます。
+ *
+ * The ConvolutionFilter class applies a matrix convolution filter effect.
+ * A convolution combines pixels in the input image with neighboring pixels to produce an image.
+ * A wide variety of image effects can be achieved through convolutions, including blurring,
+ * edge detection, sharpening, embossing, and beveling.
+ *
+ * @class
+ * @memberOf next2d.filters
+ * @extends  BitmapFilter
+ */
+export declare class ConvolutionFilter extends BitmapFilter {
+    private _$matrixX;
+    private _$matrixY;
+    private _$matrix;
+    private _$divisor;
+    private _$bias;
+    private _$preserveAlpha;
+    private _$clamp;
+    private _$color;
+    private _$alpha;
+    /**
+     * @param {number}  [matrix_x=0]
+     * @param {number}  [matrix_y=0]
+     * @param {array}   [matrix=null]
+     * @param {number}  [divisor=1.0]
+     * @param {number}  [bias=0.0]
+     * @param {boolean} [preserve_alpha=true]
+     * @param {boolean} [clamp=true]
+     * @param {number}  [color=0]
+     * @param {number}  [alpha=0.0]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(matrix_x?: number, matrix_y?: number, matrix?: number[] | null, divisor?: number, bias?: number, preserve_alpha?: boolean, clamp?: boolean, color?: number, alpha?: number);
+    /**
+     * @description 指定されたクラスのストリングを返します。
+     *              Returns the string representation of the specified class.
+     *
+     * @return  {string}
+     * @default [class ConvolutionFilter]
+     * @method
+     * @static
+     */
+    static toString(): string;
+    /**
+     * @description 指定されたクラスの空間名を返します。
+     *              Returns the space name of the specified class.
+     *
+     * @return  {string}
+     * @default next2d.filters.ConvolutionFilter
+     * @const
+     * @static
+     */
+    static get namespace(): string;
+    /**
+     * @description 指定されたオブジェクトのストリングを返します。
+     *              Returns the string representation of the specified object.
+     *
+     * @return  {string}
+     * @default [object ConvolutionFilter]
+     * @method
+     * @public
+     */
+    toString(): string;
+    /**
+     * @description 指定されたオブジェクトの空間名を返します。
+     *              Returns the space name of the specified object.
+     *
+     * @return  {string}
+     * @default next2d.filters.ConvolutionFilter
+     * @const
+     * @public
+     */
+    get namespace(): string;
+    /**
+     * @description アルファ透明度の値です。
+     *              The alpha transparency value for the color.
+     *
+     * @member  {number}
+     * @default 4
+     * @public
+     */
+    get alpha(): number;
+    set alpha(alpha: number);
+    /**
+     * @description マトリックス変換の結果に加算するバイアス量です。
+     *              The amount of bias to add to the result of the matrix transformation.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get bias(): number;
+    set bias(bias: number);
+    /**
+     * @description イメージをクランプする必要があるかどうかを示します。
+     *              Indicates whether the image should be clamped.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get clamp(): boolean;
+    set clamp(clamp: boolean);
+    /**
+     * @description ソースイメージの外にあるピクセルを置換する 16 進数のカラー値です。
+     *              The hexadecimal color to substitute for pixels that are off the source image.
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get color(): number;
+    set color(color: number);
+    /**
+     * @description マトリックス変換中に使用する除数です。
+     *              The divisor used during matrix transformation.
+     *
+     * @member  {number}
+     * @default 1
+     * @public
+     */
+    get divisor(): number;
+    set divisor(divisor: number);
+    /**
+     * @description マトリックス変換に使用する値の配列です。
+     *              An array of values used for matrix transformation.
+     *
+     * @member  {array}
+     * @default null
+     * @public
+     */
+    get matrix(): number[] | null;
+    set matrix(matrix: number[] | null);
+    /**
+     * @description マトリックスの x 次元 (マトリックスの列数) です。
+     *              The x dimension of the matrix (the number of columns in the matrix).
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get matrixX(): number;
+    set matrixX(matrix_x: number);
+    /**
+     * @description マトリックスの y 次元（マトリックスの行数）です。
+     *              The y dimension of the matrix (the number of rows in the matrix).
+     *
+     * @member  {number}
+     * @default 0
+     * @public
+     */
+    get matrixY(): number;
+    set matrixY(matrix_y: number);
+    /**
+     * @description アルファチャンネルがフィルター効果なしで維持されるかどうか、またはカラーチャンネルだけではなく
+     *              アルファチャンネルにも畳み込みフィルターが適用されるかどうかを示します。
+     *              Indicates if the alpha channel is preserved without the filter effect or
+     *              if the convolution filter is applied to the alpha channel as well as the color channels.
+     *
+     * @member  {boolean}
+     * @default true
+     * @public
+     */
+    get preserveAlpha(): boolean;
+    set preserveAlpha(preserve_alpha: boolean);
+    /**
+     * @description オブジェクトのコピーを返します。
+     *              Returns a copy of this filter object.
+     *
+     * @return {ConvolutionFilter}
+     * @method
+     * @public
+     */
+    clone(): ConvolutionFilter;
+    /**
+     * @return {array}
+     * @method
+     * @public
+     */
+    _$toArray(): any[];
+    /**
+     * @param  {Rectangle} rect
+     * @return {Rectangle}
+     * @method
+     * @private
+     */
+    _$generateFilterRect(rect: Rectangle): Rectangle;
+    /**
+     * @return {boolean}
+     * @method
+     * @private
+     */
+    _$canApply(): boolean;
+    /**
+     * @param  {CanvasToWebGLContext} context
+     * @return {WebGLTexture}
+     * @method
+     * @private
+     */
+    _$applyFilter(context: CanvasToWebGLContext): WebGLTexture;
+}