LUMIERA.clone/src/steam/fixture/segmentation.hpp

/*
  SEGMENTATION.hpp  -  Partitioning of a timeline for organising the render graph.

  Copyright (C)         Lumiera.org
    2008,               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.

*/


/** @file segmentation.hpp
 ** Part of the Fixture datastructure to manage time segments of constant structure.
 ** The Fixture is result of the build process and separation between high-level and
 ** low-level model. It's kind of an effective resulting timeline, and split into segments
 ** of constant wiring structure: whenever the processing nodes need to be wired differently
 ** for some timespan, we start a new segment of the timeline. This might be for the duration
 ** of a clip, or just for the duration of a transition, when the pipes of both clips need to
 ** be wired up in parallel.
 ** 
 ** Within the Fixture, a Segment of the timeline is used as attachment point for all the
 ** render nodes relevant for rendering this segment. Thus, the Segmentation defines the
 ** index and access datastructure to get at any point of the render node network.
 ** Moreover, the segments are used as foundation for render node memory management
 ** 
 ** @todo stalled effort towards a session implementation from 2008
 ** @todo 2016 likely to stay, but expect some extensive rework
 ** 
 ** @see Fixture
 ** @see ModelPort
 */


#ifndef STEAM_FIXTURE_SEGMENTATION_H
#define STEAM_FIXTURE_SEGMENTATION_H


#include "steam/fixture/segment.hpp"
#include "lib/nocopy.hpp"

#include <list>

using std::list;


namespace steam {
namespace fixture {
  
  
  /**
   * For the purpose of building and rendering, the fixture (for each timeline)
   * is partitioned such that each segment is _structurally constant._
   * The Segmentation defines and maintains this partitioning. Furthermore,
   * it is the general entry point for accessing the correct part of the engine
   * responsible for a given timeline time point.
   * @ingroup fixture
   * @see SegmentationTool actually calculating the Segmentation
   * 
   * @todo 1/2012 Just a Placeholder. The real thing is not yet implemented.
   * @todo 4/2023 now about to bootstrap into the implementation structure step by step (WIP)
   * @see http://lumiera.org/wiki/renderengine.html#Fixture
   */
  class Segmentation
    : util::NonCopyable
    {
      ///////////////////////////////////////////////////////////////////////////////////////////////////////TICKET #1243 : preliminary implementation
      
      /** segments of the engine in ordered sequence. */
      list<Segment> segments_;
      
    public:
      virtual ~Segmentation();      ///< this is an interface
      
    protected:
      Segmentation()                ///< there is always a single cover-all Segment initially
        : segments_{1}
      { }
      
    public:
      size_t
      size()  const
        {
          return segments_.size();
        }
      
    };
  
  
  
}} // namespace steam::fixture
#endif /*STEAM_FIXTURE_SEGMENTATION_H*/