Color grading and filters

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

• Apply color filters for narrative clarity.
• Prefer built-in transforms before custom shaders.
• Understand platform limits for blur and GPU effects.

Core syntax

• Matrixcolor
• blur
• tint
• grayscale
• depth of field

Runnable example

# 在图像定义里固定调色
image bg_room_sepia = Transform("bg/room.png", matrixcolor=SepiaMatrix())

# 在 ATL/at 里动态调色（可动画）
transform tint_blue:
    matrixcolor TintMatrix("#aaccff")

label start:
    show bg room at tint_blue

Study outline

• Start with the smallest example for color grading and filters.
• Test the key terms in a clean Ren'Py project: Matrixcolor, blur, tint, grayscale.
• 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/matrixcolor.html
• Ren'Py official reference: https://www.renpy.org/doc/html/transform_properties.html

How this fits in GenPy

• Use Performance Editor to plan mood changes and local preview for GPU-heavy effects.
• Keep exported code simple enough to maintain.

Recommended GenPy docs:

• Performance Editor
• Code editor
• Export and download