scene: add functions to place node on top/bottom

include/wlr/types/wlr_scene.h

@@ -129,14 +129,24 @@ void wlr_scene_node_set_enabled(struct wlr_scene_node *node, bool enabled);
 void wlr_scene_node_set_position(struct wlr_scene_node *node, int x, int y);
 /**
  * Move the node right above the specified sibling.
+ * Asserts that node and sibling are distinct and share the same parent.
  */
 void wlr_scene_node_place_above(struct wlr_scene_node *node,
 	struct wlr_scene_node *sibling);
 /**
  * Move the node right below the specified sibling.
+ * Asserts that node and sibling are distinct and share the same parent.
  */
 void wlr_scene_node_place_below(struct wlr_scene_node *node,
 	struct wlr_scene_node *sibling);
+/**
+ * Move the node above all of its sibling nodes.
+ */
+void wlr_scene_node_raise_to_top(struct wlr_scene_node *node);
+/**
+ * Move the node below all of its sibling nodes.
+ */
+void wlr_scene_node_lower_to_bottom(struct wlr_scene_node *node);
 /**
  * Move the node to another location in the tree.
  */

types/scene/wlr_scene.c

@@ -440,6 +440,7 @@ void wlr_scene_node_set_position(struct wlr_scene_node *node, int x, int y) {
 
 void wlr_scene_node_place_above(struct wlr_scene_node *node,
 		struct wlr_scene_node *sibling) {
+	assert(node != sibling);
 	assert(node->parent == sibling->parent);
 
 	if (node->state.link.prev == &sibling->state.link) {
@@ -455,6 +456,7 @@ void wlr_scene_node_place_above(struct wlr_scene_node *node,
 
 void wlr_scene_node_place_below(struct wlr_scene_node *node,
 		struct wlr_scene_node *sibling) {
+	assert(node != sibling);
 	assert(node->parent == sibling->parent);
 
 	if (node->state.link.next == &sibling->state.link) {
@@ -468,6 +470,24 @@ void wlr_scene_node_place_below(struct wlr_scene_node *node,
 	scene_node_damage_whole(sibling);
 }
 
+void wlr_scene_node_raise_to_top(struct wlr_scene_node *node) {
+	struct wlr_scene_node *current_top = wl_container_of(
+		node->parent->state.children.prev, current_top, state.link);
+	if (node == current_top) {
+		return;
+	}
+	wlr_scene_node_place_above(node, current_top);
+}
+
+void wlr_scene_node_lower_to_bottom(struct wlr_scene_node *node) {
+	struct wlr_scene_node *current_bottom = wl_container_of(
+		node->parent->state.children.prev, current_bottom, state.link);
+	if (node == current_bottom) {
+		return;
+	}
+	wlr_scene_node_place_below(node, current_bottom);
+}
+
 void wlr_scene_node_reparent(struct wlr_scene_node *node,
 		struct wlr_scene_node *new_parent) {
 	assert(node->type != WLR_SCENE_NODE_ROOT && new_parent != NULL);