@itwin/frontend-devtools 4.0.0-dev.8 → 4.0.0-dev.81

package/lib/esm/effects/FlipImage.d.ts

@@ -1,31 +1,31 @@
-/** @packageDocumentation
- * @module Effects
- */
-import { ScreenSpaceEffectBuilder, Tool } from "@itwin/core-frontend";
-import { AddEffectTool } from "./EffectTools";
-/** An extremely simple and mostly useless effect intended to demonstrate the basics of creating a screen-space effect.
- * It flips the Viewport's image on the x and/or y axis, and/or inverts the color of each pixel.
- * @beta
- */
-export declare class FlipImageEffect extends AddEffectTool {
-    static toolId: string;
-    protected get effectName(): string;
-    protected get textureCoordFromPosition(): boolean;
-    protected get source(): {
-        vertex: string;
-        fragment: string;
-        sampleSourcePixel: string;
-    };
-    protected defineEffect(builder: ScreenSpaceEffectBuilder): void;
-}
-/** Configure the [[FlipImageEffect]].
- * @beta
- */
-export declare class FlipImageConfig extends Tool {
-    static toolId: string;
-    static get minArgs(): number;
-    static get maxArgs(): number;
-    run(horizontal?: boolean, vertical?: boolean, color?: boolean): Promise<boolean>;
-    parseAndRun(...input: string[]): Promise<boolean>;
-}
+/** @packageDocumentation
+ * @module Effects
+ */
+import { ScreenSpaceEffectBuilder, Tool } from "@itwin/core-frontend";
+import { AddEffectTool } from "./EffectTools";
+/** An extremely simple and mostly useless effect intended to demonstrate the basics of creating a screen-space effect.
+ * It flips the Viewport's image on the x and/or y axis, and/or inverts the color of each pixel.
+ * @beta
+ */
+export declare class FlipImageEffect extends AddEffectTool {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get textureCoordFromPosition(): boolean;
+    protected get source(): {
+        vertex: string;
+        fragment: string;
+        sampleSourcePixel: string;
+    };
+    protected defineEffect(builder: ScreenSpaceEffectBuilder): void;
+}
+/** Configure the [[FlipImageEffect]].
+ * @beta
+ */
+export declare class FlipImageConfig extends Tool {
+    static toolId: string;
+    static get minArgs(): number;
+    static get maxArgs(): number;
+    run(horizontal?: boolean, vertical?: boolean, color?: boolean): Promise<boolean>;
+    parseAndRun(...input: string[]): Promise<boolean>;
+}
 //# sourceMappingURL=FlipImage.d.ts.map

package/lib/esm/effects/FlipImage.js

