This page is out of date

You've reached a page on the Ren'Py wiki. Due to massive spam, the wiki hasn't been updated in over 5 years, and much of the information here is very out of date. We've kept it because some of it is of historic interest, but all the information relevant to modern versions of Ren'Py has been moved elsewhere.

Some places to look are:

Please do not create new links to this page.


renpy.show

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?"