Detailed Description

A ICENodeInputPort object represents the input port of an ICENode.

The ICENodeInputPort cannot connect to more than one ICENode. An ICENode can have more than one ICENodeInputPort.

See also:: ICENodePort, ICENodeOutputPort, ICENode::GetInputPorts

Since:: 7.0

#include <xsi_icenodeinputport.h>

Inheritance diagram for ICENodeInputPort:

[legend]

List of all members.

Public Member Functions
	ICENodeInputPort ()
	~ICENodeInputPort ()
	ICENodeInputPort (const CRef &in_ref)
	ICENodeInputPort (const ICENodeInputPort &in_obj)
bool	IsA (siClassID in_ClassID) const
siClassID	GetClassID () const
ICENodeInputPort &	operator= (const ICENodeInputPort &in_obj)
ICENodeInputPort &	operator= (const CRef &in_ref)
CValue	GetValue (double in_time=DBL_MAX) const
CStatus	PutValue (const CValue &in_val, double in_time=DBL_MAX)

Constructor & Destructor Documentation

ICENodeInputPort ( )

Default constructor.

~ICENodeInputPort ( )

Default destructor.

ICENodeInputPort ( const CRef & in_ref )

Constructor.

Parameters:

in_ref constant reference object.

ICENodeInputPort ( const ICENodeInputPort & in_obj )

Copy constructor.

Parameters:

in_obj constant class object.

Member Function Documentation

bool IsA ( siClassID in_ClassID ) const [virtual]

Returns true if a given class type is compatible with this API class.

Parameters:

in_ClassID class type.

Returns:: true if the class is compatible, false otherwise.

Reimplemented from ICENodePort.

siClassID GetClassID ( ) const [virtual]

Returns the type of the API class.

Returns:: The class type.

Reimplemented from ICENodePort.

ICENodeInputPort& operator= ( const ICENodeInputPort & in_obj )

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 ICENodeInputPort object.

ICENodeInputPort& operator= ( const CRef & in_ref )

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 ICENodeInputPort object.

Reimplemented from ICENodePort.

CValue GetValue ( double in_time = DBL_MAX ) const

Returns the port value as a CValue at a specific frame. The type of the value depends on ICENodePort::GetDataType. The value stored in this port is only accessible when the port is not connected. If the port is connected, it returns an empty CValue.

Note:: This property only returns values for simple types such as float, integer and boolean. Returning other value types is not yet supported. If the port is unable to retrieve the value, it returns an empty CValue.

Tip:: Values for non-supported types can be accessed with ICENodePort::GetParameters.

Parameters:

in_time Time in frames. Defaults to the current frame if in_time is set with DBL_MAX.

Returns:: The port value.

Example:

This example demonstrates how to get a non-connected ICENodePort value at different times

        void CreatePrim( const CString& in_presetobj, const CString& in_geometrytype, const CString& in_name, const CString& in_parent );
        CRefArray ApplyOp( const CString& in_presetobj, CString & io_connectionset, const siConstructionMode& in_constructionmode );
        CValue AddICENode( const CValue&  in_presetobj, const CValue&  in_container );
        CValue SetValue( const CString& in_target, const CValue&  in_value, const CValue& in_time );
        void AddAttributeToSetDataICENode( const CValue&  in_setdatanode, const CString& in_attributename, siComponentDataType in_attributetype, siComponentDataContext in_attributecontext, siComponentDataStructure in_attributestructure );
        void SaveKey( const CString& in_inputobjs, CValue& io_time, const CValue& in_value );

        // Create an InitNode
        CreatePrim( L"Grid", L"MeshSurface", L"", L"" );
        ApplyOp( L"ICETree", CString(L"Grid"), siConstructionModeModeling );
        ICENode initDataNode = AddICENode( L"InitializeNode", L"grid.polymsh.ICETree" );
        SetValue( L"grid.polymsh.ICETree.InitDataNode.PredefinedAttributeName", L"EdgeLength", 0 );
        AddAttributeToSetDataICENode( L"grid.polymsh.ICETree.InitDataNode", L"EdgeLength", siComponentDataTypeFloat, siComponentDataContextComponent1D, siComponentDataStructureSingle );

        // Set some keys on the new created port
        ICENodeInputPort nodePort = initDataNode.GetInputPorts().GetItem(L"EdgeLength");

        CValue frame(1.0);
        CValue val(5.0);
        SaveKey( L"grid.polymsh.ICETree.InitDataNode.EdgeLength", frame, val );

        frame = 5.0;
        val = 25.0;
        SaveKey( L"grid.polymsh.ICETree.InitDataNode.EdgeLength", frame, val );

        // Access values on the port
        Application xsi;
        xsi.LogMessage( L"EdgeLentgh value at frame 1: " + CString(nodePort.GetValue(1.0)) );

        nodePort.PutValue( 85.0, 5.0 );
        xsi.LogMessage( L"EdgeLentgh value at frame 5: " + CString(nodePort.GetValue(5.0)) );

        // Expected results:
        // INFO : EdgeLentgh value at frame 1: 5.0
        // INFO : EdgeLentgh value at frame 5: 85.0

        void CreatePrim( const CString& in_presetobj, const CString& in_geometrytype, const CString& in_name, const CString& in_parent )
        {
            CValueArray args(4);
            CValue retval;

            args[0]= in_presetobj;
            args[1]= in_geometrytype;
            args[2]= in_name;
            args[3]= in_parent;

            Application app;
            CStatus st = app.ExecuteCommand( L"CreatePrim", args, retval );

            return;
        }
        CRefArray ApplyOp( const CString& in_presetobj, CString & io_connectionset, const siConstructionMode& in_constructionmode )
        {
            CValueArray args(6);
            CValue retval;

            args[0]=in_presetobj;
            args[1]=io_connectionset;
            args[2]=(LONG)siUnspecified;
            args[3]=(LONG)siPersistentOperation;
            if ( in_constructionmode != siConstructionModeDefault )
            {
                args[5]=(LONG)in_constructionmode;
            }

            Application app;
            CStatus st = app.ExecuteCommand( L"ApplyOp", args, retval );
            io_connectionset=args[1];
            return retval;
        }
        CValue AddICENode( const CValue&  in_presetobj, const CValue&  in_container )
        {
            CValueArray args(2);
            CValue retval;

            args[0]= in_presetobj;
            args[1]= in_container;

            Application app;
            CStatus st = app.ExecuteCommand( L"AddICENode", args, retval );

            return retval;
        }
        void AddAttributeToSetDataICENode( const CValue&  in_setdatanode, const CString& in_attributename, siComponentDataType in_attributetype, siComponentDataContext in_attributecontext, siComponentDataStructure in_attributestructure )
        {
            CValueArray args(5);
            CValue retval;

            args[0]= in_setdatanode;
            args[1]= in_attributename;
            args[2]= (LONG)in_attributetype;
            args[3]= (LONG)in_attributecontext;
            args[4]= (LONG)in_attributestructure;

            Application app;
            CStatus st = app.ExecuteCommand( L"AddAttributeToSetDataICENode", args, retval );

            return;
        }
        CValue SetValue( const CString& in_target, const CValue& in_value, const CValue&  in_time )
        {
            CValueArray args(3);
            CValue retval;

            args[0]= in_target;
            args[1]= in_value;
            args[2]= in_time;

            Application app;
            CStatus st = app.ExecuteCommand( L"SetValue", args, retval );

            return retval;
        }
        void SaveKey( const CString& in_inputobjs, CValue& io_time, const CValue& in_value )
        {
            CValueArray args(8);
            CValue retval;

            args[0]= in_inputobjs;
            args[1]= io_time;
            args[2]= in_value;
            args[3]= -1;
            args[4]= -1;
            args[5]= false;
            args[6]= 0;

            Application app;
            app.ExecuteCommand( L"SaveKey", args, retval );

            io_time = args[1];
            return;
        }

CStatus PutValue	(	const CValue &	in_val,
		double	in_time = `DBL_MAX`
	)

Sets the port value as a CValue at a specific frame. The type of the value depends on ICENodePort::GetDataType. This method can be used only when the port is not connected. If the port is connected, the method has no effect.

Note:: Only simple types such as float, integer and boolean are supported. Other value types are not yet supported.

Tip:: Values for non-supported types can be set with ICENodePort.GetParameters.

Parameters:

in_val	The port value to set.
in_time	Time in frames. Defaults to the current frame if `in_time` is set with `DBL_MAX`.

Returns:: CStatus::OK success; CStatus::False Trying to set an un-supported value type.; CStatus::Fail Other failure.

Example:

