open_toontown_panda3d/panda/src/pgraph/modelPool.h

103 lines
3.4 KiB
C++

// Filename: modelPool.h
// Created by: drose (12Mar02)
//
////////////////////////////////////////////////////////////////////
//
// 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 MODELPOOL_H
#define MODELPOOL_H
#include "pandabase.h"
#include "filename.h"
#include "modelRoot.h"
#include "pointerTo.h"
#include "pmutex.h"
#include "pmap.h"
#include "loaderOptions.h"
////////////////////////////////////////////////////////////////////
// Class : ModelPool
// Description : This class unifies all references to the same
// filename, so that multiple attempts to load the same
// model will return the same pointer. Note that the
// default behavior is thus to make instances: use with
// caution. Use the copy_subgraph() method on Node (or
// use NodePath::copy_to) to make modifiable copies of
// the node.
//
// Unlike TexturePool, this class does not automatically
// resolve the model filenames before loading, so a
// relative path and an absolute path to the same model
// will appear to be different filenames.
//
// However, see the Loader class, which is now the
// preferred interface for loading models. The Loader
// class can resolve filenames, supports threaded
// loading, and can automatically consult the ModelPool,
// according to the supplied LoaderOptions.
////////////////////////////////////////////////////////////////////
class EXPCL_PANDA ModelPool {
PUBLISHED:
INLINE static bool has_model(const string &filename);
INLINE static bool verify_model(const string &filename);
INLINE static ModelRoot *load_model(const string &filename,
const LoaderOptions &options = LoaderOptions());
INLINE static void add_model(const string &filename, ModelRoot *model);
INLINE static void release_model(const string &filename);
INLINE static void add_model(ModelRoot *model);
INLINE static void release_model(ModelRoot *model);
INLINE static void release_all_models();
INLINE static int garbage_collect();
INLINE static void list_contents(ostream &out);
INLINE static void list_contents();
static void write(ostream &out);
private:
INLINE ModelPool();
bool ns_has_model(const string &filename);
ModelRoot *ns_load_model(const string &filename,
const LoaderOptions &options);
void ns_add_model(const string &filename, ModelRoot *model);
void ns_release_model(const string &filename);
void ns_add_model(ModelRoot *model);
void ns_release_model(ModelRoot *model);
void ns_release_all_models();
int ns_garbage_collect();
void ns_list_contents(ostream &out) const;
static ModelPool *get_ptr();
static ModelPool *_global_ptr;
Mutex _lock;
typedef pmap<string, PT(ModelRoot) > Models;
Models _models;
};
#include "modelPool.I"
#endif