OP/OP_PreDefRules.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.
 *
 * Produced by:
 *      Side Effects
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * COMMENT: This class encapsulates all the data required to build the
 *          "Predefined Rules" menu that is common to some OPs including
 *          Event and Group POPs. The data is read in from a default 
 *          data file $HFS/houdini/OP<name>Rules, where 
 *          name is the OP name (ie "Event"). If a similarly named
 *          file is in the directory containing the user's houdini 
 *          preferences, (ie $HOME/houdini), the data in that file will
 *          override the defaults.
 */

#ifndef __OP_PreDefRules__
#define __OP_PreDefRules__

#include "OP_API.h"
#include <iostream.h>
#include <UT/UT_String.h>
#include <UT/UT_RefArray.h>

class UT_IStream;

class OP_API OP_PreDefRules
{
public:
                                // Constructor. The file_name is the 
                                // name of the file that will contain
                                // the table data (ie OPEventRules).
                                OP_PreDefRules(const char* file_name);

                                // Destructor does nothing.
                                ~OP_PreDefRules();

                                // Number of rules.
    int                         getCount()       { return myRuleCount; }

                                // The identifier token.
    const UT_String&            getToken(int i)  { return myTokens(i); }

                                // This is what appears in the menu.
    const UT_String&            getLabel(int i)  { return myLabels(i); }

                                // This is the rule string that corresponds 
                                // to the menu option. It ends up in the 
                                // "Rule" parameter box. 
    const UT_String&            getString(int i) { return myStrings(i); }

private:
                                // Parses a table file. '#' is a comment,
                                // and a rule is defined as:
                                // <token> <label> <string>
    bool                        parseFile(UT_IStream &is);

                                // Adds a rule.
    void                        addRule(char* rule_token, 
                                        char* rule_label,
                                        char* rule_string);
    
    int                         myRuleCount;
    UT_RefArray<UT_String>      myTokens;
    UT_RefArray<UT_String>      myLabels;
    UT_RefArray<UT_String>      myStrings;
};

#endif

---