VuoCompilerNode.cc

Go to the documentation of this file.

 
#include <sstream>
 
#include "VuoCompilerCodeGenUtilities.hh"
#include "VuoCompilerConstantsCache.hh"
#include "VuoCompilerException.hh"
#include "VuoCompilerInputDataClass.hh"
#include "VuoCompilerInputEventPort.hh"
#include "VuoCompilerInstanceData.hh"
#include "VuoCompilerIssue.hh"
#include "VuoCompilerNode.hh"
#include "VuoCompilerNodeClass.hh"
#include "VuoCompilerOutputEventPort.hh"
#include "VuoCompilerTriggerPort.hh"
#include "VuoCompilerType.hh"
#include "VuoNode.hh"
#include "VuoNodeClass.hh"
#include "VuoPort.hh"
#include "VuoStringUtilities.hh"
#include "VuoType.hh"
 
 
VuoCompilerNode::VuoCompilerNode(VuoNode *baseNode)
    : VuoBaseDetail<VuoNode>("VuoNode", baseNode)
{
    getBase()->setCompiler(this);
 
    instanceData = NULL;
    VuoCompilerInstanceDataClass *instanceDataClass = getBase()->getNodeClass()->getCompiler()->getInstanceDataClass();
    if (instanceDataClass)
        instanceData = new VuoCompilerInstanceData(instanceDataClass);
 
    graphvizIdentifier = getGraphvizIdentifierPrefix();
 
    constantsCache = NULL;
    indexInOrderedNodes = ULONG_MAX - 1;
}
 
void VuoCompilerNode::setIndexInOrderedNodes(size_t indexInOrderedNodes)
{
    this->indexInOrderedNodes = indexInOrderedNodes;
}
 
size_t VuoCompilerNode::getIndexInOrderedNodes(void)
{
    return indexInOrderedNodes;
}
 
void VuoCompilerNode::setConstantsCache(VuoCompilerConstantsCache *constantsCache)
{
    this->constantsCache = constantsCache;
 
    vector<VuoPort *> inputPorts = getBase()->getInputPorts();
    vector<VuoPort *> outputPorts = getBase()->getOutputPorts();
    vector<VuoPort *> ports;
    ports.insert(ports.end(), inputPorts.begin(), inputPorts.end());
    ports.insert(ports.end(), outputPorts.begin(), outputPorts.end());
    for (vector<VuoPort *>::iterator i = ports.begin(); i != ports.end(); ++i)
    {
        VuoCompilerPort *port = static_cast<VuoCompilerPort *>( (*i)->getCompiler() );
        port->setConstantsCache(constantsCache);
    }
}
 
Value * VuoCompilerNode::generateIdentifierValue(Module *module)
{
    return constantsCache->get(getIdentifier());
}
 
Value * VuoCompilerNode::generateSubcompositionIdentifierValue(Module *module, BasicBlock *block, Value *compositionIdentifierValue)
{
    vector<Value *> identifierParts;
    identifierParts.push_back(compositionIdentifierValue);
    identifierParts.push_back(constantsCache->get("/" + getIdentifier()));
    return VuoCompilerCodeGenUtilities::generateStringConcatenation(module, block, identifierParts, constantsCache);
}
 
Value * VuoCompilerNode::generateGetContext(Module *module, BasicBlock *block, Value *compositionStateValue)
{
    return VuoCompilerCodeGenUtilities::generateGetNodeContext(module, block, compositionStateValue, indexInOrderedNodes);
}
 
