src/third_party/skia/include/utils/SkRTConf.h

   1 /*
   2  * Copyright 2013 Google, Inc.
   3  *
   4  * Use of this source code is governed by a BSD-style license that can be
   5  * found in the LICENSE file.
   6  */
   7
   8
   9 #ifndef SkRTConf_DEFINED
  10 #define SkRTConf_DEFINED
  11
  12 #include "SkString.h"
  13 #include "SkStream.h"
  14
  15 #include "SkTDict.h"
  16 #include "SkTArray.h"
  17
  18 /** \class SkRTConfBase
  19     Non-templated base class for the runtime configs
  20 */
  21
  22 class SkRTConfBase {
  23 public:
  24     SkRTConfBase(const char *name) : fName(name) {}
  25     virtual ~SkRTConfBase() {}
  26     virtual const char *getName() const { return fName.c_str(); }
  27     virtual bool isDefault() const = 0;
  28     virtual void print(SkWStream *o) const = 0;
  29     virtual bool equals(const SkRTConfBase *conf) const = 0;
  30 protected:
  31     SkString fName;
  32 };
  33
  34 /** \class SkRTConf
  35     A class to provide runtime configurability.
  36 */
  37 template<typename T> class SkRTConf: public SkRTConfBase {
  38 public:
  39     SkRTConf(const char *name, const T &defaultValue, const char *description);
  40     operator const T&() const { return fValue; }
  41     void print(SkWStream *o) const;
  42     bool equals(const SkRTConfBase *conf) const;
  43     bool isDefault() const { return fDefault == fValue; }
  44     void set(const T& value) { fValue = value; }
  45 protected:
  46     void doPrint(char *s) const;
  47
  48     T        fValue;
  49     T        fDefault;
  50     SkString fDescription;
  51 };
  52
  53 #ifdef SK_DEVELOPER
  54 #define SK_CONF_DECLARE(confType, varName, confName, defaultValue, description) static SkRTConf<confType> varName(confName, defaultValue, description)
  55 #define SK_CONF_SET(confname, value) \
  56     skRTConfRegistry().set(confname, value, true)
  57 /* SK_CONF_TRY_SET() is like SK_CONF_SET(), but doesn't complain if
  58    confname can't be found.  This is useful if the SK_CONF_DECLARE is
  59    inside a source file whose linkage is dependent on the system. */
  60 #define SK_CONF_TRY_SET(confname, value) \
  61     skRTConfRegistry().set(confname, value, false)
  62 #else
  63 #define SK_CONF_DECLARE(confType, varName, confName, defaultValue, description) static confType varName = defaultValue
  64 #define SK_CONF_SET(confname, value) (void) confname, (void) value
  65 #define SK_CONF_TRY_SET(confname, value) (void) confname, (void) value
  66 #endif
  67
  68 /** \class SkRTConfRegistry
  69     A class that maintains a systemwide registry of all runtime configuration
  70     parameters.  Mainly used for printing them out and handling multiply-defined
  71     knobs.
  72 */
  73
  74 class SkRTConfRegistry {
  75 public:
  76     SkRTConfRegistry();
  77     ~SkRTConfRegistry();
  78     void printAll(const char *fname = NULL) const;
  79     bool hasNonDefault() const;
  80     void printNonDefault(const char *fname = NULL) const;
  81     const char *configFileLocation() const;
  82     void possiblyDumpFile() const;
  83     void validate() const;
  84     template <typename T> void set(const char *confname,
  85                                    T value,
  86                                    bool warnIfNotFound = true);
  87
  88 private:
  89     template<typename T> friend class SkRTConf;
  90
  91     void registerConf(SkRTConfBase *conf);
  92
  93     template <typename T> bool parse(const char *name, T* value);
  94
  95     SkTDArray<SkString *> fConfigFileKeys, fConfigFileValues;
  96     typedef SkTDict< SkTDArray<SkRTConfBase *> * > ConfMap;
  97     ConfMap fConfs;
  98
  99     template <typename T>
 100     friend bool test_rt_conf_parse(SkRTConfRegistry*, const char* name, T* value);
 101 };
 102
 103 // our singleton registry
 104
 105 SkRTConfRegistry &skRTConfRegistry();
 106
 107 template<typename T>
 108 SkRTConf<T>::SkRTConf(const char *name, const T &defaultValue, const char *description)
 109     : SkRTConfBase(name)
 110     , fValue(defaultValue)
 111     , fDefault(defaultValue)
 112     , fDescription(description) {
 113
 114     T value;
 115     if (skRTConfRegistry().parse(fName.c_str(), &value)) {
 116         fValue = value;
 117     }
 118     skRTConfRegistry().registerConf(this);
 119 }
 120
 121 template<typename T>
 122 void SkRTConf<T>::print(SkWStream *o) const {
 123     char outline[200]; // should be ok because we specify a max. width for everything here.
 124     char *outptr;
 125     if (strlen(getName()) >= 30) {
 126         o->writeText(getName());
 127         o->writeText(" ");
 128         outptr = &(outline[0]);
 129     } else {
 130         sprintf(outline, "%-30.30s", getName());
 131         outptr = &(outline[30]);
 132     }
 133
 134     doPrint(outptr);
 135     sprintf(outptr+30, " %.128s", fDescription.c_str());
 136     for (size_t i = strlen(outline); i --> 0 && ' ' == outline[i];) {
 137         outline[i] = '\0';
 138     }
 139     o->writeText(outline);
 140 }
 141
 142 template<typename T>
 143 void SkRTConf<T>::doPrint(char *s) const {
 144     sprintf(s, "%-30.30s", "How do I print myself??");
 145 }
 146
 147 template<> inline void SkRTConf<bool>::doPrint(char *s) const {
 148     char tmp[30];
 149     sprintf(tmp, "%s # [%s]", fValue ? "true" : "false", fDefault ? "true" : "false");
 150     sprintf(s, "%-30.30s", tmp);
 151 }
 152
 153 template<> inline void SkRTConf<int>::doPrint(char *s) const {
 154     char tmp[30];
 155     sprintf(tmp, "%d # [%d]", fValue, fDefault);
 156     sprintf(s, "%-30.30s", tmp);
 157 }
 158
 159 template<> inline void SkRTConf<unsigned int>::doPrint(char *s) const {
 160     char tmp[30];
 161     sprintf(tmp, "%u # [%u]", fValue, fDefault);
 162     sprintf(s, "%-30.30s", tmp);
 163 }
 164
 165 template<> inline void SkRTConf<float>::doPrint(char *s) const {
 166     char tmp[30];
 167     sprintf(tmp, "%6.6f # [%6.6f]", fValue, fDefault);
 168     sprintf(s, "%-30.30s", tmp);
 169 }
 170
 171 template<> inline void SkRTConf<double>::doPrint(char *s) const {
 172     char tmp[30];
 173     sprintf(tmp, "%6.6f # [%6.6f]", fValue, fDefault);
 174     sprintf(s, "%-30.30s", tmp);
 175 }
 176
 177 template<> inline void SkRTConf<const char *>::doPrint(char *s) const {
 178     char tmp[30];
 179     sprintf(tmp, "%s # [%s]", fValue, fDefault);
 180     sprintf(s, "%-30.30s", tmp);
 181 }
 182
 183 template<typename T>
 184 bool SkRTConf<T>::equals(const SkRTConfBase *conf) const {
 185     // static_cast here is okay because there's only one kind of child class.
 186     const SkRTConf<T> *child_pointer = static_cast<const SkRTConf<T> *>(conf);
 187     return child_pointer &&
 188            fName == child_pointer->fName &&
 189            fDescription == child_pointer->fDescription &&
 190            fValue == child_pointer->fValue &&
 191            fDefault == child_pointer->fDefault;
 192 }
 193
 194 #endif