SOP_NodeVerb.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * NAME:        SOP_NodeVerb.h ( SOP Library, C++)
 *
 * COMMENTS:
 *      Verb-based API for SOP cooking mechanisms.  SOPs can return
 *      one of these objects to describe how they cook, allowing the
 *      cook engine to perform additional optimizations.
 */

#ifndef __SOP_NodeVerb_h__
#define __SOP_NodeVerb_h__

#include "SOP_API.h"
#include "SOP_Node.h"
#include <OP/OP_Director.h>
#include <OP/OP_NodeParms.h>
#include <OP/OP_NodeVerb.h>
#include <OP/OP_GraphProxy.h>
#include <PRM/PRM_Parm.h>
#include <UT/UT_Array.h>
#include <UT/UT_Assert.h>
#include <SYS/SYS_Types.h>

#include <initializer_list>

#include <VEX/VEX_PodTypes.h>
template <VEX_Precision PREC> class CVEX_ContextT;
using CVEX_Context = CVEX_ContextT<VEX_32>;
class CVEX_Function;
class DEP_MicroNode;
class SOP_GraphProxy;

class SOP_API SOP_CVEXDataBacking
{
public:
    int64 getMemoryUsage(bool inclusive) const
    {
        int64 mem = inclusive ? sizeof(*this) : 0;
        mem += UTarrayDeepMemoryUsage(stringdata, false);
        return mem;
    }

public:
    fpreal32            floatdata[16];
    int32               intdata;
    UT_Array<UT_StringHolder>   stringdata;
};

class SOP_API SOP_NodeCache : public OP_NodeCache
{
protected:
    friend class SOP_NodeParms;
};

class SOP_API SOP_NodeParms : public OP_NodeParms
{
public:
             SOP_NodeParms() {}

    /// Overloads all the parameters according to matching attributes
    /// in provided geometry.
    bool         applyGeometryOverride(GU_ConstDetailHandle gdh);

    /// Detects specially named parameters, cooks required inputs using
    /// the traditional cook engine.
    bool         applyGeometryOverrideFromNode(
                            SOP_Node *node, OP_Context &context,
                            SOP_NodeCache *cache);
    /// Returns if the node has the specially named parameters that
    /// may require a parameter override.  This will disable traditional
    /// cooking.
    static bool  nodeHasGeometryOverride(SOP_Node *node, OP_Context &context);

protected:
};


///
/// SOP_NodeVerb
///
/// This should be a singleton class.  Build it with the Register
/// template to allow it to be discoverable by name.
///
class SOP_API SOP_NodeVerb : public OP_NodeVerb
{
public:
             SOP_NodeVerb() {}

    virtual SOP_NodeCache       *allocCache() const
                                    { return new SOP_NodeCache; }
    virtual SOP_NodeParms       *allocParms() const = 0;

    OP_NodeCache                *baseAllocCache() const override final
                                    { return allocCache(); }
    OP_NodeParms                *baseAllocParms() const override final
                                    { return allocParms(); }

    // UT_StringHolder           name() override const = 0;

    OP_OpTypeId                  category() const override 
                                    { return SOP_OPTYPE_ID; }

    /// Finds a verb which matches the given name
    static const SOP_NodeVerb   *lookupVerb(const UT_StringRef &name);
    static void                  listVerbs(UT_StringArray &verbnames);

    class SOP_API NodeExecuteInfo
    {
    public:
        void            clear()
        {
            myExprInputs.clear();
            myTimeDeps.clear();
        }
        void setExprInputs(const UT_Array<GU_ConstDetailHandle> &inputs,
                           const UT_IntArray &timedeps)
        {
            myExprInputs = inputs;
            myTimeDeps = timedeps;
        }
        const UT_Array<GU_ConstDetailHandle> &exprinputs() const { return myExprInputs; }
        const UT_IntArray &timedeps() const { return myTimeDeps; }

    protected:
        UT_Array<GU_ConstDetailHandle>  myExprInputs;
        UT_IntArray                     myTimeDeps;
    };

