dali/internal/event/common/object-registry-impl.h

   1 #ifndef __DALI_INTERNAL_OBJECT_REGISTRY_H__
   2 #define __DALI_INTERNAL_OBJECT_REGISTRY_H__
   3
   4 /*
   5  * Copyright (c) 2014 Samsung Electronics Co., Ltd.
   6  *
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  * http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  *
  19  */
  20
  21 // INTERNAL INCLUDES
  22 #ifdef DEBUG_ENABLED
  23 #include <dali/public-api/common/set-wrapper.h>
  24 #endif
  25 #include <dali/public-api/object/ref-object.h>
  26 #include <dali/public-api/object/object-registry.h>
  27 #include <dali/public-api/object/base-object.h>
  28
  29 namespace Dali
  30 {
  31
  32 struct Vector2;
  33
  34 namespace Internal
  35 {
  36
  37 namespace SceneGraph
  38 {
  39 class UpdateManager;
  40 }
  41
  42 class ObjectRegistry;
  43
  44 typedef IntrusivePtr<ObjectRegistry> ObjectRegistryPtr;
  45
  46 /**
  47  * The ObjectRegistry notifies it's observers when an object is created.
  48  * There is a single instance of Object registry for each Dali-core instance.
  49  * All Dali Objects need to register with ObjectRegistry to be observed by
  50  * feedback plugin's and other observers.
  51  */
  52 class ObjectRegistry : public BaseObject
  53 {
  54 public:
  55
  56   /**
  57    * Create the objectRegistry
  58    */
  59   static ObjectRegistryPtr New();
  60
  61   /**
  62    * Registers the Object into the Object Registry, Which notifies
  63    * about this object creation to its observers.
  64    * @pre The object is not already registered.
  65    * @param[in] object Pointer to the object.
  66    */
  67   void RegisterObject( Dali::BaseObject* object );
  68
  69   /**
  70    * Unregisters the Object from the Object Registry, Which notifies
  71    * about this object destruction to its observers.
  72    * @pre The object is already registered.
  73    * @param[in] object Pointer to the object.
  74    */
  75   void UnregisterObject( Dali::BaseObject* object );
  76
  77   /**
  78    * @copydoc Dali::ObjectRegistry::ObjectCreatedSignal()
  79    */
  80   Dali::ObjectRegistry::ObjectCreatedSignalV2& ObjectCreatedSignal()
  81   {
  82     return mObjectCreatedSignalV2;
  83   }
  84
  85   /**
  86    * @copydoc Dali::ObjectRegistry::ObjectDestroyedSignal()
  87    */
  88   Dali::ObjectRegistry::ObjectDestroyedSignalV2& ObjectDestroyedSignal()
  89   {
  90     return mObjectDestroyedSignalV2;
  91   }
  92
  93   /**
  94    * Connects a callback function with the object registry signals.
  95    * @param[in] object The object providing the signal.
  96    * @param[in] tracker Used to disconnect the signal.
  97    * @param[in] signalName The signal to connect to.
  98    * @param[in] functor A newly allocated FunctorDelegate.
  99    * @return True if the signal was connected.
 100    * @post If a signal was connected, ownership of functor was passed to CallbackBase. Otherwise the caller is responsible for deleting the unused functor.
 101    */
 102   static bool DoConnectSignal( BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor );
 103
 104 private:
 105
 106   /**
 107    * Protected constructor; see also ObjectRegistry::New()
 108    */
 109   ObjectRegistry();
 110
 111   /**
 112    * A reference counted object may only be deleted by calling Unreference()
 113    */
 114   ~ObjectRegistry();
 115
 116 private:
 117
 118   Dali::ObjectRegistry::ObjectCreatedSignalV2 mObjectCreatedSignalV2;
 119   Dali::ObjectRegistry::ObjectDestroyedSignalV2 mObjectDestroyedSignalV2;
 120
 121 #ifdef DEBUG_ENABLED
 122   std::set< Dali::BaseObject* > mDebugRegistry; ///< This allows us to assert that an object is only registered once (debug builds only)
 123 #endif
 124
 125 };
 126
 127 } // namespace Internal
 128
 129 // Helpers for public-api forwarding methods
 130
 131 inline Internal::ObjectRegistry& GetImplementation(Dali::ObjectRegistry& objectRegistry)
 132 {
 133   DALI_ASSERT_ALWAYS( objectRegistry && "ObjectRegistry handle is empty" );
 134
 135   BaseObject& handle = objectRegistry.GetBaseObject();
 136
 137   return static_cast<Internal::ObjectRegistry&>(handle);
 138 }
 139
 140 inline const Internal::ObjectRegistry& GetImplementation(const Dali::ObjectRegistry& objectRegistry)
 141 {
 142   DALI_ASSERT_ALWAYS( objectRegistry && "ObjectRegistry handle is empty" );
 143
 144   const BaseObject& handle = objectRegistry.GetBaseObject();
 145
 146   return static_cast<const Internal::ObjectRegistry&>(handle);
 147 }
 148
 149 } // namespace Dali
 150
 151 #endif // __DALI_INTERNAL_OBJECT_REGISTRY_H__