@onerjs/smart-filters 8.25.1 → 8.25.3

package/dist/blockFoundation/inputBlock.js

@@ -0,0 +1,89 @@
+import { BaseBlock } from "./baseBlock.js";
+import { CreateStrongRef } from "../runtime/strongRef.js";
+import { ConnectionPointType } from "../connection/connectionPointType.js";
+/**
+ * Type predicate to check if value is a strong ref or a direct value
+ * @param value - The value to check
+ * @returns true if the value is a strong ref, otherwise false
+ */
+function IsRuntimeData(value) {
+    return value && value.value !== undefined;
+}
+/**
+ * Predicate to check if a block is a texture input block.
+ * @param block - The block to check
+ * @returns true if the block is a texture input block, otherwise false
+ */
+export function IsTextureInputBlock(block) {
+    return block.type === ConnectionPointType.Texture;
+}
+/**
+ * Predicate to check if a block is a disableable block.
+ * @param block - The block to check
+ * @returns true if the block is a disableable block, otherwise false
+ */
+export function IsDisableableShaderBlock(block) {
+    return block.disabled !== undefined;
+}
+/**
+ * This base class exists to provide a type that the serializer can use to represent
+ * any InputBlock without knowing the exact type it is.
+ */
+export class InputBlockBase extends BaseBlock {
+}
+/**
+ * The class name of the block.
+ */
+InputBlockBase.ClassName = "InputBlock";
+/**
+ * This represents any inputs used in the graph.
+ *
+ * This is used to provide a way to connect the graph to the outside world.
+ *
+ * The value is dynamically set by the user.
+ */
+export class InputBlock extends InputBlockBase {
+    /**
+     * Gets the current value of the input.
+     */
+    get runtimeValue() {
+        return this.output.runtimeData;
+    }
+    /**
+     * Sets the current value of the input.
+     */
+    set runtimeValue(value) {
+        this.output.runtimeData = value;
+    }
+    /**
+     * Creates a new InputBlock.
+     * @param smartFilter - The smart filter to add the block to
+     * @param name - The friendly name of the block
+     * @param type - The type of the input
+     * @param initialValue - The initial value of the input
+     * @remarks the initial value can either be a strong reference or a value
+     */
+    constructor(smartFilter, name, type, initialValue) {
+        super(smartFilter, name);
+        /**
+         * Data used by the Editor to store options required for instantiating the block in the Editor.
+         */
+        this.editorData = null;
+        /**
+         * Metadata the hosting app wants to track for this input. For example, a hint for what data to
+         * assign to this input, or hints about how to draw dynamic UI to allow users to control this value.
+         */
+        this.appMetadata = null;
+        this.type = type;
+        // Creates the output connection point
+        this.output = this._registerOutputWithDefault("output", type, IsRuntimeData(initialValue) ? initialValue : CreateStrongRef(initialValue));
+        // Creates a strong reference to the initial value in case a reference has not been provided
+        if (IsRuntimeData(initialValue)) {
+            this.runtimeValue = initialValue;
+        }
+        else {
+            this.runtimeValue = CreateStrongRef(initialValue);
+        }
+    }
+}
+//# sourceMappingURL=inputBlock.js.map

package/dist/blockFoundation/inputBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputBlock.js","sourceRoot":"","sources":["../../src/blockFoundation/inputBlock.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E;;;;GAIG;AACH,SAAS,aAAa,CAAgC,KAA+C;IACjG,OAAO,KAAK,IAAK,KAA0C,CAAC,KAAK,KAAK,SAAS,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAChD,OAAQ,KAAiD,CAAC,IAAI,KAAK,mBAAmB,CAAC,OAAO,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAgB;IACrD,OAAQ,KAAgC,CAAC,QAAQ,KAAK,SAAS,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,OAAgB,cAAe,SAAQ,SAAS;;AAClD;;GAEG;AACoB,wBAAS,GAAG,YAAY,CAAC;AA+DpD;;;;;;GAMG;AACH,MAAM,OAAO,UAAuD,SAAQ,cAAc;IAsBtF;;OAEG;IACH,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAW,YAAY,CAAC,KAAqB;QACzC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,WAAwB,EAAE,IAAY,EAAE,IAAO,EAAE,YAAsD;QAC/G,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAlC7B;;WAEG;QACI,eAAU,GAAsC,IAAI,CAAC;QAE5D;;;WAGG;QACI,gBAAW,GAAgB,IAAI,CAAC;QA0BnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,sCAAsC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,0BAA0B,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;QAE1I,4FAA4F;QAC5F,IAAI,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACrC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,YAAY,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACJ"}

