# Game and multimedia framework for Nit
module gamnit
+
+import app
+
+import display
+import textures
+import programs
+
+import gamnit_android is conditional(android)
+import gamnit_linux is conditional(linux)
+
+redef class App
+
+ # Main `GamnitDisplay` initialized by `on_create`
+ var display: nullable GamnitDisplay = null
+
+ redef fun on_create
+ do
+ super
+
+ var display = new GamnitDisplay
+ display.setup
+ self.display = display
+ end
+
+ # Core of the frame logic, executed only when the display is visible
+ #
+ # This method should be redefined by user modules to customize the behavior of the game.
+ protected fun frame_core(display: GamnitDisplay) do end
+
+ # Full frame logic, executed even if the display is not visible
+ #
+ # This method wraps `frame_core` and other services to be executed in the main app loop.
+ #
+ # To customize the behavior on each turn, it is preferable to redefined `frame_core`.
+ # Still, `frame_full` can be redefined with care for more control.
+ protected fun frame_full
+ do
+ var display = display
+ if display != null then frame_core(display)
+
+ feed_events
+ end
+
+ redef fun run
+ do
+ # TODO manage exit condition
+ loop frame_full
+ end
+
+ # Loop on available events and feed them back to the app
+ #
+ # The implementation varies per platform.
+ private fun feed_events do end
+
+ # Hook to receive and respond to `event` triggered by the user or system
+ #
+ # Returns whether or not the event is used or intercepted.
+ # If `true`, the event will not be processed further by the system.
+ # Returns `false` to intercepts events like the back key on mobile devices.
+ #
+ # The instances passed as `event` may be freed (or overwritten),
+ # right after this method returns. They should not be preserved.
+ fun accept_event(event: InputEvent): Bool do return false
+
+ # The window has been resized by the user or system
+ #
+ # The framework handles resizing the viewport automatically.
+ fun on_resize(display: GamnitDisplay) do end
+end