factoryBase.I

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 factoryBase.I
 * @author drose
 * @date 2000-05-08
 */

/**
 * 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.
 */
INLINE TypedObject *FactoryBase::
make_instance(const std::string &type_name, const FactoryParams &params) {
  TypeHandle handle = TypeRegistry::ptr()->find_type(type_name);
  nassertr(handle != TypeHandle::none(), nullptr);

  return make_instance(handle, 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.
 *
 * 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.
 */
INLINE TypedObject *FactoryBase::
make_instance_more_general(const std::string &type_name,
                           const FactoryParams &params) {
  TypeHandle handle = TypeRegistry::ptr()->find_type(type_name);
  nassertr(handle != TypeHandle::none(), nullptr);

  return make_instance_more_general(handle, params);
}