package/dist/blockFoundation/inputBlock.serialization.types.d.ts

@@ -0,0 +1,105 @@
+import type { Nullable } from "@onerjs/core/types.js";
+import type { ConnectionPointType } from "../connection/connectionPointType.js";
+import type { IColor3Like, IColor4Like, IVector2Like } from "@onerjs/core/Maths/math.like.js";
+/**
+ * Data that all serialized InputBlocks share
+ */
+export type CommonInputBlockData = {
+    /**
+     * Metadata the hosting app wants to track for this input. For example, a hint for what data to
+     * assign to this input, or hints about how to draw dynamic UI to allow users to control this value.
+     */
+    appMetadata: unknown;
+};
+/**
+ * The data for an InputBlock for ConnectionPointType.Texture inputs
+ */
+export type TextureInputBlockData = CommonInputBlockData & {
+    /** The type of the input block */
+    inputType: ConnectionPointType.Texture;
+    /** The URL, if available, of the texture */
+    url: Nullable<string>;
+    /**
+     * If supplied, gives a hint as to which type of texture the URL points to.
+     * Default is assumed to be "image"
+     */
+    urlTypeHint: Nullable<"image" | "video">;
+    /**
+     * Defines the anisotropic level to use, or default if null
+     */
+    anisotropicFilteringLevel: Nullable<number>;
+    /**
+     * Indicates if the Y axis should be flipped, or default if null
+     */
+    flipY: Nullable<boolean>;
+    /**
+     * The file extension to use, or default if null.
+     */
+    forcedExtension: Nullable<string>;
+};
+/**
+ * The data for an InputBlock for ConnectionPointType.Boolean inputs
+ */
+export type BooleanInputBlockData = CommonInputBlockData & {
+    /** The type of the input block */
+    inputType: ConnectionPointType.Boolean;
+    /** The value of the input block */
+    value: boolean;
+};
+/**
+ * The data for an InputBlock for ConnectionPointType.Float inputs
+ */
+export type FloatInputBlockData = CommonInputBlockData & {
+    /** The type of the input block */
+    inputType: ConnectionPointType.Float;
+    /** The value of the input block */
+    value: number;
+    /**
+     * If supplied, how this should be animated by the editor.  Will not affect runtime behavior.
+     */
+    animationType: Nullable<"time">;
+    /**
+     * If supplied, the amount to change the value per millisecond when animating.
+     */
+    valueDeltaPerMs: Nullable<number>;
+    /**
+     * The minimum value of the float, used for slider control.
+     */
+    min: Nullable<number>;
+    /**
+     * The maximum value of the float, used for slider control.
+     */
+    max: Nullable<number>;
+};
+/**
+ * The data for an InputBlock for ConnectionPointType.Color3 inputs
+ */
+export type Color3InputBlockData = CommonInputBlockData & {
+    /** The type of the input block */
+    inputType: ConnectionPointType.Color3;
+    /** The value of the input block */
+    value: IColor3Like;
+};
+/**
+ * The data for an InputBlock for ConnectionPointType.Color4 inputs
+ */
+export type Color4InputBlockData = CommonInputBlockData & {
+    /** The type of the input block */
+    inputType: ConnectionPointType.Color4;
+    /** The value of the input block */
+    value: IColor4Like;
+};
+/**
+ * The data for an InputBlock for ConnectionPointType.Vector2 inputs
+ */
+export type Vector2InputBlockData = CommonInputBlockData & {
+    /** The type of the input block */
+    inputType: ConnectionPointType.Vector2;
+    /** The value of the input block */
+    value: IVector2Like;
+};
+/**
+ * Type union of all possible InputBlock data types
+ */
+export type SerializedInputBlockData = TextureInputBlockData | BooleanInputBlockData | FloatInputBlockData | Color3InputBlockData | Color4InputBlockData | Vector2InputBlockData;
+//# sourceMappingURL=inputBlock.serialization.types.d.ts.map

