@babylonjs/smart-filters 0.4.3-alpha → 0.6.0-alpha

package/dist/utils/shaderCodeUtils.d.ts

@@ -1,51 +1,10 @@
 import type { Effect } from "@babylonjs/core/Materials/effect";
+import type { ShaderCode } from "./buildTools/shaderCode.types";
 /**
  * The shader code decorator.
  * Used to decorate the names of uniform, function and const variables for easier parsing.
  */
 export declare const decorateChar = "_";
-/**
- * Describes a shader function.
- */
-export type ShaderFunction = {
-    /**
-     * The name of the function.
-     */
-    name: string;
-    /**
-     * The code of the function.
-     */
-    code: string;
-};
-/**
- * Describes a shader code.
- */
-export type ShaderCode = {
-    /**
-     * The declaration of the const variables.
-     */
-    const?: string;
-    /**
-     * The declaration of the uniform variables.
-     */
-    uniform?: string;
-    /**
-     * The declaration of the uniform variables that should be common for all ShaderBlock instances using this shader code.
-     */
-    uniformSingle?: string;
-    /**
-     * The name of the main function.
-     */
-    mainFunctionName: string;
-    /**
-     * The name of the input texture which is passed through if the block is disabled.
-     */
-    mainInputTexture?: string;
-    /**
-     * The list of functions used in the shader.
-     */
-    functions: ShaderFunction[];
-};
 /**
  * Describes a shader program.
  */

