Whilevarn - EDukeWiki

# Whilevarn

From EDukeWiki

whilevarn <gamevar> <value> { code to execute }
whilevarvarn <gamevar> <gamevar> { code to execute }

Executes the code in the curly braces as long as <gamevar> does not equal <value>. This is a simple while loop.

Caution: Poor execution or endless loops will cause your game to close without error or simply stall and crash!

This example will set up the palette of the floor from all sectors on the map:

    gamevar TEMP 0 0
    onevent EVENT_LOADACTOR
      setvar TEMP 0
      whilevarvarn TEMP NUMSECTORS
      {
        setsector[TEMP].floorpal 1
        addvar TEMP 1
      }
    endevent

There's no variable keeping the number of sprites in the map. The sprites may be randomly arranged throughout the array with a maximum of 16384 entries. An example of a correct per-sprite loop:

    setvar sectnum 0
    whilevarvarn sectnum NUMSECTORS
    {
      headspritesect I sectnum
      setvarvar HEAD I
      whilevarn I -1 {
        // LOOP CODE
        nextspritesect I I
        ifvarvare I HEAD setvar I -1 // Break the loop
      }
      addvar sectnum 1
    }

Commands with an additional "var" suffix take gamevars rather than constants or defined labels for their inputs.

Retrieved from "http://wiki.eduke32.com/w/index.php?title=Whilevarn&oldid=9980"
Category:

- EDuke32 specific commands