package/dist/blockFoundation/inputBlock.serialization.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputBlock.serialization.types.d.ts","sourceRoot":"","sources":["../../src/blockFoundation/inputBlock.serialization.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAAsB;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,wCAAgC;AAEtF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG;IACvD,kCAAkC;IAClC,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC;IAEvC,4CAA4C;IAC5C,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEtB;;;OAGG;IACH,WAAW,EAAE,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE5C;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEzB;;OAEG;IACH,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG;IACvD,kCAAkC;IAClC,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC;IAEvC,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG;IACrD,kCAAkC;IAClC,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC;IAErC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEtB;;OAEG;IACH,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IACtD,kCAAkC;IAClC,SAAS,EAAE,mBAAmB,CAAC,MAAM,CAAC;IAEtC,mCAAmC;IACnC,KAAK,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IACtD,kCAAkC;IAClC,SAAS,EAAE,mBAAmB,CAAC,MAAM,CAAC;IAEtC,mCAAmC;IACnC,KAAK,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG;IACvD,kCAAkC;IAClC,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC;IAEvC,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,qBAAqB,CAAC"}

package/dist/blockFoundation/inputBlock.serialization.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputBlock.serialization.types.js.map

package/dist/blockFoundation/inputBlock.serialization.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputBlock.serialization.types.js","sourceRoot":"","sources":["../../src/blockFoundation/inputBlock.serialization.types.ts"],"names":[],"mappings":""}

package/dist/blockFoundation/inputBlock.serializer.d.ts

@@ -0,0 +1,6 @@
+import type { IBlockSerializerV1 } from "../serialization/v1/smartFilterSerialization.types.js";
+/**
+ * The V1 serializer for an InputBlock
+ */
+export declare const InputBlockSerializer: IBlockSerializerV1;
+//# sourceMappingURL=inputBlock.serializer.d.ts.map

package/dist/blockFoundation/inputBlock.serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputBlock.serializer.d.ts","sourceRoot":"","sources":["../../src/blockFoundation/inputBlock.serializer.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAuHhG;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAelC,CAAC"}

package/dist/blockFoundation/inputBlock.serializer.js