@@ -1,26 +1,26 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Effects
- */
-import { Tool, UniformType, VaryingType } from "@itwin/core-frontend";
-import { parseArgs } from "../tools/parseArgs";
-import { AddEffectTool, refreshViewportsForEffect } from "./EffectTools";
-let flipHorizontal = false;
-let flipVertical = false;
-let flipColor = false;
-/** An extremely simple and mostly useless effect intended to demonstrate the basics of creating a screen-space effect.
- * It flips the Viewport's image on the x and/or y axis, and/or inverts the color of each pixel.
- * @beta
- */
-export class FlipImageEffect extends AddEffectTool {
-    get effectName() { return "flip"; }
-    get textureCoordFromPosition() { return true; }
-    get source() {
-        return {
-            // Compute texture coordinate for use in fragment shader.
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Effects
+ */
+import { Tool, UniformType, VaryingType } from "@itwin/core-frontend";
+import { parseArgs } from "../tools/parseArgs";
+import { AddEffectTool, refreshViewportsForEffect } from "./EffectTools";
+let flipHorizontal = false;
+let flipVertical = false;
+let flipColor = false;
+/** An extremely simple and mostly useless effect intended to demonstrate the basics of creating a screen-space effect.
+ * It flips the Viewport's image on the x and/or y axis, and/or inverts the color of each pixel.
+ * @beta
+ */
+class FlipImageEffect extends AddEffectTool {
+    get effectName() { return "flip"; }
+    get textureCoordFromPosition() { return true; }
+    get source() {
+        return {
+            // Compute texture coordinate for use in fragment shader.
             vertex: `
         void effectMain(vec4 pos) {
           vec2 uv = textureCoordFromPosition(pos);
@@ -31,8 +31,8 @@ export class FlipImageEffect extends AddEffectTool {
             uv.y = 1.0 - uv.y;
 
           v_uv = uv;
-        }`,
-            // Sample the original image to flip on x and/or y axis, then invert its color.
+        }`,
+            // Sample the original image to flip on x and/or y axis, then invert its color.
             fragment: `
         vec4 effectMain() {
           vec4 color = sampleSourcePixel();
@@ -43,53 +43,55 @@ export class FlipImageEffect extends AddEffectTool {
           }
 
           return color;
-        }`,
-            // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise
-            // element locate will not work correctly.
-            sampleSourcePixel: "return TEXTURE(u_diffuse, v_uv);",
-        };
-    }
-    defineEffect(builder) {
-        // Don't bother applying the effect if nothing is to be flipped.
-        builder.shouldApply = (_context) => flipHorizontal || flipVertical || flipColor;
-        // Define the varying for the texture coordinate.
-        builder.addVarying("v_uv", VaryingType.Vec2);
-        // Hook up the uniforms.
-        builder.addUniform({
-            name: "u_flipHorizontal",
-            type: UniformType.Bool,
-            bind: (uniform, _context) => uniform.setUniform1i(flipHorizontal ? 1 : 0),
-        });
-        builder.addUniform({
-            name: "u_flipVertical",
-            type: UniformType.Bool,
-            bind: (uniform, _context) => uniform.setUniform1i(flipVertical ? 1 : 0),
-        });
-        builder.addUniform({
-            name: "u_flipColor",
-            type: UniformType.Bool,
-            bind: (uniform, _context) => uniform.setUniform1i(flipColor ? 1 : 0),
-        });
-    }
-}
-FlipImageEffect.toolId = "FlipImageEffect";
-/** Configure the [[FlipImageEffect]].
- * @beta
- */
-export class FlipImageConfig extends Tool {
-    static get minArgs() { return 0; }
-    static get maxArgs() { return 3; }
-    async run(horizontal, vertical, color) {
-        flipHorizontal = !!horizontal;
-        flipVertical = !!vertical;
-        flipColor = !!color;
-        refreshViewportsForEffect("fdt flip");
-        return true;
-    }
-    async parseAndRun(...input) {
-        const args = parseArgs(input);
-        return this.run(args.getBoolean("h"), args.getBoolean("v"), args.getBoolean("c"));
-    }
-}
-FlipImageConfig.toolId = "FlipImageConfig";
+        }`,
+            // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise
+            // element locate will not work correctly.
+            sampleSourcePixel: "return TEXTURE(u_diffuse, v_uv);",
+        };
+    }
+    defineEffect(builder) {
+        // Don't bother applying the effect if nothing is to be flipped.
+        builder.shouldApply = (_context) => flipHorizontal || flipVertical || flipColor;
+        // Define the varying for the texture coordinate.
+        builder.addVarying("v_uv", VaryingType.Vec2);
+        // Hook up the uniforms.
+        builder.addUniform({
+            name: "u_flipHorizontal",
+            type: UniformType.Bool,
+            bind: (uniform, _context) => uniform.setUniform1i(flipHorizontal ? 1 : 0),
+        });
+        builder.addUniform({
+            name: "u_flipVertical",
+            type: UniformType.Bool,
+            bind: (uniform, _context) => uniform.setUniform1i(flipVertical ? 1 : 0),
+        });
+        builder.addUniform({
+            name: "u_flipColor",
+            type: UniformType.Bool,
+            bind: (uniform, _context) => uniform.setUniform1i(flipColor ? 1 : 0),
+        });
+    }
+}
+FlipImageEffect.toolId = "FlipImageEffect";
+export { FlipImageEffect };
+/** Configure the [[FlipImageEffect]].
+ * @beta
+ */
+class FlipImageConfig extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 3; }
+    async run(horizontal, vertical, color) {
+        flipHorizontal = !!horizontal;
+        flipVertical = !!vertical;
+        flipColor = !!color;
+        refreshViewportsForEffect("fdt flip");
+        return true;
+    }
+    async parseAndRun(...input) {
+        const args = parseArgs(input);
+        return this.run(args.getBoolean("h"), args.getBoolean("v"), args.getBoolean("c"));
+    }
+}
+FlipImageConfig.toolId = "FlipImageConfig";
+export { FlipImageConfig };
 //# sourceMappingURL=FlipImage.js.map

package/lib/esm/effects/FlipImage.js.map