    class ForbiddenNodeMap
    {
    public:
        const NodeExecuteInfo *findOpNode(const OP_Node *op) const
        {
            auto && info = myOpNodeMap.find(op);
            if (info == myOpNodeMap.end()) return nullptr;
            return &info->second;
        }

        const NodeExecuteInfo *find(OP_GraphProxy::NodeOrIdx nodeoridx) const
        {
            if (nodeoridx.node())
            {
                auto && info = myOpNodeMap.find(nodeoridx.node());
                if (info == myOpNodeMap.end()) return nullptr;
                return &info->second;
            }
            auto && info = myIndexMap.find(nodeoridx.index());
            if (info == myIndexMap.end()) return nullptr;
            return &info->second;
        }

        NodeExecuteInfo         &info(OP_GraphProxy::NodeOrIdx nodeoridx)
        {
            if (nodeoridx.node())
                return myOpNodeMap[nodeoridx.node()];
            return myIndexMap[nodeoridx.index()];
        }

        exint                   size() const { return myOpNodeMap.size() + myIndexMap.size(); }
        bool                    contains(const OP_Node *op) const
        { return myOpNodeMap.contains(op); }
        bool                    contains(OP_GraphProxy::NodeOrIdx nodeoridx) const
        { 
            if (nodeoridx.node()) return myOpNodeMap.contains(nodeoridx.node());
            return myIndexMap.contains(nodeoridx.index());
        }

        UT_Map<const OP_Node *, NodeExecuteInfo> &opNodeMapNC() { return myOpNodeMap; }
        const UT_Map<const OP_Node *, NodeExecuteInfo> &opNodeMap() const { return myOpNodeMap; }

        void                    clearExecuteInfo()
        {
            for (auto && noderef : myOpNodeMap)
            {
                noderef.second.clear();
            }
        }

    private:
        UT_Map<const OP_Node *, NodeExecuteInfo> myOpNodeMap;
        UT_Map<OP_GraphProxy::NodeIdx, NodeExecuteInfo> myIndexMap;
    };

    /// During execution of a verb chain you may wish to disable
    /// the traditional cooking of nodes.  This provides a set of
    /// nodes you do not want recursed into during the verb cook.
    /// It will be NULL if there are none or this thread isn't in
    /// a compiled execution path.
    static const ForbiddenNodeMap *forbiddenNodes();
    static const ForbiddenNodeMap *forbiddenNodes(int thread);

    /// This scope class will push the given list of nodes marking
    /// them as inelligible for cooking in the traditional path.
    /// Needless to say, the invoker needs to ensure the set's lifetime
    /// persists.
    class SOP_API ScopeForbiddenNodes
    {
    public:
        ScopeForbiddenNodes(const ForbiddenNodeMap *forbiddennodes);
        ~ScopeForbiddenNodes();

        ScopeForbiddenNodes(const ScopeForbiddenNodes &) = delete;
        ScopeForbiddenNodes &operator=(const ScopeForbiddenNodes &) = delete;
    protected:
        const ForbiddenNodeMap          *myPrevNodes;
    };

    enum CookMode
    {
        // With in place the destination gdp will be the first input or
        // a copy.
        // The first input will be null.
        COOK_INPLACE,
        // With duplicate, the destination gdp will be a copy of the
        // first input.  All inputs will be valid.
        COOK_DUPLICATE,
        // With generator, the destination gdp is empty, possibly
        // a stashAll().  All inputs will be valid.
        COOK_GENERATOR,
        // With instance, the destination gdp is invalid.  All inputs
        // will be valid.
        COOK_INSTANCE,
        // There will be a destination gdp, but its contents are unspecified
        // It may contain the results of the last cook. All inputs are
        // valid.
        COOK_GENERIC,
        // If cookMode is pass through, the cook method will not be
        // invoked at all.  Instead, the first input will be passed through
        // unchanged.  If there is no first input, an empty gdp is
        // created.
        COOK_PASSTHROUGH,
    };

