From ffadc23cab725828a3a38646d3efa10bd551f7b2 Mon Sep 17 00:00:00 2001
From: Matthias Melcher <github@matthiasm.com>
Date: Thu, 9 Feb 2023 14:48:39 +0100
Subject: Expose elapsed time API (#670)

---
 FL/Fl.H             |  7 +++++++
 FL/platform_types.h | 21 +++++++++++++++++++++
 2 files changed, 28 insertions(+)

(limited to 'FL')

diff --git a/FL/Fl.H b/FL/Fl.H
index d33ff393c..925daa591 100644
--- a/FL/Fl.H
+++ b/FL/Fl.H
@@ -470,6 +470,13 @@ public:
   static void add_check(Fl_Timeout_Handler, void* = 0);
   static int  has_check(Fl_Timeout_Handler, void* = 0);
   static void remove_check(Fl_Timeout_Handler, void* = 0);
+
+  static Fl_Timestamp now();
+  static double seconds_since(Fl_Timestamp& then);
+  static double seconds_between(Fl_Timestamp& back, Fl_Timestamp& further_back);
+  static long ticks_since(Fl_Timestamp& then);
+  static long ticks_between(Fl_Timestamp& back, Fl_Timestamp& further_back);
+
   // private
   static void run_idle();
   static void run_checks();
diff --git a/FL/platform_types.h b/FL/platform_types.h
index b55544d4c..421a0b7c6 100644
--- a/FL/platform_types.h
+++ b/FL/platform_types.h
@@ -12,6 +12,9 @@
  *     https://www.fltk.org/bugs.php
  */
 
+#ifndef Fl_Platform_Types_H
+#define Fl_Platform_Types_H
+
 /** \file
  Definitions of platform-dependent types.
  The exact nature of these types varies with the platform.
@@ -62,6 +65,13 @@ typedef opaque FL_SOCKET; /**< socket or file descriptor */
  */
 typedef struct opaque *GLContext;
 
+/**
+ Platform-specific point in time, used for delta time calculation.
+ \note This type may be a struct. sizeof(Fl_Timestamp) may be different on
+ different platforms. Fl_Timestamp may change with future ABI changes.
+ */
+typedef opaque Fl_Timestamp;
+
 #  define FL_COMMAND  opaque   /**< An alias for FL_CTRL on Windows and X11, or FL_META on MacOS X */
 #  define FL_CONTROL  opaque   /**< An alias for FL_META on Windows and X11, or FL_CTRL on MacOS X */
 
@@ -127,4 +137,15 @@ extern FL_EXPORT int fl_control_modifier();
 
 #endif /* FL_PLATFORM_TYPES_H */
 
+// This is currently the same for all platforms, but may change in the future
+struct Fl_Timestamp_t {
+  long sec;
+  long usec;
+};
+
+typedef struct Fl_Timestamp_t Fl_Timestamp;
+
 #endif /* FL_DOXYGEN */
+
+#endif /* Fl_Platform_Types_H */
+
-- 
cgit v1.2.3