libobs: Add obs_scene_find_source_recursive

Same as obs_scene_find_source but also searches groups within the scene.
2020-01-27 14:36:53 -08:00
parent 818e3a364e
commit 3aa08c4e0f
3 changed files with 46 additions and 0 deletions
--- a/docs/sphinx/reference-scenes.rst
+++ b/docs/sphinx/reference-scenes.rst
@@ -225,6 +225,16 @@ General Scene Functions

 ---------------------

+.. function:: obs_sceneitem_t *obs_scene_find_source_recursive(obs_scene_t *scene, const char *name)
+
+   Same as obs_scene_find_source, but also searches groups within the
+   scene.
+
+   :param name: The name of the source to find
+   :return:     The scene item if found, otherwise *NULL* if not found
+
+---------------------
+
 .. function:: obs_sceneitem_t *obs_scene_find_sceneitem_by_id(obs_scene_t *scene, int64_t id)

   :param id: The unique numeric identifier of the scene item