    class SOP_API NodeInputs
    {
    public:
                 NodeInputs() {}
        virtual ~NodeInputs() {}

        NodeInputs(const NodeInputs &) = delete;
        NodeInputs &operator=(const NodeInputs &) = delete;

        virtual exint   nInputs() const = 0;
        /// Returns if the input is wired.
        virtual bool    hasInput(exint idx) const = 0;

        /// Demands the input be cooked.  After this, the inputGeo()
        /// will return the contents.
        /// Returns false if the cook failed for some reason.
        virtual bool    cookInput(exint idx) = 0;

        /// Returns an invalid handle if the input isn't wired or not yet
        /// cooked.
        virtual GU_DetailHandle inputGeo(exint idx) = 0;

        /// Unlocks/forgets the given input.  Returns an invalid handle if
        /// not wired or not cooked.
        virtual GU_DetailHandle unloadInput(exint idx, bool flushce) = 0;

        /// Marks the given input used.  Needed if the input isn't cooked,
        /// as unload will not mark it unused (as it must be marked such
        /// ASAP to free up earlier nodes)
        virtual void            markInputUnused(exint idx) = 0;
    };

    class SOP_API PreCookedNodeInputs : public NodeInputs
    {
    public:
                 PreCookedNodeInputs(const UT_Array<GU_ConstDetailHandle> &gdps)
                    : myGdps(gdps)
                 { }

        exint           nInputs() const override { return myGdps.entries(); }
        bool            hasInput(exint idx) const override
        {
            if (idx < 0 || idx >= nInputs())
                return false;
            return myGdps(idx).gdp() != nullptr;
        }

        bool            cookInput(exint idx) override
        {
            // Precooked, so if we have it it successfully cooked.
            return hasInput(idx);
        }

        GU_DetailHandle inputGeo(exint idx) override
        {
            if (!hasInput(idx))
                return GU_DetailHandle();
            return myGdps(idx).castAwayConst();
        }

        GU_DetailHandle unloadInput(exint idx, bool flushce) override
        {
            // It would make sense to clear out the gdp at this point,
            // but we don't have ownership of the array.
            return inputGeo(idx);
        }

        void            markInputUnused(exint idx) override {}
    protected:
        const UT_Array<GU_ConstDetailHandle>    &myGdps;
    };

    class SOP_API InputParms
    {
    public:
        InputParms(NodeInputs &inputs, NodeInputs &exprinputs,
                    const OP_Context &context,
                    const SOP_NodeParms *parms,
                    SOP_NodeCache *cache,
                    UT_ErrorManager *error, DEP_MicroNode *depnode)
        : myInputs(inputs)
        , myExprInputs(exprinputs)
        , myContext(context)
        , myParms(parms)
        , myCache(cache)
        , myError(error)
        , myDepNode(depnode)
        {
        }

        virtual ~InputParms() {}

        InputParms(const InputParms &) = delete;
        InputParms &operator=(const InputParms &) = delete;

        NodeInputs      &inputs() const { return myInputs; }

        NodeInputs      &exprinputs() const { return myExprInputs; }

        template <typename T>
        const T                 &parms() const
                                { return *UTverify_cast<const T*>(myParms); }

        template <typename T>
        T                       *cache() const
                                { return UTverify_cast<T *>(myCache); }

        UT_ErrorManager *error() const { return myError; }

        DEP_MicroNode *depnode() const { return myDepNode; }

        const OP_Context        &getContext() const
                                 { return myContext; }
        fpreal                   getCookTime() const
                                { return myContext.getTime(); }

    protected:
        NodeInputs              &myInputs;
        NodeInputs              &myExprInputs;
        const SOP_NodeParms     *myParms;
        SOP_NodeCache           *myCache;
        UT_ErrorManager         *myError;
        DEP_MicroNode           *myDepNode;
        const OP_Context        &myContext;
    };

