@lightningjs/renderer 3.0.0-beta8 → 3.0.0

package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js

@@ -0,0 +1,45 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ShaderEffect, } from './ShaderEffect.js';
+/**
+ * Grayscale effect grayscales the color values of the current mask color
+ */
+export class GrayscaleEffect extends ShaderEffect {
+    name = 'grayscale';
+    static getEffectKey() {
+        return `grayscale`;
+    }
+    static resolveDefaults(props) {
+        return {
+            amount: props.amount ?? 1,
+        };
+    }
+    static uniforms = {
+        amount: {
+            value: 1,
+            method: 'uniform1f',
+            type: 'float',
+        },
+    };
+    static onColorize = `
+    float grayness = 0.2 * maskColor.r + 0.6 * maskColor.g + 0.2 * maskColor.b;
+    return vec4(amount * vec3(grayness) + (1.0 - amount) * maskColor.rgb, maskColor.a);
+  `;
+}
+//# sourceMappingURL=GrayscaleEffect.js.map

package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrayscaleEffect.js","sourceRoot":"","sources":["../../../../../../../src/core/renderers/webgl/shaders/effects/GrayscaleEffect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAc3B;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC7B,IAAI,GAAG,WAAW,CAAC;IAErC,MAAM,CAAU,YAAY;QAC1B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,CAAU,eAAe,CAC7B,KAA2B;QAE3B,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,QAAQ,GAAyB;QAC/C,MAAM,EAAE;YACN,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,OAAO;SACd;KACF,CAAC;IAEF,MAAM,CAAU,UAAU,GAAG;;;GAG5B,CAAC"}

package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.d.ts

@@ -0,0 +1,58 @@
+import { ShaderEffect, type DefaultEffectProps, type ShaderEffectUniforms } from './ShaderEffect.js';
+/**
+ * Properties of the {@link RadiusEffect} shader
+ */
+export interface HolePunchEffectProps extends DefaultEffectProps {
+    /**
+     * X position where the hole punch starts
+     */
+    x?: number;
+    /**
+     * Y position where the hole punch starts
+     */
+    y?: number;
+    /**
+     * Width of the hole punch
+     */
+    width?: number;
+    /**
+     * height of the hole punch
+     *
+     * @remarks if not defined uses the width value
+     */
+    height?: number;
+    /**
+     * Corner radius in pixels, to cut out of the corners of the hole punch
+     *
+     * @remarks
+     * You can input an array with a length of up to four or a number.
+     *
+     * array length 4:
+     * [topLeft, topRight, bottomRight, bottomLeft]
+     *
+     * array length 2:
+     * [20, 40] -> [20(topLeft), 40(topRight), 20(bottomRight), 40(bottomLeft)]
+     *
+     * array length 3:
+     * [20, 40, 60] -> [20(topLeft), 40(topRight), 60(bottomRight), 20(bottomLeft)]
+     *
+     * number:
+     * 30 -> [30, 30, 30, 30]
+     *
+     * @default 0
+     */
+    radius?: number | number[];
+}
+/**
+ * Masks the current maskcolor a holepunch effect with rounded corners similar to {@link RoundedRectangle}
+ */
+export declare class HolePunchEffect extends ShaderEffect {
+    static z$__type__Props: HolePunchEffectProps;
+    readonly name = "holePunch";
+    static getEffectKey(): string;
+    static uniforms: ShaderEffectUniforms;
+    static resolveDefaults(props: HolePunchEffectProps): Required<HolePunchEffectProps>;
+    static methods: Record<string, string>;
+    static onShaderMask: string;
+    static onEffectMask: string;
+}

package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js

