placement.hpp

Go to the documentation of this file.

/*
  PLACEMENT.hpp  -  Key Abstraction: a way to place and locate a Media Object
 
   Copyright (C)
     2008,            Hermann Vosseler <Ichthyostega@web.de>
 
 **Lumiera** is free software; you can redistribute it and/or modify it
 under the terms of the GNU General Public License as published by the
 Free Software Foundation; either version 2 of the License, or (at your
 option) any later version. See the file COPYING for further details.
 
*/
 
 
#ifndef MOBJECT_PLACEMENT_H
#define MOBJECT_PLACEMENT_H
 
#include "lib/error.hpp"
#include "lib/hash-indexed.hpp"
#include "lib/time/timevalue.hpp"
#include "steam/mobject/session/locatingpin.hpp"
 
#include "steam/asset/pipe.hpp"   
 
#include <memory>
 
 
namespace steam {
namespace mobject {
  
  namespace session{ class MObjectFactory; }
  
  class MObject;
  class ExplicitPlacement;
  
  using std::shared_ptr;
  using std::static_pointer_cast;
  using lib::HashIndexed;
  
  
  
  template<class MO, class B =MObject>
  class Placement ;
  
  
  template<>
  class Placement<MObject,MObject>
    : protected shared_ptr<MObject>
    , public HashIndexed<Placement<MObject>, lib::hash::LuidH >
    {
    protected:
      using HashInd = HashIndexed<Placement<MObject>, lib::hash::LuidH>;
      using _SmartPtr = shared_ptr<MObject>;
      typedef void (*Deleter)(MObject*);
      using Time = lib::time::Time;
      using Pipe = asset::shared_ptr<asset::Pipe>;   
      
      
      
    public:
      MObject *
      operator->()  const
        {
          ENSURE (*this);
          return _SmartPtr::operator->();
        }
      
      template<class Y>
      bool
      isCompatible ()  const
        {
          return 0 != dynamic_cast<Y*> (get());
        }
      
      template<class Y>
      void
      extendOwnershipTo (shared_ptr<Y>& target)  const
        {
          REQUIRE (isCompatible<Y>());
          target = static_pointer_cast<Y>(*this);
        }
      
      friend bool
      isSharedPointee (Placement const& p1, Placement const& p2)
      {
        return static_cast<const void*> (p1.get())
            == static_cast<const void*> (p2.get());
      }
      
      
      operator string()   const ;
      size_t use_count()  const { return _SmartPtr::use_count(); }
      bool   isValid()    const { return _SmartPtr::use_count(); }
      
      
      virtual ~Placement() {};
      
      
      
      session::LocatingPin chain;
      
      virtual ExplicitPlacement resolve ()  const;
      
      
      Placement (Placement const& ref)
        : _SmartPtr (ref)
        , HashInd()    // creating a new ID!
        , chain(ref.chain)
        { }
      
      Placement& operator= (Placement const&)  = default;
      
    protected:
      Placement (MObject & subject, Deleter killer)
        : _SmartPtr (&subject, killer) { };
        
      friend class session::MObjectFactory;
      
      
//  private:
//    /** copy assignment prohibited */
//    Placement& operator= (Placement const&);
    };
  
  
  template<class MO, class B>
  class Placement
    : public Placement<B>
    {
    protected:
      using _Parent   = Placement<B>;
      using _Id       = _Parent::template Id<MO> const&;
      using Deleter   = _Parent::Deleter;
      using _SmartPtr = _Parent::_SmartPtr;
      
      
      Placement (MO & mo, Deleter killer)
        : _Parent (mo, killer)
        { };
      friend class session::MObjectFactory;
      
    public:
      MO*
      operator-> ()  const
        {
          ENSURE (INSTANCEOF (MO, this->get()));
          return static_cast<MO*>
            (_SmartPtr::operator-> ());
        }
      
      _Id
      getID ()  const  
        {
          return _Parent::template recastID<MO>();
        }
      
    };
  
  
  using PlacementMO = Placement<MObject>;
  using PMO         = Placement<MObject>;
  
  
  
  /* == free functions == */
 
  string
  format_PlacementID (PlacementMO const&) ;
  
  
  bool
  isSameDef (PlacementMO const&, PlacementMO const&);
  
  
  
}} // namespace steam::mobject
#endif