Vertex Docs

Scene

Description: A Scene represents a single state of your game (e.g. Main Menu, Gameplay, Pause Screen). Each Scene is a QWidget and is managed by the SceneManager.

Scenes handle game logic in update() and rendering in draw(). Only one scene can be active at a time.

Example: Usage

from VertexEngine.scenes import Scene

class Main(Scene):
    def __init__(self, engine):
        super().__init__(engine)

    def update(self):
        print("Updating game logic")

    def draw(self, surface):
        # Draw your game here
        pass

Lifecycle Methods

• on_enter()
  Called automatically when the scene becomes active. The scene receives focus here.
• on_exit()
  Called when the scene is removed or replaced. Use this to clean up timers, sounds, or resources.

Main Methods

• update()
  Runs every frame. Put all game logic here (input handling, physics, AI, state changes).
• draw(surface)
  Runs every frame. Put all rendering code here.

Parameters

• engine (GameEngine)
  The main engine instance. Used as the parent widget and to access engine systems.

Notes

• Only the active scene receives updates and draw calls
• Scenes automatically inherit the engine's focus policy
• Designed to work with SceneManager