@@ -0,0 +1,80 @@
+import { updateWebSafeRadius, validateArrayLength4 } from './EffectUtils.js';
+import { ShaderEffect, } from './ShaderEffect.js';
+/**
+ * Masks the current maskcolor a holepunch effect with rounded corners similar to {@link RoundedRectangle}
+ */
+export class HolePunchEffect extends ShaderEffect {
+    static z$__type__Props;
+    name = 'holePunch';
+    static getEffectKey() {
+        return `holePunch`;
+    }
+    static uniforms = {
+        x: {
+            value: 0,
+            method: 'uniform1f',
+            type: 'float',
+        },
+        y: {
+            value: 0,
+            method: 'uniform1f',
+            type: 'float',
+        },
+        width: {
+            value: 0,
+            method: 'uniform1f',
+            type: 'float',
+        },
+        height: {
+            value: 0,
+            method: 'uniform1f',
+            type: 'float',
+        },
+        radius: {
+            value: 0,
+            method: 'uniform4fv',
+            type: 'vec4',
+            updateOnBind: true,
+            validator: validateArrayLength4,
+            updateProgramValue: updateWebSafeRadius,
+        },
+    };
+    static resolveDefaults(props) {
+        return {
+            x: props.x || 0,
+            y: props.y || 0,
+            width: props.width || 50,
+            height: props.height || 50,
+            radius: props.radius ?? 0,
+        };
+    }
+    static methods = {
+        fillMask: `
+      float function(float dist) {
+        return clamp(-dist, 0.0, 1.0);
+      }
+    `,
+        boxDist: `
+      float function(vec2 p, vec2 size, float radius) {
+        size -= vec2(radius);
+        vec2 d = abs(p) - size;
+        return min(max(d.x, d.y), 0.0) + length(max(d, 0.0)) - radius;
+      }
+    `,
+    };
+    static onShaderMask = `
+  vec2 halfDimensions = u_dimensions * 0.5;
+  vec2 size = vec2(width, height) * 0.5;
+  vec2 basePos = v_nodeCoordinate.xy * u_dimensions.xy - vec2(x, y);
+  vec2 pos = basePos - size;
+  float r = radius[0] * step(pos.x, 0.5) * step(pos.y, 0.5);
+  r = r + radius[1] * step(0.5, pos.x) * step(pos.y, 0.5);
+  r = r + radius[2] * step(0.5, pos.x) * step(0.5, pos.y);
+  r = r + radius[3] * step(pos.x, 0.5) * step(0.5, pos.y);
+  return $boxDist(pos, size, r);
+  `;
+    static onEffectMask = `
+  return mix(maskColor, vec4(0.0), $fillMask(shaderMask));
+  `;
+}
+//# sourceMappingURL=HolePunchEffect.js.map

package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HolePunchEffect.js","sourceRoot":"","sources":["../../../../../../../src/core/renderers/webgl/shaders/effects/HolePunchEffect.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EACL,YAAY,GAIb,MAAM,mBAAmB,CAAC;AA+C3B;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,MAAM,CAAC,eAAe,CAAuB;IAC3B,IAAI,GAAG,WAAW,CAAC;IAErC,MAAM,CAAU,YAAY;QAC1B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,CAAU,QAAQ,GAAyB;QAC/C,CAAC,EAAE;YACD,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,OAAO;SACd;QACD,CAAC,EAAE;YACD,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,OAAO;SACd;QACD,KAAK,EAAE;YACL,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,OAAO;SACd;QACD,MAAM,EAAE;YACN,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,OAAO;SACd;QACD,MAAM,EAAE;YACN,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,oBAAoB;YAC/B,kBAAkB,EAAE,mBAAmB;SACxC;KACF,CAAC;IAEF,MAAM,CAAU,eAAe,CAC7B,KAA2B;QAE3B,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;YACf,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;YACf,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,OAAO,GAA2B;QAChD,QAAQ,EAAE;;;;KAIT;QACD,OAAO,EAAE;;;;;;KAMR;KACF,CAAC;IAEF,MAAM,CAAU,YAAY,GAAG;;;;;;;;;;GAU9B,CAAC;IAEF,MAAM,CAAU,YAAY,GAAG;;GAE9B,CAAC"}

package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.d.ts

@@ -0,0 +1,35 @@
+import { type DefaultEffectProps, ShaderEffect, type ShaderEffectUniforms } from './ShaderEffect.js';
+/**
+ * Properties of the {@link LinearGradientEffect} effect
+ */
+export interface LinearGradientEffectProps extends DefaultEffectProps {
+    /**
+     * Array of colors to be used in the LinearGradientEffect
+     *
+     * @default [0xff000000, 0xffffffff]
+     */
+    colors?: number[];
+    /**
+     * Angle of the LinearGradientEffect, Angle in Radians
+     *
+     * @default 0
+     */
+    angle?: number;
+    /**
+     * Array of color stops
+     */
+    stops?: number[];
+}
+/**
+ * Linear Gradient effect over a effect mask
+ */
+export declare class LinearGradientEffect extends ShaderEffect {
+    static z$__type__Props: LinearGradientEffectProps;
+    readonly name = "linearGradient";
+    static getEffectKey(props: LinearGradientEffectProps): string;
+    static resolveDefaults(props: LinearGradientEffectProps): Required<LinearGradientEffectProps>;
+    static uniforms: ShaderEffectUniforms;
+    static methods: Record<string, string>;
+    static ColorLoop: (amount: number) => string;
+    static onColorize: (props: LinearGradientEffectProps) => string;
+}

