Class ReflectionBlock

comments

generateOnlyFragmentCode

inputsAreExclusive

onCodeIsReadyObservable

uniqueId

visibleInInspector

visibleOnFrame

buildId

• get buildId(): number

  Gets or sets the build Id

  Returns number

• set buildId(value: number): void

  Parameters

  • value: number

  Returns void

codeIsReady

• get codeIsReady(): boolean

  Gets a boolean indicating that this block has is code ready to be used

  Returns boolean

inputs

• get inputs(): NodeMaterialConnectionPoint[]

  Gets the list of input points

  Returns NodeMaterialConnectionPoint[]

isFinalMerger

• get isFinalMerger(): boolean

  Gets a boolean indicating that this block is an end block (e.g. it is generating a system value)

  Returns boolean

isInput

• get isInput(): boolean

  Gets a boolean indicating that this block is an input (e.g. it sends data to the shader)

  Returns boolean

isLoop

• get isLoop(): boolean

  Gets a boolean indicating if this block is a loop

  Returns boolean

isTeleportIn

• get isTeleportIn(): boolean

  Gets a boolean indicating if this block is a teleport in

  Returns boolean

isTeleportOut

• get isTeleportOut(): boolean

  Gets a boolean indicating if this block is a teleport out

  Returns boolean

isUnique

• get isUnique(): boolean

  Gets a boolean indicating that this block can only be used once per NodeMaterial

  Returns boolean

name

• get name(): string

  Gets the name of the block

  Returns string

• set name(newName: string): void

  Sets the name of the block. Will check if the name is valid.

  Parameters

  • newName: string

  Returns void

outputs

• get outputs(): NodeMaterialConnectionPoint[]

  Gets the list of output points

  Returns NodeMaterialConnectionPoint[]

target

• get target(): NodeMaterialBlockTargets

  Gets or sets the target of the block

  Returns NodeMaterialBlockTargets

• set target(value: NodeMaterialBlockTargets): void

  Parameters

  • value: NodeMaterialBlockTargets

  Returns void

texture

• get texture(): Nullable<BaseTexture>

  Gets or sets the texture associated with the node

  Returns Nullable<BaseTexture>

• set texture(texture: Nullable<BaseTexture>): void

  Parameters

  • texture: Nullable<BaseTexture>

  Returns void

willBeGeneratedIntoVertexShaderFromFragmentShader

• get willBeGeneratedIntoVertexShaderFromFragmentShader(): boolean

  Gets a boolean indicating that the code of this block will be promoted to vertex shader even if connected to fragment output

  Returns boolean

autoConfigure

• autoConfigure(
      material: NodeMaterial,
      additionalFilteringInfo?: (node: NodeMaterialBlock) => boolean,
  ): void

  Auto configure the node based on the existing material

  Parameters

  • material: NodeMaterial

    defines the material to configure

  • additionalFilteringInfo: (node: NodeMaterialBlock) => boolean = ...

    defines additional info to be used when filtering inputs (we might want to skip some non relevant blocks)

  Returns void

build

• build(state: NodeMaterialBuildState, activeBlocks: NodeMaterialBlock[]): boolean

  Compile the current node and generate the shader code

  Parameters

  • state: NodeMaterialBuildState

    defines the current compilation state (uniforms, samplers, current string)

  • activeBlocks: NodeMaterialBlock[]

    defines the list of active blocks (i.e. blocks to compile)

  Returns boolean

  true if already built

clone

• clone(scene: Scene, rootUrl?: string): NodeMaterialBlock | null

  Clone the current block to a new identical block

  Parameters

  • scene: Scene

    defines the hosting scene

  • rootUrl: string = ""

    defines the root URL to use to load textures and relative dependencies

  Returns NodeMaterialBlock | null

  a copy of the current block

connectTo