@@ -0,0 +1,130 @@
+import { InputBlockBase } from "./inputBlock.js";
+import { ConnectionPointType } from "../connection/connectionPointType.js";
+/**
+ * Determines which generic type of InputBlock we are trying to serialize and calls the appropriate function
+ * to serialize the specifics for that type of InputBlock
+ * @param inputBlock - The InputBlock to serialize
+ * @returns Serialized data for the InputBlock
+ */
+function SerializeInputBlockData(inputBlock) {
+    switch (inputBlock.type) {
+        case ConnectionPointType.Texture:
+            return SerializeTextureInputBlock(inputBlock);
+        case ConnectionPointType.Boolean:
+            return SerializeBooleanInputBlock(inputBlock);
+        case ConnectionPointType.Float:
+            return SerializeFloatInputBlock(inputBlock);
+        case ConnectionPointType.Color3:
+            return SerializeColor3InputBlock(inputBlock);
+        case ConnectionPointType.Color4:
+            return SerializeColor4InputBlock(inputBlock);
+        case ConnectionPointType.Vector2:
+            return SerializeVector2InputBlock(inputBlock);
+    }
+}
+/**
+ * Generates the serialized data for a Texture InputBlock
+ * @param inputBlock - The Texture InputBlock to serialize
+ * @returns The serialized data for the InputBlock
+ */
+function SerializeTextureInputBlock(inputBlock) {
+    const internalTexture = inputBlock.runtimeValue.value?.getInternalTexture();
+    const forcedExtension = internalTexture?._extension ?? null;
+    let url = internalTexture?.url ?? null;
+    if (url === "" || !url) {
+        url = inputBlock.editorData?.url ?? null;
+    }
+    return {
+        inputType: ConnectionPointType.Texture,
+        url,
+        urlTypeHint: inputBlock.editorData?.urlTypeHint ?? null,
+        flipY: internalTexture?.invertY ?? null,
+        anisotropicFilteringLevel: internalTexture?.anisotropicFilteringLevel ?? null,
+        forcedExtension: forcedExtension !== "" ? forcedExtension : null,
+        appMetadata: inputBlock.appMetadata,
+    };
+}
+/**
+ * Generates the serialized data for a Boolean InputBlock
+ * @param inputBlock - The Boolean InputBlock to serialize
+ * @returns The serialized data for the InputBlock
+ */
+function SerializeBooleanInputBlock(inputBlock) {
+    return {
+        inputType: ConnectionPointType.Boolean,
+        value: inputBlock.runtimeValue.value,
+        appMetadata: inputBlock.appMetadata,
+    };
+}
+/**
+ * Generates the serialized data for a Float InputBlock
+ * @param inputBlock - The Float InputBlock to serialize
+ * @returns The serialized data for the InputBlock
+ */
+function SerializeFloatInputBlock(inputBlock) {
+    return {
+        inputType: ConnectionPointType.Float,
+        value: inputBlock.runtimeValue.value,
+        animationType: inputBlock.editorData?.animationType ?? null,
+        valueDeltaPerMs: inputBlock.editorData?.valueDeltaPerMs ?? null,
+        min: inputBlock.editorData?.min ?? null,
+        max: inputBlock.editorData?.max ?? null,
+        appMetadata: inputBlock.appMetadata,
+    };
+}
+/**
+ * Generates the serialized data for a Color3 InputBlock
+ * @param inputBlock - The Color3 InputBlock to serialize
+ * @returns The serialized data for the InputBlock
+ */
+function SerializeColor3InputBlock(inputBlock) {
+    return {
+        inputType: ConnectionPointType.Color3,
+        value: inputBlock.runtimeValue.value,
+        appMetadata: inputBlock.appMetadata,
+    };
+}
+/**
+ * Generates the serialized data for a Color4 InputBlock
+ * @param inputBlock - The Color4 InputBlock to serialize
+ * @returns The serialized data for the InputBlock
+ */
+function SerializeColor4InputBlock(inputBlock) {
+    return {
+        inputType: ConnectionPointType.Color4,
+        value: inputBlock.runtimeValue.value,
+        appMetadata: inputBlock.appMetadata,
+    };
+}
+/**
+ * Generates the serialized data for a Vector2 InputBlock
+ * @param inputBlock - The Vector2 InputBlock to serialize
+ * @returns The serialized data for the InputBlock
+ */
+function SerializeVector2InputBlock(inputBlock) {
+    return {
+        inputType: ConnectionPointType.Vector2,
+        value: inputBlock.runtimeValue.value,
+        appMetadata: inputBlock.appMetadata,
+    };
+}
+/**
+ * The V1 serializer for an InputBlock
+ */
+export const InputBlockSerializer = {
+    blockType: InputBlockBase.ClassName,
+    serialize: (block) => {
+        if (block.blockType !== InputBlockBase.ClassName) {
+            throw new Error("Was asked to serialize an unrecognized block type");
+        }
+        return {
+            name: block.name,
+            uniqueId: block.uniqueId,
+            blockType: InputBlockBase.ClassName,
+            namespace: null,
+            comments: block.comments,
+            data: SerializeInputBlockData(block),
+        };
+    },
+};
+//# sourceMappingURL=inputBlock.serializer.js.map

