LUMIERA.clone/src/proc/mobject/session/query-focus.cpp

/*
  QueryFocus  -  management of current scope within the Session
 
  Copyright (C)         Lumiera.org
    2009,               Hermann Vosseler <Ichthyostega@web.de>
 
  This program 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.
 
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.
 
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
* *****************************************************/


#include "proc/mobject/session/query-focus.hpp"
//#include "proc/mobject/session/track.hpp"
//#include "proc/mobject/placement.hpp"
//#include "proc/mobject/session/mobjectfactory.hpp"
//#include "proc/asset/track.hpp"

namespace mobject {
namespace session {
  
  
  
  /** TODO??? */
  QueryFocus::QueryFocus()
  { }
  
  
  /** */
  ScopePath&
  QueryFocus::currPath()
  {
    UNIMPLEMENTED ("dereference and access the current scope path");
  }

  ScopePath const&
  QueryFocus::currPath()  const
  {
    UNIMPLEMENTED ("dereference and access the current scope path");
  }

  
  /** discard any state and clear
      the current focus path */
  QueryFocus&
  QueryFocus::reset ()
  {
    scopes_.clear();
    return *this;
  }
  
  
  /** attach this QueryFocus to a container-like scope,
      causing it to \em navigate, changing the
      current ScopePath as a side-effect 
  */
  QueryFocus&
  QueryFocus::attach (Scope const& container)
  {
    UNIMPLEMENTED ("navigate this focus to attach to the given container scop");
    return *this;
  }
  
  
  /** push the "current QueryFocus" aside and open a new focus frame.
      This new QueryFocus will act as "current" until going out of scope
   */
  QueryFocus
  QueryFocus::push (Scope const& otherContainer)
  {
    UNIMPLEMENTED ("push current, open a new QueryFocus frame");
    QueryFocus newFocus; // = do push and open new frame
    newFocus.attach (otherContainer);
    return newFocus;
  }
  
  
  /** cease to use \em this specific reference to the current frame.
      This operation immediately tries to re-attach to what is "current"
      and readjusts the internal handle. But when the previously released
      reference was the last one, releasing it will cause the QueryFocusStack
      to pop, in which case we'll re-attach to the now uncovered previous stack top.
  */
  QueryFocus&
  QueryFocus::pop()
  {
    UNIMPLEMENTED ("pop, give up one reference, maybe drop stack top");
    return *this;
  }
  
  
  
}} // namespace mobject::session