• connectTo(
      other: NodeMaterialBlock,
      options?: { input?: string; output?: string; outputSwizzle?: string },
  ): ReflectionBlock | undefined

  Connect current block with another block

  Parameters

  • other: NodeMaterialBlock

    defines the block to connect with

  • Optionaloptions: { input?: string; output?: string; outputSwizzle?: string }

    define the various options to help pick the right connections

  Returns ReflectionBlock | undefined

  the current block

dispose

• dispose(): void

  Release resources

  Returns void

getFirstAvailableInput

• getFirstAvailableInput(
      forOutput?: Nullable<NodeMaterialConnectionPoint>,
  ): NodeMaterialConnectionPoint | null

  Will return the first available input e.g. the first one which is not an uniform or an attribute

  Parameters

  • forOutput: Nullable<NodeMaterialConnectionPoint> = null

    defines an optional connection point to check compatibility with

  Returns NodeMaterialConnectionPoint | null

  the first available input or null

getFirstAvailableOutput

• getFirstAvailableOutput(
      forBlock?: Nullable<NodeMaterialBlock>,
  ): NodeMaterialConnectionPoint | null

  Will return the first available output e.g. the first one which is not yet connected and not a varying

  Parameters

  • forBlock: Nullable<NodeMaterialBlock> = null

    defines an optional block to check compatibility with

  Returns NodeMaterialConnectionPoint | null

  the first available input or null

getInputByName

• getInputByName(name: string): NodeMaterialConnectionPoint | null

  Find an input by its name

  Parameters

  • name: string

    defines the name of the input to look for

  Returns NodeMaterialConnectionPoint | null

  the input or null if not found

getOutputByName

• getOutputByName(name: string): NodeMaterialConnectionPoint | null

  Find an output by its name

  Parameters

  • name: string

    defines the name of the output to look for

  Returns NodeMaterialConnectionPoint | null

  the output or null if not found

getSiblingOutput

• getSiblingOutput(
      current: NodeMaterialConnectionPoint,
  ): NodeMaterialConnectionPoint | null

  Gets the sibling of the given output

  Parameters

  • current: NodeMaterialConnectionPoint

    defines the current output

  Returns NodeMaterialConnectionPoint | null

  the next output in the list or null

handleFragmentSideCodeReflectionColor

• handleFragmentSideCodeReflectionColor(
      state: NodeMaterialBuildState,
      lodVarName?: string,
      swizzleLookupTexture?: string,
  ): string

  Generates the reflection color code for the fragment code path

  Parameters

  • state: NodeMaterialBuildState

    defines the build state

  • OptionallodVarName: string

    name of the lod variable

  • swizzleLookupTexture: string = ".rgb"

    swizzle to use for the final color variable

  Returns string

  the shader code

handleFragmentSideCodeReflectionCoords

• handleFragmentSideCodeReflectionCoords(
      state: NodeMaterialBuildState,
      worldNormalVarName: string,
      worldPos?: string,
      onlyReflectionVector?: boolean,
      doNotEmitInvertZ?: boolean,
  ): string

  Generates the reflection coords code for the fragment code path

  Parameters

  • state: NodeMaterialBuildState

    defines the build state

  • worldNormalVarName: string

    name of the world normal variable

  • OptionalworldPos: string

    name of the world position variable. If not provided, will use the world position connected to this block

  • onlyReflectionVector: boolean = false

    if true, generates code only for the reflection vector computation, not for the reflection coordinates

  • doNotEmitInvertZ: boolean = false

    if true, does not emit the invertZ code

  Returns string

  the shader code

handleFragmentSideInits

• handleFragmentSideInits(state: NodeMaterialBuildState): void

  Handles the inits for the fragment code path

  Parameters

  • state: NodeMaterialBuildState

    node material build state

  Returns void

initializeDefines

• initializeDefines(defines: NodeMaterialDefines): void

  Initialize defines for shader compilation

  Parameters

  • defines: NodeMaterialDefines

    defines the material defines to update

  Returns void

isAnAncestorOf

