PRM/PRM_Default.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:
 *      ramin
 *      Side Effects Software Inc.
 *      20 Maud St.
 *      Toronto, Ontario,  M5V 2M5
 *      Canada
 *      416-366-4607
 *
 * NAME:        PRM_Default.h (Parameter Library)
 *
 * COMMENTS:
 */

#ifndef __PRM_Default__
#define __PRM_Default__

#include "PRM_API.h"
#include <CH/CH_ExprLanguage.h>

// These options can be OR'd and are processed in order from top to bottom.
enum PRM_DefaultType {
    PRM_DEFAULT_LOCK    = 0x00000001,
    PRM_DEFAULT_USER    = 0x00000002,
    PRM_DEFAULT_EXPR    = 0x00000004,
    PRM_DEFAULT_FCTY    = 0x00000008,
    PRM_DEFAULT_MASK    = 0x0000000F
};

#define PRM_FACTORY_DEF         PRM_DefaultType(        \
                                    PRM_DEFAULT_LOCK | PRM_DEFAULT_FCTY)
#define PRM_USER_DEF            PRM_DefaultType(        \
                                    PRM_FACTORY_DEF | PRM_DEFAULT_USER)
#define PRM_TRUE_FACTORY_DEF    PRM_DefaultType(        \
                                    PRM_FACTORY_DEF | PRM_DEFAULT_EXPR)
#define PRM_FACTORY_UI_DEF      PRM_DefaultType(        \
                                    PRM_TRUE_FACTORY_DEF & ~PRM_DEFAULT_LOCK)

//
// For now, ordinal and animated parameters are both stored in a floating
// point number.
//

class PRM_API PRM_Default
{
public:
    /// PRM_Default has two parts: a float and a string. For floating point
    /// parameters, if the default string is defined, then the parameter will
    /// start off being animated and have the channel expression defined by the
    /// string. Otherwise, the floating point default is used for float and
    /// integer types, while the string is used to initialize string types. 
                 PRM_Default(float thefloat=0.0F, const char *thestring = 0,
                             CH_StringMeaning string_meaning =
                                CH_AUTO_DETECT_OLD_EXPRESSION);

    float        getFloat() const       { return myFloat; }
    int          getOrdinal() const     { return (int)myFloat; }
    bool         gotString() const      { return (myString) ? true : false; }
    const char  *getString() const      { return (myString) ? myString : ""; }
    CH_StringMeaning getStringMeaning() const
                                        { return myStringMeaning; }

    PRM_Default &operator=(const PRM_Default &dft);

    void         set(float thefloat, const char *thestring,
                     CH_StringMeaning string_meaning);

    void         setFloat(float v)      { myFloat = v; }
    void         setOrdinal(int v)      { myFloat = (float)v; }
    void         setString(const char *v, bool free_existing = false);
    void         setStringMeaning(CH_StringMeaning string_meaning);

private:
    float        myFloat;
    char        *myString;
    CH_StringMeaning myStringMeaning;
};
#endif

---