    class SOP_API CookParms
    {
    public:
        CookParms(GU_DetailHandle &destgdh,
                  const UT_Array<GU_ConstDetailHandle> &inputs,
                  OP_CookEngine cookengine,
                  const OP_GraphProxy *graphproxy,
                  OP_GraphProxy::NodeOrIdx nodeoridx,
                  const OP_Context &context,
                  const SOP_NodeParms *parms,
                  SOP_NodeCache *cache,
                  UT_ErrorManager *error,
                  DEP_MicroNode *depnode)
        : myDestGdh(destgdh)
        , myInputs(inputs)
        , myExprInputs(nullptr)
        , myCookEngine(cookengine)
        , myGraphProxy(graphproxy)
        , myNode(nodeoridx)
        , myOpNode(nodeoridx)
        , myContext(context)
        , myParms(parms)
        , myCache(cache)
        , myError(error)
        , myDepNode(depnode)
        {}
        void                    setPseudoPath(const UT_StringHolder &path) { myPseudoPath = path; }
        void                    setExprInputs(const UT_Array<GU_ConstDetailHandle> &exprinputs) { myExprInputs = & exprinputs; }

        virtual ~CookParms() {}


        /// The initial state of gdh depends on the cookMode()
        GU_DetailHandle         &gdh() const { return myDestGdh; }

        /// The currently cooking SOP.  This is only non-null if in
        /// the old cook path.  When executing compiled nodes it will
        /// be null as the verb is supposed to operate independently
        /// of the original SOP.
        SOP_Node                *getNode() const { return (myCookEngine == OP_COOK_TRADITIONAL) ? CAST_SOPNODE(myNode.node()) : 0; }

        OP_GraphProxy::NodeIdx   getNodeIdx() const { return myNode.index(); }
        OP_GraphProxy::NodeOrIdx getNodeOrIdx() const { return myNode; }
        const OP_GraphProxy     *graphProxy() const { return myGraphProxy; }

        template <typename T>
        T                       *getCookNode() const
                                { if (myCookEngine != OP_COOK_TRADITIONAL) 
                                    return 0;
                                  return UTverify_cast<T *>(myNode.node()); }

        /// The node that generated this verb, if any...  
        OP_Node                 *getSrcNode() const { return myNode.node(); }
        /// The getCwd() should be used to evaluate relative paths.
        OP_Node                 *getCwd() const { if (myOpNode.node()) return myOpNode.node(); return OPgetDirector(); }
        /// Returns a full path for display purposes, this will
        /// be the node path if it is presnet, otherwise the "pseudopath",
        /// otherwise <internal>
        UT_StringHolder          getFullPathForDisplay() const
        {
            if (myNode.node())
                return myNode.node()->getFullPath();
            if (myPseudoPath.isstring())
                return myPseudoPath;
            return "<internal>"_UTsh;
        }
        const OP_Context        &getContext() const
                                 { return myContext; }
        fpreal                   getCookTime() const
                                { return myContext.getTime(); }

        /// Accessors designed to simplify porting from old cook code.
        /// Just becaues you have nInputs does not mean all are wired or
        /// cooked.  But, the number demanded by your OP_Operator shall
        /// be present.
        /// Inputs have been locked & preserve request set 
        exint                    nInputs() const { return myInputs.size(); }
        bool                     hasInput(exint idx) const
        {
            if (idx < 0 || idx >= myInputs.size())
                return false;
            return myInputs(idx).isValid();
        }
        const GU_Detail         *inputGeo(exint idx) const
        {
            if (!hasInput(idx)) return 0;
            return myInputs(idx).gdp();
        }
        GU_ConstDetailHandle     inputGeoHandle(exint idx) const
        {
            if (!hasInput(idx)) return GU_ConstDetailHandle();
            return myInputs(idx);
        }