package/dist/utils/shaderCodeUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shaderCodeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/shaderCodeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,cAAc,EAAE,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,aAAa,QA4BvE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,UAAQ,GAAG,MAAM,CA0BhG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,qBAAqB,CA4C1F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvD"}
+{"version":3,"file":"shaderCodeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/shaderCodeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,aAAa,QA4BvE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,UAAQ,GAAG,MAAM,CA0BhG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,qBAAqB,CA4C1F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/utils/shaderCodeUtils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@babylonjs/smart-filters",
-    "version": "0.4.3-alpha",
+    "version": "0.6.0-alpha",
     "description": "Babylon.js Smart Filter core",
     "author": {
         "name": "Sebastien VANDENBERGHE"

package/readme.md

@@ -16,7 +16,7 @@ This can be installed with `npm install @babylonjs/smart-filters`.
 
 It requires the following peer dependencies:
 
--   @babylonjs/core
+- @babylonjs/core
 
 ## How to use
 
@@ -48,23 +48,23 @@ The notion of a `SmartFilter` is a graph of blocks (all inheriting from `BaseBlo
 
 During the initialization phase, the `SmartFilter` examines the graph and builds a list of commands to execute during each frame and stores them in a `CommandBuffer`:
 
--   This keeps each frame render very fast by ensuring the work is branchless.
--   Basically, every `BaseBlock` during its `initialize` step will register in the `CommandBuffer` only the work it has to execute according to its options.
--   In the end the render loop it only needs to run and execute each command in the list.
--   This also allows for easy injection of debug tools or logging in between each command without growing the minimum required code to run a filter.
--   As discussed, the `Blocks` are responsible for "injecting" their command in the filter `CommandBuffer`.
--   For example: the `ShaderBlock` highlights how convenient it can be to only switch once at init time between rendering to the main frame buffer (if linked to the output) or to an intermediate texture if in the middle of the chain.
+- This keeps each frame render very fast by ensuring the work is branchless.
+- Basically, every `BaseBlock` during its `initialize` step will register in the `CommandBuffer` only the work it has to execute according to its options.
+- In the end the render loop it only needs to run and execute each command in the list.
+- This also allows for easy injection of debug tools or logging in between each command without growing the minimum required code to run a filter.
+- As discussed, the `Blocks` are responsible for "injecting" their command in the filter `CommandBuffer`.
+- For example: the `ShaderBlock` highlights how convenient it can be to only switch once at init time between rendering to the main frame buffer (if linked to the output) or to an intermediate texture if in the middle of the chain.
 
 Each block is responsible for exposing their inputs and outputs through `registerInput` and `registerOutput`:
 
--   This creates and stores the related `ConnectionPoint`.
--   All property values of a block must be updated only before `initialize` is called as the runtime won't reference it at render time.
--   All values that need to be dynamically updated after `initialize` must be defined as connection points or 'StrongRef'.
+- This creates and stores the related `ConnectionPoint`.
+- All property values of a block must be updated only before `initialize` is called as the runtime won't reference it at render time.
+- All values that need to be dynamically updated after `initialize` must be defined as connection points or 'StrongRef'.
 
 The `ConnectionPoints` are:
 
--   Strongly typed, allowing more type safety while creating `SmartFilter` by code, yet keeping enough flexibility to be understood efficiently at runtime.
--   They are also responsible for their compatibility when linked to each other.
+- Strongly typed, allowing more type safety while creating `SmartFilter` by code, yet keeping enough flexibility to be understood efficiently at runtime.
+- They are also responsible for their compatibility when linked to each other.
 
 The Smart Filter is fully abstracted away from the runtime notion and does not even require a Babylon Engine to work with. It is only responsible to hold the "graph" of the filter or the "map" of all its blocks. A Filter only needs a name to be created:
 
@@ -160,14 +160,15 @@ _Note_ The runtime should be disposed once it is not used anymore to free the GP
 
 The overall system is trying at best to follow 3 simple rules:
 
--   Be CPU efficient: for instance, we are trying to be branchless in most of our commands and we try to keep the number of commands as low as possible.
--   Be memory efficient: no commands should allocate memory as it could trigger some garbage collection at the expense of frame loss.
--   Be GPU efficient: the graph and texture optimizers minimize the number of "passes" required to render an image and the GPU resources used by the graph.
+- Be CPU efficient: for instance, we are trying to be branchless in most of our commands and we try to keep the number of commands as low as possible.
+- Be memory efficient: no commands should allocate memory as it could trigger some garbage collection at the expense of frame loss.
+- Be GPU efficient: the graph and texture optimizers minimize the number of "passes" required to render an image and the GPU resources used by the graph.
 
 ## Requirements for GLSL code
 
 To be imported into blocks, the following requirements must be met by .glsl files:
 
+1. The file must start with a multiline comment that contains a JSON encoded GlslHeader object
 1. There must be a sampler2D uniform designed as the main input texture (the one to be passed along) if this block is disabled. It must have a comment on its line like this:
    `// main`
 1. There must be a single main function which takes in a vec2 named vUV and returns a vec4, and it must have a comment on its line like this:
@@ -175,3 +176,6 @@ To be imported into blocks, the following requirements must be met by .glsl file
 1. Any uniforms which should have the same value across all instances of the same block should have a comment on its line like this:
    `// single`
 1. Functions must be declared with the open { on the same line as the function name
+1. Uniforms can have metadata, such as a default value if no connection is made to their corresponding connection point
+    - In the line immediately above the uniform declaration, start with a // comment followed by a JSON object
+    - The supported metadata is described in the UniformMetadataProperties type

package/src/blocks/baseBlock.ts

@@ -44,6 +44,15 @@ export abstract class BaseBlock implements ICommandOwner {
      */
     public readonly name: string;
 
+    /**
+     * The type of the block - used when serializing / deserializing the block, and in the editor.
+     * For programmatically created blocks, this should be the class name of the block.
+     * For custom blocks, this is specified in the block definition.
+     */
+    public get blockType(): string {
+        return this.getClassName();
+    }
+
     /**
      * User provided comments about the block. It can be used to document the block.
      */

package/src/blocks/customShaderBlock.ts

@@ -0,0 +1,217 @@
+import type { Effect } from "@babylonjs/core/Materials/effect";
+import { ConnectionPointType } from "../connection/connectionPointType.js";
+import { ShaderBinding } from "../runtime/shaderRuntime.js";
+import { createStrongRef } from "../runtime/strongRef.js";
+import type { SerializedBlockDefinition } from "../serialization/serializedBlockDefinition";
+import type { SerializedInputConnectionPointV1 } from "../serialization/v1/blockSerialization.types";
+import type { SmartFilter } from "../smartFilter";
+import type { ShaderProgram } from "../utils/shaderCodeUtils";
+import { ShaderBlock } from "./shaderBlock.js";
+import type { RuntimeData } from "../connection/connectionPoint";
+
+/**
+ * The binding for a CustomShaderBlock
+ */
+class CustomShaderBlockBinding extends ShaderBinding {
+    private readonly _bindSteps: ((effect: Effect) => void)[] = [];
+
+    /**
+     * Creates a new shader binding instance for the CustomShaderBlock block.
+     * @param inputsWithRuntimeData - The input connection points of the block
+     */
+    public constructor(inputsWithRuntimeData: AnyInputWithRuntimeData[]) {
+        super();
+
+        for (const input of inputsWithRuntimeData) {
+            switch (input.type) {
+                case ConnectionPointType.Float:
+                    this._bindSteps.push((effect) => {
+                        effect.setFloat(this.getRemappedName(input.name), input.runtimeData.value);
+                    });
+                    break;
+                case ConnectionPointType.Texture:
+                    this._bindSteps.push((effect) => {
+                        effect.setTexture(this.getRemappedName(input.name), input.runtimeData.value);
+                    });
+                    break;
+                case ConnectionPointType.Color3:
+                    this._bindSteps.push((effect) => {
+                        effect.setColor3(this.getRemappedName(input.name), input.runtimeData.value);
+                    });
+                    break;
+                case ConnectionPointType.Color4:
+                    this._bindSteps.push((effect) => {
+                        effect.setDirectColor4(this.getRemappedName(input.name), input.runtimeData.value);
+                    });
+                    break;
+                case ConnectionPointType.Boolean:
+                    this._bindSteps.push((effect) => {
+                        effect.setBool(this.getRemappedName(input.name), input.runtimeData.value);
+                    });
+                    break;
+                case ConnectionPointType.Vector2:
+                    this._bindSteps.push((effect) => {
+                        effect.setVector2(this.getRemappedName(input.name), input.runtimeData.value);
+                    });
+                    break;
+            }
+        }
+    }
+
+    /**
+     * Binds all the required data to the shader when rendering.
+     * @param effect - The effect to bind the data to
+     */
+    public override bind(effect: Effect): void {
+        for (let i = 0; i < this._bindSteps.length; i++) {
+            this._bindSteps[i]!(effect);
+        }
+    }
+}
+
+/**
+ * A block which loads a SerializedBlockDefinition for use in a SmartFilter.
+ */
+export class CustomShaderBlock extends ShaderBlock {
+    /**
+     * Deserializes a CustomShaderBlock from a serialized block definition.
+     * @param smartFilter - The smart filter this block belongs to
+     * @param name - Defines the name of the block
+     * @param blockDefinition - The serialized block definition
+     * @returns The deserialized CustomShaderBlock instance
+     */
+    public static Create(
+        smartFilter: SmartFilter,
+        name: string,
+        blockDefinition: SerializedBlockDefinition
+    ): CustomShaderBlock {
+        // When a new version of SerializedBlockDefinition is created, this function should be updated to handle the new properties.
+
+        return new CustomShaderBlock(
+            smartFilter,
+            name,
+            blockDefinition.disableOptimization,
+            blockDefinition.blockType,
+            blockDefinition.inputConnectionPoints,
+            blockDefinition.shaderProgram
+        );
+    }
+
+    /**
+     * The class name of the block.
+     */
+    public static override ClassName = "CustomShaderBlock";
+
+    private readonly _shaderProgram: ShaderProgram;
+    private readonly _blockType: string;
+
+    /**
+     * The type of the block - used when serializing / deserializing the block, and in the editor.
+     */
+    public override get blockType(): string {
+        return this._blockType;
+    }
+
+    /**
+     * Instantiates a new custom shader block.
+     * @param smartFilter - The smart filter this block belongs to
+     * @param name - The name of the block
+     * @param disableOptimization - If true, this optimizer will not attempt to optimize this block
+     * @param blockType - The type of the block
+     * @param inputConnectionPoints - The input connection points of the
+     * @param shaderProgram - The shader program for the block
+     */
+    private constructor(
+        smartFilter: SmartFilter,
+        name: string,
+        disableOptimization: boolean,
+        blockType: string,
+        inputConnectionPoints: SerializedInputConnectionPointV1[],
+        shaderProgram: ShaderProgram
+    ) {
+        super(smartFilter, name, disableOptimization);
+        this._blockType = blockType;
+
+        for (const input of inputConnectionPoints) {
+            this._registerSerializedInputConnectionPointV1(input);
+        }
+
+        this._shaderProgram = shaderProgram;
+    }
+
+    /**
+     * Gets the shader program to use to render the block.
+     * @returns The shader program to use to render the block
+     */
+    public override getShaderProgram() {
+        return this._shaderProgram;
+    }
+
+    /**
+     * Checks a specific input connection point type to see if it has a default value, and registers the input
+     * connection point accordingly.
+     * @param connectionPoint - The input connection point to register
+     */
+    private _registerSerializedInputConnectionPointV1<U extends ConnectionPointType>(
+        connectionPoint: SerializedInputConnectionPointV1<U>
+    ): void {
+        if (connectionPoint.defaultValue !== undefined) {
+            this._registerOptionalInput(
+                connectionPoint.name,
+                connectionPoint.type,
+                createStrongRef(connectionPoint.defaultValue)
+            );
+        } else {
+            this._registerInput(connectionPoint.name, connectionPoint.type);
+        }
+    }
+
+    /**
+     * Gets the shader binding for the custom shader block.
+     * @returns The shader binding for the custom shader block
+     */
+    public override getShaderBinding(): ShaderBinding {
+        const inputs = this.inputs;
+
+        const inputsWithRuntimeData = inputs.map((input) => {
+            return {
+                name: input.name,
+                type: input.type,
+                runtimeData: this._confirmRuntimeDataSupplied(input),
+            };
+        });
+
+        return new CustomShaderBlockBinding(inputsWithRuntimeData);
+    }
+}
+
+/**
+ * Represents an input with its runtime data, enforcing type safety.
+ */
+type InputWithRuntimeData<U extends ConnectionPointType> = {
+    /**
+     * The name of the input connection point
+     */
+    name: string;
+
+    /**
+     * The type of the input connection point
+     */
+    type: U;
+
+    /**
+     * The runtime data for the input connection point
+     */
+    runtimeData: RuntimeData<U>;
+};
+
+/**
+ * All possible input types with runtime data.
+ */
+type AnyInputWithRuntimeData =
+    | InputWithRuntimeData<ConnectionPointType.Boolean>
+    | InputWithRuntimeData<ConnectionPointType.Color3>
+    | InputWithRuntimeData<ConnectionPointType.Color4>
+    | InputWithRuntimeData<ConnectionPointType.Float>
+    | InputWithRuntimeData<ConnectionPointType.Texture>
+    | InputWithRuntimeData<ConnectionPointType.Vector2>;

package/src/blocks/inputBlock.deserializer.ts

@@ -2,7 +2,7 @@ import { InputBlock } from "./inputBlock.js";
 import type { SerializedInputBlockData } from "./inputBlock.serialization.types.js";
 import { ConnectionPointType } from "../connection/connectionPointType.js";
 import type { SmartFilter } from "../smartFilter.js";
-import type { ISerializedBlockV1 } from "../serialization/v1/serialization.types.js";
+import type { ISerializedBlockV1 } from "../serialization/v1/smartFilterSerialization.types.js";
 
 /**
  * V1 Input Block Deserializer

package/src/blocks/inputBlock.serializer.ts

@@ -10,7 +10,7 @@ import type {
     TextureInputBlockData,
     Vector2InputBlockData,
 } from "./inputBlock.serialization.types";
-import type { IBlockSerializerV1 } from "../serialization/v1/serialization.types";
+import type { IBlockSerializerV1 } from "../serialization/v1/smartFilterSerialization.types.js";
 
 /**
  * Determines which generic type of InputBlock we are trying to serialize and calls the appropriate function
@@ -127,15 +127,15 @@ function serializeVector2InputBlock(inputBlock: InputBlock<ConnectionPointType.V
  * The V1 serializer for an InputBlock
  */
 export const inputBlockSerializer: IBlockSerializerV1 = {
-    className: InputBlockBase.ClassName,
+    blockType: InputBlockBase.ClassName,
     serialize: (block: BaseBlock) => {
-        if (block.getClassName() !== InputBlockBase.ClassName) {
+        if (block.blockType !== InputBlockBase.ClassName) {
             throw new Error("Was asked to serialize an unrecognized block type");
         }
         return {
             name: block.name,
             uniqueId: block.uniqueId,
-            className: InputBlockBase.ClassName,
+            blockType: InputBlockBase.ClassName,
             comments: block.comments,
             data: serializeInputBlockData(block as unknown as InputBlockBase),
         };

package/src/blocks/shaderBlock.ts

@@ -11,6 +11,10 @@ import { createCommand } from "../command/command.js";
 import { undecorateSymbol } from "../utils/shaderCodeUtils.js";
 import { getRenderTargetWrapper, registerFinalRenderCommand } from "../utils/renderTargetUtils.js";
 import { BaseBlock } from "./baseBlock.js";
+import { TextureFormat, TextureType, type OutputTextureOptions } from "./textureOptions.js";
+import { editableInPropertyPage, PropertyTypeForEdition } from "../editorUtils/editableInPropertyPage.js";
+
+const OutputTexturePropertiesGroupName = "OUTPUT TEXTURE PROPERTIES";
 
 /**
  * This is the base class for all shader blocks.
@@ -42,21 +46,38 @@ export abstract class ShaderBlock extends BaseBlock {
      */
     public readonly output = this._registerOutput("output", ConnectionPointType.Texture);
 
-    protected _textureRatio: number = 1;
-
     /**
-     * Gets the texture ratio of the output texture.
+     * The options used when creating the texture this block outputs to
      */
-    public get textureRatio() {
-        return this._textureRatio;
-    }
-
-    /**
-     * Sets the texture ratio of the output texture.
-     */
-    public set textureRatio(value: number) {
-        this._textureRatio = value;
-    }
+    @editableInPropertyPage("Ratio", PropertyTypeForEdition.Float, OutputTexturePropertiesGroupName, {
+        min: 0.1,
+        max: 10.0,
+        notifiers: { rebuild: true },
+        subPropertyName: "ratio",
+    })
+    @editableInPropertyPage("Format", PropertyTypeForEdition.List, OutputTexturePropertiesGroupName, {
+        notifiers: { rebuild: true },
+        subPropertyName: "format",
+        options: [
+            { label: "R", value: TextureFormat.R },
+            { label: "RG", value: TextureFormat.RG },
+            { label: "RGBA", value: TextureFormat.RGBA },
+        ],
+    })
+    @editableInPropertyPage("Type", PropertyTypeForEdition.List, OutputTexturePropertiesGroupName, {
+        notifiers: { rebuild: true },
+        subPropertyName: "type",
+        options: [
+            { label: "UByte", value: TextureType.UNSIGNED_BYTE },
+            { label: "Float", value: TextureType.FLOAT },
+            { label: "Half Float", value: TextureType.HALF_FLOAT },
+        ],
+    })
+    public outputTextureOptions: OutputTextureOptions = {
+        ratio: 1,
+        format: TextureFormat.RGBA,
+        type: TextureType.UNSIGNED_BYTE,
+    };
 
     /**
      * Disconnects the block from the graph.
@@ -131,11 +152,11 @@ export abstract class ShaderBlock extends BaseBlock {
         } else {
             const renderTarget = getRenderTargetWrapper(
                 this.output.runtimeData?.value as ThinRenderTargetTexture,
-                this.getClassName()
+                this.blockType
             );
 
             runtime.registerCommand(
-                createCommand(`${this.getClassName()}.render`, this, () => {
+                createCommand(`${this.blockType}.render`, this, () => {
                     shaderBlockRuntime.renderToTexture(renderTarget);
                 })
             );

package/src/blocks/textureOptions.ts

@@ -0,0 +1,57 @@
+/**
+ * The format of a texture - corresponds to the Babylon.js TextureFormat constants
+ */
+export enum TextureFormat {
+    /** Babylon Constants.TEXTUREFORMAT_RGBA */
+    RGBA = 5,
+    /** Babylon Constants.TEXTUREFORMAT_R */
+    R = 6,
+    /** Babylon Constants.TEXTUREFORMAT_RG */
+    RG = 7,
+}
+
+/**
+ * The type of a texture - corresponds to the Babylon.js TextureType constants
+ */
+export enum TextureType {
+    /** Babylon Constants.TEXTURETYPE_UNSIGNED_BYTE */
+    UNSIGNED_BYTE = 0,
+    /** Babylon Constants.TEXTURETYPE_FLOAT */
+    FLOAT = 1,
+    /** Babylon Constants.TEXTURETYPE_HALF_FLOAT */
+    HALF_FLOAT = 2,
+}
+
+// IMPORTANT: Update textureOptionsMatch() if you add more fields to OutputTextureOptions
+/**
+ * Describes the requirements for the output texture of a shader block.
+ */
+export type OutputTextureOptions = {
+    /**
+     * The texture size ratio (output size of this block / size of the Smart Filter output)
+     */
+    ratio: number;
+
+    /**
+     * The format of the texture
+     */
+    format: TextureFormat;
+
+    /**
+     * The type of the texture
+     */
+    type: TextureType;
+};
+
+/**
+ * Compares two OutputTextureOptions to see if they match.
+ * @param a - The first OutputTextureOptions
+ * @param b - The second OutputTextureOptions
+ * @returns True if the two options match, false otherwise
+ */
+export function textureOptionsMatch(a: OutputTextureOptions | undefined, b: OutputTextureOptions | undefined): boolean {
+    if (a === undefined || b === undefined) {
+        return false;
+    }
+    return a.ratio === b.ratio && a.format === b.format && a.type === b.type;
+}

package/src/command/command.ts

@@ -1,6 +1,5 @@
 /**
  * Represents the owner of a command.
- * In practice, it will mostly be a block, the smart filter or a tool injecting commands.
  */
 export interface ICommandOwner {
     /**
@@ -9,9 +8,9 @@ export interface ICommandOwner {
     readonly name: string;
 
     /**
-     * Gets the class name of the owner.
+     * The blockType of the owner;
      */
-    getClassName(): string;
+    readonly blockType: string;
 }
 
 /**

package/src/command/commandBufferDebugger.ts

@@ -7,7 +7,7 @@ import type { CommandBuffer } from "./commandBuffer";
 export function logCommands(commandBuffer: Readonly<CommandBuffer>) {
     console.log("----- Command buffer commands -----");
     commandBuffer.visitCommands((command) => {
-        console.log(`  Owner: ${command.owner.getClassName()} (${command.owner.name}) - Command: ${command.name}`);
+        console.log(`  Owner: ${command.owner.blockType} (${command.owner.name}) - Command: ${command.name}`);
     });
     console.log("-----------------------------------");
 }

package/src/connection/connectionPointType.ts

@@ -20,6 +20,17 @@ export enum ConnectionPointType {
     Vector2 = 6,
 }
 
+/**
+ * A union of all supported connection point types
+ */
+export type AllConnectionPointTypes =
+    | ConnectionPointType.Float
+    | ConnectionPointType.Texture
+    | ConnectionPointType.Color3
+    | ConnectionPointType.Color4
+    | ConnectionPointType.Boolean
+    | ConnectionPointType.Vector2;
+
 /**
  * Retrieves the type of the value from the Connection point type.
  */

package/src/editorUtils/editableInPropertyPage.ts

@@ -51,6 +51,8 @@ export interface IEditablePropertyOption {
     options?: IEditablePropertyListOption[] | Observable<IEditablePropertyListOption[]>;
     /** whether the options' values should be treated as strings */
     valuesAreStrings?: boolean;
+    /** If supplied, the sub property to read/write */
+    subPropertyName?: string;
 }
 
 /**
@@ -67,6 +69,8 @@ export interface IPropertyDescriptionForEdition {
     groupName: string;
     /** options for the property */
     options: IEditablePropertyOption;
+    /** name of the class that contains the property */
+    className: string;
 }
 
 /**
@@ -96,6 +100,7 @@ export function editableInPropertyPage(
             type: propertyType,
             groupName: groupName,
             options: options ?? {},
+            className: target.constructor.name,
         });
     };
 }

package/src/index.ts

@@ -20,6 +20,7 @@ export { BaseBlock } from "./blocks/baseBlock.js";
 export { InputBlock, type InputBlockEditorData } from "./blocks/inputBlock.js";
 export { type AnyInputBlock } from "./blocks/inputBlock.js";
 export { ShaderBlock } from "./blocks/shaderBlock.js";
+export { CustomShaderBlock } from "./blocks/customShaderBlock.js";
 export { DisableableShaderBlock, BlockDisableStrategy as DisableStrategy } from "./blocks/disableableShaderBlock.js";
 export { AggregateBlock } from "./blocks/aggregateBlock.js";
 export { DisableableShaderBinding, ShaderBinding, ShaderRuntime } from "./runtime/shaderRuntime.js";
@@ -36,3 +37,4 @@ export { SmartFilterOptimizer } from "./optimization/smartFilterOptimizer.js";
 export * from "./utils/textureLoaders.js";
 export * from "./serialization/index.js";
 export * from "./editorUtils/editableInPropertyPage.js";
+export * from "./serialization/importCustomShaderBlockDefinition.js";