TextureLayerPort Class Reference

Related Scripting Object: TextureLayerPort | Supported Parameter List: TextureLayerPort

The TextureLayerPort is an object used to describe which specific shader and material parameters a TextureLayer affects. Like shader connections, they indicate what shader ports are being driven by the layer. More...

#include <xsi_texturelayerport.h>

Inheritance diagram for TextureLayerPort:

Detailed Description

The port has a few properties which describe how the layer affects a single shading parameter, generally these are used to modify the layer's settings in a port-specific way, for example by inverting or scaling the overall effect. A layer may be set up to blend its color by 50% with the layer beneath it. However, that layer's the ambient port effect may only be 25% whereas the diffuse port contribution could be set to 100%.

See also:

TextureLayer::GetTextureLayerPorts, TextureLayer::AddTextureLayerPort, Shader

Since:

4.0

Example:

This C++ example shows how to create texture layer ports, plus enumerating and removing them.

        using namespace XSI;
        Application app;
        Model root = app.GetActiveSceneRoot();
        X3DObject mySphere;
        root.AddGeometry( L"Sphere",L"MeshSurface",L"" ,mySphere );
        Material myMaterial;
        mySphere.AddMaterial(L"Phong",false,L"",myMaterial);
        CRefArray   myShaders;
        Shader myPhong;
        myShaders = myMaterial.GetShaders();
        myPhong = myShaders[0];

        TextureLayer    myLayer;
        // Add a layer (since there are no others the "After" flag is irrelevant).
        myLayer = myPhong.CreateTextureLayer( L"DirtLayer", true );

        CRefArray       myPorts(3);
        // Add some texture layer port connections on this layer.
        myPorts[0] = myLayer.AddTextureLayerPort( myPhong.GetParameters().GetItem( L"ambient" ) );
        myPorts[1] = myLayer.AddTextureLayerPort( myPhong.GetParameters().GetItem( L"diffuse" ) );
        myPorts[2] = myLayer.AddTextureLayerPort( myPhong.GetParameters().GetItem( L"specular" ) );

        myPorts = myLayer.GetTextureLayerPorts();
        app.LogMessage( L"Created " + CValue(myPorts.GetCount()).GetAsText() + L" ports." );

        for ( LONG i = 0; i < myPorts.GetCount(); i++ )
        {
            TextureLayerPort    curPort = myPorts[i];
            app.LogMessage( CValue(i + 1L).GetAsText() + L": " + curPort.GetName() +
                L" --> " + curPort.GetTarget().GetFullName() );
        }

        myLayer.RemoveTextureLayerPort( myPorts[1] );
        myLayer.RemoveTextureLayerPort( myLayer.GetFullName() + L"." + TextureLayerPort(myPorts[2]).GetName() );

        myPorts = myLayer.GetTextureLayerPorts();
        app.LogMessage( L"Only " + CValue(myPorts.GetCount()).GetAsText() + L" remain(s) after removal." );
        for ( i = 0; i < myPorts.GetCount(); i++ )
        {
            app.LogMessage( CValue(i + 1L).GetAsText() + L": " + TextureLayerPort(myPorts[i]).GetFullName() );
        }

        // This example should output something like this:
        // INFO : "Created 3 ports."
        // INFO : "1: ambient --> sphere.Material.Phong.ambient"
        // INFO : "2: diffuse --> sphere.Material.Phong.diffuse"
        // INFO : "3: specular --> sphere.Material.Phong.specular"
        // INFO : "Only 1 remain(s) after removal."
        // INFO : "1: sphere.Material.Phong.DirtLayer.ambient"

Constructor & Destructor Documentation

Default destructor.

Constructor.

Parameters:

in_ref

constant reference object.

Copy constructor.

Parameters:

in_obj

constant class object.

Member Function Documentation

Returns the type of the API class.

Returns:

The class type.

Reimplemented from ProjectItem.

Creates an object from another object. The newly created object is set to empty if the input object is not compatible.

Parameters:

in_obj

constant class object.

Returns:

The new TextureLayerPort object.

Creates an object from a reference object. The newly created object is set to empty if the input reference object is not compatible.

Parameters:

in_ref

constant class object.

Returns:

The new TextureLayerPort object.

Reimplemented from ProjectItem.

Returns a reference to the Parameter which is driven by this port.

Returns:

The driven Parameter.

• xsi_texturelayerport.h