// Filename: recorderController.h
// Created by:  drose (25Jan04)
//
////////////////////////////////////////////////////////////////////
//
// PANDA 3D SOFTWARE
// Copyright (c) 2001 - 2004, Disney Enterprises, Inc.  All rights reserved
//
// All use of this software is subject to the terms of the Panda 3d
// Software license.  You should have received a copy of this license
// along with this source code; you will also find a current copy of
// the license at http://etc.cmu.edu/panda3d/docs/license/ .
//
// To contact the maintainers of this program write to
// panda3d-general@lists.sourceforge.net .
//
////////////////////////////////////////////////////////////////////

#ifndef RECORDERCONTROLLER_H
#define RECORDERCONTROLLER_H

#include "pandabase.h"
#include "datagramOutputFile.h"
#include "datagramInputFile.h"
#include "recorderTable.h"
#include "recorderHeader.h"
#include "typedReferenceCount.h"
#include "factory.h"

class RecorderBase;
class RecorderFrame;

////////////////////////////////////////////////////////////////////
//       Class : RecorderController
// Description : This object manages the process of recording the
//               user's runtime inputs to a bam file so that the
//               session can be recreated later.
////////////////////////////////////////////////////////////////////
class EXPCL_PANDA RecorderController : public TypedReferenceCount {
PUBLISHED:
  RecorderController();
  ~RecorderController();

  bool begin_record(const Filename &filename);
  bool begin_playback(const Filename &filename);
  void close();

  INLINE time_t get_start_time() const;

  INLINE void set_random_seed(int random_seed);
  INLINE int get_random_seed() const;

  INLINE bool is_recording() const;
  INLINE bool is_playing() const;
  INLINE bool is_open() const;
  INLINE const Filename &get_filename() const;

  INLINE bool is_error();
  INLINE double get_clock_offset() const;
  INLINE int get_frame_offset() const;

  INLINE void add_recorder(const string &name, RecorderBase *recorder);
  INLINE bool has_recorder(const string &name) const;
  INLINE RecorderBase *get_recorder(const string &name) const;
  INLINE bool remove_recorder(const string &name);

  INLINE void set_frame_tie(bool frame_tie);
  INLINE bool get_frame_tie() const;

  void record_frame();
  void play_frame();

public:
  typedef Factory<RecorderBase> RecorderFactory;

  INLINE static RecorderFactory *get_factory();

private:
  INLINE static void create_factory();
  RecorderFrame *read_frame();

private:
  RecorderHeader _header;
  double _clock_offset;
  int _frame_offset;

  Filename _filename;
  DatagramOutputFile _dout;
  DatagramInputFile _din;
  BamWriter *_writer;
  BamReader *_reader;
  bool _frame_tie;

  // _user_table is directly modified by the user.
  RecorderTable *_user_table;
  bool _user_table_modified;

  // In playback mode, _file_table represents the table as read
  // directly from the session file, with default recorders in each
  // slot.
  RecorderTable *_file_table;

  // In playback mode, _active_table is the result of the merge of
  // _file_table and _user_table, with a default recorder or a
  // user-specified recorder in each active slot.
  RecorderTable *_active_table;

  RecorderFrame *_next_frame;
  bool _eof;

  static RecorderFactory *_factory;
  
public:
  static TypeHandle get_class_type() {
    return _type_handle;
  }
  static void init_type() {
    TypedReferenceCount::init_type();
    register_type(_type_handle, "RecorderController",
                  TypedReferenceCount::get_class_type());
  }
  virtual TypeHandle get_type() const {
    return get_class_type();
  }
  virtual TypeHandle force_init_type() {init_type(); return get_class_type();}

private:
  static TypeHandle _type_handle;

  friend class RecorderFrame;
};

#include "recorderController.I"

#endif

