Houdini Engine 3.2
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
Node Creation Sample

For documentation on the nodes APIs, see Nodes.

Simple example that checks for editable node networks, queries child nodes, creates a node, renames it, connects it to existing nodes, and then deletes it.

#include <HAPI/HAPI.h>
#include <iostream>
#include <string>
#include <vector>
#define ENSURE_SUCCESS( result ) \
if ( (result) != HAPI_RESULT_SUCCESS ) \
{ \
std::cout << "Failure at " << __FILE__ << ": " << __LINE__ << std::endl; \
std::cout << getLastError() << std::endl; \
exit( 1 ); \
}
#define ENSURE_COOK_SUCCESS( result ) \
if ( (result) != HAPI_RESULT_SUCCESS ) \
{ \
std::cout << "Failure at " << __FILE__ << ": " << __LINE__ << std::endl; \
std::cout << getLastCookError() << std::endl; \
exit( 1 ); \
}
static std::string getLastError();
static std::string getLastCookError();
static std::string getString( HAPI_StringHandle stringHandle );
static void printChildNodeInfo( HAPI_Session &session, std::vector< HAPI_NodeId > &childrenNodes);
int
main( int argc, char ** argv )
{
const char * hdaFile = argc == 2 ? argv[ 1 ] : "examples/FourShapes.hda";
HAPI_Session session;
bool bUseInProcess = false;
if(bUseInProcess)
{
// Creates an in process session
}
else
{
// Start and connect to an out of process session
HAPI_ThriftServerOptions serverOptions{ 0 };
serverOptions.autoClose = true;
serverOptions.timeoutMs = 3000.0f;
// Start a HARS named-pipe server named "hapi"
ENSURE_SUCCESS( HAPI_StartThriftNamedPipeServer(&serverOptions, "hapi", nullptr) );
// and create a new HAPI session to use that server
ENSURE_SUCCESS( HAPI_CreateThriftNamedPipeSession(&session, "hapi") );
}
ENSURE_SUCCESS( HAPI_Initialize( &session,
&cookOptions,
true,
-1,
nullptr,
nullptr,
nullptr,
nullptr,
nullptr ) );
HAPI_AssetLibraryId assetLibId;
ENSURE_SUCCESS( HAPI_LoadAssetLibraryFromFile( &session, hdaFile, true, &assetLibId ) );
int assetCount;
ENSURE_SUCCESS( HAPI_GetAvailableAssetCount( &session, assetLibId, &assetCount ) );
if (assetCount > 1)
{
std::cout << "Should only be loading 1 asset here" << std::endl;
exit ( 1 );
}
ENSURE_SUCCESS( HAPI_GetAvailableAssets( &session, assetLibId, &assetSh, assetCount ) );
std::string assetName = getString( assetSh );
HAPI_NodeId editableNetworkId;
ENSURE_SUCCESS( HAPI_CreateNode( &session, -1, assetName.c_str(), "FourShapes", false, &editableNetworkId ) );
ENSURE_SUCCESS( HAPI_CookNode( &session, editableNetworkId, &cookOptions ) );
int cookStatus;
HAPI_Result cookResult;
do
{
cookResult = HAPI_GetStatus( &session, HAPI_STATUS_COOK_STATE, &cookStatus );
}
while ( cookStatus > HAPI_STATE_MAX_READY_STATE && cookResult == HAPI_RESULT_SUCCESS );
ENSURE_SUCCESS( cookResult );
ENSURE_COOK_SUCCESS( cookStatus );
int childCount;
ENSURE_SUCCESS( HAPI_ComposeChildNodeList( &session, editableNetworkId,
false, &childCount ) );
std::cout << "Editable Node Network Child Count: "
<< childCount << std::endl;
std::vector< HAPI_NodeId > childNodeIds( childCount );
ENSURE_SUCCESS( HAPI_GetComposedChildNodeList( &session, editableNetworkId,
&childNodeIds.front(), childCount ) );
printChildNodeInfo( session, childNodeIds );
HAPI_NodeId anotherBoxNode;
ENSURE_SUCCESS( HAPI_CreateNode( &session, editableNetworkId, "geo",
"ProgrammaticBox", false, &anotherBoxNode ) );
ENSURE_SUCCESS( HAPI_ConnectNodeInput( &session, anotherBoxNode, 0, childNodeIds[ 0 ], 0 ) );
ENSURE_SUCCESS( HAPI_CookNode( &session, anotherBoxNode, &cookOptions ) );
int boxCookStatus;
HAPI_Result boxCookResult;
do
{
boxCookResult = HAPI_GetStatus( &session, HAPI_STATUS_COOK_STATE, &boxCookStatus );
}
while ( boxCookStatus > HAPI_STATE_MAX_READY_STATE && boxCookResult == HAPI_RESULT_SUCCESS );
ENSURE_SUCCESS( boxCookResult );
ENSURE_COOK_SUCCESS( boxCookStatus );
// Confirm the connection
HAPI_NodeId connectedNodeId;
ENSURE_SUCCESS( HAPI_QueryNodeInput( &session, anotherBoxNode, 0, &connectedNodeId ) );
if ( connectedNodeId != childNodeIds[ 0 ] )
{
std::cout << "The connected node id is " << connectedNodeId << " when it should be "
<< editableNetworkId << std::endl;
exit ( 1 );
}
ENSURE_SUCCESS( HAPI_ComposeChildNodeList( &session, editableNetworkId,
false, &childCount ) );
std::vector < HAPI_NodeId > newChildNodes ( childCount );
ENSURE_SUCCESS( HAPI_GetComposedChildNodeList( &session, editableNetworkId,
&newChildNodes.front(), childCount ) );
std::cout << "After CONNECT NODE" << std::endl;
printChildNodeInfo( session, newChildNodes );
ENSURE_SUCCESS( HAPI_SaveHIPFile( &session, "examples/modifiedScene.hip", false ) );
ENSURE_SUCCESS( HAPI_DisconnectNodeInput( &session, anotherBoxNode, 0 ) );
ENSURE_SUCCESS( HAPI_DeleteNode( &session, anotherBoxNode ) );
std::cout << "After DELETING NODE" << std::endl;
ENSURE_SUCCESS( HAPI_ComposeChildNodeList( &session, editableNetworkId,
false, &childCount ) );
std::vector < HAPI_NodeId > finalChildList ( childCount );
ENSURE_SUCCESS( HAPI_GetComposedChildNodeList( &session, editableNetworkId,
&finalChildList.front(), childCount ) );
printChildNodeInfo( session, finalChildList );
char in;
std::cout << "Press any key to exit" << std::endl;
std::cin >> in;
HAPI_Cleanup( &session );
return 0;
}
static void printChildNodeInfo( HAPI_Session &session, std::vector< HAPI_NodeId > &childrenNodes )
{
std::cout << "Child Node Ids" << std::endl;
for ( int i = 0; i < childrenNodes.size(); ++i )
{
ENSURE_SUCCESS( HAPI_GetNodeInfo( &session, childrenNodes[ i ], &nInfo ) );
std::cout << " "
<< childrenNodes[ i ]
<< " - "
<< ( nInfo.createdPostAssetLoad ? "NEW" : "EXISTING" )
<< std::endl;
}
}
static std::string
getLastError()
{
int bufferLength;
&bufferLength );
char * buffer = new char[ bufferLength ];
HAPI_GetStatusString( nullptr, HAPI_STATUS_CALL_RESULT, buffer, bufferLength );
std::string result( buffer );
delete [] buffer;
return result;
}
static std::string
getLastCookError()
{
int bufferLength;
&bufferLength );
char * buffer = new char[ bufferLength ];
HAPI_GetStatusString( nullptr, HAPI_STATUS_COOK_RESULT, buffer, bufferLength );
std::string result( buffer );
delete[] buffer;
return result;
}
static std::string
getString( HAPI_StringHandle stringHandle )
{
if ( stringHandle == 0 )
{
return "";
}
int bufferLength;
stringHandle,
&bufferLength );
char * buffer = new char[ bufferLength ];
HAPI_GetString ( nullptr, stringHandle, buffer, bufferLength );
std::string result( buffer );
delete [] buffer;
return result;
}