Showing images

This page is part of the GenPy Ren'Py learning path. It focuses on practical Ren'Py 8.x production and links each concept back to the GenPy workflow.

Learning goals

• Define and reference images safely.
• Use scene/show/hide for common visual changes.
• Understand attributes and placement basics.

Core syntax

• image
• scene
• show
• hide
• at
• with

Runnable example

image eileen happy = "eileen/happy.png"
image eileen sad   = "eileen/sad.png"
image bg room      = "bg/room.png"

Study outline

• Start with the smallest example for showing images.
• Test the key terms in a clean Ren'Py project: image, scene, show, hide.
• Move the pattern back into your real project only after the example runs.
• Use GenPy docs and validation to keep the feature connected to story, assets, and export readiness.

Common pitfalls

• Test the smallest working script before layering on visual or UI complexity.
• Run Ren'Py Lint before release builds, even when the script appears to run locally.
• Keep examples in standard .rpy files so they remain editable outside GenPy.

Official references

• Ren'Py official reference: https://www.renpy.org/doc/html/displaying_images.html
• Ren'Py official reference: https://www.renpy.org/doc/html/displayables.html

How this fits in GenPy

• Use the Performance Editor to stage backgrounds, sprites, and scene beats visually.
• Use Assets to keep filenames and folders export-friendly.

Recommended GenPy docs:

• Performance Editor
• Export and download
• Export and download