        /// Accessors to get to the expression, ie, spare, inputs
        /// index is the positive index for the spare input.
        exint                    numSpareInputs() const 
        { 
            if (!myExprInputs) return 0;
            return myExprInputs->size(); 
        }
        bool                     hasSpareInput(exint idx) const
        {
            if (!myExprInputs) return false;
            if (idx < 0 || idx > myExprInputs->size()) return false;
            return (*myExprInputs)(idx).isValid();
        }
        const GU_Detail         *spareInputGeo(exint idx) const
        {
            if (!hasSpareInput(idx)) return nullptr;
            return (*myExprInputs)(idx).gdp();
        }
        GU_ConstDetailHandle     spareInputGeoHandle(exint idx) const
        {
            if (!hasSpareInput(idx)) return GU_ConstDetailHandle();
            return (*myExprInputs)(idx);
        }

        template <typename T>
        const T                 &parms() const
                                { return *UTverify_cast<const T*>(myParms); }

        /// Cache may, or may not, persist between cooks.  But it is
        /// guaranteed this is the only thread using the cache.
        SOP_NodeCache           *cache() const { return myCache; }

        /// Error managers are not locked, so do not pass this to
        /// something that forks.
        UT_ErrorManager         *error() const { return myError; }
        DEP_MicroNode           *depnode() const { return myDepNode; }

        // NOTE: Do not hold onto the ptr object longer than necessary!
        UT_LockedRawPtr<UT_ErrorManager,OP_Lock>
        getLockedErrorManager() const
        {
            return UT_LockedRawPtr<UT_ErrorManager,OP_Lock>(
                        *myError, myErrorLock);
        }

        /// Methods to wire directly to the optional depnode.
        void                     addExplicitInput(DEP_MicroNode &inp, bool check_dup=true) const
        { if (myDepNode) myDepNode->addExplicitInput(inp, check_dup); }

        /// Methods to add directly to any present error manager.
        UT_ErrorSeverity addMessage (const char *type, int code, const char *msg=0,
                                     const UT_SourceLocation *loc=0) const
        { if (myError) return getLockedErrorManager()->addMessage(type, code, formatError(msg), loc); 
          return UT_ERROR_MESSAGE; }
        UT_ErrorSeverity addWarning (const char *type, int code, const char *msg=0,
                                     const UT_SourceLocation *loc=0) const
        { if (myError) return getLockedErrorManager()->addWarning(type, code, formatError(msg), loc); 
          return UT_ERROR_WARNING; }
        UT_ErrorSeverity addError   (const char *type, int code, const char *msg=0,
                                     const UT_SourceLocation *loc=0) const
        { if (myError) return getLockedErrorManager()->addError(type, code, formatError(msg), loc); 
          return UT_ERROR_ABORT; }


        UT_ErrorSeverity addMessageFmt(const char *fmt) const 
        { return addMessage("SOP", SOP_MESSAGE, fmt); }
        UT_ErrorSeverity addMessageFmt(const char *fmt, std::initializer_list<UT::Format::ArgValue> args) const
        {
            UT_WorkBuffer work;
            work.appendFormat(fmt, args);
            return addMessageFmt(work.buffer());
        }
        template<typename... Args>
        UT_ErrorSeverity addMessageFmt(const char *fmt, const Args &...args) const
        { return addMessageFmt(fmt, {args...}); }

        UT_ErrorSeverity addWarningFmt(const char *fmt) const 
        { return addWarning("SOP", SOP_MESSAGE, fmt); }
        UT_ErrorSeverity addWarningFmt( const char *fmt, std::initializer_list<UT::Format::ArgValue> args) const
        {
            UT_WorkBuffer work;
            work.appendFormat(fmt, args);
            return addWarningFmt(work.buffer());
        }
        template<typename... Args>
        UT_ErrorSeverity addWarningFmt(const char *fmt, const Args &...args) const
        { return addWarningFmt(fmt, {args...}); }

        UT_ErrorSeverity addErrorFmt(const char *fmt) const 
        { return addError("SOP", SOP_MESSAGE, fmt); }
        UT_ErrorSeverity addErrorFmt(const char *fmt, std::initializer_list<UT::Format::ArgValue> args) const
        {
            UT_WorkBuffer work;
            work.appendFormat(fmt, args);
            return addErrorFmt(work.buffer());
        }
        template<typename... Args>
        UT_ErrorSeverity addErrorFmt(const char *fmt, const Args &...args) const
        { return addErrorFmt(fmt, {args...}); }

