88 lines
2.3 KiB
Plaintext
88 lines
2.3 KiB
Plaintext
/**
|
|
* 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 asyncTaskManager.I
|
|
* @author drose
|
|
* @date 2006-08-23
|
|
*/
|
|
|
|
/**
|
|
* Replaces the clock pointer used within the AsyncTaskManager. This is used
|
|
* to control when tasks with a set_delay() specified will be scheduled. It
|
|
* can also be ticked automatically each epoch, if set_tick_clock() is true.
|
|
*
|
|
* The default is the global clock pointer.
|
|
*/
|
|
INLINE void AsyncTaskManager::
|
|
set_clock(ClockObject *clock) {
|
|
_clock = clock;
|
|
}
|
|
|
|
/**
|
|
* Returns the clock pointer used within the AsyncTaskManager. See
|
|
* set_clock().
|
|
*/
|
|
INLINE ClockObject *AsyncTaskManager::
|
|
get_clock() {
|
|
return _clock;
|
|
}
|
|
|
|
#ifndef CPPPARSER
|
|
/**
|
|
* Adds a new task to the task manager which calls the indicated callable.
|
|
* This method is defined as a more convenient alternative to subclassing
|
|
* AsyncTask.
|
|
*
|
|
* This given callable allowed to be any object defining a call operator that
|
|
* accepts an AsyncTask pointer and returns a DoneStatus.
|
|
*
|
|
* Returns the newly created AsyncTask object.
|
|
*
|
|
* @since 1.11.0
|
|
*/
|
|
template<class Callable>
|
|
INLINE AsyncTask *AsyncTaskManager::
|
|
add(Callable callable, const std::string &name, int sort, int priority) {
|
|
AsyncTaskChain *chain = make_task_chain("default");
|
|
nassertr(chain != nullptr, nullptr);
|
|
return chain->add(std::move(callable), name, sort, priority);
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* Returns the number of tasks that are currently active or sleeping within
|
|
* the task manager.
|
|
*/
|
|
INLINE size_t AsyncTaskManager::
|
|
get_num_tasks() const {
|
|
MutexHolder holder(_lock);
|
|
return _num_tasks;
|
|
}
|
|
|
|
/**
|
|
* Returns a pointer to the global AsyncTaskManager. This is the
|
|
* AsyncTaskManager that most code should use for queueing tasks and suchlike.
|
|
*/
|
|
INLINE AsyncTaskManager *AsyncTaskManager::
|
|
get_global_ptr() {
|
|
if (_global_ptr == nullptr) {
|
|
make_global_ptr();
|
|
}
|
|
return _global_ptr;
|
|
}
|
|
|
|
/**
|
|
* Adds the task to the _tasks_by_name index, if it has a nonempty name.
|
|
*/
|
|
INLINE void AsyncTaskManager::
|
|
add_task_by_name(AsyncTask *task) {
|
|
if (!task->get_name().empty()) {
|
|
_tasks_by_name.insert(task);
|
|
}
|
|
}
|