package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js

@@ -0,0 +1,134 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { getNormalizedRgbaComponents } from '../../../../lib/utils.js';
+import { updateFloat32ArrayLengthN } from './EffectUtils.js';
+import { ShaderEffect, } from './ShaderEffect.js';
+/**
+ * Linear Gradient effect over a effect mask
+ */
+export class LinearGradientEffect extends ShaderEffect {
+    static z$__type__Props;
+    name = 'linearGradient';
+    static getEffectKey(props) {
+        if (props.colors.value) {
+            return `linearGradient${props.colors.value
+                .length}`;
+        }
+        return `linearGradient${props.colors.length}`;
+    }
+    static resolveDefaults(props) {
+        const colors = props.colors ?? [0xff000000, 0xffffffff];
+        let stops = props.stops || [];
+        if (stops.length === 0 || stops.length !== colors.length) {
+            const colorsL = colors.length;
+            let i = 0;
+            const tmp = stops;
+            for (; i < colorsL; i++) {
+                if (stops[i]) {
+                    tmp[i] = stops[i];
+                    if (stops[i - 1] === undefined && tmp[i - 2] !== undefined) {
+                        tmp[i - 1] = tmp[i - 2] + (stops[i] - tmp[i - 2]) / 2;
+                    }
+                }
+                else {
+                    tmp[i] = i * (1 / (colors.length - 1));
+                }
+            }
+            stops = tmp;
+        }
+        return {
+            colors,
+            stops,
+            angle: props.angle ?? 0,
+        };
+    }
+    static uniforms = {
+        angle: {
+            value: 0,
+            method: 'uniform1f',
+            type: 'float',
+        },
+        colors: {
+            value: 0xffffffff,
+            validator: (rgbas) => {
+                return rgbas.reduce((acc, val) => acc.concat(getNormalizedRgbaComponents(val)), []);
+            },
+            updateProgramValue: updateFloat32ArrayLengthN,
+            size: (props) => props.colors.length,
+            method: 'uniform4fv',
+            type: 'vec4',
+        },
+        stops: {
+            value: [],
+            size: (props) => props.colors.length,
+            method: 'uniform1fv',
+            type: 'float',
+        },
+    };
+    static methods = {
+        calcPoint: `
+      vec2 function(float d, float angle) {
+        return d * vec2(cos(angle), sin(angle)) + (u_dimensions * 0.5);
+      }
+    `,
+    };
+    static ColorLoop = (amount) => {
+        let loop = '';
+        for (let i = 2; i < amount; i++) {
+            loop += `colorOut = mix(colorOut, colors[${i}], clamp((dist - stops[${i - 1}]) / (stops[${i}] - stops[${i - 1}]), 0.0, 1.0));`;
+        }
+        return loop;
+    };
+    static onColorize = (props) => {
+        const colors = props.colors.length || 1;
+        return `
+      float a = angle - (PI / 180.0 * 90.0);
+      float lineDist = abs(u_dimensions.x * cos(a)) + abs(u_dimensions.y * sin(a));
+      vec2 f = $calcPoint(lineDist * 0.5, a);
+      vec2 t = $calcPoint(lineDist * 0.5, a + PI);
+      vec2 gradVec = t - f;
+      float dist = dot(v_nodeCoordinate.xy * u_dimensions - f, gradVec) / dot(gradVec, gradVec);
+
+      //return early if dist is lower or equal to first stop
+      if(dist <= stops[0]) {
+        return mix(maskColor, colors[0], clamp(colors[0].a, 0.0, 1.0));
+      }
+      const int amount = ${colors};
+      const int last = amount - 1;
+
+      if(dist >= stops[last]) {
+        return mix(maskColor, colors[last], clamp(colors[last].a, 0.0, 1.0));
+      }
+
+      for(int i = 0; i < last; i++) {
+        float left = stops[i];
+        float right = stops[i + 1];
+        if(dist >= left && dist <= right) {
+          float localDist = smoothstep(left, right, dist);
+          vec4 colorOut = mix(colors[i], colors[i + 1], localDist);
+          return mix(maskColor, colorOut, clamp(colorOut.a, 0.0, 1.0));
+        }
+      }
+
+      //final fallback
+      return mix(maskColor, colors[last], clamp(colors[last].a, 0.0, 1.0));
+    `;
+    };
+}
+//# sourceMappingURL=LinearGradientEffect.js.map