package/dist/blockFoundation/inputBlock.serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputBlock.serializer.js","sourceRoot":"","sources":["../../src/blockFoundation/inputBlock.serializer.ts"],"names":[],"mappings":"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"}

package/dist/blockFoundation/outputBlock.d.ts

@@ -0,0 +1,47 @@
+import type { InitializationData, SmartFilter } from "../smartFilter.js";
+import { ConnectionPointType } from "../connection/connectionPointType.js";
+import { BaseBlock } from "./baseBlock.js";
+import type { Nullable } from "@onerjs/core/types.js";
+import type { RenderTargetWrapper } from "@onerjs/core/Engines/renderTargetWrapper.js";
+/**
+ * The output block of a smart filter.
+ *
+ * Only the smart filter will internally create and host the output block.
+ * It should not be exported through the main index.ts module.
+ */
+export declare class OutputBlock extends BaseBlock {
+    /**
+     * The class name of the block.
+     */
+    static ClassName: string;
+    /**
+     * Input connection point of the output block.
+     * This takes a texture as input.
+     */
+    readonly input: import("../connection/connectionPoint.js").ConnectionPoint<ConnectionPointType.Texture>;
+    /**
+     * If supplied, the Smart Filter will render into this RenderTargetWrapper. Otherwise, it renders
+     * into the the canvas or WebGL context the ThinEngine is using for rendering.
+     */
+    renderTargetWrapper: Nullable<RenderTargetWrapper>;
+    /**
+     * Create a new output block.
+     * @param smartFilter - The smart filter this block belongs to
+     */
+    constructor(smartFilter: SmartFilter);
+    /**
+     * Prepares all blocks for runtime by traversing the graph.
+     */
+    prepareForRuntime(): void;
+    /**
+     * Propagates the runtime data for all graph blocks.
+     */
+    propagateRuntimeData(): void;
+    /**
+     * Generates the commands needed to execute the block at runtime and gathers promises for initialization work
+     * @param initializationData - The initialization data to use
+     * @param finalOutput - Defines if the block is the final output of the smart filter
+     */
+    generateCommandsAndGatherInitPromises(initializationData: InitializationData, finalOutput: boolean): void;
+}
+//# sourceMappingURL=outputBlock.d.ts.map

package/dist/blockFoundation/outputBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputBlock.d.ts","sourceRoot":"","sources":["../../src/blockFoundation/outputBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,8BAAsB;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,oDAA4C;AAsC/E;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACtC;;OAEG;IACH,OAAuB,SAAS,SAAiB;IAEjD;;;OAGG;IACH,SAAgB,KAAK,0FAA6D;IAElF;;;OAGG;IACI,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAQ;IAEjE;;;OAGG;gBACS,WAAW,EAAE,WAAW;IAIpC;;OAEG;IACa,iBAAiB,IAAI,IAAI;IAQzC;;OAEG;IACa,oBAAoB,IAAI,IAAI;IAS5C;;;;OAIG;IACa,qCAAqC,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;CAe5H"}

package/dist/blockFoundation/outputBlock.js

