#ifndef TIMING_H
#define TIMING_H

#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

void timing_init();
void timing_update();
void timing_update_no_sleep();
int64_t timing_lead_us();

// Emulation speed, as an absolute target clock in kHz rather than a percentage.
//
// The machine's clock is whatever -mhz selected (default 8, range 1..40), so a
// percentage on its own says nothing without knowing what it is a percentage
// of: "50%" is a different absolute speed on a machine started with -mhz 1 than
// on one started with -mhz 12. kHz is unambiguous, and does not lose precision
// at the very low speeds that are useful for watching a routine execute.
//
// Warp mode bypasses throttling entirely and ignores all of this.
#define TIMING_SPEED_MIN_KHZ 25      // 0.025 MHz - slow enough to follow by eye
#define TIMING_SPEED_MAX_KHZ 100000  // 100 MHz - well past any real hardware

int  timing_native_khz(void);        // the machine's own clock, from -mhz
int  timing_get_speed_khz(void);
void timing_set_speed_khz(int khz);  // clamped to the range above
void timing_reset_speed(void);       // back to the machine's own clock

// Step to the next/previous preset clock (direction > 0 faster, < 0 slower).
// The presets are anchored on speeds real hardware runs at, and always include
// the machine's own, so normal speed is reachable however it was started.
void timing_step_speed(int direction);

// The target as a percentage of the machine's clock, for display.
int  timing_get_speed_percent(void);

#ifdef __cplusplus
}
#endif

#endif