• isAnAncestorOf(block: NodeMaterialBlock): boolean

  Checks if the current block is an ancestor of a given block

  Parameters

  • block: NodeMaterialBlock

    defines the potential descendant block to check

  Returns boolean

  true if block is a descendant

isConnectedInFragmentShader

• isConnectedInFragmentShader(): boolean

  Gets a boolean indicating that this connection will be used in the fragment shader

  Returns boolean

  true if connected in fragment shader

isReady

• isReady(): boolean

  Checks if the block is ready

  Returns boolean

  true if ready

provideFallbacks

• provideFallbacks(fallbacks: EffectFallbacks, mesh?: AbstractMesh): void

  Add potential fallbacks if shader compilation fails

  Parameters

  • fallbacks: EffectFallbacks

    defines the current prioritized list of fallbacks

  • Optionalmesh: AbstractMesh

    defines the mesh to be rendered

  Returns void

registerInput

• registerInput(
      name: string,
      type: NodeMaterialBlockConnectionPointTypes,
      isOptional?: boolean,
      target?: NodeMaterialBlockTargets,
      point?: NodeMaterialConnectionPoint,
  ): ReflectionBlock

  Register a new input. Must be called inside a block constructor

  Parameters

  • name: string

    defines the connection point name

  • type: NodeMaterialBlockConnectionPointTypes

    defines the connection point type

  • isOptional: boolean = false

    defines a boolean indicating that this input can be omitted

  • Optionaltarget: NodeMaterialBlockTargets

    defines the target to use to limit the connection point (will be VertexAndFragment by default)

  • Optionalpoint: NodeMaterialConnectionPoint

    an already created connection point. If not provided, create a new one

  Returns ReflectionBlock

  the current block

registerOutput

• registerOutput(
      name: string,
      type: NodeMaterialBlockConnectionPointTypes,
      target?: NodeMaterialBlockTargets,
      point?: NodeMaterialConnectionPoint,
  ): ReflectionBlock

  Register a new output. Must be called inside a block constructor

  Parameters

  • name: string

    defines the connection point name

  • type: NodeMaterialBlockConnectionPointTypes

    defines the connection point type

  • Optionaltarget: NodeMaterialBlockTargets

    defines the target to use to limit the connection point (will be VertexAndFragment by default)

  • Optionalpoint: NodeMaterialConnectionPoint

    an already created connection point. If not provided, create a new one

  Returns ReflectionBlock

  the current block

replaceRepeatableContent

• replaceRepeatableContent(
      vertexShaderState: NodeMaterialBuildState,
      defines: NodeMaterialDefines,
      mesh?: AbstractMesh,
  ): void

  Function called when a block is declared as repeatable content generator

  Parameters

  • vertexShaderState: NodeMaterialBuildState

    defines the current compilation state for the vertex shader

  • defines: NodeMaterialDefines

    defines the material defines to update

  • Optionalmesh: AbstractMesh

    defines the mesh to be rendered

  Returns void

updateUniformsAndSamples

• updateUniformsAndSamples(
      state: NodeMaterialBuildState,
      nodeMaterial: NodeMaterial,
      defines: NodeMaterialDefines,
      uniformBuffers: string[],
  ): void

  Add uniforms, samplers and uniform buffers at compilation time

  Parameters

  • state: NodeMaterialBuildState

    defines the state to update

  • nodeMaterial: NodeMaterial

    defines the node material requesting the update

  • defines: NodeMaterialDefines

    defines the material defines to update

  • uniformBuffers: string[]

    defines the list of uniform buffer names

  Returns void

validateBlockName

• validateBlockName(newName: string): boolean

  Validates the new name for the block node.

  Parameters

  • newName: string

    the new name to be given to the node.

  Returns boolean

  false if the name is a reserve word, else true.

writeOutputs

• writeOutputs(state: NodeMaterialBuildState, varName: string): string

  Generates the code corresponding to the connected output points

  Parameters

  • state: NodeMaterialBuildState

    node material build state

  • varName: string

    name of the variable to output

  Returns string

  the shader code