@@ -0,0 +1,123 @@
+import { ConnectionPointType } from "../connection/connectionPointType.js";
+import { BaseBlock } from "./baseBlock.js";
+import { ShaderBinding, ShaderRuntime } from "../runtime/shaderRuntime.js";
+import { RegisterFinalRenderCommand } from "../utils/renderTargetUtils.js";
+/**
+ * The shader program for the block.
+ */
+const BlockShaderProgram = {
+    vertex: undefined,
+    fragment: {
+        uniform: `
+            uniform sampler2D _input_; // main`,
+        mainInputTexture: "_input_",
+        mainFunctionName: "_copy_",
+        functions: [
+            {
+                name: "_copy_",
+                code: `
+                    vec4 _copy_(vec2 vUV) {
+                        return texture2D(_input_, vUV);
+                    }
+
+                    `,
+            },
+        ],
+    },
+};
+/**
+ * The uniform names for this shader, to be used in the shader binding so
+ * that the names are always in sync.
+ */
+const Uniforms = {
+    input: "input",
+};
+/**
+ * The output block of a smart filter.
+ *
+ * Only the smart filter will internally create and host the output block.
+ * It should not be exported through the main index.ts module.
+ */
+export class OutputBlock extends BaseBlock {
+    /**
+     * Create a new output block.
+     * @param smartFilter - The smart filter this block belongs to
+     */
+    constructor(smartFilter) {
+        super(smartFilter, "output");
+        /**
+         * Input connection point of the output block.
+         * This takes a texture as input.
+         */
+        this.input = this._registerInput("input", ConnectionPointType.Texture);
+        /**
+         * If supplied, the Smart Filter will render into this RenderTargetWrapper. Otherwise, it renders
+         * into the the canvas or WebGL context the ThinEngine is using for rendering.
+         */
+        this.renderTargetWrapper = null;
+    }
+    /**
+     * Prepares all blocks for runtime by traversing the graph.
+     */
+    prepareForRuntime() {
+        this.visit({}, (block, _extraData) => {
+            if (block !== this) {
+                block.prepareForRuntime();
+            }
+        });
+    }
+    /**
+     * Propagates the runtime data for all graph blocks.
+     */
+    propagateRuntimeData() {
+        this.visit({}, (block, _extraData) => {
+            if (block !== this) {
+                block.propagateRuntimeData();
+            }
+        });
+        this._confirmRuntimeDataSupplied(this.input);
+    }
+    /**
+     * Generates the commands needed to execute the block at runtime and gathers promises for initialization work
+     * @param initializationData - The initialization data to use
+     * @param finalOutput - Defines if the block is the final output of the smart filter
+     */
+    generateCommandsAndGatherInitPromises(initializationData, finalOutput) {
+        // In the case that this OutputBlock is directly connected to a texture InputBlock, we must
+        // use a shader to copy the texture to the render target texture.
+        if (this.input.connectedTo?.ownerBlock.isInput && this.input.runtimeData) {
+            const runtime = initializationData.runtime;
+            const shaderBlockRuntime = new ShaderRuntime(runtime.effectRenderer, BlockShaderProgram, new OutputShaderBinding(this.input.runtimeData));
+            initializationData.initializationPromises.push(shaderBlockRuntime.onReadyAsync);
+            runtime.registerResource(shaderBlockRuntime);
+            RegisterFinalRenderCommand(this, runtime, this, shaderBlockRuntime);
+            super.generateCommandsAndGatherInitPromises(initializationData, finalOutput);
+        }
+    }
+}
+/**
+ * The class name of the block.
+ */
+OutputBlock.ClassName = "OutputBlock";
+/**
+ * Shader binding to use when the OutputBlock is directly connected to a texture InputBlock.
+ */
+class OutputShaderBinding extends ShaderBinding {
+    /**
+     * Creates a new shader binding instance.
+     * @param inputTexture - defines the input texture to copy
+     */
+    constructor(inputTexture) {
+        super();
+        this._inputTexture = inputTexture;
+    }
+    /**
+     * Binds all the required data to the shader when rendering.
+     * @param effect - defines the effect to bind the data to
+     * @internal
+     */
+    bind(effect) {
+        effect.setTexture(this.getRemappedName(Uniforms.input), this._inputTexture.value);
+    }
+}
+//# sourceMappingURL=outputBlock.js.map

package/dist/blockFoundation/outputBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputBlock.js","sourceRoot":"","sources":["../../src/blockFoundation/outputBlock.ts"],"names":[],"mappings":"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"}

package/dist/blockFoundation/shaderBlock.d.ts