void VuoCompilerNode::generateAddMetadata(Module *module, BasicBlock *block, Value *compositionStateValue,
                                          const vector<VuoCompilerType *> &orderedTypes,
                                          Function *compositionCreateContextForNode,
                                          Function *compositionSetPortValueFunction, Function *compositionGetPortValueFunction,
                                          Function *compositionFireTriggerPortEventFunction, Function *compositionReleasePortDataFunction)
{
    Function *subcompositionFunctionSrc = getBase()->getNodeClass()->getCompiler()->getCompositionAddNodeMetadataFunction();
 
    Value *nodeIdentifierValue = generateIdentifierValue(module);
    VuoCompilerCodeGenUtilities::generateAddNodeMetadata(module, block, compositionStateValue, nodeIdentifierValue,
                                                         compositionCreateContextForNode, compositionSetPortValueFunction,
                                                         compositionGetPortValueFunction, compositionFireTriggerPortEventFunction,
                                                         compositionReleasePortDataFunction);
 
    vector<VuoPort *> inputPorts = getBase()->getInputPorts();
    vector<VuoPort *> outputPorts = getBase()->getOutputPorts();
    vector<VuoPort *> ports;
    ports.insert(ports.end(), inputPorts.begin(), inputPorts.end());
    ports.insert(ports.end(), outputPorts.begin(), outputPorts.end());
    for (vector<VuoPort *>::iterator i = ports.begin(); i != ports.end(); ++i)
    {
        VuoCompilerPort *port = static_cast<VuoCompilerPort *>( (*i)->getCompiler() );
 
        Value *portIdentifierValue = constantsCache->get(port->getIdentifier());
        Value *portNameValue = constantsCache->get(port->getBase()->getClass()->getName());
 
        size_t typeIndex;
        string initialValue;
 
        VuoType *dataType = port->getDataVuoType();
        if (dataType)
        {
            vector<VuoCompilerType *>::const_iterator typeIter = find(orderedTypes.begin(), orderedTypes.end(), dataType->getCompiler());
            typeIndex = typeIter - orderedTypes.begin();
 
            VuoCompilerInputEventPort *inputEventPort = dynamic_cast<VuoCompilerInputEventPort *>(port);
            initialValue = (inputEventPort ? inputEventPort->getData()->getInitialValue() : "");
        }
        else
        {
            typeIndex = orderedTypes.size();
        }
 
        Value *initialValueValue = constantsCache->get(initialValue);
 
        VuoCompilerCodeGenUtilities::generateAddPortMetadata(module, block, compositionStateValue, portIdentifierValue,
                                                             portNameValue, typeIndex, initialValueValue);
    }
 
    if (subcompositionFunctionSrc)
    {
        Value *runtimeStateValue = VuoCompilerCodeGenUtilities::generateGetCompositionStateRuntimeState(module, block, compositionStateValue);
        Value *compositionIdentifierValue = VuoCompilerCodeGenUtilities::generateGetCompositionStateCompositionIdentifier(module, block, compositionStateValue);
        Value *subcompositionIdentifierValue = generateSubcompositionIdentifierValue(module, block, compositionIdentifierValue);
        Value *subcompositionStateValue = VuoCompilerCodeGenUtilities::generateCreateCompositionState(module, block, runtimeStateValue, subcompositionIdentifierValue);
 
        Function *subcompositionFunctionDst = VuoCompilerModule::declareFunctionInModule(module, subcompositionFunctionSrc);
        Value *arg = new BitCastInst(subcompositionStateValue, subcompositionFunctionDst->getFunctionType()->getParamType(0), "", block);
        CallInst::Create(subcompositionFunctionDst, arg, "", block);
 
        VuoCompilerCodeGenUtilities::generateFreeCompositionState(module, block, subcompositionStateValue);
        VuoCompilerCodeGenUtilities::generateFreeCall(module, block, subcompositionIdentifierValue);
    }
}
 
Value * VuoCompilerNode::generateCreateContext(Module *module, BasicBlock *block)
{
    // Create the node context.
 
    bool isSubcomposition = getBase()->getNodeClass()->getCompiler()->isSubcomposition();
    unsigned long publishedOutputPortCount = (isSubcomposition ?
                                                  getBase()->getOutputPorts().size() - VuoNodeClass::unreservedOutputPortStartIndex : 0);
 
    Value * nodeContextValue = VuoCompilerCodeGenUtilities::generateCreateNodeContext(module, block, instanceData, isSubcomposition, publishedOutputPortCount);
 
    // Create each port's context.
 
    vector<VuoPort *> inputPorts = getBase()->getInputPorts();
    vector<VuoPort *> outputPorts = getBase()->getOutputPorts();
    vector<VuoPort *> ports;
    ports.insert(ports.end(), inputPorts.begin(), inputPorts.end());
    ports.insert(ports.end(), outputPorts.begin(), outputPorts.end());
    vector<Value *> portContextValues;
    for (vector<VuoPort *>::iterator i = ports.begin(); i != ports.end(); ++i)
    {
        VuoCompilerPort *port = static_cast<VuoCompilerPort *>( (*i)->getCompiler() );
 
        Value *portContextValue = port->generateCreatePortContext(module, block);
        portContextValues.push_back(portContextValue);
    }
 
    VuoCompilerCodeGenUtilities::generateSetNodeContextPortContexts(module, block, nodeContextValue, portContextValues);
 
    return nodeContextValue;
}
 
