Special effects overview

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

• Choose the simplest effect system that works.
• Understand performance and platform risks before adding effects.
• Use advanced effects as reusable building blocks.

Core syntax

• ATL function
• layers
• screens
• displayables
• shader
• performance

Runnable example

init python:
    def my_effect(trans, st, at):
        # trans: 变换对象，改它的属性即可（trans.xoffset/zoom/rotate/alpha...）
        # st: 本函数开始以来的秒数；at: 同 tag 显示以来的秒数
        trans.xoffset = 10
        return 0      # 返回 0 = 下一帧立即再调用；返回 None = 结束

transform my_transform:
    function my_effect

Study outline

• Start with the smallest example for special effects overview.
• Test the key terms in a clean Ren'Py project: ATL function, layers, screens, displayables.
• 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/

How this fits in GenPy

• Use Performance Editor to prototype timing and presentation.
• Use Code mode and local Ren'Py preview for advanced effects.

Recommended GenPy docs:

• Performance Editor
• Code editor
• Desktop App