Panda3D
|
A Factory can be used to create an instance of a particular subclass of some general base class. More...
#include "factoryBase.h"
Public Types | |
typedef TypedObject * | BaseCreateFunc(const FactoryParams ¶ms) |
Public Member Functions | |
void | add_preferred (TypeHandle handle) |
Adds the indicated type to the end of the list of preferred types. More... | |
void | clear_preferred () |
Empties the list of preferred types. More... | |
TypeHandle | find_registered_type (TypeHandle handle) |
Returns the TypeHandle given, if it is a registered type, or if it is not registered, searches for the nearest ancestor of the indicated type that is registered and returns it. More... | |
int | get_num_preferred () const |
Returns the number of types added to the preferred-type list. More... | |
int | get_num_types () const |
Returns the number of different types the Factory knows how to create. More... | |
TypeHandle | get_preferred (int n) const |
Returns the nth type added to the preferred-type list. More... | |
TypeHandle | get_type (int n) const |
Returns the nth type the Factory knows how to create. More... | |
TypedObject * | make_instance (TypeHandle handle, const FactoryParams ¶ms) |
Attempts to create a new instance of some class of the indicated type, or some derivative if necessary. More... | |
TypedObject * | make_instance (const string &type_name, const FactoryParams ¶ms) |
Attempts to create a new instance of some class of the indicated type, or some derivative if necessary. More... | |
TypedObject * | make_instance_more_general (TypeHandle handle, const FactoryParams ¶ms) |
Attempts to create an instance of the type requested, or some base type of the type requested. More... | |
TypedObject * | make_instance_more_general (const string &type_name, const FactoryParams ¶ms) |
Attempts to create an instance of the type requested, or some base type of the type requested. More... | |
void | register_factory (TypeHandle handle, BaseCreateFunc *func) |
Registers a new kind of thing the Factory will be able to create. More... | |
void | write_types (ostream &out, int indent_level=0) const |
Writes a list of all known types the Factory can create to the indicated output stream, one per line. More... | |
A Factory can be used to create an instance of a particular subclass of some general base class.
Each subclass registers itself with the Factory, supplying a function that will construct an instance of that subclass; the Factory can later choose a suitable subclass and return a newly-constructed pointer to an object of that type on the user's demand. This is used, for instance, to manage the set of GraphicsPipes available to the user.
FactoryBase is the main definition of the thin template class Factory.
Definition at line 42 of file factoryBase.h.
void FactoryBase::add_preferred | ( | TypeHandle | handle | ) |
Adds the indicated type to the end of the list of preferred types.
On the next call to make_instance(), if the exact type requested cannot be created, the preferred types are first tried in the order specified.
Definition at line 213 of file factoryBase.cxx.
References get_num_preferred(), and TypeHandle::none().
Referenced by clear_preferred().
void FactoryBase::clear_preferred | ( | ) |
Empties the list of preferred types.
Definition at line 199 of file factoryBase.cxx.
References add_preferred().
Referenced by get_type().
TypeHandle FactoryBase::find_registered_type | ( | TypeHandle | handle | ) |
Returns the TypeHandle given, if it is a registered type, or if it is not registered, searches for the nearest ancestor of the indicated type that is registered and returns it.
If no ancestor of the indicated type is registered, returns TypeHandle::none().
Definition at line 119 of file factoryBase.cxx.
References TypeHandle::get_num_parent_classes(), TypeHandle::get_parent_class(), TypeHandle::none(), and register_factory().
Referenced by make_instance_more_general(), and BamWriter::write_handle().
int FactoryBase::get_num_preferred | ( | ) | const |
Returns the number of types added to the preferred-type list.
Definition at line 225 of file factoryBase.cxx.
References get_preferred().
Referenced by add_preferred(), and get_preferred().
int FactoryBase::get_num_types | ( | ) | const |
Returns the number of different types the Factory knows how to create.
Definition at line 164 of file factoryBase.cxx.
References get_type().
Referenced by get_type(), and register_factory().
TypeHandle FactoryBase::get_preferred | ( | int | n | ) | const |
Returns the nth type added to the preferred-type list.
Definition at line 236 of file factoryBase.cxx.
References get_num_preferred(), TypeHandle::none(), and write_types().
Referenced by get_num_preferred().
TypeHandle FactoryBase::get_type | ( | int | n | ) | const |
Returns the nth type the Factory knows how to create.
This is not a terribly efficient function; it's included primarily for debugging output. Normally you wouldn't need to traverse the list of the Factory's types.
Definition at line 178 of file factoryBase.cxx.
References clear_preferred(), get_num_types(), and TypeHandle::none().
Referenced by get_num_types().
TypedObject * FactoryBase::make_instance | ( | TypeHandle | handle, |
const FactoryParams & | params | ||
) |
Attempts to create a new instance of some class of the indicated type, or some derivative if necessary.
If an instance of the exact type cannot be created, the specified preferred will specify which derived class will be preferred.
Definition at line 47 of file factoryBase.cxx.
References make_instance_more_general().
Referenced by Factory< Type >::make_instance(), and make_instance().
|
inline |
Attempts to create a new instance of some class of the indicated type, or some derivative if necessary.
If an instance of the exact type cannot be created, the specified priorities will specify which derived class will be preferred.
This flavor of make_instance() accepts a string name that indicates the desired type. It must be the name of some already-registered type.
Definition at line 30 of file factoryBase.I.
References TypeRegistry::find_type(), make_instance(), make_instance_more_general(), TypeHandle::none(), and TypeRegistry::ptr().
TypedObject * FactoryBase::make_instance_more_general | ( | TypeHandle | handle, |
const FactoryParams & | params | ||
) |
Attempts to create an instance of the type requested, or some base type of the type requested.
Returns the new instance created, or NULL if the instance could not be created.
Definition at line 78 of file factoryBase.cxx.
References find_registered_type(), TypeHandle::get_num_parent_classes(), and TypeHandle::get_parent_class().
Referenced by make_instance(), Factory< Type >::make_instance_more_general(), and make_instance_more_general().
|
inline |
Attempts to create an instance of the type requested, or some base type of the type requested.
Returns the new instance created, or NULL if the instance could not be created.
This flavor of make_instance_more_general() accepts a string name that indicates the desired type. It must be the name of some already-registered type.
Definition at line 51 of file factoryBase.I.
References TypeRegistry::find_type(), make_instance_more_general(), TypeHandle::none(), and TypeRegistry::ptr().
void FactoryBase::register_factory | ( | TypeHandle | handle, |
BaseCreateFunc * | func | ||
) |
Registers a new kind of thing the Factory will be able to create.
Definition at line 151 of file factoryBase.cxx.
References get_num_types(), and TypeHandle::none().
Referenced by find_registered_type(), and Factory< Type >::register_factory().
void FactoryBase::write_types | ( | ostream & | out, |
int | indent_level = 0 |
||
) | const |
Writes a list of all known types the Factory can create to the indicated output stream, one per line.
Definition at line 248 of file factoryBase.cxx.
References TypeHandle::is_derived_from().
Referenced by get_preferred().