void VuoCompilerNode::generateEventFunctionCall(Module *module, Function *function, BasicBlock *&currentBlock,
                                                Value *compositionStateValue)
{
    Function *functionSrc = getBase()->getNodeClass()->getCompiler()->getEventFunction();
 
    Value *nodeContextValue = generateGetContext(module, currentBlock, compositionStateValue);
 
    map<VuoCompilerEventPort *, Value *> portContextForEventPort;
    vector<VuoPort *> inputPorts = getBase()->getInputPorts();
    vector<VuoPort *> outputPorts = getBase()->getOutputPorts();
    vector<VuoPort *> ports;
    ports.insert(ports.end(), inputPorts.begin(), inputPorts.end());
    ports.insert(ports.end(), outputPorts.begin(), outputPorts.end());
    for (vector<VuoPort *>::iterator i = ports.begin(); i != ports.end(); ++i)
    {
        VuoCompilerEventPort *eventPort = dynamic_cast<VuoCompilerEventPort *>((*i)->getCompiler());
        if (eventPort)
            portContextForEventPort[eventPort] = eventPort->generateGetPortContext(module, currentBlock, nodeContextValue);
    }
 
    generateFunctionCall(functionSrc, module, currentBlock, compositionStateValue, nodeContextValue, portContextForEventPort);
 
    // The output port should transmit an event if any non-blocking input port received the event.
    // The output port should not transmit an event if no non-blocking or door input ports received the event.
    // Otherwise, the output port's event transmission is handled by the node class implementation.
 
    vector<VuoPort *> nonBlockingInputPorts;
    vector<VuoPort *> doorInputPorts;
    for (vector<VuoPort *>::iterator i = inputPorts.begin(); i != inputPorts.end(); ++i)
    {
        VuoPortClass::EventBlocking eventBlocking = (*i)->getClass()->getEventBlocking();
        if (eventBlocking == VuoPortClass::EventBlocking_None)
            nonBlockingInputPorts.push_back(*i);
        else if (eventBlocking == VuoPortClass::EventBlocking_Door)
            doorInputPorts.push_back(*i);
    }
 
    Value *eventHitNonBlockingInputPort = generateReceivedEventCondition(module, currentBlock, nodeContextValue, nonBlockingInputPorts,
                                                                         portContextForEventPort);
    Value *transmitForAllOutputPorts = eventHitNonBlockingInputPort;
 
    BasicBlock *handleTransmissionBlock = NULL;
    BasicBlock *nextBlock = NULL;
    if (! doorInputPorts.empty())
    {
        handleTransmissionBlock = BasicBlock::Create(module->getContext(), "handleTransmission", function, 0);
        nextBlock = BasicBlock::Create(module->getContext(), "next", function, 0);
 
        Value *eventHitDoorInputPort = generateReceivedEventCondition(module, currentBlock, nodeContextValue, doorInputPorts,
                                                                      portContextForEventPort);
 
        Value *blockForAllOutputPorts = BinaryOperator::Create(Instruction::And,
                                                               BinaryOperator::CreateNot(eventHitNonBlockingInputPort, "", currentBlock),
                                                               BinaryOperator::CreateNot(eventHitDoorInputPort, "", currentBlock),
                                                               "", currentBlock);
        Value *handleTransmission = BinaryOperator::Create(Instruction::Or, transmitForAllOutputPorts, blockForAllOutputPorts, "", currentBlock);
 
        Constant *zeroValue = ConstantInt::get(transmitForAllOutputPorts->getType(), 0);
        ICmpInst *handleTransmissionComparison = new ICmpInst(*currentBlock, ICmpInst::ICMP_NE, handleTransmission, zeroValue, "");
        BranchInst::Create(handleTransmissionBlock, nextBlock, handleTransmissionComparison, currentBlock);
    }
    else
    {
        handleTransmissionBlock = currentBlock;
    }
 
    for (vector<VuoPort *>::iterator i = outputPorts.begin(); i != outputPorts.end(); ++i)
    {
        VuoCompilerOutputEventPort *eventPort = dynamic_cast<VuoCompilerOutputEventPort *>((*i)->getCompiler());
        if (eventPort)
        {
            Value *portContextValue = portContextForEventPort[eventPort];
            eventPort->generateStoreEvent(module, handleTransmissionBlock, nodeContextValue, transmitForAllOutputPorts, portContextValue);
        }
    }
 
    if (! doorInputPorts.empty())
    {
        BranchInst::Create(nextBlock, handleTransmissionBlock);
        currentBlock = nextBlock;
    }
}
 