        // Note that these methods first expand the error message using the
        // provided `code` & `msg`, then pass along the expanded result using
        // the `SOP_MESSAGE` code, so that the message can be properly prefixed
        // using the name of the associated node.
        UT_ErrorSeverity sopAddMessage (int code, const char *msg=0,
                                     const UT_SourceLocation *loc=0) const
        {
            UT_WorkBuffer errbuf;
            UT_Error("SOP", code, msg).getErrorFormattedString(errbuf);
            return addMessage("SOP", SOP_MESSAGE, errbuf.buffer(), loc); 
        }
        UT_ErrorSeverity sopAddWarning (int code, const char *msg=0,
                                     const UT_SourceLocation *loc=0) const
        {
            UT_WorkBuffer errbuf;
            UT_Error("SOP", code, msg).getErrorFormattedString(errbuf);
            return addWarning("SOP", SOP_MESSAGE, errbuf.buffer(), loc); 
        }
        UT_ErrorSeverity sopAddError   (int code, const char *msg=0,
                                     const UT_SourceLocation *loc=0) const
        {
            UT_WorkBuffer errbuf;
            UT_Error("SOP", code, msg).getErrorFormattedString(errbuf);
            return addError("SOP", SOP_MESSAGE, errbuf.buffer(), loc); 
        }

        void addTransformError(const OP_Node &node, const char *label=0) const
        {
            UT_String   path;
            node.getFullPath(path);
            if (UTisstring(label))
            {
                path += "(as "; path += label; path += ")";
            }
            addError("OP", OP_ERR_TRANSFORM, path);
        }

        void            stealErrors(UT_ErrorManager &src,
                                    bool borrow_only = false) const
        { if (myError) getLockedErrorManager()->stealErrors(src,0, -1, UT_ERROR_NONE, borrow_only); }

        void             select(GA_GroupType gtype = GA_GROUP_PRIMITIVE) const
        { if (getNode())
            getNode()->select(gtype); }
        
        void             select(GU_SelectionHandle selection, 
                                    bool add_to_sel = false) const
        { if (getNode())
            getNode()->select(selection, add_to_sel); }
        
                             // Select the group. opt use its type as sel type
        void             select(const GA_Group &group, bool use_gtype = true,
                                    bool add_to_sel = false) const
        { if (getNode())
            getNode()->select(group, use_gtype, add_to_sel); }
        
        void             select(const GEO_Primitive &prim, bool sel_prim = true,
                                    bool add_to_sel = false) const
        { if (getNode())
            getNode()->select(prim, sel_prim, add_to_sel); }
        void             selectPrimitive(GA_Offset primoff, bool prim_sel = true,
                                    bool add_to_sel = false) const
        { if (getNode())
            getNode()->selectPrimitive(primoff, prim_sel, add_to_sel); }
        void             selectPoint(GA_Offset ptoff, bool point_sel = true,
                                    bool add_to_sel = false) const
        { if (getNode())
            getNode()->selectPoint(ptoff, point_sel, add_to_sel); }
        void             selectFrom(const GEO_Primitive &prim, bool sel_prim = true,
                                        bool add_to_sel = false) const
        { if (getNode())
            getNode()->selectFrom(prim, sel_prim, add_to_sel); }
        void             selectPointsFrom(GA_Offset ptoff, bool point_sel = true,
                                        bool add_to_sel = false) const
        { if (getNode())
            getNode()->selectPointsFrom(ptoff, point_sel, add_to_sel); }
        void             select(const GA_Range &range, bool use_rtype = true,
                                    bool add_to_sel = false) const
        { if (getNode())
            getNode()->select(range, use_rtype, add_to_sel); }

