Skip to main content

Scene2D Basics

Scene2D uses Scene, Entity, and 2D renderer components.

Minimal Scene2D Setup​

Init method() {
  window is Window.Create(1280, 720, "Scene2D");
  scene is Scene.Create();

  cameraEntity is scene.CreateEntity("Camera");
  camera is cameraEntity.AddCamera2D();
  camera.SetPrimary(true);
  camera.SetZoom(1.25);

  spriteEntity is scene.CreateEntity("Sprite");
  sprite is spriteEntity.AddSpriteRenderer2D();
  sprite.SetTexture(Texture2D.Load("examples/assets/checker.png"));
  sprite.SetSize(Vector2(2.0, 2.0));

  renderer is Renderer2D.Create();
  renderer.SetCamera(camera);

  canvas(window) {
    OnFrame {
      renderer.Render(scene);
    }
  }
}

Common 2D Components​

  • Camera2D
  • SpriteRenderer2D
  • ShapeRenderer2D
  • TextRenderer2D

Each component can be added only once per entity for its type.

Ordering in 2D​

For sprite/shape/text renderers:

  • SetSortingLayer(int)
  • SetOrderInLayer(int)

Use these to control draw order.

Next Steps​