From c855c8725b73a38e9da687c00fcb6359af9693e9 Mon Sep 17 00:00:00 2001
From: Caitlyn Stewart <caitlynrosestewart@gmail.com>
Date: Tue, 3 Jun 2025 01:37:06 +0100
Subject: [PATCH] single-pixel-buffer-v1: clarify create_u32_rgba_buffer

Signed-off-by: Caitlyn Stewart <caitlynrosestewart@gmail.com>
---
 staging/single-pixel-buffer/single-pixel-buffer-v1.xml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/staging/single-pixel-buffer/single-pixel-buffer-v1.xml b/staging/single-pixel-buffer/single-pixel-buffer-v1.xml
index b157155..bcbd038 100644
--- a/staging/single-pixel-buffer/single-pixel-buffer-v1.xml
+++ b/staging/single-pixel-buffer/single-pixel-buffer-v1.xml
@@ -58,6 +58,13 @@
         pre-multiplied alpha.
 
         The width and height of the buffer are 1.
+
+        The r, g, b and a arguments valid range is from UINT32_MIN (0)
+        to UINT32_MAX (0xffffffff).
+        
+        These arguments should be interpreted as a percentage, i.e.
+        - UINT32_MIN = 0% of the given color component
+        - UINT32_MAX = 100% of the given color component
       </description>
       <arg name="id" type="new_id" interface="wl_buffer"/>
       <arg name="r" type="uint" summary="value of the buffer's red channel"/>