documentation index ◦ reference manual ◦ function index

# renpy.roll_forward_info

Function: | renpy.roll_forward_info | ():

When re-executing a statement after rollback, this returns the data stored using renpy.checkpoint the last time this statement was executed. If this statement is not being re-executed due to a rollback, this returns None.

Often, this data is passed as the roll_forward parameter of ui.interact. It's important to check to ensure that the value is valid before using it in this way.

## Example

    python:
        roll_forward = renpy.roll_forward_info()
        if roll_forward not in ("rock", "paper", "scissors"):
            roll_forward = None

        ui.hbox()
        ui.imagebutton("rock.png", "rock_hover.png", clicked=ui.returns("rock"))
        ui.imagebutton("paper.png", "paper_hover.png", clicked=ui.returns("paper"))
        ui.imagebutton("scissors.png", "scissors_hover.png", clicked=ui.returns("scissors"))
        ui.close()

        choice = ui.interact(roll_forward=roll_forward)
        renpy.checkpoint(choice)

documentation index ◦ reference manual ◦ function index