New Room Section

The new room section of a logic is a section of code that runs during the first interpreter cycle in a new room and does not run again unless the player leaves the room and re-enters it. This section is used to perform initialization of the variables, flags, objects, and other data used by the room - in other words, the new room section contains code that you would only want to run once in a room.

The new room section is controlled by the special flag f5 (or new_room, in the AGI Studio Template Game). This flag is set during the first cycle through a new room and is reset after that cycle has completed.

A typical new room section will contain code like the following:

Code:

  #define new_room f5
  #define room_no  v0
  #define ego      o0

  if (new_room)
  {
    /* new room section */

    load.pic(room_no);
    draw.pic(room_no);
    discard.pic(room_no);

    draw(ego);
    show.pic();
  }

 

See also

• new.room
• load.pic
• draw.pic
• discard.pic
• draw
• show.pic