@@ -1 +1 @@
-{"version":3,"file":"FlipImage.js","sourceRoot":"","sources":["../../../src/effects/FlipImage.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Effects\r\n */\r\n\r\nimport { ScreenSpaceEffectBuilder, Tool, UniformType, VaryingType } from \"@itwin/core-frontend\";\r\nimport { parseArgs } from \"../tools/parseArgs\";\r\nimport { AddEffectTool, refreshViewportsForEffect } from \"./EffectTools\";\r\n\r\nlet flipHorizontal = false;\r\nlet flipVertical = false;\r\nlet flipColor = false;\r\n\r\n/** An extremely simple and mostly useless effect intended to demonstrate the basics of creating a screen-space effect.\r\n * It flips the Viewport's image on the x and/or y axis, and/or inverts the color of each pixel.\r\n * @beta\r\n */\r\nexport class FlipImageEffect extends AddEffectTool {\r\n  public static override toolId = \"FlipImageEffect\";\r\n\r\n  protected get effectName() { return \"flip\"; }\r\n  protected get textureCoordFromPosition() { return true; }\r\n\r\n  protected get source() {\r\n    return {\r\n      // Compute texture coordinate for use in fragment shader.\r\n      vertex: `\r\n        void effectMain(vec4 pos) {\r\n          vec2 uv = textureCoordFromPosition(pos);\r\n          if (u_flipHorizontal)\r\n            uv.x = 1.0 - uv.x;\r\n\r\n          if (u_flipVertical)\r\n            uv.y = 1.0 - uv.y;\r\n\r\n          v_uv = uv;\r\n        }`,\r\n      // Sample the original image to flip on x and/or y axis, then invert its color.\r\n      fragment: `\r\n        vec4 effectMain() {\r\n          vec4 color = sampleSourcePixel();\r\n          if (u_flipColor) {\r\n            color.r = 1.0 - color.r;\r\n            color.g = 1.0 - color.g;\r\n            color.b = 1.0 - color.b;\r\n          }\r\n\r\n          return color;\r\n        }`,\r\n      // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise\r\n      // element locate will not work correctly.\r\n      sampleSourcePixel: \"return TEXTURE(u_diffuse, v_uv);\",\r\n    };\r\n  }\r\n\r\n  protected defineEffect(builder: ScreenSpaceEffectBuilder): void {\r\n    // Don't bother applying the effect if nothing is to be flipped.\r\n    builder.shouldApply = (_context) => flipHorizontal || flipVertical || flipColor;\r\n\r\n    // Define the varying for the texture coordinate.\r\n    builder.addVarying(\"v_uv\", VaryingType.Vec2);\r\n\r\n    // Hook up the uniforms.\r\n    builder.addUniform({\r\n      name: \"u_flipHorizontal\",\r\n      type: UniformType.Bool,\r\n      bind: (uniform, _context) => uniform.setUniform1i(flipHorizontal ? 1 : 0),\r\n    });\r\n    builder.addUniform({\r\n      name: \"u_flipVertical\",\r\n      type: UniformType.Bool,\r\n      bind: (uniform, _context) => uniform.setUniform1i(flipVertical ? 1 : 0),\r\n    });\r\n    builder.addUniform({\r\n      name: \"u_flipColor\",\r\n      type: UniformType.Bool,\r\n      bind: (uniform, _context) => uniform.setUniform1i(flipColor ? 1 : 0),\r\n    });\r\n  }\r\n}\r\n\r\n/** Configure the [[FlipImageEffect]].\r\n * @beta\r\n */\r\nexport class FlipImageConfig extends Tool {\r\n  public static override toolId = \"FlipImageConfig\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 3; }\r\n\r\n  public override async run(horizontal?: boolean, vertical?: boolean, color?: boolean): Promise<boolean> {\r\n    flipHorizontal = !!horizontal;\r\n    flipVertical = !!vertical;\r\n    flipColor = !!color;\r\n\r\n    refreshViewportsForEffect(\"fdt flip\");\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...input: string[]): Promise<boolean> {\r\n    const args = parseArgs(input);\r\n    return this.run(args.getBoolean(\"h\"), args.getBoolean(\"v\"), args.getBoolean(\"c\"));\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"FlipImage.js","sourceRoot":"","sources":["../../../src/effects/FlipImage.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Effects\r\n */\r\n\r\nimport { ScreenSpaceEffectBuilder, Tool, UniformType, VaryingType } from \"@itwin/core-frontend\";\r\nimport { parseArgs } from \"../tools/parseArgs\";\r\nimport { AddEffectTool, refreshViewportsForEffect } from \"./EffectTools\";\r\n\r\nlet flipHorizontal = false;\r\nlet flipVertical = false;\r\nlet flipColor = false;\r\n\r\n/** An extremely simple and mostly useless effect intended to demonstrate the basics of creating a screen-space effect.\r\n * It flips the Viewport's image on the x and/or y axis, and/or inverts the color of each pixel.\r\n * @beta\r\n */\r\nexport class FlipImageEffect extends AddEffectTool {\r\n  public static override toolId = \"FlipImageEffect\";\r\n\r\n  protected get effectName() { return \"flip\"; }\r\n  protected get textureCoordFromPosition() { return true; }\r\n\r\n  protected get source() {\r\n    return {\r\n      // Compute texture coordinate for use in fragment shader.\r\n      vertex: `\r\n        void effectMain(vec4 pos) {\r\n          vec2 uv = textureCoordFromPosition(pos);\r\n          if (u_flipHorizontal)\r\n            uv.x = 1.0 - uv.x;\r\n\r\n          if (u_flipVertical)\r\n            uv.y = 1.0 - uv.y;\r\n\r\n          v_uv = uv;\r\n        }`,\r\n      // Sample the original image to flip on x and/or y axis, then invert its color.\r\n      fragment: `\r\n        vec4 effectMain() {\r\n          vec4 color = sampleSourcePixel();\r\n          if (u_flipColor) {\r\n            color.r = 1.0 - color.r;\r\n            color.g = 1.0 - color.g;\r\n            color.b = 1.0 - color.b;\r\n          }\r\n\r\n          return color;\r\n        }`,\r\n      // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise\r\n      // element locate will not work correctly.\r\n      sampleSourcePixel: \"return TEXTURE(u_diffuse, v_uv);\",\r\n    };\r\n  }\r\n\r\n  protected defineEffect(builder: ScreenSpaceEffectBuilder): void {\r\n    // Don't bother applying the effect if nothing is to be flipped.\r\n    builder.shouldApply = (_context) => flipHorizontal || flipVertical || flipColor;\r\n\r\n    // Define the varying for the texture coordinate.\r\n    builder.addVarying(\"v_uv\", VaryingType.Vec2);\r\n\r\n    // Hook up the uniforms.\r\n    builder.addUniform({\r\n      name: \"u_flipHorizontal\",\r\n      type: UniformType.Bool,\r\n      bind: (uniform, _context) => uniform.setUniform1i(flipHorizontal ? 1 : 0),\r\n    });\r\n    builder.addUniform({\r\n      name: \"u_flipVertical\",\r\n      type: UniformType.Bool,\r\n      bind: (uniform, _context) => uniform.setUniform1i(flipVertical ? 1 : 0),\r\n    });\r\n    builder.addUniform({\r\n      name: \"u_flipColor\",\r\n      type: UniformType.Bool,\r\n      bind: (uniform, _context) => uniform.setUniform1i(flipColor ? 1 : 0),\r\n    });\r\n  }\r\n}\r\n\r\n/** Configure the [[FlipImageEffect]].\r\n * @beta\r\n */\r\nexport class FlipImageConfig extends Tool {\r\n  public static override toolId = \"FlipImageConfig\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 3; }\r\n\r\n  public override async run(horizontal?: boolean, vertical?: boolean, color?: boolean): Promise<boolean> {\r\n    flipHorizontal = !!horizontal;\r\n    flipVertical = !!vertical;\r\n    flipColor = !!color;\r\n\r\n    refreshViewportsForEffect(\"fdt flip\");\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...input: string[]): Promise<boolean> {\r\n    const args = parseArgs(input);\r\n    return this.run(args.getBoolean(\"h\"), args.getBoolean(\"v\"), args.getBoolean(\"c\"));\r\n  }\r\n}\r\n"]}

