Step Editor: Next Step

This tab lets you select the next step to execute when the step meets its condition. By default the next step is executed. However you can also go to a different step. If you check the "Bookmark Place" box, GP3EZ will "hold your place" and then go to the new step. This allows you to call subroutines.

As of V1.4 there is an additional option on this screen (which is set by default) that causes GP3EZ to wait for the GP3 hardware to complete any actions pending before advancing to the next step. This matches the behavior of compiled scripts. If you uncheck the box, some operations will occur at the same time as the GP3 operations. This is easy to notice when working with long pulses or tones. For example, if you produce a tone with a 1000mS time, and the next step has a 1000mS delay on the condition tab, you'll see the difference. If you make the tone-generating step wait for completion, the first step will wait until the tone completes before continuing. If you clear the option, the first step will start the tone and the second step's delay will be (mostly) concurrent with the tone. Unless you have a specific reason, keep the option checked (which is the default).

GP3EZ maintains three "loop counters" A, B, and C. You can initialize them on the action tab. If the Loop box is checked, GP3EZ decreases the indicated counter. If the count is greater than zero, the go to you specify is executed. If the count is 0 or less, GP3EZ proceeds with the next step.

If you build a subroutine, the last step would use the "Last Bookmark" selection to go back to the previous bookmark. In non-compiled code you can have up to 255 pending bookmarks.