home *** CD-ROM | disk | FTP | other *** search
/ Hackers Magazine 57 / CdHackersMagazineNr57.iso / Software / Multimedia / k3d-setup-0.7.11.0.exe / include / k3d / k3dsdk / value_demand_storage.h < prev    next >
Encoding:
C/C++ Source or Header  |  2008-07-19  |  3.1 KB  |  112 lines
  1. #ifndef K3DSDK_VALUE_DEMAND_STORAGE_H
  2. #define K3DSDK_VALUE_DEMAND_STORAGE_H
  3.  
  4. // K-3D
  5. // Copyright (c) 1995-2008, Timothy M. Shead
  6. //
  7. // Contact: tshead@k-3d.com
  8. //
  9. // This program is free software; you can redistribute it and/or
  10. // modify it under the terms of the GNU General Public
  11. // License as published by the Free Software Foundation; either
  12. // version 2 of the License, or (at your option) any later version.
  13. //
  14. // This program is distributed in the hope that it will be useful,
  15. // but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17. // General Public License for more details.
  18. //
  19. // You should have received a copy of the GNU General Public
  20. // License along with this program; if not, write to the Free Software
  21. // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  22.  
  23. #include <boost/scoped_ptr.hpp>
  24. #include <boost/static_assert.hpp>
  25. #include <boost/type_traits.hpp>
  26.  
  27. namespace k3d
  28. {
  29.  
  30. namespace data
  31. {
  32.  
  33. /////////////////////////////////////////////////////////////////////////////
  34. // value_demand_storage
  35.  
  36. /// Storage policy that computes a value on-demand
  37. template<typename value_t, typename signal_policy_t>
  38. class value_demand_storage :
  39.     public signal_policy_t
  40. {
  41.     // This policy only works for data stored by-value
  42.     BOOST_STATIC_ASSERT((!boost::is_pointer<value_t>::value));
  43.  
  44. public:
  45.     typedef value_demand_storage<value_t, signal_policy_t> this_t;
  46.     typedef std::vector<ihint*> pending_hints_t;
  47.  
  48.     /// Set the slot that will be called to bring the underlying data up-to-date
  49.     void set_update_slot(const sigc::slot<void, const pending_hints_t&, value_t&>& Slot)
  50.     {
  51.         m_update_slot = Slot;
  52.         update();
  53.     }
  54.  
  55.     /// Returns a slot that will invoke the update() method
  56.     sigc::slot<void, ihint*> make_slot()
  57.     {
  58.         return sigc::mem_fun(*this, &this_t::update);
  59.     }
  60.  
  61.     /// Schedule an update for the value the next time it's read
  62.     void update(ihint* const Hint = 0)
  63.     {
  64.         m_pending_hints.push_back(Hint ? Hint->clone() : static_cast<ihint*>(0));
  65.         signal_policy_t::set_value(Hint);
  66.     }
  67.  
  68.     /// Accesses the underlying data, updating it if necessary
  69.     const value_t& internal_value()
  70.     {
  71.         if(!m_pending_hints.empty())
  72.         {
  73.             // Create a temporary copy of pending hints in-case we are updated while executing ...
  74.             const pending_hints_t pending_hints(m_pending_hints);
  75.             m_update_slot(pending_hints, m_value);
  76.             
  77.             std::for_each(m_pending_hints.begin(), m_pending_hints.end(), delete_object());
  78.             m_pending_hints.clear();
  79.         }
  80.  
  81.         return m_value;
  82.     }
  83.  
  84. protected:
  85.     template<typename init_t>
  86.     value_demand_storage(const init_t& Init) :
  87.         signal_policy_t(Init),
  88.         m_value(Init.value())
  89.     {
  90.     }
  91.  
  92.     ~value_demand_storage()
  93.     {
  94.         std::for_each(m_pending_hints.begin(), m_pending_hints.end(), delete_object());
  95.     }
  96.  
  97. private:
  98.     /// Storage for this policy's value
  99.     value_t m_value;
  100.     /// Stores a slot that will be called to bring this policy's value up-to-date
  101.     sigc::slot<void, const pending_hints_t&, value_t&> m_update_slot;
  102.     /// Stores a collection of pending hints to be updated
  103.     pending_hints_t m_pending_hints;
  104. };
  105.  
  106. } // namespace data
  107.  
  108. } // namespace k3d
  109.  
  110. #endif // !K3DSDK_VALUE_DEMAND_STORAGE_H
  111.  
  112.