:mod:`pygame2.sdl.time` -- SDL time handling and measurement wrapper module
===========================================================================

SDL time handling and measurement wrapper module

.. module:: pygame2.sdl.time
   :synopsis: SDL time handling and measurement wrapper module

Module Functions
----------------
.. function:: add_timer (interval, callable[, data]) -> CObject

  Adds a timer callback to be called periodically.

  Adds a timer callback to be called periodically using the specified
  *interval*. *callable* can be any callable objet, method or function. On
  invocation, the optional *data* will be passed to the callable.

  This will return an CObject that acts as unique id for the timer callback.



.. function:: delay (time) -> None

  Delays the execution for a specific time.

  Delays the program execution for a specific *time*. The *time* is
  expressed in milliseconds.



.. function:: get_ticks () -> long

  Gets the number of milliseconds since the initialization of the underlying
  SDL library.

  Gets the number of milliseconds since the initialization of the underlying
  SDL library. The value will wrap if the program runs for more than ~49
  days.



.. function:: init () -> None

  Initializes the timer subsystem of the SDL library.



.. function:: quit () -> None

  Shuts down the timer subsystem of the SDL library.

  After calling this function, you should not invoke any class,
  method or function related to the timer subsystem as they are
  likely to fail or might give unpredictable results.



.. function:: remove_timer (timerobj) -> None

  Removes a previously added timer callback.

  Removes a previously added timer callback and throws an exception, if the
  passed object is not a matching timer object.



.. function:: set_timer (interval, callable) -> None

  Sets a single timer callback to be called periodically.

  Sets a single timer callback to be called periodically using the specified
  *interval* in milliseconds. The timer callback can be reset by passing
  None as *callable* object.



.. function:: was_init () -> bool

  Returns, whether the timer subsystem of the SDL library is initialized.