package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinearGradientEffect.js","sourceRoot":"","sources":["../../../../../../../src/core/renderers/webgl/shaders/effects/LinearGradientEffect.ts"],"names":[],"mappings":"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"}

package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.d.ts

@@ -0,0 +1,40 @@
+import { type DefaultEffectProps, ShaderEffect, type ShaderEffectUniforms } from './ShaderEffect.js';
+/**
+ * Properties of the {@link RadialGradientEffect} effect
+ */
+export interface RadialGradientEffectProps extends DefaultEffectProps {
+    /**
+     * Array of colors to be used in the RadialGradientEffect
+     *
+     * @default [0xff000000, 0xffffffff]
+     */
+    colors?: number[];
+    /**
+     * Array of color stops
+     */
+    stops?: number[];
+    /**
+     * Width of the RadialGradientEffect
+     */
+    width?: number;
+    /**
+     * height of the RadialGradientEffect
+     *
+     * @remarks if not defined uses the width value
+     */
+    height?: number;
+    /**
+     * center point of where the RadialGradientEffect is drawn
+     */
+    pivot?: number[];
+}
+export declare class RadialGradientEffect extends ShaderEffect {
+    static z$__type__Props: RadialGradientEffectProps;
+    readonly name = "radialGradient";
+    static getEffectKey(props: RadialGradientEffectProps): string;
+    static resolveDefaults(props: RadialGradientEffectProps): Required<RadialGradientEffectProps>;
+    static uniforms: ShaderEffectUniforms;
+    static methods: Record<string, string>;
+    static ColorLoop: (amount: number) => string;
+    static onColorize: (props: RadialGradientEffectProps) => string;
+}

package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js

