/* Preference - Holds user-chosen preferences that are saved between sessions. */ #ifndef PREFERENCE_H #define PREFERENCE_H #include "EnumHelper.h" #include "LuaManager.h" #include "RageUtil.h" class XNode; struct lua_State; class IPreference { public: IPreference( const RString& sName ); virtual ~IPreference(); void ReadFrom( const XNode* pNode, bool bIsStatic ); void WriteTo( XNode* pNode ) const; void ReadDefaultFrom( const XNode* pNode ); virtual void LoadDefault() = 0; virtual void SetDefaultFromString( const RString &s ) = 0; virtual RString ToString() const = 0; virtual void FromString( const RString &s ) = 0; virtual void SetFromStack( lua_State *L ); virtual void PushValue( lua_State *L ) const; const RString &GetName() const { return m_sName; } static IPreference *GetPreferenceByName( const RString &sName ); static void LoadAllDefaults(); static void ReadAllPrefsFromNode( const XNode* pNode, bool bIsStatic ); static void SavePrefsToNode( XNode* pNode ); static void ReadAllDefaultsFromNode( const XNode* pNode ); RString GetName() { return m_sName; } void SetStatic( bool b ) { m_bIsStatic = b; } private: RString m_sName; bool m_bIsStatic; // loaded from Static.ini? If so, don't write to Preferences.ini }; void BroadcastPreferenceChanged( const RString& sPreferenceName ); template class Preference : public IPreference { public: Preference( const RString& sName, const T& defaultValue, void (pfnValidate)(T& val) = NULL ): IPreference( sName ), m_currentValue( defaultValue ), m_defaultValue( defaultValue ), m_pfnValidate( pfnValidate ) { LoadDefault(); } RString ToString() const { return StringConversion::ToString( m_currentValue ); } void FromString( const RString &s ) { if( !StringConversion::FromString(s, m_currentValue) ) m_currentValue = m_defaultValue; if( m_pfnValidate ) m_pfnValidate( m_currentValue ); } void SetFromStack( lua_State *L ) { LuaHelpers::Pop( L, m_currentValue ); if( m_pfnValidate ) m_pfnValidate( m_currentValue ); } void PushValue( lua_State *L ) const { LuaHelpers::Push( L, m_currentValue ); } void LoadDefault() { m_currentValue = m_defaultValue; } void SetDefaultFromString( const RString &s ) { T def = m_defaultValue; if( !StringConversion::FromString(s, m_defaultValue) ) m_defaultValue = def; } const T &Get() const { return m_currentValue; } const T &GetDefault() const { return m_defaultValue; } operator const T () const { return Get(); } void Set( const T& other ) { m_currentValue = other; BroadcastPreferenceChanged( GetName() ); } static Preference *GetPreferenceByName( const RString &sName ) { IPreference *pPreference = IPreference::GetPreferenceByName( sName ); Preference *pRet = dynamic_cast *>(pPreference); return pRet; } private: T m_currentValue; T m_defaultValue; void (*m_pfnValidate)(T& val); }; /** @brief Utilities for working with Lua. */ namespace LuaHelpers { template void Push( lua_State *L, const Preference &Object ) { LuaHelpers::Push( L, Object.Get() ); } } template class Preference1D { public: typedef Preference PreferenceT; vector m_v; Preference1D( void pfn(size_t i, RString &sNameOut, T &defaultValueOut ), size_t N ) { for( size_t i=0; i(sName, defaultValue) ); } } ~Preference1D() { for( size_t i=0; i& operator[]( size_t i ) const { return *m_v[i]; } Preference& operator[]( size_t i ) { return *m_v[i]; } }; #endif /* * (c) 2001-2004 Chris Danford, Chris Gomez * All rights reserved. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, and/or sell copies of the Software, and to permit persons to * whom the Software is furnished to do so, provided that the above * copyright notice(s) and this permission notice appear in all copies of * the Software and that both the above copyright notice(s) and this * permission notice appear in supporting documentation. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF * THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS * INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT * OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. */