m fix types, stub |
cleanup |
||
(5 intermediate revisions by 3 users not shown) | |||
Line 11: | Line 11: | ||
|Outputs= | |Outputs= | ||
[ | [ | ||
{"Name": "LoopStart", "Type":" | {"Name": "LoopStart", "Type":"AsyncCall"}, | ||
{"Name": "LoopIteration", "Type":" | {"Name": "LoopIteration", "Type":"AsyncCall"}, | ||
{"Name": "LoopEnd", "Type": "Continuation"}, | {"Name": "LoopEnd", "Type": "Continuation"}, | ||
{"Name": "Current", "Type": "int"} | {"Name": "Current", "Type": "int"} | ||
Line 18: | Line 18: | ||
|}} | |}} | ||
{{ | 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>>=</nowiki> StepSize</code> when going forwards or <code>2147483648 + End <nowiki>>=</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
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
.
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.