@@ -0,0 +1,64 @@
+import "@onerjs/core/Engines/Extensions/engine.renderTarget.js";
+import type { InitializationData, SmartFilter } from "../smartFilter.js";
+import type { ShaderProgram } from "../utils/shaderCodeUtils.js";
+import type { ShaderBinding } from "../runtime/shaderRuntime.js";
+import type { ConnectionPoint } from "../connection/connectionPoint.js";
+import { ConnectionPointType } from "../connection/connectionPointType.js";
+import { BaseBlock } from "./baseBlock.js";
+import { type OutputTextureOptions } from "./textureOptions.js";
+/**
+ * This is the base class for all shader blocks.
+ *
+ * It contains the redundant part of wrapping a shader for a full screen pass.
+ *
+ * The only required function to implement is the bind function.
+ */
+export declare abstract class ShaderBlock extends BaseBlock {
+    /**
+     * The class name of the block.
+     */
+    static ClassName: string;
+    /**
+     * Get the class instance that binds all the required data to the shader (effect) when rendering.
+     * It should throw an error if required inputs are missing.
+     * @returns The class instance that binds the data to the effect
+     */
+    abstract getShaderBinding(): ShaderBinding;
+    /**
+     * The shader program (vertex and fragment code) to use to render the block
+     */
+    static ShaderCode: ShaderProgram;
+    /**
+     * The output connection point of the block.
+     */
+    readonly output: ConnectionPoint<ConnectionPointType.Texture>;
+    /**
+     * The options used when creating the texture this block outputs to
+     */
+    outputTextureOptions: OutputTextureOptions;
+    /**
+     * Disconnects the block from the graph.
+     * @param disconnectedConnections - Stores the connections that have been broken in the process. You can reconnect them later if needed.
+     */
+    disconnectFromGraph(disconnectedConnections?: [ConnectionPoint, ConnectionPoint][]): void;
+    protected _getConnectionForMainInputTexture(): ConnectionPoint;
+    /**
+     * Instantiates a new block.
+     * @param smartFilter - Defines the smart filter the block belongs to
+     * @param name - Defines the name of the block
+     * @param disableOptimization - Defines if the block should not be optimized (default: false)
+     */
+    constructor(smartFilter: SmartFilter, name: string, disableOptimization?: boolean);
+    /**
+     * Gets the shader program to use to render the block.
+     * @returns The shader program to use to render the block
+     */
+    getShaderProgram(): ShaderProgram;
+    /**
+     * Generates the commands needed to execute the block at runtime and gathers promises for initialization work
+     * @param initializationData - The initialization data to use
+     * @param finalOutput - Defines if the block is the final output of the smart filter
+     */
+    generateCommandsAndGatherInitPromises(initializationData: InitializationData, finalOutput: boolean): void;
+}
+//# sourceMappingURL=shaderBlock.d.ts.map

package/dist/blockFoundation/shaderBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shaderBlock.d.ts","sourceRoot":"","sources":["../../src/blockFoundation/shaderBlock.ts"],"names":[],"mappings":"AACA,gEAAwD;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAI3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAM5F;;;;;;GAMG;AACH,8BAAsB,WAAY,SAAQ,SAAS;IAC/C;;OAEG;IACH,OAAuB,SAAS,SAAiB;IAEjD;;;;OAIG;aACa,gBAAgB,IAAI,aAAa;IAEjD;;OAEG;IACH,OAAc,UAAU,EAAE,aAAa,CAAC;IAExC;;OAEG;IACH,SAAgB,MAAM,+CAA+D;IAErF;;OAEG;IAyBI,oBAAoB,EAAE,oBAAoB,CAI/C;IAEF;;;OAGG;IACa,mBAAmB,CAAC,uBAAuB,CAAC,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC,EAAE,GAAG,IAAI;IASzG,SAAS,CAAC,iCAAiC,IAAI,eAAe;IAc9D;;;;;OAKG;gBACS,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,UAAQ;IAI/E;;;OAGG;IACI,gBAAgB;IAIvB;;;;OAIG;IACa,qCAAqC,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;CAuB5H"}