Index: include/utils/SkRTConf.h |
diff --git a/include/utils/SkRTConf.h b/include/utils/SkRTConf.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..d80e418419701536ecede47b5ea46dc072444373 |
--- /dev/null |
+++ b/include/utils/SkRTConf.h |
@@ -0,0 +1,193 @@ |
+/* |
+ * Copyright 2013 Google, Inc. |
+ * |
+ * Use of this source code is governed by a BSD-style license that can be |
+ * found in the LICENSE file. |
+ */ |
+ |
+ |
+#ifndef SkRTConf_DEFINED |
+#define SkRTConf_DEFINED |
+ |
+#include "../private/SkTDArray.h" |
+#include "../private/SkTDict.h" |
+#include "SkString.h" |
+#include "SkStream.h" |
+ |
+/** \class SkRTConfBase |
+ Non-templated base class for the runtime configs |
+*/ |
+ |
+class SkRTConfBase { |
+public: |
+ SkRTConfBase(const char *name) : fName(name) {} |
+ virtual ~SkRTConfBase() {} |
+ virtual const char *getName() const { return fName.c_str(); } |
+ virtual bool isDefault() const = 0; |
+ virtual void print(SkWStream *o) const = 0; |
+ virtual bool equals(const SkRTConfBase *conf) const = 0; |
+protected: |
+ SkString fName; |
+}; |
+ |
+/** \class SkRTConf |
+ A class to provide runtime configurability. |
+*/ |
+template<typename T> class SkRTConf: public SkRTConfBase { |
+public: |
+ SkRTConf(const char *name, const T &defaultValue, const char *description); |
+ operator const T&() const { return fValue; } |
+ void print(SkWStream *o) const; |
+ bool equals(const SkRTConfBase *conf) const; |
+ bool isDefault() const { return fDefault == fValue; } |
+ void set(const T& value) { fValue = value; } |
+protected: |
+ void doPrint(char *s) const; |
+ |
+ T fValue; |
+ T fDefault; |
+ SkString fDescription; |
+}; |
+ |
+#ifdef SK_DEBUG |
+#define SK_CONF_DECLARE(confType, varName, confName, defaultValue, description) static SkRTConf<confType> varName(confName, defaultValue, description) |
+#define SK_CONF_SET(confname, value) \ |
+ skRTConfRegistry().set(confname, value, true) |
+/* SK_CONF_TRY_SET() is like SK_CONF_SET(), but doesn't complain if |
+ confname can't be found. This is useful if the SK_CONF_DECLARE is |
+ inside a source file whose linkage is dependent on the system. */ |
+#define SK_CONF_TRY_SET(confname, value) \ |
+ skRTConfRegistry().set(confname, value, false) |
+#else |
+#define SK_CONF_DECLARE(confType, varName, confName, defaultValue, description) static confType varName = defaultValue |
+#define SK_CONF_SET(confname, value) (void) confname, (void) value |
+#define SK_CONF_TRY_SET(confname, value) (void) confname, (void) value |
+#endif |
+ |
+/** \class SkRTConfRegistry |
+ A class that maintains a systemwide registry of all runtime configuration |
+ parameters. Mainly used for printing them out and handling multiply-defined |
+ knobs. |
+*/ |
+ |
+class SkRTConfRegistry { |
+public: |
+ SkRTConfRegistry(); |
+ ~SkRTConfRegistry(); |
+ void printAll(const char *fname = NULL) const; |
+ bool hasNonDefault() const; |
+ void printNonDefault(const char *fname = NULL) const; |
+ const char *configFileLocation() const; |
+ void possiblyDumpFile() const; |
+ void validate() const; |
+ template <typename T> void set(const char *confname, |
+ T value, |
+ bool warnIfNotFound = true); |
+ |
+private: |
+ template<typename T> friend class SkRTConf; |
+ |
+ void registerConf(SkRTConfBase *conf); |
+ |
+ template <typename T> bool parse(const char *name, T* value); |
+ |
+ SkTDArray<SkString *> fConfigFileKeys, fConfigFileValues; |
+ typedef SkTDict< SkTDArray<SkRTConfBase *> * > ConfMap; |
+ ConfMap fConfs; |
+ |
+ template <typename T> |
+ friend bool test_rt_conf_parse(SkRTConfRegistry*, const char* name, T* value); |
+}; |
+ |
+// our singleton registry |
+ |
+SkRTConfRegistry &skRTConfRegistry(); |
+ |
+template<typename T> |
+SkRTConf<T>::SkRTConf(const char *name, const T &defaultValue, const char *description) |
+ : SkRTConfBase(name) |
+ , fValue(defaultValue) |
+ , fDefault(defaultValue) |
+ , fDescription(description) { |
+ |
+ T value; |
+ if (skRTConfRegistry().parse(fName.c_str(), &value)) { |
+ fValue = value; |
+ } |
+ skRTConfRegistry().registerConf(this); |
+} |
+ |
+template<typename T> |
+void SkRTConf<T>::print(SkWStream *o) const { |
+ char outline[200]; // should be ok because we specify a max. width for everything here. |
+ char *outptr; |
+ if (strlen(getName()) >= 30) { |
+ o->writeText(getName()); |
+ o->writeText(" "); |
+ outptr = &(outline[0]); |
+ } else { |
+ sprintf(outline, "%-30.30s", getName()); |
+ outptr = &(outline[30]); |
+ } |
+ |
+ doPrint(outptr); |
+ sprintf(outptr+30, " %.128s", fDescription.c_str()); |
+ for (size_t i = strlen(outline); i --> 0 && ' ' == outline[i];) { |
+ outline[i] = '\0'; |
+ } |
+ o->writeText(outline); |
+} |
+ |
+template<typename T> |
+void SkRTConf<T>::doPrint(char *s) const { |
+ sprintf(s, "%-30.30s", "How do I print myself??"); |
+} |
+ |
+template<> inline void SkRTConf<bool>::doPrint(char *s) const { |
+ char tmp[30]; |
+ sprintf(tmp, "%s # [%s]", fValue ? "true" : "false", fDefault ? "true" : "false"); |
+ sprintf(s, "%-30.30s", tmp); |
+} |
+ |
+template<> inline void SkRTConf<int>::doPrint(char *s) const { |
+ char tmp[30]; |
+ sprintf(tmp, "%d # [%d]", fValue, fDefault); |
+ sprintf(s, "%-30.30s", tmp); |
+} |
+ |
+template<> inline void SkRTConf<unsigned int>::doPrint(char *s) const { |
+ char tmp[30]; |
+ sprintf(tmp, "%u # [%u]", fValue, fDefault); |
+ sprintf(s, "%-30.30s", tmp); |
+} |
+ |
+template<> inline void SkRTConf<float>::doPrint(char *s) const { |
+ char tmp[30]; |
+ sprintf(tmp, "%6.6f # [%6.6f]", fValue, fDefault); |
+ sprintf(s, "%-30.30s", tmp); |
+} |
+ |
+template<> inline void SkRTConf<double>::doPrint(char *s) const { |
+ char tmp[30]; |
+ sprintf(tmp, "%6.6f # [%6.6f]", fValue, fDefault); |
+ sprintf(s, "%-30.30s", tmp); |
+} |
+ |
+template<> inline void SkRTConf<const char *>::doPrint(char *s) const { |
+ char tmp[30]; |
+ sprintf(tmp, "%s # [%s]", fValue, fDefault); |
+ sprintf(s, "%-30.30s", tmp); |
+} |
+ |
+template<typename T> |
+bool SkRTConf<T>::equals(const SkRTConfBase *conf) const { |
+ // static_cast here is okay because there's only one kind of child class. |
+ const SkRTConf<T> *child_pointer = static_cast<const SkRTConf<T> *>(conf); |
+ return child_pointer && |
+ fName == child_pointer->fName && |
+ fDescription == child_pointer->fDescription && |
+ fValue == child_pointer->fValue && |
+ fDefault == child_pointer->fDefault; |
+} |
+ |
+#endif |