ProtoFlux:Async Range Loop Int: Difference between revisions

From Resonite Wiki
cleanup
 
(7 intermediate revisions by 4 users not shown)
Line 4: Line 4:
|Inputs=
|Inputs=
[
[
{"Name": "*", "Type": "AsyncImpulse"},
{"Name": "*", "Type": "AsyncCall"},
{"Name": "Start", "Type": "int"},
{"Name": "Start", "Type": "int"},
{"Name": "End", "Type": "int"},
{"Name": "End", "Type": "int"},
Line 11: Line 11:
|Outputs=
|Outputs=
[
[
{"Name": "LoopStart", "Type":"AsyncImpulse"},
{"Name": "LoopStart", "Type":"AsyncCall"},
{"Name": "LoopIteration", "Type":"AsyncImpulse"},
{"Name": "LoopIteration", "Type":"AsyncCall"},
{"Name": "LoopEnd", "Type": "Continuation"},
{"Name": "LoopEnd", "Type": "Continuation"},
{"Name": "Current", "Type": "int"}
{"Name": "Current", "Type": "int"}
]
]
|}}
|}}
The '''Async Range Loop Int''' node is the [[async]] analogue to the [[ProtoFlux:Range Loop Int|Range Loop Int]] node. It is used to perform looping operations by allowing one to define a range of values and step size for iterations to follow. It is a more flexible version of the [[ProtoFlux:Async For|Async For]] node.
== Inputs ==
=== * ([[Impulses#ASync|IAsyncOperation]]) ===
Begin the range loop.
=== Start ([[Type:Int|int]]) ===
The number for <code>Current</code> to start at during execution.
=== End ([[Type:Int|int]]) ===
The number for <code>Current</code> to iterate towards and compare to during execution. This input is inclusive.
=== StepSize ([[Type:Int|int]]) ===
The value that is added or subtracted to <code>Current</code> per iteration for the current <code>LoopIteration</code>. The loop will either add or subtract this value depending on whether <code>Start</code> is less than or greater than <code>End</code>. There will be no iterations if this value is less than <code>1</code>.
{{Note|As of the time of writing, [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/3350 this node does not account for overflow or underflow when evaluating the loop range]. To avoid this issue, make sure that <code>2147483647 - End <nowiki>&gt;=</nowiki> StepSize</code> when going forwards or <code>2147483648 + End <nowiki>&gt;=</nowiki> StepSize</code> when going backwards.|warning}}
== Outputs ==
=== LoopStart ([[Impulses#ASync|AsyncCall]]) ===
Fires after <code>*</code> is pulsed and before any iterations are done. Will be pulsed even if <code>StepSize < 1</code>.
=== LoopIteration ([[Impulses#ASync|AsyncCall]]) ===
Fires for each iteration of the loop. This impulse is triggered until <code>Current</code> exceeds <code>End</code> in the direction of the loop, at which point the iterations will stop.
=== LoopEnd ([[Impulses|Continuation]]) ===
Fires once the loop has finished.
=== Current ([[Type:Int|int]]) ===
This value will start at <code>Start</code> for the first iteration, then at each iteration, this value will either increase or decrease by <code>StepSize</code> depending on whether <code>End</code> is greater than or less than <code>Start</code>. This value lasts for said iteration's entire [[context]].
== Examples ==


[[Category:ProtoFlux:Flow:Async]]
[[Category:ProtoFlux:Flow:Async]]

Latest revision as of 02:55, 13 December 2024

Async Range Loop
*
LoopStart
Start
LoopIteration
End
LoopEnd
StepSize
Current
Async

The Async Range Loop Int node is the async analogue to the Range Loop Int node. It is used to perform looping operations by allowing one to define a range of values and step size for iterations to follow. It is a more flexible version of the Async For node.

Inputs

* (IAsyncOperation)

Begin the range loop.

Start (int)

The number for Current to start at during execution.

End (int)

The number for Current to iterate towards and compare to during execution. This input is inclusive.

StepSize (int)

The value that is added or subtracted to Current per iteration for the current LoopIteration. The loop will either add or subtract this value depending on whether Start is less than or greater than End. There will be no iterations if this value is less than 1.

As of the time of writing, this node does not account for overflow or underflow when evaluating the loop range. To avoid this issue, make sure that 2147483647 - End >= StepSize when going forwards or 2147483648 + End >= StepSize when going backwards.

Outputs

LoopStart (AsyncCall)

Fires after * is pulsed and before any iterations are done. Will be pulsed even if StepSize < 1.

LoopIteration (AsyncCall)

Fires for each iteration of the loop. This impulse is triggered until Current exceeds End in the direction of the loop, at which point the iterations will stop.

LoopEnd (Continuation)

Fires once the loop has finished.

Current (int)

This value will start at Start for the first iteration, then at each iteration, this value will either increase or decrease by StepSize depending on whether End is greater than or less than Start. This value lasts for said iteration's entire context.

Examples