## BlendInTextureLayersWithPorts

### Introduced

v4.0

### Description

Adds new texture layers to the ports to blend in the specified presets.

### Scripting Syntax

    oReturn = BlendInTextureLayersWithPorts( [PresetNames], [InputObjs] );

### Return Value

Returns the layers created as an XSICollection.

### Parameters

Parameter | Type | Description
--- | --- | ---
PresetNames | String | Shader Presets corresponding to the shaders and/or images you want to connect Default Value: "Image"
InputObjs | String | List of shader connections to blend in new layers Default Value: Current selection

### Examples

#### VBScript Example

    '
    ' This example demonstrates how to apply blended shaders to a specific connection
    ' point on a cube. It also shows how to access the shader information both from the
    ' collection returned by BlendInTextureLayersWithPorts and through the object's material.
    '
    NewScene , false
    ' Create a default cube and apply a default Phong shader:
    Set oBox = ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface" )
    ApplyShader , oBox
    ' Apply Cloud and Gradient presets on the cube's Material Surface port:
    Set oLayers = BlendInTextureLayersWithPorts( "Cloud,Gradient", oBox.Material.Parameters( "Surface" ) )
    ' Now display the name of the created layers:
    For Each oLayer In oLayers
            Set oShader = SIGetShaderOnCnxPoint( oLayer & ".color" )
            Application.LogMessage oLayer.Name & " created with shader " & oShader.Name
    Next
    ' View the results in a rendered frame. (The colors appear quite smooth.)
    RenderPasses oDefPass, 1, 1
    ' Set the mode of the Gradient to "Darken":
    SetValue oBox.Material & ".Gradient_Layer.mode", 8
    ' View the results in a rendered frame. (Now the colors seem to have a mottled effect.)
    RenderPasses oDefPass, 1, 1
    ' Output of above script:
    'INFO : "Cloud_Layer created with shader Cloud"
    'INFO : "Gradient_Layer created with shader Gradient"

### See Also

BlendInTextureLayers BlendInTextureLayersInsp BlendInTextureLayersWithPortsInsp BlendClipsInTextureLayers BlendClipsInTextureLayersInsp BlendClipsInTextureLayersWithPortsInsp