From 52df51c37afc3f34853680ffd4cd33c9ff7c5bdd Mon Sep 17 00:00:00 2001
From: JailDoctor <jaildoctor@gmail.com>
Date: Tue, 7 Dec 2021 14:10:53 +0100
Subject: [PATCH] Update 'btnp'

---
 btnp.md | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/btnp.md b/btnp.md
index 4d25b59..288471b 100644
--- a/btnp.md
+++ b/btnp.md
@@ -1,9 +1,31 @@
 # btnp(tecla)
-Aquesta funció torna `true` o `false` segons la tecla que s'especifica com a paràmetre s'haja acabat de polsar. Aquesta funció tornarà `true` nomes durant el primer cicle després de polsar la tecla. La funció germana, [btn](btn), torna `true` tot el temps que la tecla estiga polsada.
+Aquesta funció torna `true` o `false` segons la tecla que s'especifica com a paràmetre s'haja acabat de polsar. Tornarà `true` nomes durant el primer cicle després de polsar la tecla. La funció germana, [btn](btn), torna `true` tot el temps que la tecla estiga polsada.
+
+> Atenció: a aquesta funció li afectarà la repetició de teclat que tinga el sistema operatiu configurat.
+
+### Paràmetres
 
 `tecla`
 Una de les [constants](teclat) asociades al teclat.
 
+### Exemple
+```
+function init()
+    estat = 0
+end
+
+function update()
+    cls()
+    paper(COLOR_BLACK)
+    print("Polsa espai per a canviar el semafor.",0,0)
+    if btnp(KEY_SPACE) then
+        estat = (estat==2) and (0) or (estat + 1)
+    end
+    if estat==0 then paper(COLOR_RED) print(" ", 5, 5) end
+    if estat==1 then paper(COLOR_YELLOW) print(" ", 5, 6) end
+    if estat==2 then paper(COLOR_GREEN) print(" ", 5, 7) end
+end
+```
 ### Vore també
 * [btn(tecla)](btn)
 * [Constants de teclat](teclat)