PK_DEBUG_SESSION_watch_items

PK_ERROR_code_t               PK_DEBUG_SESSION_watch_items
(
--- received arguments ---
PK_ITEM_array_t               create,           --- objects to watch
                                                --- (may be empty)
PK_DEBUG_SESSION_create_cb_t  create_fn,        --- create callback
                                                --- (may be NULL)
PK_ITEM_array_t               destroy,          --- items to watch
                                                --- (may be empty)
PK_DEBUG_SESSION_destroy_cb_t destroy_fn        --- destroy callback
                                                --- (may be NULL)
)


This function registers arrays of tagged items which are to be watched
via two application callback functions.



The application may register arrays of tagged items to watch via a
create and a destroy callback function. The create callback function
will be invoked whenever one of the watched items is created. The
destroy callback will be invoked whenever one of the watched items
is deleted.

This function may be called before or after the session has been
started (ie. before or after a call to PK_SESSION_start). This
function must not be invoked before a frustrum has been registered
via PK_SESSION_register_frustrum.

The system to watch items may be disabled by invoking the function and
specifying zero items to watch.

See here for more information on this function.

NOTE: This function is only to be used for debugging purposes, it
      is not to be used to track the creation and deletion of tagged
      items during general application execution.

This function supersedes the PK_SESSION_watch_tags function.