void VuoCompilerNode::generateInitFunctionCall(Module *module, BasicBlock *block, Value *compositionStateValue)
{
    Function *functionSrc = getBase()->getNodeClass()->getCompiler()->getInitFunction();
 
    Value *nodeContextValue = generateGetContext(module, block, compositionStateValue);
    CallInst *call = generateFunctionCall(functionSrc, module, block, compositionStateValue, nodeContextValue);
 
    Type *instanceDataType = instanceData->getType();
    Value *callCasted = VuoCompilerCodeGenUtilities::generateTypeCast(module, block, call, instanceDataType);
    instanceData->generateStore(module, block, nodeContextValue, callCasted);
 
    // Retain the instance data.
    Value *instanceDataValue = instanceData->generateLoad(module, block, nodeContextValue);
    VuoCompilerCodeGenUtilities::generateRetainCall(module, block, instanceDataValue);
}
 
void VuoCompilerNode::generateFiniFunctionCall(Module *module, BasicBlock *block, Value *compositionStateValue)
{
    Function *functionSrc = getBase()->getNodeClass()->getCompiler()->getFiniFunction();
 
    Value *nodeContextValue = generateGetContext(module, block, compositionStateValue);
    if (functionSrc)
        generateFunctionCall(functionSrc, module, block, compositionStateValue, nodeContextValue);
 
    // Release the instance data.
    Value *instanceDataValue = instanceData->generateLoad(module, block, nodeContextValue);
    VuoCompilerCodeGenUtilities::generateReleaseCall(module, block, instanceDataValue);
}
 
void VuoCompilerNode::generateCallbackStartFunctionCall(Module *module, BasicBlock *block, Value *compositionStateValue)
{
    Function *functionSrc = getBase()->getNodeClass()->getCompiler()->getCallbackStartFunction();
    if (! functionSrc)
        return;
 
    Value *nodeContextValue = generateGetContext(module, block, compositionStateValue);
    generateFunctionCall(functionSrc, module, block, compositionStateValue, nodeContextValue);
}
 
void VuoCompilerNode::generateCallbackUpdateFunctionCall(Module *module, BasicBlock *block, Value *compositionStateValue)
{
    Function *functionSrc = getBase()->getNodeClass()->getCompiler()->getCallbackUpdateFunction();
    if (! functionSrc)
        return;
 
    Value *nodeContextValue = generateGetContext(module, block, compositionStateValue);
    generateFunctionCall(functionSrc, module, block, compositionStateValue, nodeContextValue);
}
 
void VuoCompilerNode::generateCallbackStopFunctionCall(Module *module, BasicBlock *block, Value *compositionStateValue)
{
    Function *functionSrc = getBase()->getNodeClass()->getCompiler()->getCallbackStopFunction();
    if (! functionSrc)
        return;
 
    Value *nodeContextValue = generateGetContext(module, block, compositionStateValue);
    generateFunctionCall(functionSrc, module, block, compositionStateValue, nodeContextValue);
}
 