package/lib/esm/effects/LensDistortion.d.ts

@@ -1,35 +1,35 @@
-/** @packageDocumentation
- * @module Effects
- */
-import { ScreenSpaceEffectBuilder, Tool } from "@itwin/core-frontend";
-import { AddEffectTool } from "./EffectTools";
-/** Adds a screen-space effect to the selected [[Viewport]] to simulate the lens distortion produced by real-world cameras with very wide fields of view.
- * Based on https://www.decarpentier.nl/lens-distortion
- * The effect is improved considerably by enabling anti-aliasing (e.g., via [RenderSystem.Options.antialiasSamples]($frontend) at startup, or using the `fdt aasamples` key-in`).
- * @note Because this effect applies a non-linear transform to each pixel, operations like snapping to geometry will not work properly. Element locate will work however - @see [ScreenSpaceEffectSource.sampleSourcePixel]($frontend).
- * @beta
- */
-export declare class LensDistortionEffect extends AddEffectTool {
-    static toolId: string;
-    protected get effectName(): string;
-    protected get textureCoordFromPosition(): boolean;
-    protected get source(): {
-        vertex: string;
-        fragment: string;
-        sampleSourcePixel: string;
-    };
-    protected defineEffect(builder: ScreenSpaceEffectBuilder): void;
-}
-/** Configures the [[LensDistortionEffect]].
- * @beta
- */
-export declare class LensDistortionConfig extends Tool {
-    static toolId: string;
-    static get minArgs(): number;
-    static get maxArgs(): number;
-    static strength: number;
-    static cylindricalRatio: number;
-    run(strength?: number, ratio?: number): Promise<boolean>;
-    parseAndRun(...input: string[]): Promise<boolean>;
-}
+/** @packageDocumentation
+ * @module Effects
+ */
+import { ScreenSpaceEffectBuilder, Tool } from "@itwin/core-frontend";
+import { AddEffectTool } from "./EffectTools";
+/** Adds a screen-space effect to the selected [[Viewport]] to simulate the lens distortion produced by real-world cameras with very wide fields of view.
+ * Based on https://www.decarpentier.nl/lens-distortion
+ * The effect is improved considerably by enabling anti-aliasing (e.g., via [RenderSystem.Options.antialiasSamples]($frontend) at startup, or using the `fdt aasamples` key-in`).
+ * @note Because this effect applies a non-linear transform to each pixel, operations like snapping to geometry will not work properly. Element locate will work however - @see [ScreenSpaceEffectSource.sampleSourcePixel]($frontend).
+ * @beta
+ */
+export declare class LensDistortionEffect extends AddEffectTool {
+    static toolId: string;
+    protected get effectName(): string;
+    protected get textureCoordFromPosition(): boolean;
+    protected get source(): {
+        vertex: string;
+        fragment: string;
+        sampleSourcePixel: string;
+    };
+    protected defineEffect(builder: ScreenSpaceEffectBuilder): void;
+}
+/** Configures the [[LensDistortionEffect]].
+ * @beta
+ */
+export declare class LensDistortionConfig extends Tool {
+    static toolId: string;
+    static get minArgs(): number;
+    static get maxArgs(): number;
+    static strength: number;
+    static cylindricalRatio: number;
+    run(strength?: number, ratio?: number): Promise<boolean>;
+    parseAndRun(...input: string[]): Promise<boolean>;
+}
 //# sourceMappingURL=LensDistortion.d.ts.map