        // Selects input based on the group supplied and the group type.  If
        // group is not null, then it's type is used, otherwise the group type
        // is used.
        void             selectInputGroup(const GA_Group *group,
                                              GA_GroupType grouptype) const
        { if (getNode())
            getNode()->selectInputGroup(group, grouptype); }

        // If no selection is present, then create a new empty primitive cook   
        // selection group. Otherwise, clear the selection.
        void             clearSelection() const
        { if (getNode())
            getNode()->clearSelection(); }

        /// If the cook selection group is not of the given type, create an empty
        /// cook selection group of that type. Otherwise, clear the existing cook
        /// selection group.
        void             clearSelection(GA_GroupType gtype) const
        { if (getNode())
            getNode()->clearSelection(gtype); }
        
        // Blow away the selection and reinitialize it to 0. Much more radical
        // than clearSelection(), which leaves behind a clean, empty selection.
        // This method returns 1 if it had anything to destroy, else 0.
        bool             destroySelection() const
        {       if (getNode())
                return getNode()->destroySelection(); 
            return false;
        }

        // Return 1 if selection is enabled, 0 if false.
        bool             selectionEnabled() const
                             {
                                 if (!getNode())
                                     return false;
                                 return getNode()->getHighlight();
                             }

        /// Shims for local variables
        bool            setupLocalVars() const
        { if (getNode()) return getNode()->setupLocalVars(); return false; }
        void            resetLocalVarRefs() const
        { if (getNode()) getNode()->resetLocalVarRefs(); }
        void            setCurGdh(int index, const GU_DetailHandle &gdh) const
        { if (getNode()) getNode()->setCurGdh(index, gdh); }
        void            clearCurGdh(int index) const
        { if (getNode()) getNode()->clearCurGdh(index); }
        void            setCurPoint(int index, GA_Offset off) const
        { if (getNode()) getNode()->setCurPoint(index, off); }
        void            clearCurPoint(int index) const
        { if (getNode()) getNode()->clearCurPoint(index); }
        void            setCurVertex(int index, GA_Offset off) const
        { if (getNode()) getNode()->setCurVertex(index, off); }
        void            clearCurVertex(int index) const
        { if (getNode()) getNode()->clearCurVertex(index); }
        void            setCurPrim(int index, GA_Offset off) const
        { if (getNode()) getNode()->setCurPrim(index, off); }
        void            clearCurPrim(int index) const
        { if (getNode()) getNode()->clearCurPrim(index); }
        void            setCurVertexNum(int index, exint num) const
        { if (getNode()) getNode()->setCurVertexNum(index, num); }
        void            clearCurVertexNum(int index) const
        { if (getNode()) getNode()->clearCurVertexNum(index); }
        void             setVariableOrder(int detail, int prim, 
                                              int pt, int vtx) const
        { if (getNode()) getNode()->setVariableOrder(detail, prim, pt, vtx); }

        /// Tracks if any local variables were accessed by op functions.
        void             resetLocalVariableAccessed() const
        { if (getNode()) getNode()->myUsesSOPLocalVar = false; }
        bool             wasLocalVariableAccessed() const
        { if (!getNode()) return false;
          return getNode()->myUsesSOPLocalVar; }


    protected:
        /// Prefix errors so we can get sensible results.
        UT_StringHolder         formatError(const char *msg) const
        {
            // Do not prefix with the path in traditional cook
            // as it is properly assigned.
            if (myCookEngine == OP_COOK_TRADITIONAL)
                return msg;
            UT_StringHolder     result;
            if (!msg || !*msg)
                return result;
            UT_WorkBuffer               buf;
            UT_StringHolder             fullpath;
            fullpath = getFullPathForDisplay();
            buf.sprintf("%s: %s", (const char *) fullpath, msg);
            result = buf;
            return result;
        }

