configPageManager.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 configPageManager.h
 * @author drose
 * @date 2004-10-15
 */
 
#ifndef CONFIGPAGEMANAGER_H
#define CONFIGPAGEMANAGER_H
 
#include "dtoolbase.h"
#include "configFlags.h"
#include "dSearchPath.h"
#include "globPattern.h"
#include "pnotify.h"
 
#include <vector>
 
class ConfigPage;
 
/**
 * A global object that maintains the set of ConfigPages everywhere in the
 * world, and keeps them in sorted order.
 */
class EXPCL_DTOOL_PRC ConfigPageManager : public ConfigFlags {
protected:
  ConfigPageManager();
  ~ConfigPageManager();
 
PUBLISHED:
  INLINE bool loaded_implicit_pages() const;
  INLINE void load_implicit_pages();
  void reload_implicit_pages();
 
  INLINE DSearchPath &get_search_path();
 
  INLINE size_t get_num_prc_patterns() const;
  INLINE std::string get_prc_pattern(size_t n) const;
 
  INLINE size_t get_num_prc_encrypted_patterns() const;
  INLINE std::string get_prc_encrypted_pattern(size_t n) const;
 
  INLINE size_t get_num_prc_executable_patterns() const;
  INLINE std::string get_prc_executable_pattern(size_t n) const;
 
  ConfigPage *make_explicit_page(const std::string &name);
  bool delete_explicit_page(ConfigPage *page);
 
  INLINE size_t get_num_implicit_pages() const;
  INLINE ConfigPage *get_implicit_page(size_t n) const;
 
  INLINE size_t get_num_explicit_pages() const;
  INLINE ConfigPage *get_explicit_page(size_t n) const;
 
  void output(std::ostream &out) const;
  void write(std::ostream &out) const;
 
  static ConfigPageManager *get_global_ptr();
 
PUBLISHED:
  MAKE_PROPERTY(search_path, get_search_path);
 
  MAKE_SEQ_PROPERTY(prc_patterns, get_num_prc_patterns, get_prc_pattern);
  MAKE_SEQ_PROPERTY(prc_encrypted_patterns, get_num_prc_encrypted_patterns, get_prc_encrypted_pattern);
  MAKE_SEQ_PROPERTY(prc_executable_patterns, get_num_prc_executable_patterns, get_prc_executable_pattern);
 
  MAKE_SEQ_PROPERTY(implicit_pages, get_num_implicit_pages, get_implicit_page);
  MAKE_SEQ_PROPERTY(explicit_pages, get_num_explicit_pages, get_explicit_page);
 
public:
  INLINE void mark_unsorted();
 
private:
  INLINE void check_sort_pages() const;
  void sort_pages();
 
  bool scan_auto_prc_dir(Filename &prc_dir) const;
  bool scan_up_from(Filename &result, const Filename &dir,
                    const Filename &suffix) const;
 
  void config_initialized();
 
  typedef std::vector<ConfigPage *> Pages;
  Pages _implicit_pages;
  Pages _explicit_pages;
  bool _pages_sorted;
  int _next_page_seq;
 
  bool _loaded_implicit;
  bool _currently_loading;
 
  DSearchPath _search_path;
 
  typedef std::vector<GlobPattern> Globs;
  Globs _prc_patterns;
  Globs _prc_encrypted_patterns;
  Globs _prc_executable_patterns;
 
  // In load_implicit_pages(), we temporarily build up a list of potential
  // config files to read andor execute.  We'll need some data structures to
  // store that information.
  enum FileFlags {
    FF_read     = 0x001,
    FF_execute  = 0x002,
    FF_decrypt  = 0x004,
  };
  class ConfigFile {
  public:
    int _file_flags;
    Filename _filename;
  };
  typedef std::vector<ConfigFile> ConfigFiles;
 
  static ConfigPageManager *_global_ptr;
};
 
INLINE std::ostream &operator << (std::ostream &out, const ConfigPageManager &pageMgr);
 
#include "configPageManager.I"
 
#endif