@@ -0,0 +1,143 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { getNormalizedRgbaComponents } from '../../../../lib/utils.js';
+import { updateFloat32ArrayLength2, updateFloat32ArrayLengthN, } from './EffectUtils.js';
+import { ShaderEffect, } from './ShaderEffect.js';
+export class RadialGradientEffect extends ShaderEffect {
+    static z$__type__Props;
+    name = 'radialGradient';
+    static getEffectKey(props) {
+        if (props.colors.value) {
+            return `radialGradient${props.colors.value
+                .length}`;
+        }
+        return `radialGradient${props.colors.length}`;
+    }
+    static resolveDefaults(props) {
+        const colors = props.colors ?? [0xff000000, 0xffffffff];
+        let stops = props.stops || [];
+        if (stops.length === 0 || stops.length !== colors.length) {
+            const colorsL = colors.length;
+            let i = 0;
+            const tmp = stops;
+            for (; i < colorsL; i++) {
+                if (stops[i]) {
+                    tmp[i] = stops[i];
+                    if (stops[i - 1] === undefined && tmp[i - 2] !== undefined) {
+                        tmp[i - 1] = tmp[i - 2] + (stops[i] - tmp[i - 2]) / 2;
+                    }
+                }
+                else {
+                    tmp[i] = i * (1 / (colors.length - 1));
+                }
+            }
+            stops = tmp;
+        }
+        return {
+            colors,
+            stops,
+            width: props.width ?? 0,
+            height: props.height ?? props.width ?? 0,
+            pivot: props.pivot ?? [0.5, 0.5],
+        };
+    }
+    static uniforms = {
+        width: {
+            value: 0,
+            method: 'uniform1f',
+            type: 'float',
+        },
+        height: {
+            value: 0,
+            method: 'uniform1f',
+            type: 'float',
+        },
+        pivot: {
+            value: [0.5, 0.5],
+            updateProgramValue: updateFloat32ArrayLength2,
+            method: 'uniform2fv',
+            type: 'vec2',
+        },
+        colors: {
+            value: 0xffffffff,
+            validator: (rgbas) => {
+                return rgbas.reduce((acc, val) => acc.concat(getNormalizedRgbaComponents(val)), []);
+            },
+            updateProgramValue: updateFloat32ArrayLengthN,
+            size: (props) => props.colors.length,
+            method: 'uniform4fv',
+            type: 'vec4',
+        },
+        stops: {
+            value: [],
+            size: (props) => props.colors.length,
+            method: 'uniform1fv',
+            type: 'float',
+        },
+    };
+    static methods = {
+        getGradientColor: `
+      float function(float dist) {
+        return clamp(-dist, 0.0, 1.0);
+      }
+    `,
+    };
+    static ColorLoop = (amount) => {
+        let loop = '';
+        for (let i = 2; i < amount; i++) {
+            loop += `colorOut = mix(colorOut, colors[${i}], clamp((dist - stops[${i - 1}]) / (stops[${i}] - stops[${i - 1}]), 0.0, 1.0));`;
+        }
+        return loop;
+    };
+    static onColorize = (props) => {
+        const colors = props.colors.length || 1;
+        return `
+      vec2 point = v_nodeCoordinate.xy * u_dimensions;
+      vec2 projection = vec2(pivot.x * u_dimensions.x, pivot.y * u_dimensions.y);
+
+      float dist = length((point - projection) / vec2(width, height));
+
+      dist = clamp(dist, 0.0, 1.0);
+      //return early if dist is lower or equal to first stop
+      if(dist <= stops[0]) {
+        return mix(maskColor, colors[0], clamp(colors[0].a, 0.0, 1.0));
+      }
+      const int amount = ${colors};
+      const int last = amount - 1;
+
+      if(dist >= stops[last]) {
+        return mix(maskColor, colors[last], clamp(colors[last].a, 0.0, 1.0));
+      }
+
+      for(int i = 0; i < last; i++) {
+        float left = stops[i];
+        float right = stops[i + 1];
+        if(dist >= left && dist <= right) {
+          float localDist = smoothstep(left, right, dist);
+          vec4 colorOut = mix(colors[i], colors[i + 1], localDist);
+          return mix(maskColor, colorOut, clamp(colorOut.a, 0.0, 1.0));
+        }
+      }
+
+      //final fallback
+      return mix(maskColor, colors[last], clamp(colors[last].a, 0.0, 1.0));
+    `;
+    };
+}
+//# sourceMappingURL=RadialGradientEffect.js.map

package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadialGradientEffect.js","sourceRoot":"","sources":["../../../../../../../src/core/renderers/webgl/shaders/effects/RadialGradientEffect.ts"],"names":[],"mappings":"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"}

package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.d.ts

@@ -0,0 +1,61 @@
+import { ShaderEffect, type DefaultEffectProps, type ShaderEffectUniforms } from './ShaderEffect.js';
+/**
+ * Properties of the {@link RadialProgressEffect} effect
+ */
+export interface RadialProgressEffectProps extends DefaultEffectProps {
+    /**
+     * Width of the border in pixels
+     *
+     * @default 10
+     */
+    width?: number;
+    /**
+     * progress from 0 to 1 in floats
+     *
+     * @default 0.5;
+     */
+    progress?: number;
+    /**
+     * offset where the radial progress starts drawing.
+     *
+     * @default 0;
+     */
+    offset?: number;
+    /**
+     * maximum range of the radial progress in radians
+     *
+     * @default Math.PI * 2
+     */
+    range?: number;
+    /**
+     * rounded ends of the progress bar;
+     *
+     * @default false
+     */
+    rounded?: boolean;
+    /**
+     * radius from center to outer edge from 0 to 1 in floats;
+     *
+     * @default 1
+     */
+    radius?: number;
+    /**
+     * Color of the border in 0xRRGGBBAA
+     *
+     * @default 0xffffffff
+     */
+    color?: number;
+}
+/**
+ * The RadialProgressEffect renders a border along all edges of an element
+ */
+export declare class RadialProgressEffect extends ShaderEffect {
+    static z$__type__Props: RadialProgressEffectProps;
+    readonly name = "radialProgress";
+    static getEffectKey(): string;
+    static resolveDefaults(props: RadialProgressEffectProps): Required<RadialProgressEffectProps>;
+    static uniforms: ShaderEffectUniforms;
+    static methods: Record<string, string>;
+    static onEffectMask: string;
+    static onColorize: string;
+}