lua: add lilka.show_fps

docs/lua/lilka.rst

@@ -1,5 +1,5 @@
-``lilka``: Автоматичні функції
-==============================
+``lilka``: Спеціальні функції
+=============================
 
 Цей модуль описує функції, які ви можете визначити в своєму коді, щоб вони викликались автоматично в певних ситуаціях.
 
@@ -27,3 +27,8 @@
     Ця функція автоматично викликається після `lilka.update`. Тут відбувається відображення графіки.
 
     Ви повинні визначити її в своєму коді, якщо ви хочете використовувати її для малювання вашої програми.
+
+.. lua:autoclass:: lilka
+
+    .. Does not work with aliases... So we have to copy-paste the stuff above.
+    .. :members: init, update, render

firmware/main/sdcard/asteroids/asteroids.lua

@@ -21,6 +21,8 @@ MAGENTA = display.color565(255, 0, 255)
 -- ROOT = 'asteroids/'
 ROOT = ''
 
+-- lilka.show_fps = true
+
 -------------------------------------------------------------------------------
 -- Загальні константи
 -------------------------------------------------------------------------------

sdk/addons/lualilka/library/lilka.lua

@@ -1,19 +1,22 @@
 ---@meta
 
 ---@class lilka
+---@field show_fps boolean Показувати частоту кадрів на екрані, якщо встановлено в ``true``. Наприклад: ``lilka.show_fps = true``
 lilka = {}
 
 ---Ця функція автоматично викликається один раз при запуску програми.
 ---
 ---Ви повинні визначити її в своєму коді, якщо ви хочете використовувати її для ініціалізації вашої програми.
----lilka.init fun()
+---@alias lilka.init fun()
+
 ---Ця функція автоматично викликається кожен кадр. Тут виконується ігрова логіка. В параметрі delta передається час, який пройшов з останнього кадру.
 ---
 ---Ви повинні визначити її в своєму коді, якщо ви хочете використовувати її для оновлення вашої програми.
----lilka.update fun(delta: number)
+---@alias lilka.update fun(delta: number)
+
 ---Ця функція автоматично викликається після `lilka.update`. Тут відбувається відображення графіки.
 ---
 ---Ви повинні визначити її в своєму коді, якщо ви хочете використовувати її для малювання вашої програми.
----lilka.render fun()
+---@alias lilka.render fun()
 
 return lilka

sdk/lib/lilka/src/lua/luarunner.cpp

@@ -57,7 +57,7 @@ bool callUpdate(lua_State* L, uint32_t delta) {
         lua_pop(L, 1);
         return false;
     }
-    lua_pushnumber(L, delta / 1000.0);
+    lua_pushnumber(L, ((float)delta) / 1000.0);
     int retCode = lua_pcall(L, 1, 0, 0);
     lua_Debug dbg;
     if (retCode) {
@@ -129,6 +129,15 @@ int execute(lua_State* L) {
                 serial_log("lua: no update or draw function");
             }
 
+            // Check if show_fps is true and render FPS
+            lua_getfield(L, -1, "show_fps");
+            if (lua_toboolean(L, -1)) {
+                canvas->setCursor(24, 24);
+                canvas->setTextColor(0xFFFF, 0);
+                canvas->print(String("FPS: ") + (1000 / (delta > 0 ? delta : 1)) + "  ");
+            }
+            lua_pop(L, 1);
+
             display.renderCanvas(*canvas);
 
             // Calculate time spent in update
@@ -202,6 +211,9 @@ lua_State* lua_setup(const char* dir) {
 
     // Set global "lilka" table for user stuff
     lua_newtable(L);
+    // Add show_fps attribute to lilka table that defaults to false
+    lua_pushboolean(L, false);
+    lua_setfield(L, -2, "show_fps");
     lua_setglobal(L, "lilka");
 
     return L;