btn

btn [id: 0..31] -> pressed

Parameters:

id : the id of the key we want to interrogate, see the key map for reference

Description:

This function allows to read the status of one of the buttons attached to TIC. The function returns true when the key interrogated using its id is currently in the pressed state. It remains true for as long as the key is held. If you want to test if a key was just pressed, use btnp instead,

Old example courtesy of Rain_Effect:

Example

--Key Test Project
--By Rain_Effect
local x=70
local y=25
local btnLabel={"Up","Down","Left","Right","Btn A","Btn B"}
function TIC()
  cls(0)

  print("Key Test Project",x,y)
  print("Btn",x,y+15,2)
  print("1P",x+50,y+15,2)
  print("2P",x+80,y+15,2)

  for i=1,6 do
    print(btnLabel[i],x,y+(i+1)*10+5)

    if btn(i-1) then
      print("On",x+50,y+(i+1)*10+5,11)
    else
      print("Off",x+47,y+(i+1)*10+5,6)
    end

    if btn(i+7) then
      print("On",x+80,y+(i+1)*10+5,11)
    else
      print("Off",x+77,y+(i+1)*10+5,6)
    end
  end
end