diff options
| author | Anton Novoselov <[email protected]> | 2017-08-14 16:41:28 +0300 |
|---|---|---|
| committer | Anton Novoselov <[email protected]> | 2017-08-14 16:41:28 +0300 |
| commit | 9a1c1d814f3fa0b54b49d90b43130c02bc280f44 (patch) | |
| tree | eae6ead883173c66619c30b6a1ed085f3cb70f4d /docs/_source/api_hl_users_guide.txt | |
| parent | Updated to CL 22627414: (diff) | |
| download | blast-9a1c1d814f3fa0b54b49d90b43130c02bc280f44.tar.xz blast-9a1c1d814f3fa0b54b49d90b43130c02bc280f44.zip | |
Updated to CL 22661993:
* docs updates
* authoring fixes
* asset view in sample fix
* latest blast_tools_and_samples-windows.zip
Diffstat (limited to 'docs/_source/api_hl_users_guide.txt')
| -rw-r--r-- | docs/_source/api_hl_users_guide.txt | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/docs/_source/api_hl_users_guide.txt b/docs/_source/api_hl_users_guide.txt index c1504f5..ae8dd4a 100644 --- a/docs/_source/api_hl_users_guide.txt +++ b/docs/_source/api_hl_users_guide.txt @@ -269,7 +269,7 @@ by the group's actors. After all jobs have been run, the user must call TkGroup with families with actors in the group. A convenience function, TkGroup::process(), is provided which uses one worker to perform all jobs sequentially on the calling thread. This is useful shortcut to -get BlastTk up and running quickly. A multithreaded group processing implementation is given by Nv::Blast::ExtGroupTaskManagerImpl (in NvBlastExtPxTaskImpl.h). +get BlastTk up and running quickly. A multithreaded group processing implementation is given by Nv::Blast::ExtGroupTaskManager (in NvBlastExtPxTask.h). This resides in \ref pageextphysx, because it uses physx::PxTask. Actors resulting from the split of a "parent" actor will be placed automatically into the group that the parent belonged to. This is similar to the assigment of @@ -321,6 +321,21 @@ group2->release(); \endcode <br> +<b>Multithreaded processing</b> + +When distributing the jobs as mentioned above, every job must be processed exactly once (over all user tasks). + +The number of jobs processed per worker can range from a single job (resulting in a user task per job) to all jobs (like Nv::Blast::TkGroup::process() does). + +At any point in time, no more than the set workerCount amount of workers may have been acquired. Return the worker at the end of each task. + +\code +Nv::Blast::TkGroupWorker* worker = group->acquireWorker(); +// process some jobs +group->returnWorker(worker); +\endcode + +<br> \section damage_in_tk Applying Damage to Actors and Families Damage in NvBlastTk uses the same damage program scheme as the low-level SDK (see \ref splitting). One passes the program |