pipeline.h

Go to the documentation of this file.

/**
 * PANDA 3D SOFTWARE
 * Copyright (c) Carnegie Mellon University.  All rights reserved.
 *
 * All use of this software is subject to the terms of the revised BSD
 * license.  You should have received a copy of this license along
 * with this source code in a file named "LICENSE."
 *
 * @file pipeline.h
 * @author drose
 * @date 2002-02-21
 */
 
#ifndef PIPELINE_H
#define PIPELINE_H
 
#include "pandabase.h"
#include "pipelineCyclerLinks.h"
#include "namable.h"
#include "pset.h"
#include "pmutex.h"
#include "mutexHolder.h"
#include "reMutex.h"
#include "reMutexHolder.h"
#include "selectThreadImpl.h"  // for THREADED_PIPELINE definition
 
struct PipelineCyclerTrueImpl;
 
/**
 * This class manages a staged pipeline of data, for instance the render
 * pipeline, so that each stage of the pipeline can simultaneously access
 * different copies of the same data.  It actually maintains a collection of
 * PipelineCycler objects, and manages the turning of all of them at once.
 *
 * There is one default Pipeline object, the render pipeline.  Other specialty
 * pipelines may be created as needed.
 */
class EXPCL_PANDA_PIPELINE Pipeline : public Namable {
public:
  Pipeline(const std::string &name, int num_stages);
  ~Pipeline();
 
  INLINE static Pipeline *get_render_pipeline();
 
  void cycle();
 
  void set_num_stages(int num_stages);
  INLINE void set_min_stages(int min_stages);
  INLINE int get_num_stages() const;
 
#ifdef THREADED_PIPELINE
  void add_cycler(PipelineCyclerTrueImpl *cycler);
  void add_cycler(PipelineCyclerTrueImpl *cycler, bool dirty);
  void add_dirty_cycler(PipelineCyclerTrueImpl *cycler);
  void remove_cycler(PipelineCyclerTrueImpl *cycler);
 
  INLINE int get_num_cyclers() const;
  INLINE int get_num_dirty_cyclers() const;
 
#ifdef DEBUG_THREADS
  typedef void CallbackFunc(TypeHandle type, int count, void *data);
  void iterate_all_cycler_types(CallbackFunc *func, void *data) const;
  void iterate_dirty_cycler_types(CallbackFunc *func, void *data) const;
#endif  // DEBUG_THREADS
 
#endif  // THREADED_PIPELINE
 
private:
  int _num_stages;
 
  static void make_render_pipeline();
  static Pipeline *_render_pipeline;
 
#ifdef THREADED_PIPELINE
  PipelineCyclerLinks _clean;
  PipelineCyclerLinks _dirty;
 
  int _num_cyclers;
  int _num_dirty_cyclers;
 
#ifdef DEBUG_THREADS
  typedef pmap<TypeHandle, int> TypeCount;
  TypeCount _all_cycler_types, _dirty_cycler_types;
 
  static void inc_cycler_type(TypeCount &count, TypeHandle type, int addend);
#endif  // DEBUG_THREADS
 
  // This is true only during cycle().
  bool _cycling;
 
  // This increases with every cycle run.  If the _dirty field of a cycler is
  // set to the same value as this, it indicates that it is scheduled for the
  // next cycle.
  unsigned int _next_cycle_seq;
 
  // This lock is always held during cycle().
  ReMutex _cycle_lock;
 
  // This lock protects the data stored on this Pipeline.
  Mutex _lock;
#endif  // THREADED_PIPELINE
};
 
#include "pipeline.I"
 
#endif