renpy.show - Ren'Py Visual Novel Engine

documentation index ◦ reference manual ◦ function index

# renpy.show

Function: | renpy.show | (name, at_list=[], layer='master', what=None, zorder=0, tag=None, behind=None):

This is used to execute the show statement, adding the named image to the screen.

name - The name of the image to add to the screen. This may be a tuple of strings, or a single string. In the latter case, it is split on whitespace to make a tuple.

at_list - The at list, a list of functions that are applied to the image when shown. The members of the at list need to be pickleable if sticky_positions is True.

layer - The layer the image will be shown on.

what - If not None, this is expected to be a displayable. That displayable is shown, instead of going through the normal lookup process.

zorder - The zorder of this image.

tag - The tag of this image. If None, the tag is taken from name.

behind - A list of tags this image will be shown behind, if they are present on the same layer at the same zorder, and an image with the same tag is not already present on the layer.

## Example

    init:
        python:
            for slideindex in range(10):
                # images are named slide0.png...slide9.png
                renpy.image('slide%d' % slideindex,
                            'slide%d.png' % slideindex)

    "And now, a slideshow"
    python:
        for slideindex in range(10):
            # clear all images
            renpy.scene()

            renpy.show('slide%d' % slideindex)

            # set the transition for the pause interaction
            renpy.transition(dissolve)

            renpy.pause(3.0)

    scene bg washington
    "Wasn't that nice?"

documentation index ◦ reference manual ◦ function index