mirror of
https://github.com/Ellpeck/Coroutine.git
synced 2024-11-22 05:43:29 +01:00
added a convenience method that accepts a TimeSpan for Tick
This commit is contained in:
parent
9f4d43d730
commit
cf1b3c2db0
4 changed files with 20 additions and 4 deletions
|
@ -30,10 +30,14 @@ namespace Coroutine {
|
|||
return Instance.InvokeLater(wait, action, name, priority);
|
||||
}
|
||||
|
||||
/// <inheritdoc cref="CoroutineHandlerInstance.Tick"/>
|
||||
/// <inheritdoc cref="CoroutineHandlerInstance.Tick(double)"/>
|
||||
public static void Tick(double deltaSeconds) {
|
||||
Instance.Tick(deltaSeconds);
|
||||
}
|
||||
/// <inheritdoc cref="CoroutineHandlerInstance.Tick(TimeSpan)"/>
|
||||
public static void Tick(TimeSpan delta) {
|
||||
Instance.Tick(delta);
|
||||
}
|
||||
|
||||
/// <inheritdoc cref="CoroutineHandlerInstance.RaiseEvent"/>
|
||||
public static void RaiseEvent(Event evt) {
|
||||
|
|
|
@ -82,6 +82,15 @@ namespace Coroutine {
|
|||
});
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Ticks this coroutine handler, causing all time-based <see cref="Wait"/>s to be ticked.
|
||||
/// This is a convenience method that calls <see cref="Tick(double)"/>, but accepts a <see cref="TimeSpan"/> instead of an amount of seconds.
|
||||
/// </summary>
|
||||
/// <param name="delta">The time that has passed since the last time this method was invoked</param>
|
||||
public void Tick(TimeSpan delta) {
|
||||
this.Tick(delta.TotalSeconds);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Raises the given event, causing all event-based <see cref="Wait"/>s to be updated.
|
||||
/// </summary>
|
||||
|
|
|
@ -26,7 +26,7 @@ namespace Example {
|
|||
var lastTime = DateTime.Now;
|
||||
while (true) {
|
||||
var currTime = DateTime.Now;
|
||||
CoroutineHandler.Tick((currTime - lastTime).TotalSeconds);
|
||||
CoroutineHandler.Tick(currTime - lastTime);
|
||||
lastTime = currTime;
|
||||
Thread.Sleep(1);
|
||||
}
|
||||
|
|
|
@ -15,12 +15,12 @@ Additionally, Coroutine provides the following features:
|
|||
|
||||
# How to Use
|
||||
## Setting up the CoroutineHandler
|
||||
The `CoroutineHandler` is the place where coroutines get executed. For this to occur, the `Tick` method needs to be called continuously. The `Tick` method takes a single parameter which represents the amount of seconds since the last time it was called. It can either be called in your application's existing update loop or as follows.
|
||||
The `CoroutineHandler` is the place where coroutines get executed. For this to occur, the `Tick` method needs to be called continuously. The `Tick` method takes a single parameter which represents the amount of time since the last time it was called. It can either be called in your application's existing update loop or as follows.
|
||||
```cs
|
||||
var lastTime = DateTime.Now;
|
||||
while (true) {
|
||||
var currTime = DateTime.Now;
|
||||
CoroutineHandler.Tick((currTime - lastTime).TotalSeconds);
|
||||
CoroutineHandler.Tick(currTime - lastTime);
|
||||
lastTime = currTime;
|
||||
Thread.Sleep(1);
|
||||
}
|
||||
|
@ -59,11 +59,14 @@ private static IEnumerator<Wait> WaitForTestEvent() {
|
|||
Console.WriteLine("Test event received");
|
||||
}
|
||||
```
|
||||
Of course, having time-based waits and event-based waits in the same coroutine is also supported.
|
||||
|
||||
To actually cause the event to be raised, causing all currently waiting coroutines to be continued, simply call `RaiseEvent`:
|
||||
```cs
|
||||
CoroutineHandler.RaiseEvent(TestEvent);
|
||||
```
|
||||
|
||||
Note that, since `Tick` is an important lifecycle method, it has to be [called continuously](#Setting-up-the-CoroutineHandler) even if only event-based coroutines are used.
|
||||
|
||||
## Additional Examples
|
||||
For additional examples, take a look at the [Example class](https://github.com/Ellpeck/Coroutine/blob/master/Example/Example.cs).
|
Loading…
Reference in a new issue