CallInst * VuoCompilerNode::generateFunctionCall(Function *functionSrc, Module *module, BasicBlock *block,
                                                 Value *compositionStateValue, Value *nodeContextValue,
                                                 const map<VuoCompilerEventPort *, Value *> &portContextForEventPort)
{
    Function *functionDst = VuoCompilerModule::declareFunctionInModule(module, functionSrc);
 
    vector<Value *> args(functionDst->getFunctionType()->getNumParams());
 
    // Set up the argument for the composition state (if a subcomposition).
    Value *subcompositionIdentifierValue = NULL;
    Value *subcompositionStateValue = NULL;
    if (getBase()->getNodeClass()->getCompiler()->isSubcomposition())
    {
        Value *runtimeStateValue = VuoCompilerCodeGenUtilities::generateGetCompositionStateRuntimeState(module, block, compositionStateValue);
        Value *compositionIdentifierValue = VuoCompilerCodeGenUtilities::generateGetCompositionStateCompositionIdentifier(module, block, compositionStateValue);
        subcompositionIdentifierValue = generateSubcompositionIdentifierValue(module, block, compositionIdentifierValue);
        subcompositionStateValue = VuoCompilerCodeGenUtilities::generateCreateCompositionState(module, block, runtimeStateValue, subcompositionIdentifierValue);
        args[0] = new BitCastInst(subcompositionStateValue, functionDst->getFunctionType()->getParamType(0), "", block);
    }
 
    // Set up the arguments for input ports.
    vector<VuoPort *> inputPorts = getBase()->getInputPorts();
    for (vector<VuoPort *>::iterator i = inputPorts.begin(); i != inputPorts.end(); ++i)
    {
        VuoCompilerInputEventPort *eventPort = dynamic_cast<VuoCompilerInputEventPort *>((*i)->getCompiler());
 
        VuoCompilerInputData *data = eventPort->getData();
        bool isEventArgumentInFunction = isArgumentInFunction(eventPort, functionSrc);
        bool isDataArgumentInFunction = data && isArgumentInFunction(data, functionSrc);
 
        if (isEventArgumentInFunction || isDataArgumentInFunction)
        {
            map<VuoCompilerEventPort *, Value *>::const_iterator iter = portContextForEventPort.find(eventPort);
            Value *portContextValue = (iter != portContextForEventPort.end() ?
                                                   iter->second :
                                                   eventPort->generateGetPortContext(module, block, nodeContextValue));
 
            if (isEventArgumentInFunction)
            {
                size_t index = getArgumentIndexInFunction(eventPort, functionSrc);
                args[index] = eventPort->generateLoadEvent(module, block, nodeContextValue, portContextValue);
            }
 
            if (isDataArgumentInFunction)
            {
                size_t index = getArgumentIndexInFunction(data, functionSrc);
                Value *pointerToDataAsVoidPointer = VuoCompilerCodeGenUtilities::generateGetPortContextDataVariableAsVoidPointer(module, block, portContextValue);
                vector<Value *> loweredArgs = eventPort->getDataType()->convertPortDataToArgs(module, block, pointerToDataAsVoidPointer,
                                                                                              functionDst->getFunctionType(), index,
                                                                                              isUnloweredStructPointerParameter(data, functionSrc));
                for (auto a : loweredArgs)
                    args[index++] = a;
            }
        }
    }
 
    // Set up the arguments for output ports.
    vector<VuoPort *> outputPorts = getBase()->getOutputPorts();
    map<VuoCompilerOutputEventPort *, Value *> outputPortDataVariables;
    map<VuoCompilerOutputEventPort *, AllocaInst *> outputPortEventVariables;
    for (vector<VuoPort *>::iterator i = outputPorts.begin(); i != outputPorts.end(); ++i)
    {
        VuoCompilerOutputEventPort *eventPort = dynamic_cast<VuoCompilerOutputEventPort *>((*i)->getCompiler());
        if (eventPort)
        {
            VuoCompilerOutputData *data = eventPort->getData();
            bool isEventArgumentInFunction = isArgumentInFunction(eventPort, functionSrc);
            bool isDataArgumentInFunction = data && isArgumentInFunction(data, functionSrc);
 
            if (isEventArgumentInFunction)
            {
                size_t index = getArgumentIndexInFunction(eventPort, functionSrc);
                PointerType *eventPointerType = static_cast<PointerType *>( functionDst->getFunctionType()->getParamType(index) );
                AllocaInst *arg = new AllocaInst(eventPointerType->getElementType(), 0, "", block);
                new StoreInst(ConstantInt::get(eventPointerType->getElementType(), 0), arg, block);
                outputPortEventVariables[eventPort] = arg;
                args[index] = arg;
            }
 
            if (isDataArgumentInFunction)
            {
                map<VuoCompilerEventPort *, Value *>::const_iterator iter = portContextForEventPort.find(eventPort);
                Value *portContextValue = (iter != portContextForEventPort.end() ?
                                                       iter->second :
                                                       eventPort->generateGetPortContext(module, block, nodeContextValue));
 
                size_t index = getArgumentIndexInFunction(data, functionSrc);
                VuoCompilerType *type = eventPort->getDataVuoType()->getCompiler();
                Value *dataPointer = VuoCompilerCodeGenUtilities::generateGetPortContextDataVariable(module, block, portContextValue, type);
                outputPortDataVariables[eventPort] = dataPointer;
 
                Value *arg = new BitCastInst(dataPointer, functionDst->getFunctionType()->getParamType(index), "dataArgumentCasted", block);
                args[index] = arg;
            }
        }
        else
        {
            VuoCompilerTriggerPort *triggerPort = (VuoCompilerTriggerPort *)((*i)->getCompiler());
            if (isArgumentInFunction(triggerPort, functionSrc))
            {
                size_t index = getArgumentIndexInFunction(triggerPort, functionSrc);
                Value *triggerFunction = triggerPort->generateLoadFunction(module, block, nodeContextValue);
                args[index] = new BitCastInst(triggerFunction, functionDst->getFunctionType()->getParamType(index), "triggerArgumentCasted", block);
            }
        }
    }
 
    // Set up the argument for the instance data (if it exists).
    Value *instanceDataVariable = NULL;
    if (instanceData && isArgumentInFunction(instanceData, functionSrc))
    {
        Type *type = instanceData->getType();
        instanceDataVariable = VuoCompilerCodeGenUtilities::generateGetNodeContextInstanceDataVariable(module, block, nodeContextValue, type);
 
        size_t index = getArgumentIndexInFunction(instanceData, functionSrc);
        Value *arg = instanceDataVariable;
        args[index] = new BitCastInst(arg, functionDst->getFunctionType()->getParamType(index), "", block);
        if (!args[index])
        {
            VUserLog("Warning: Couldn't convert argument for instance data of function %s; not generating call.", functionDst->getName().str().c_str());
            return nullptr;
        }
    }
 
    // Save the old output port values so they can be released later.
    map<VuoCompilerOutputEventPort *, Value *> oldOutputDataPointers;
    for (map<VuoCompilerOutputEventPort *, Value *>::iterator i = outputPortDataVariables.begin(); i != outputPortDataVariables.end(); ++i)
    {
        VuoCompilerOutputEventPort *eventPort = i->first;
        Value *dataVariable                   = i->second;  // For VuoText, this is `char **`
        Value *dataPointer                    = new AllocaInst(static_cast<PointerType *>(dataVariable->getType())->getElementType(), 0, "", block);  // For VuoText, this is `char **`
        Value *dataValue                      = new LoadInst(dataVariable, "", false, block);  // For VuoText, this is `char *`
        new StoreInst(dataValue, dataPointer, block);
        oldOutputDataPointers[eventPort] = dataPointer;
    }
 
    // Save the old instance data value so it can be released later.
    Value *oldInstanceDataValue = NULL;
    if (instanceDataVariable)
    {
        oldInstanceDataValue = new LoadInst(instanceDataVariable, "", false, block);
    }
 
    VuoCompilerCodeGenUtilities::generateAddCompositionStateToThreadLocalStorage(module, block, compositionStateValue);
 
    {
        int i = 0;
        for (auto arg : args)
        {
            if (!arg)
            {
                string s;
                raw_string_ostream type(s);
                functionDst->getFunctionType()->getParamType(i)->print(type);
                ostringstream argIndex;
                argIndex << i;
                string details = "When trying to generate a call to function " + functionDst->getName().str() +
                                 ", argument " + argIndex.str() + " (" + type.str() + ") was missing.";
                VuoCompilerIssue issue(VuoCompilerIssue::Error, "compiling composition", "", "", details);
                throw VuoCompilerException(issue);
            }
            ++i;
        }
    }
 
    // Call the node class's function.
    CallInst *call = CallInst::Create(functionDst, args, "", block);
 
    VuoCompilerCodeGenUtilities::generateRemoveCompositionStateFromThreadLocalStorage(module, block);
 
    // Save the output events from temporary variables to the ports.
    // (The temporary variables are needed to avoid mismatched types between the parameters and the arguments, e.g. i8* vs. i64*.)
    for (map<VuoCompilerOutputEventPort *, AllocaInst *>::iterator i = outputPortEventVariables.begin(); i != outputPortEventVariables.end(); ++i)
    {
        VuoCompilerOutputEventPort *eventPort = i->first;
        AllocaInst *eventVariable = i->second;
        Value *eventValue = new LoadInst(eventVariable, "", false, block);
        eventPort->generateStoreEvent(module, block, nodeContextValue, eventValue);
    }
 
    // Retain the new output port values.
    for (map<VuoCompilerOutputEventPort *, Value *>::iterator i = outputPortDataVariables.begin(); i != outputPortDataVariables.end(); ++i)
    {
        VuoCompilerOutputEventPort *eventPort = i->first;
        Value *dataVariable = i->second;
 
        VuoCompilerType *type = eventPort->getDataVuoType()->getCompiler();
        type->generateRetainCall(module, block, dataVariable);
    }
 
    // Release the old output port values.
    for (map<VuoCompilerOutputEventPort *, Value *>::iterator i = oldOutputDataPointers.begin(); i != oldOutputDataPointers.end(); ++i)
    {
        VuoCompilerOutputEventPort *eventPort = i->first;
        Value *oldOutputDataPointer = i->second;  // For VuoText, this is `char **`
 
        VuoCompilerType *type = eventPort->getDataVuoType()->getCompiler();
        type->generateReleaseCall(module, block, oldOutputDataPointer);
    }
 
    if (instanceDataVariable)
    {
        // Retain the new instance data value.
        Value *instanceDataValue = new LoadInst(instanceDataVariable, "", false, block);
        VuoCompilerCodeGenUtilities::generateRetainCall(module, block, instanceDataValue);
 
        // Release the old instance data value.
        VuoCompilerCodeGenUtilities::generateReleaseCall(module, block, oldInstanceDataValue);
    }
 
    if (getBase()->getNodeClass()->getCompiler()->isSubcomposition())
    {
        VuoCompilerCodeGenUtilities::generateFreeCompositionState(module, block, subcompositionStateValue);
        VuoCompilerCodeGenUtilities::generateFreeCall(module, block, subcompositionIdentifierValue);
    }
 
    return call;
}
 
