View source for Debounce

<!-- manually recreated, no source archive -->
{{CatUp|Tutorials}}
__TOC__

== Introduction ==

A debounce system is a system that keeps a function from running too many times. It usually is used in a listener because a listener can be called many times while it's still working. 

== The basic idea ==

<pre>
enabled = true					--default is true, so that the function works
function dosomething()
	if not enabled then return end		--if enabled is not true, then return without doing anything.
	enabled = false				--set enabled to false, because this function is already doing something.
	--stuff is done here			
	enabled = true				--open up the function to be called again.
end
</pre>

Debouncing works by setting the "gate" variable (in this case, enabled) to false while it is performing the stuff it needs to do so that it won't get interrupted. After it is finished, it sets it back to true so that it can run again later. 

For example: 

<pre>
while true do
print("Hello world1!")     -- Prints Hello world1!

enabled = true					--default is true, so that the function works

function dosomething()
	if not enabled then return end		--if enabled is not true, then return without doing anything.
	enabled = false				--set enabled to false, because this function 
                                                --is already doing something.
print("Hello world2!")
wait (5)
	enabled = true				--open up the function to be called again.
end

dosomething()  -- calls the dosomething function and prints Hello world2!

end
</pre>

== Debounce in a real script ==

Here's the Local Gui script of the Rocket Launcher: 

<pre>
enabled = true
function onButton1Down(mouse)
	if not enabled then
		return
	end

	enabled = false
	mouse.Icon = "rbxasset://textures\\GunWaitCursor.png"

	wait(12)
	mouse.Icon = "rbxasset://textures\\GunCursor.png"
	enabled = true

end
</pre>

When you fire a rocket, the script shows the reload icon. Then the function waits for 12 seconds. During this time, enabled is false, so if the player tries to fire another rocket, the script won't run because the function will just return right away. After the 12 seconds are up, the reload cursor goes away and enabled becomes true again, allowing the user to fire another rocket. 

[[Category: Scripting Tutorials]]