        OP_CookEngine                            myCookEngine;
        GU_DetailHandle                         &myDestGdh;
        const UT_Array<GU_ConstDetailHandle>    &myInputs;
        const UT_Array<GU_ConstDetailHandle>    *myExprInputs;
        const OP_GraphProxy                     *myGraphProxy;
        OP_GraphProxy::NodeOrIdx                 myNode;
        OP_GraphProxy::NodeOrIdx                 myOpNode;
        UT_StringHolder                          myPseudoPath;
        const OP_Context                        &myContext;
        const SOP_NodeParms                     *myParms;
        SOP_NodeCache                           *myCache;
        UT_ErrorManager                         *myError;
        DEP_MicroNode                           *myDepNode;
        mutable UT_Lock                          myErrorLock;
    };

    /// If doPartialInputCook is false, we do assume cookInputs() will
    /// apply to all inputs regardless of node parameters.  If local
    /// variables require the inputs, it is required for this to be false
    /// for the inputs to be available when parameters are evaluated.
    virtual bool                 doPartialInputCook() const { return false; }

    /// If doExprInputCook is true, we will also cook all expression inputs
    /// in cookInputs using the default method.
    virtual bool                 doExprInputCook() const { return false ; }

    virtual bool                 cookInputs(const InputParms &parms) const
    {
        for (exint i = 0; i < parms.inputs().nInputs(); i++)
            if (parms.inputs().hasInput(i))
            {
                if (!parms.inputs().cookInput(i))
                    return false;
            }
        for (exint i = 0; i < parms.exprinputs().nInputs(); i++)
            if (parms.exprinputs().hasInput(i))
            {
                if (!parms.exprinputs().cookInput(i))
                    return false;
            }
        return true;
    }

    /// These are for the old-cook path to allow nodes to store relevant
    /// local variable information inside the SOP for callbacks.  The
    /// evalVariableValue() should be guarded to ensure it doesn't
    /// run from a forbidden node.
    /// These can be used if the local variables depend only on the inputs
    /// and are not change for every parameter.  If they change for
    /// every parameter, traditional cook paths will need to setup &
    /// evaluate explicitly in the cook method.
    virtual void                setupLocalVariables(SOP_Node *sop, const UT_Array<GU_ConstDetailHandle> &inputs) const {}
    virtual void                resetLocalVariables(SOP_Node *sop) const {}

    /// Traditional nodes may evaluate parameters while cooking, this is
    /// required for dynamic local variables.  If this is true, no pre-cooking
    /// of the parameter struture will be done in the traditional cook
    /// path avoiding double cooking parameters.  Remember other cook paths
    /// will not have access to the sop so should use the parameter structure!
    virtual bool                evaluatesParametersDuringCook() const { return false; }

    virtual CookMode             cookMode(const SOP_NodeParms *parms) const { return COOK_DUPLICATE; }

    /// Whether this verb's APEX callback will use an in-place port.
    /// Typically verbs that use a COOK_INPLACE or a COOK_PASSTHROUGH cook mode
    /// should use an in-place port in APEX.
    virtual bool apexInplace() const { return false; }

    /// Geometry elements can end up cached on the GPU.  Some SOPs are able
    /// to handle this. Some are ambivalent (such as switch or null)
    /// And some expect all GPU buffers to be flushed prior to
    /// operating.
    /// @{
    /// If requiresCEFlush() is true, all inputs will be flushed from the GPU
    /// to CPU prior to being cooked.
    virtual bool                 requiresCEFlush() const { return true; }
    /// If usesCE() is true, it says some of its output geometry will still be
    /// on the GPU, which will require flushing to be used on the CPU. 
    virtual bool                 usesCE() const { return false; }
    /// @}
    
    /// Compute the output geometry.
    virtual void        cook(const CookParms &cookparms) const = 0;

    /// This is used to update handles, it only has an effect
    /// if oldsop is non-null, ie, we are in the old cook path.
    /// Neither the group nor the gdp have to persist beyond this call.
    /// Pass -1 for the grouptype if there is no grouptype parameter.
    void notifyGroupParmListeners(SOP_Node *oldsop,
                            int groupparm_idx,
                            int grouptype_idx,
                            const GU_Detail *gdp,
                            const GA_Group *group) const;
    
protected:
};

#endif