bool VuoCompilerNode::isArgumentInFunction(VuoCompilerNodeArgument *argument, Function *function)
{
    VuoCompilerNodeArgumentClass *argumentClass = argument->getBase()->getClass()->getCompiler();
    if (function == getBase()->getNodeClass()->getCompiler()->getEventFunction())
        return argumentClass->isInEventFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getInitFunction())
        return argumentClass->isInInitFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackStartFunction())
        return argumentClass->isInCallbackStartFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackUpdateFunction())
        return argumentClass->isInCallbackUpdateFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackStopFunction())
        return argumentClass->isInCallbackStopFunction();
    else if (instanceData == argument &&
             (function == getBase()->getNodeClass()->getCompiler()->getFiniFunction()))
        return true;
    return false;
}
 
size_t VuoCompilerNode::getArgumentIndexInFunction(VuoCompilerNodeArgument *argument, Function *function)
{
    VuoCompilerNodeArgumentClass *argumentClass = argument->getBase()->getClass()->getCompiler();
    if (function == getBase()->getNodeClass()->getCompiler()->getEventFunction())
        return argumentClass->getIndexInEventFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getInitFunction())
        return argumentClass->getIndexInInitFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getFiniFunction())
        return (getBase()->getNodeClass()->getCompiler()->isSubcomposition() ? 1 : 0);
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackStartFunction())
        return argumentClass->getIndexInCallbackStartFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackUpdateFunction())
        return argumentClass->getIndexInCallbackUpdateFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackStopFunction())
        return argumentClass->getIndexInCallbackStopFunction();
    return 0;
}
 