package/lib/esm/effects/LensDistortion.js

@@ -1,25 +1,25 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Effects
- */
-import { assert } from "@itwin/core-bentley";
-import { Tool, UniformType, VaryingType } from "@itwin/core-frontend";
-import { AddEffectTool, refreshViewportsForEffect } from "./EffectTools";
-import { parseArgs } from "../tools/parseArgs";
-/** Adds a screen-space effect to the selected [[Viewport]] to simulate the lens distortion produced by real-world cameras with very wide fields of view.
- * Based on https://www.decarpentier.nl/lens-distortion
- * The effect is improved considerably by enabling anti-aliasing (e.g., via [RenderSystem.Options.antialiasSamples]($frontend) at startup, or using the `fdt aasamples` key-in`).
- * @note Because this effect applies a non-linear transform to each pixel, operations like snapping to geometry will not work properly. Element locate will work however - @see [ScreenSpaceEffectSource.sampleSourcePixel]($frontend).
- * @beta
- */
-export class LensDistortionEffect extends AddEffectTool {
-    get effectName() { return "lensdistortion"; }
-    get textureCoordFromPosition() { return true; }
-    get source() {
-        return {
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Effects
+ */
+import { assert } from "@itwin/core-bentley";
+import { Tool, UniformType, VaryingType } from "@itwin/core-frontend";
+import { AddEffectTool, refreshViewportsForEffect } from "./EffectTools";
+import { parseArgs } from "../tools/parseArgs";
+/** Adds a screen-space effect to the selected [[Viewport]] to simulate the lens distortion produced by real-world cameras with very wide fields of view.
+ * Based on https://www.decarpentier.nl/lens-distortion
+ * The effect is improved considerably by enabling anti-aliasing (e.g., via [RenderSystem.Options.antialiasSamples]($frontend) at startup, or using the `fdt aasamples` key-in`).
+ * @note Because this effect applies a non-linear transform to each pixel, operations like snapping to geometry will not work properly. Element locate will work however - @see [ScreenSpaceEffectSource.sampleSourcePixel]($frontend).
+ * @beta
+ */
+class LensDistortionEffect extends AddEffectTool {
+    get effectName() { return "lensdistortion"; }
+    get textureCoordFromPosition() { return true; }
+    get source() {
+        return {
             vertex: `
         void effectMain(vec4 position) {
           vec2 uv = textureCoordFromPosition(position);
@@ -35,71 +35,73 @@ export class LensDistortionEffect extends AddEffectTool {
           vUVDot = sqrt(ny) * vec2(cylAspectRatio, 1.0) * signedUV;
           vUV = vec3(0.5, 0.5, 1.0) * z + vec3(-0.5, -0.5, 0.0);
           vUV.xy += uv;
-        }`,
-            // We simply shift pixels - we don't alter their colors.
+        }`,
+            // We simply shift pixels - we don't alter their colors.
             fragment: `
         vec4 effectMain() {
           return sampleSourcePixel();
-        }`,
-            // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise
-            // element locate will not work correctly.
+        }`,
+            // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise
+            // element locate will not work correctly.
             sampleSourcePixel: `
         vec3 uv = dot(vUVDot, vUVDot) * vec3(-0.5, -0.5, -1.0) + vUV;
         return TEXTURE_PROJ(u_diffuse, uv);
-      `,
-        };
-    }
-    defineEffect(builder) {
-        // Lens distortion is only applicable to views with the camera enabled.
-        builder.shouldApply = (context) => context.viewport.isCameraOn;
-        builder.addVarying("vUV", VaryingType.Vec3);
-        builder.addVarying("vUVDot", VaryingType.Vec2);
-        builder.addUniform({
-            name: "strength",
-            type: UniformType.Float,
-            bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.strength),
-        });
-        builder.addUniform({
-            name: "cylindricalRatio",
-            type: UniformType.Float,
-            bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.cylindricalRatio),
-        });
-        builder.addUniform({
-            name: "aspectRatio",
-            type: UniformType.Float,
-            bind: (uniform, context) => uniform.setUniform1f(context.viewport.viewRect.aspect),
-        });
-        builder.addUniform({
-            name: "height",
-            type: UniformType.Float,
-            bind: (uniform, context) => {
-                assert(context.viewport.view.is3d() && context.viewport.view.isCameraOn);
-                const fov = context.viewport.view.camera.lens.radians;
-                const height = Math.tan(fov / 2) / context.viewport.viewRect.aspect;
-                uniform.setUniform1f(height);
-            },
-        });
-    }
-}
-LensDistortionEffect.toolId = "LensDistortionEffect";
-/** Configures the [[LensDistortionEffect]].
- * @beta
- */
-export class LensDistortionConfig extends Tool {
-    static get minArgs() { return 0; }
-    static get maxArgs() { return 2; }
-    async run(strength, ratio) {
-        LensDistortionConfig.strength = strength !== null && strength !== void 0 ? strength : 0.5;
-        LensDistortionConfig.cylindricalRatio = ratio !== null && ratio !== void 0 ? ratio : 0.5;
-        refreshViewportsForEffect("fdt lensdistortion");
-        return true;
-    }
-    async parseAndRun(...input) {
-        const args = parseArgs(input);
-        return this.run(args.getFloat("s"), args.getFloat("r"));
-    }
-}
-LensDistortionConfig.toolId = "LensDistortionConfig";
-LensDistortionConfig.strength = 0.5;
-LensDistortionConfig.cylindricalRatio = 0.5;
+      `,
+        };
+    }
+    defineEffect(builder) {
+        // Lens distortion is only applicable to views with the camera enabled.
+        builder.shouldApply = (context) => context.viewport.isCameraOn;
+        builder.addVarying("vUV", VaryingType.Vec3);
+        builder.addVarying("vUVDot", VaryingType.Vec2);
+        builder.addUniform({
+            name: "strength",
+            type: UniformType.Float,
+            bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.strength),
+        });
+        builder.addUniform({
+            name: "cylindricalRatio",
+            type: UniformType.Float,
+            bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.cylindricalRatio),
+        });
+        builder.addUniform({
+            name: "aspectRatio",
+            type: UniformType.Float,
+            bind: (uniform, context) => uniform.setUniform1f(context.viewport.viewRect.aspect),
+        });
+        builder.addUniform({
+            name: "height",
+            type: UniformType.Float,
+            bind: (uniform, context) => {
+                assert(context.viewport.view.is3d() && context.viewport.view.isCameraOn);
+                const fov = context.viewport.view.camera.lens.radians;
+                const height = Math.tan(fov / 2) / context.viewport.viewRect.aspect;
+                uniform.setUniform1f(height);
+            },
+        });
+    }
+}
+LensDistortionEffect.toolId = "LensDistortionEffect";
+export { LensDistortionEffect };
+/** Configures the [[LensDistortionEffect]].
+ * @beta
+ */
+class LensDistortionConfig extends Tool {
+    static get minArgs() { return 0; }
+    static get maxArgs() { return 2; }
+    async run(strength, ratio) {
+        LensDistortionConfig.strength = strength ?? 0.5;
+        LensDistortionConfig.cylindricalRatio = ratio ?? 0.5;
+        refreshViewportsForEffect("fdt lensdistortion");
+        return true;
+    }
+    async parseAndRun(...input) {
+        const args = parseArgs(input);
+        return this.run(args.getFloat("s"), args.getFloat("r"));
+    }
+}
+LensDistortionConfig.toolId = "LensDistortionConfig";
+LensDistortionConfig.strength = 0.5;
+LensDistortionConfig.cylindricalRatio = 0.5;
+export { LensDistortionConfig };
 //# sourceMappingURL=LensDistortion.js.map

package/lib/esm/effects/LensDistortion.js.map

@@ -1 +1 @@
-{"version":3,"file":"LensDistortion.js","sourceRoot":"","sources":["../../../src/effects/LensDistortion.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Effects\r\n */\r\n\r\nimport { assert } from \"@itwin/core-bentley\";\r\nimport { ScreenSpaceEffectBuilder, Tool, UniformType, VaryingType } from \"@itwin/core-frontend\";\r\nimport { AddEffectTool, refreshViewportsForEffect } from \"./EffectTools\";\r\nimport { parseArgs } from \"../tools/parseArgs\";\r\n\r\n/** Adds a screen-space effect to the selected [[Viewport]] to simulate the lens distortion produced by real-world cameras with very wide fields of view.\r\n * Based on https://www.decarpentier.nl/lens-distortion\r\n * The effect is improved considerably by enabling anti-aliasing (e.g., via [RenderSystem.Options.antialiasSamples]($frontend) at startup, or using the `fdt aasamples` key-in`).\r\n * @note Because this effect applies a non-linear transform to each pixel, operations like snapping to geometry will not work properly. Element locate will work however - @see [ScreenSpaceEffectSource.sampleSourcePixel]($frontend).\r\n * @beta\r\n */\r\nexport class LensDistortionEffect extends AddEffectTool {\r\n  public static override toolId = \"LensDistortionEffect\";\r\n\r\n  protected get effectName() { return \"lensdistortion\"; }\r\n  protected get textureCoordFromPosition() { return true; }\r\n\r\n  protected get source() {\r\n    return {\r\n      vertex: `\r\n        void effectMain(vec4 position) {\r\n          vec2 uv = textureCoordFromPosition(position);\r\n          float scaledHeight = strength * height;\r\n          float cylAspectRatio = aspectRatio * cylindricalRatio;\r\n          float aspectDiagSq = aspectRatio * aspectRatio + 1.0;\r\n          float diagSq = scaledHeight * scaledHeight * aspectDiagSq;\r\n          vec2 signedUV = (2.0 * uv + vec2(-1.0, -1.0));\r\n\r\n          float z = 0.5 * sqrt(diagSq + 1.0) + 0.5;\r\n          float ny = (z - 1.0) / (cylAspectRatio * cylAspectRatio + 1.0);\r\n\r\n          vUVDot = sqrt(ny) * vec2(cylAspectRatio, 1.0) * signedUV;\r\n          vUV = vec3(0.5, 0.5, 1.0) * z + vec3(-0.5, -0.5, 0.0);\r\n          vUV.xy += uv;\r\n        }`,\r\n      // We simply shift pixels - we don't alter their colors.\r\n      fragment: `\r\n        vec4 effectMain() {\r\n          return sampleSourcePixel();\r\n        }`,\r\n      // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise\r\n      // element locate will not work correctly.\r\n      sampleSourcePixel: `\r\n        vec3 uv = dot(vUVDot, vUVDot) * vec3(-0.5, -0.5, -1.0) + vUV;\r\n        return TEXTURE_PROJ(u_diffuse, uv);\r\n      `,\r\n    };\r\n  }\r\n\r\n  protected defineEffect(builder: ScreenSpaceEffectBuilder): void {\r\n    // Lens distortion is only applicable to views with the camera enabled.\r\n    builder.shouldApply = (context) => context.viewport.isCameraOn;\r\n\r\n    builder.addVarying(\"vUV\", VaryingType.Vec3);\r\n    builder.addVarying(\"vUVDot\", VaryingType.Vec2);\r\n\r\n    builder.addUniform({\r\n      name: \"strength\",\r\n      type: UniformType.Float,\r\n      bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.strength),\r\n    });\r\n    builder.addUniform({\r\n      name: \"cylindricalRatio\",\r\n      type: UniformType.Float,\r\n      bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.cylindricalRatio),\r\n    });\r\n    builder.addUniform({\r\n      name: \"aspectRatio\",\r\n      type: UniformType.Float,\r\n      bind: (uniform, context) => uniform.setUniform1f(context.viewport.viewRect.aspect),\r\n    });\r\n    builder.addUniform({\r\n      name: \"height\",\r\n      type: UniformType.Float,\r\n      bind: (uniform, context) => {\r\n        assert(context.viewport.view.is3d() && context.viewport.view.isCameraOn);\r\n        const fov = context.viewport.view.camera.lens.radians;\r\n        const height = Math.tan(fov / 2) / context.viewport.viewRect.aspect;\r\n        uniform.setUniform1f(height);\r\n      },\r\n    });\r\n  }\r\n}\r\n\r\n/** Configures the [[LensDistortionEffect]].\r\n * @beta\r\n */\r\nexport class LensDistortionConfig extends Tool {\r\n  public static override toolId = \"LensDistortionConfig\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 2; }\r\n\r\n  public static strength = 0.5;\r\n  public static cylindricalRatio = 0.5;\r\n\r\n  public override async run(strength?: number, ratio?: number): Promise<boolean> {\r\n    LensDistortionConfig.strength = strength ?? 0.5;\r\n    LensDistortionConfig.cylindricalRatio = ratio ?? 0.5;\r\n    refreshViewportsForEffect(\"fdt lensdistortion\");\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...input: string[]): Promise<boolean> {\r\n    const args = parseArgs(input);\r\n    return this.run(args.getFloat(\"s\"), args.getFloat(\"r\"));\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"LensDistortion.js","sourceRoot":"","sources":["../../../src/effects/LensDistortion.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Effects\r\n */\r\n\r\nimport { assert } from \"@itwin/core-bentley\";\r\nimport { ScreenSpaceEffectBuilder, Tool, UniformType, VaryingType } from \"@itwin/core-frontend\";\r\nimport { AddEffectTool, refreshViewportsForEffect } from \"./EffectTools\";\r\nimport { parseArgs } from \"../tools/parseArgs\";\r\n\r\n/** Adds a screen-space effect to the selected [[Viewport]] to simulate the lens distortion produced by real-world cameras with very wide fields of view.\r\n * Based on https://www.decarpentier.nl/lens-distortion\r\n * The effect is improved considerably by enabling anti-aliasing (e.g., via [RenderSystem.Options.antialiasSamples]($frontend) at startup, or using the `fdt aasamples` key-in`).\r\n * @note Because this effect applies a non-linear transform to each pixel, operations like snapping to geometry will not work properly. Element locate will work however - @see [ScreenSpaceEffectSource.sampleSourcePixel]($frontend).\r\n * @beta\r\n */\r\nexport class LensDistortionEffect extends AddEffectTool {\r\n  public static override toolId = \"LensDistortionEffect\";\r\n\r\n  protected get effectName() { return \"lensdistortion\"; }\r\n  protected get textureCoordFromPosition() { return true; }\r\n\r\n  protected get source() {\r\n    return {\r\n      vertex: `\r\n        void effectMain(vec4 position) {\r\n          vec2 uv = textureCoordFromPosition(position);\r\n          float scaledHeight = strength * height;\r\n          float cylAspectRatio = aspectRatio * cylindricalRatio;\r\n          float aspectDiagSq = aspectRatio * aspectRatio + 1.0;\r\n          float diagSq = scaledHeight * scaledHeight * aspectDiagSq;\r\n          vec2 signedUV = (2.0 * uv + vec2(-1.0, -1.0));\r\n\r\n          float z = 0.5 * sqrt(diagSq + 1.0) + 0.5;\r\n          float ny = (z - 1.0) / (cylAspectRatio * cylAspectRatio + 1.0);\r\n\r\n          vUVDot = sqrt(ny) * vec2(cylAspectRatio, 1.0) * signedUV;\r\n          vUV = vec3(0.5, 0.5, 1.0) * z + vec3(-0.5, -0.5, 0.0);\r\n          vUV.xy += uv;\r\n        }`,\r\n      // We simply shift pixels - we don't alter their colors.\r\n      fragment: `\r\n        vec4 effectMain() {\r\n          return sampleSourcePixel();\r\n        }`,\r\n      // Because we're moving pixels around, we must tell the render system where the source pixel was originally located - otherwise\r\n      // element locate will not work correctly.\r\n      sampleSourcePixel: `\r\n        vec3 uv = dot(vUVDot, vUVDot) * vec3(-0.5, -0.5, -1.0) + vUV;\r\n        return TEXTURE_PROJ(u_diffuse, uv);\r\n      `,\r\n    };\r\n  }\r\n\r\n  protected defineEffect(builder: ScreenSpaceEffectBuilder): void {\r\n    // Lens distortion is only applicable to views with the camera enabled.\r\n    builder.shouldApply = (context) => context.viewport.isCameraOn;\r\n\r\n    builder.addVarying(\"vUV\", VaryingType.Vec3);\r\n    builder.addVarying(\"vUVDot\", VaryingType.Vec2);\r\n\r\n    builder.addUniform({\r\n      name: \"strength\",\r\n      type: UniformType.Float,\r\n      bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.strength),\r\n    });\r\n    builder.addUniform({\r\n      name: \"cylindricalRatio\",\r\n      type: UniformType.Float,\r\n      bind: (uniform) => uniform.setUniform1f(LensDistortionConfig.cylindricalRatio),\r\n    });\r\n    builder.addUniform({\r\n      name: \"aspectRatio\",\r\n      type: UniformType.Float,\r\n      bind: (uniform, context) => uniform.setUniform1f(context.viewport.viewRect.aspect),\r\n    });\r\n    builder.addUniform({\r\n      name: \"height\",\r\n      type: UniformType.Float,\r\n      bind: (uniform, context) => {\r\n        assert(context.viewport.view.is3d() && context.viewport.view.isCameraOn);\r\n        const fov = context.viewport.view.camera.lens.radians;\r\n        const height = Math.tan(fov / 2) / context.viewport.viewRect.aspect;\r\n        uniform.setUniform1f(height);\r\n      },\r\n    });\r\n  }\r\n}\r\n\r\n/** Configures the [[LensDistortionEffect]].\r\n * @beta\r\n */\r\nexport class LensDistortionConfig extends Tool {\r\n  public static override toolId = \"LensDistortionConfig\";\r\n  public static override get minArgs() { return 0; }\r\n  public static override get maxArgs() { return 2; }\r\n\r\n  public static strength = 0.5;\r\n  public static cylindricalRatio = 0.5;\r\n\r\n  public override async run(strength?: number, ratio?: number): Promise<boolean> {\r\n    LensDistortionConfig.strength = strength ?? 0.5;\r\n    LensDistortionConfig.cylindricalRatio = ratio ?? 0.5;\r\n    refreshViewportsForEffect(\"fdt lensdistortion\");\r\n    return true;\r\n  }\r\n\r\n  public override async parseAndRun(...input: string[]): Promise<boolean> {\r\n    const args = parseArgs(input);\r\n    return this.run(args.getFloat(\"s\"), args.getFloat(\"r\"));\r\n  }\r\n}\r\n"]}