This example demonstrates how to set a non-connected Node port value at different times

        void CreatePrim( const CString& in_presetobj, const CString& in_geometrytype, const CString& in_name, const CString& in_parent );
        CRefArray ApplyOp( const CString& in_presetobj, CString & io_connectionset, const siConstructionMode& in_constructionmode );
        CValue AddICENode( const CValue&  in_presetobj, const CValue&  in_container );
        CValue SetValue( const CString& in_target, const CValue&  in_value, const CValue& in_time );
        void AddAttributeToSetDataICENode( const CValue&  in_setdatanode, const CString& in_attributename, siComponentDataType in_attributetype, siComponentDataContext in_attributecontext, siComponentDataStructure in_attributestructure );
        void SaveKey( const CString& in_inputobjs, CValue& io_time, const CValue& in_value );

        // Create an InitNode
        CreatePrim( L"Grid", L"MeshSurface", L"", L"" );
        ApplyOp( L"ICETree", CString(L"Grid"), siConstructionModeModeling );
        ICENode initDataNode = AddICENode( L"InitializeNode", L"grid.polymsh.ICETree" );
        SetValue( L"grid.polymsh.ICETree.InitDataNode.PredefinedAttributeName", L"EdgeLength", 0 );
        AddAttributeToSetDataICENode( L"grid.polymsh.ICETree.InitDataNode", L"EdgeLength", siComponentDataTypeFloat, siComponentDataContextComponent1D, siComponentDataStructureSingle );

        // Set some keys on the new created port
        ICENodeInputPort nodePort = initDataNode.GetInputPorts().GetItem(L"EdgeLength");

        CValue frame(1.0);
        CValue val(5.0);
        SaveKey( L"grid.polymsh.ICETree.InitDataNode.EdgeLength", frame, val );

        frame = 5.0;
        val = 25.0;
        SaveKey( L"grid.polymsh.ICETree.InitDataNode.EdgeLength", frame, val );

        // Access values on the port
        Application xsi;
        xsi.LogMessage( L"EdgeLentgh value at frame 1: " + CString(nodePort.GetValue(1.0)) );

        nodePort.PutValue( 85.0, 5.0 );
        xsi.LogMessage( L"EdgeLentgh value at frame 5: " + CString(nodePort.GetValue(5.0)) );

        // Expected results:
        // INFO : EdgeLentgh value at frame 1: 5.0
        // INFO : EdgeLentgh value at frame 5: 85.0

        void CreatePrim( const CString& in_presetobj, const CString& in_geometrytype, const CString& in_name, const CString& in_parent )
        {
            CValueArray args(4);
            CValue retval;

            args[0]= in_presetobj;
            args[1]= in_geometrytype;
            args[2]= in_name;
            args[3]= in_parent;

            Application app;
            CStatus st = app.ExecuteCommand( L"CreatePrim", args, retval );

            return;
        }
        CRefArray ApplyOp( const CString& in_presetobj, CString & io_connectionset, const siConstructionMode& in_constructionmode )
        {
            CValueArray args(6);
            CValue retval;

            args[0]=in_presetobj;
            args[1]=io_connectionset;
            args[2]=(LONG)siUnspecified;
            args[3]=(LONG)siPersistentOperation;
            if ( in_constructionmode != siConstructionModeDefault )
            {
                args[5]=(LONG)in_constructionmode;
            }

            Application app;
            CStatus st = app.ExecuteCommand( L"ApplyOp", args, retval );
            io_connectionset=args[1];
            return retval;
        }
        CValue AddICENode( const CValue&  in_presetobj, const CValue&  in_container )
        {
            CValueArray args(2);
            CValue retval;

            args[0]= in_presetobj;
            args[1]= in_container;

            Application app;
            CStatus st = app.ExecuteCommand( L"AddICENode", args, retval );

            return retval;
        }
        void AddAttributeToSetDataICENode( const CValue&  in_setdatanode, const CString& in_attributename, siComponentDataType in_attributetype, siComponentDataContext in_attributecontext, siComponentDataStructure in_attributestructure )
        {
            CValueArray args(5);
            CValue retval;

            args[0]= in_setdatanode;
            args[1]= in_attributename;
            args[2]= (LONG)in_attributetype;
            args[3]= (LONG)in_attributecontext;
            args[4]= (LONG)in_attributestructure;

            Application app;
            CStatus st = app.ExecuteCommand( L"AddAttributeToSetDataICENode", args, retval );

            return;
        }
        CValue SetValue( const CString& in_target, const CValue& in_value, const CValue&  in_time )
        {
            CValueArray args(3);
            CValue retval;

            args[0]= in_target;
            args[1]= in_value;
            args[2]= in_time;

            Application app;
            CStatus st = app.ExecuteCommand( L"SetValue", args, retval );

            return retval;
        }
        void SaveKey( const CString& in_inputobjs, CValue& io_time, const CValue& in_value )
        {
            CValueArray args(8);
            CValue retval;

            args[0]= in_inputobjs;
            args[1]= io_time;
            args[2]= in_value;
            args[3]= -1;
            args[4]= -1;
            args[5]= false;
            args[6]= 0;

            Application app;
            app.ExecuteCommand( L"SaveKey", args, retval );

            io_time = args[1];
            return;
        }

The documentation for this class was generated from the following file:

xsi_icenodeinputport.h

Detailed Description

Public Member Functions

Constructor & Destructor Documentation

Member Function Documentation