bool VuoCompilerNode::isUnloweredStructPointerParameter(VuoCompilerInputData *inputData, Function *function)
{
    VuoCompilerInputDataClass *inputDataClass = static_cast<VuoCompilerInputDataClass *>(inputData->getBase()->getClass()->getCompiler());
    if (function == getBase()->getNodeClass()->getCompiler()->getEventFunction())
        return inputDataClass->isUnloweredStructPointerInEventFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getInitFunction())
        return inputDataClass->isUnloweredStructPointerInInitFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackStartFunction())
        return inputDataClass->isUnloweredStructPointerInCallbackStartFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackUpdateFunction())
        return inputDataClass->isUnloweredStructPointerInCallbackUpdateFunction();
    else if (function == getBase()->getNodeClass()->getCompiler()->getCallbackStopFunction())
        return inputDataClass->isUnloweredStructPointerInCallbackStopFunction();
    return false;
}
 
Value * VuoCompilerNode::generateReceivedEventCondition(Module *module, BasicBlock *block, Value *nodeContextValue)
{
    return generateReceivedEventCondition(module, block, nodeContextValue, getBase()->getInputPorts());
}
 
Value * VuoCompilerNode::generateReceivedEventCondition(Module *module, BasicBlock *block, Value *nodeContextValue,
                                                        vector<VuoPort *> selectedInputPorts,
                                                        const map<VuoCompilerEventPort *, Value *> &portContextForEventPort)
{
    Value *conditionValue = ConstantInt::getFalse(block->getContext());
    for (vector<VuoPort *>::iterator i = selectedInputPorts.begin(); i != selectedInputPorts.end(); ++i)
    {
        VuoCompilerInputEventPort *eventPort = dynamic_cast<VuoCompilerInputEventPort *>((*i)->getCompiler());
        if (eventPort)
        {
            map<VuoCompilerEventPort *, Value *>::const_iterator iter = portContextForEventPort.find(eventPort);
            Value *portContextValue = (iter != portContextForEventPort.end() ?
                                                   iter->second :
                                                   eventPort->generateGetPortContext(module, block, nodeContextValue));
 
            Value *pushValue = eventPort->generateLoadEvent(module, block, nodeContextValue, portContextValue);
            conditionValue = BinaryOperator::Create(Instruction::Or, conditionValue, pushValue, "", block);
        }
    }
    return conditionValue;
}
 