package/lib/esm/effects/Random.d.ts

@@ -1,25 +1,25 @@
-/** @packageDocumentation
- * @module Effects
- */
-import { Point3d, Range1d, Range3d } from "@itwin/core-geometry";
-/** Generate integer in [min, max].
- * @beta
- */
-export declare function randomInteger(min: number, max: number): number;
-/** Generate random integer in [range.low, range.high].
- * @beta
- */
-export declare function randomIntegerInRange(range: Range1d): number;
-/** Generate random floating-point number in [min, max).
- * @beta
- */
-export declare function randomFloat(min: number, max: number): number;
-/** Generate random floating-point number in [range.low, range.high).
- * @beta
- */
-export declare function randomFloatInRange(range: Range1d): number;
-/** Generate a random position in the specified range.
- * @beta
- */
-export declare function randomPositionInRange(range: Range3d): Point3d;
+/** @packageDocumentation
+ * @module Effects
+ */
+import { Point3d, Range1d, Range3d } from "@itwin/core-geometry";
+/** Generate integer in [min, max].
+ * @beta
+ */
+export declare function randomInteger(min: number, max: number): number;
+/** Generate random integer in [range.low, range.high].
+ * @beta
+ */
+export declare function randomIntegerInRange(range: Range1d): number;
+/** Generate random floating-point number in [min, max).
+ * @beta
+ */
+export declare function randomFloat(min: number, max: number): number;
+/** Generate random floating-point number in [range.low, range.high).
+ * @beta
+ */
+export declare function randomFloatInRange(range: Range1d): number;
+/** Generate a random position in the specified range.
+ * @beta
+ */
+export declare function randomPositionInRange(range: Range3d): Point3d;
 //# sourceMappingURL=Random.d.ts.map