VuoCompilerInstanceData * VuoCompilerNode::getInstanceData(void)
{
    return instanceData;
}
 
string VuoCompilerNode::getIdentifier(void)
{
    return getGraphvizIdentifier();
}
 
string VuoCompilerNode::getGraphvizIdentifierPrefix(void)
{
    string titleWithoutSpaces = VuoStringUtilities::convertToCamelCase(getBase()->getTitle(), true, false, false);
 
    if (titleWithoutSpaces.empty())
        return "Node";
    else
        return titleWithoutSpaces;
}
 
void VuoCompilerNode::setGraphvizIdentifier(string graphvizIdentifier)
{
    this->graphvizIdentifier = graphvizIdentifier;
}
 
string VuoCompilerNode::getGraphvizIdentifier(void)
{
    return graphvizIdentifier;
}
 
string VuoCompilerNode::getGraphvizDeclaration(bool shouldPrintPosition, double xPositionOffset, double yPositionOffset,
                                               VuoPort *manuallyFirableInputPort)
{
    ostringstream declaration;
 
    vector<VuoPort *> inputPorts = getBase()->getInputPorts();
    vector<VuoPort *> outputPorts = getBase()->getOutputPorts();
 
    // name
    declaration << getGraphvizIdentifier();
 
    // type
    declaration << " [type=\"" << getBase()->getNodeClass()->getClassName() << "\"";
 
    // version
    declaration << " version=\"" << getBase()->getNodeClass()->getVersion() << "\"";
 
    // label
    declaration << " label=\"" << VuoStringUtilities::transcodeToGraphvizIdentifier(getBase()->getTitle());
    for (vector<VuoPort *>::iterator i = inputPorts.begin(); i != inputPorts.end(); ++i)
    {
        string portName = VuoStringUtilities::transcodeToGraphvizIdentifier((*i)->getClass()->getName());
        declaration << "|<" << portName << ">" << portName << "\\l";
    }
    for (vector<VuoPort *>::iterator i = outputPorts.begin(); i != outputPorts.end(); ++i)
    {
        string portName = VuoStringUtilities::transcodeToGraphvizIdentifier((*i)->getClass()->getName());
        declaration << "|<" << portName << ">" << portName << "\\r";
    }
    declaration << "\"";
 
    // position
    if (shouldPrintPosition)
        declaration << " pos=\"" << getBase()->getX()+xPositionOffset << "," << getBase()->getY()+yPositionOffset << "\"";
 
    // collapsed
    if (getBase()->isCollapsed())
        declaration << " collapsed";
 
    // tint color
    if (getBase()->getTintColor() != VuoNode::TintNone)
        declaration << " fillcolor=\"" << getBase()->getTintColorGraphvizName() << "\"";
 
    // constant values
    for (vector<VuoPort *>::iterator i = inputPorts.begin(); i != inputPorts.end(); ++i)
    {
        VuoPort *port = *i;
        VuoCompilerInputEventPort *eventPort = static_cast<VuoCompilerInputEventPort *>(port->getCompiler());
        VuoCompilerInputData *data = eventPort->getData();
        if (data && (! eventPort->hasConnectedDataCable() && ! data->getInitialValue().empty()))
        {
            string portConstant = data->getInitialValue();
            string escapedPortConstant = VuoStringUtilities::transcodeToGraphvizIdentifier(portConstant);
            declaration << " _" << port->getClass()->getName() << "=\"" << escapedPortConstant << "\"";
        }
    }
 
    // event throttling
    for (vector<VuoPort *>::iterator i = outputPorts.begin(); i != outputPorts.end(); ++i)
    {
        VuoPort *port = *i;
        if (port->getClass()->getPortType() == VuoPortClass::triggerPort)
        {
            string eventThrottling = (port->getEventThrottling() == VuoPortClass::EventThrottling_Enqueue ? "enqueue" : "drop");
            declaration << " _" << port->getClass()->getName() << "_eventThrottling=\"" << eventThrottling << "\"";
        }
    }
 
    // manually firable input port
    if (manuallyFirableInputPort)
        declaration << " _" << manuallyFirableInputPort->getClass()->getName() << "_manuallyFirable=\"yes\"";
 
    declaration << "];";
 
    return declaration.str();
}