In earlier lessons, we saw how to draw shapes and handle mouse events for individual elements in SDL. While this works for simple examples, managing dozens or hundreds of elements directly in our main function quickly becomes unmanageable.

This lesson introduces techniques for structuring larger SDL applications. We'll learn how to create "manager" classes that take responsibility for specific parts of the program, keeping our main code clean and organized.

We will cover:

Creating a UI manager class.
Using std::vector to manage multiple components dynamically.
Applying inheritance to create specialized components.
Leveraging polymorphism to handle different component types uniformly.
Building hierarchies of managers for complex UIs.

Starting Point

We'll build upon the code from our previous lesson. This starting point includes an SDL application that initializes the library, creates a Window, and manages a single Rectangle object. The Rectangle handles its own rendering and responds to mouse hover and click events.

Files

src

Select a file to view its content

Manager Classes

In more complex projects, we're likely to find our game managing thousands or maybe millions of objects. We can't just orchestrate all of them from our main function - that would quickly get unmanageable.

To deal with this, we can introduce intermediate manager classes that take ownership over some area of our program. For example, we might have a UI class, responsible for managing all the buttons and menus in our program.

That class would need to react to events and render the objects it manages, so let's add HandleEvent() and Render() functions:

src/UI.h

1#pragma once
2#include <SDL3/SDL.h>
3
4class UI {
5public:
6  void Render(SDL_Surface* Surface) const {
7    // ...
8  }
9
10  void HandleEvent(SDL_Event& E) {
11    // ...
12  }
13};

Now, in our main function, managing the entire UI only requires three lines of code. We construct a UI manager, we notify it of events, and we render it:

src/main.cpp

1#include <SDL3/SDL.h>
2#include <SDL3/SDL_main.h>
3#include "Window.h"
4#include "Rectangle.h"
5#include "UI.h"
6
7int main(int, char**) {
8  SDL_Init(SDL_INIT_VIDEO);
9  Window GameWindow;
10  Rectangle Rect{SDL_Rect{50, 50, 50, 50}};
11  UI UIManager;
12
13  bool IsRunning = true;
14  SDL_Event Event;
15  while (IsRunning) {
16    while (SDL_PollEvent(&Event)) {
17      Rect.HandleEvent(Event);
18      UIManager.HandleEvent(Event);
19      if (Event.type == SDL_EVENT_QUIT) {
20        IsRunning = false;
21      }
22    }
23
24    GameWindow.Render();
25    Rect.Render(GameWindow.GetSurface());
26    UIManager.Render(GameWindow.GetSurface());
27    GameWindow.Update();
28  }
29
30  SDL_Quit();
31  return 0;
32}

Let's add some objects for our UI to manage. We'll create three rectangles and, every time our UI receives an event or a request to render, it forwards that request to all of its children:

src/UI.h

1#pragma once
2#include <SDL3/SDL.h>
3#include "Rectangle.h"
4
5class UI {
6public:
7  void Render(SDL_Surface* Surface) const {
8    A.Render(Surface);
9    B.Render(Surface);
10    C.Render(Surface);
11  }
12
13  void HandleEvent(SDL_Event& E) {
14    A.HandleEvent(E);
15    B.HandleEvent(E);
16    C.HandleEvent(E);
17  }
18
19private:
20  Rectangle A{SDL_Rect{50, 50, 50, 50}};
21  Rectangle B{SDL_Rect{150, 50, 50, 50}};
22  Rectangle C{SDL_Rect{250, 50, 50, 50}};
23};

Dynamic Children

A manager class can have a dynamic number of children by storing them in a container such as a std::vector. Below, we update our UI class to manage 60 rectangles.

Our constructor uses some loops to create all of our rectangles, and some arithmetic to position them into a grid layout:

src/UI.h

1#pragma once
2#include <SDL3/SDL.h>
3#include <vector>
4#include "Rectangle.h"
5
6class UI {
7public:
8  UI() {
9    int RowCount{5}, ColCount{12};
10    Rectangles.reserve(RowCount * ColCount);
11    for (int Row{0}; Row < RowCount; ++Row) {
12      for (int Col{0}; Col < ColCount; ++Col) {
13        Rectangles.emplace_back(SDL_Rect{
14          60 * Col, 60 * Row, 50, 50
15        });
16      }
17    }
18  }
19
20  void Render(SDL_Surface* Surface) const {
21    // ...
22  }
23
24  void HandleEvent(SDL_Event& E) {
25    // ...
26  }
27
28private:
29  std::vector<Rectangle> Rectangles;
30};

When a UI receives a Render() or HandleEvent() request, it now iterates over all of the elements in its array, forwarding the request to each of them:

src/UI.h

1// ...
2
3class UI {
4public:
5  // ...
6  void Render(SDL_Surface* Surface) const {
7    for (auto& Rectangle : Rectangles) {
8      Rectangle.Render(Surface);
9    }
10  }
11
12  void HandleEvent(SDL_Event& E) {
13    for (auto& Rectangle : Rectangles) {
14      Rectangle.HandleEvent(E);
15    }
16  }
17
18  // ...
19};

Screenshot showing the program rendering a grid of red rectangles

Inheritance

Remember, once we have a class set up, we can use inheritance to extend that class, or provide variations. Let's create a GreenRectangle class that inherits from our Rectangle.

We'll just forward the SDL_Rect to the inherited constructor and then, from the constructor body, set our color to green:

src/GreenRectangle.h

1#pragma once
2#include <SDL3/SDL.h>
3#include "Rectangle.h"
4
5class GreenRectangle : public Rectangle {
6 public:
7  GreenRectangle(const SDL_Rect& Rect)
8  : Rectangle{Rect} {
9    SetColor({0, 255, 0, 255});
10  }
11};

In our UI class, we can switch to using green rectangles by updating the type of our array:

src/UI.h

1#pragma once
2#include <SDL3/SDL.h>
3#include <vector>
4#include "Rectangle.h"
5#include "GreenRectangle.h"
6
7class UI {
8// ...
9
10private:
11  std::vector<GreenRectangle> Rectangles;
12};

Screenshot showing the program rendering a grid of green rectangles

Polymorphism

When we're using inheritance, our UI class can store objects of varying types within the same collection. They just need to share the same base class, such as Rectangle.

To use polymorphism, our UI needs to store its children as pointers. We'll use std::unique_ptr to implement a model here, as the UI should conceptually "own" the objects that it is managing:

src/UI.h

1// ...
2#include <memory> // For std::unique_ptr
3
4class UI {
5public:
6
7  // ...
8
9private:
10  std::vector<std::unique_ptr<
11    Rectangle>> Rectangles;
12};

As our Rectangles array is now storing pointers rather than Rectangle values, we need to update our Render() and HandleEvent() functions to use the -> operator instead of .:

src/UI.h

1// ...
2
3class UI {
4public:
5  // ...
6  void Render(SDL_Surface* Surface) const {
7    for (auto& Rectangle : Rectangles) {
8      Rectangle.Render(Surface);
9      Rectangle->Render(Surface);
10    }
11  }
12
13  void HandleEvent(SDL_Event& E) {
14    for (auto& Rectangle : Rectangles) {
15      Rectangle.HandleEvent(E);
16      Rectangle->HandleEvent(E);
17    }
18  }
19  // ...
20};

Let's update our constructor to create an alternating grid of red and green rectangles using the :

src/UI.h

1#pragma once
2#include <SDL3/SDL.h>
3#include <vector>
4#include <memory>
5#include "Rectangle.h"
6#include "GreenRectangle.h"
7
8class UI {
9public:
10  UI() {
11    int RowCount{5}, ColCount{12};
12    Rectangles.reserve(RowCount * ColCount);
13    for (int Row{0}; Row < RowCount; ++Row) {
14      for (int Col{0}; Col < ColCount; ++Col) {
15        bool useGreen{(Row + Col) % 2 == 0};
16        Rectangles.emplace_back(useGreen
17        ? std::make_unique<GreenRectangle>(SDL_Rect{
18            60 * Col, 60 * Row, 50, 50})
19        : std::make_unique<Rectangle>(SDL_Rect{
20            60 * Col, 60 * Row, 50, 50})
21        );
22      }
23    }
24  }
25
26  // ...
27};

Screenshot showing the program rendering a grid of red and green rectangles

The `virtual` Keyword

In our previous example, our UI constructor is calling the GreenRectangle constructor on every other iteration of the loop. It is this constructor that sets the rectangle's color to green.

However, invocations of other functions, such as Render(), are using the base Rectangle version of that function, even if the Rectangle smart pointer is specifically pointing to a GreenRectangle. That worked in this case but, in more advanced inheritance examples, we might require a derived class like GreenRectangle to override the behavior of the Render() function entirely.

If we want derived classes to have the option to override the behavior of a function they're inheriting, we should add the virtual keyword to that function. We introduced virtual in our lesson on .

Applying it to Rectangle::Render(), for example, would look like this:

src/Rectangle.h

1// ...
2
3class Rectangle {
4 public:
5 // ...
6
7  virtual void Render(
8    SDL_Surface* Surface
9  ) const {
20  }
21  // ...
22};

Any derived class that overrides this function should add the override keyword:

src/GreenRectangle.h

1// ...
2
3class GreenRectangle : public Rectangle {
4 public:
5  // ...
6
7  void Render(
8    SDL_Surface* Surface
9  ) const override {
10    // ...
11  }
12};

When we want to use polymorphism, it is also highly recommended to mark the base class's destructor as virtual:

src/Rectangle.h

1// ...
2
3class Rectangle {
4 public:
5 // ...
6
7  virtual ~Rectangle() = default;
8  // ...
9};

This is because, if a derived type implements a custom destructor, we want to ensure that destructor is used even if the object is deleted through a reference to the base type.

Non-virtual destructors are a common source of memory leaks as, if the GreenRectangle allocates some memory in its constructor and deallocates it in the destructor, we want to make sure that destructor is used:

1// This will call the GreenRectangle constructor...
2Rectangle* Rect{
3  new GreenRectangle{SDL_Rect{1, 2, 3, 4}}
4};
5
6// ...so we want this to call the GreenRectangle destructor,
7// even though Rect is a base Rectangle pointer
8delete Rect;

Hierarchy

Our UI class successfully abstracts complexity away from main. However, in a large application with multiple distinct UI areas (like a header, main content area, and footer), the UI class itself could become overly complex, managing dozens or hundreds of disparate components.

We can address this simply by repeating the pattern again, introducing another layer of manager-style classes. We can do this as many times as needed, thereby creating a hierarchy of managers.

For example, instead of the main UI class managing every single rectangle, it can manage a few higher-level manager objects, each responsible for a specific section of the UI. For example, UI could own instances of Header, Footer, and Grid classes.

The Header class would manage components specific to the header, the Footer class would manage its components, and the Grid class would manage the grid of rectangles.

The top-level UI class then simply delegates tasks: UI::Render() calls Render() on Header, Grid, and Footer, and UI::HandleEvent() forwards events similarly:

src/UI.h

1#pragma once
2#include <SDL3/SDL.h>
3#include "Header.h"
4#include "Footer.h"
5#include "Grid.h"
6
7class UI {
8public:
9  void Render(SDL_Surface* Surface) const {
10    TopMenu.Render(Surface);
11    Rectangles.Render(Surface);
12    BottomMenu.Render(Surface);
13  }
14
15  void HandleEvent(SDL_Event& E) {
16    TopMenu.HandleEvent(E);
17    Rectangles.HandleEvent(E);
18    BottomMenu.HandleEvent(E);
19  }
20
21private:
22  Header TopMenu;
23  Grid Rectangles;
24  Footer BottomMenu;
25};

In this example program, the Header and Footer class both render a simple gray rectangle, whilst the Grid renders a grid of red rectangles:

Screenshot showing a program rendering a header, grid, and footer

For reference, the Header, Grid, and Footer classes used for this example are provided below:

Files

src

Select a file to view its content

Where Does the Logic Go?

If we think about our application design as layers in a hierarchy: main is the highest level, followed by UI, then section managers like Grid, and finally individual components like Rectangle.

Conceptually, we can think of code that is placed in classes or functions near the top of this hierarchy as being more impactful than code near the bottom. This is because code placed higher up should generally have broader scope and impact.

Good design practice suggests pushing functionality as far down this hierarchy as is reasonable. If a behavior relates only to how a rectangle draws itself or responds to input, that logic should live within the Rectangle class. It shouldn't clutter the more important Grid or UI classes, and least of all the main() function.

This concept, often related to encapsulation and cohesion, promotes locality. Keeping behavior close to the relevant data makes classes more independent, easier to test, and simpler to reason about. High-level classes stay focused on wider-scale coordination, leading to a cleaner overall architecture.

Component Reuse

Beyond managing complexity, building UIs from components also enables code reuse.

For example, let's imagine we wanted to add the ability to load and render an image in our Header class. Even if we can add the required logic without making the Header code excessively complex, it's probably a good idea to create a separate Image component anyway.

This is because the ability to render an image is likely to be useful in many parts of our application, not just the Header class. By creating a separate Image component for this purpose, our work can be reused across other parts of our application that require an image.

Diagram showing an Image Component reused multiple times across a complex UI hierarchy

We'll learn how to render images in the next chapter.

Complete Code

We'll reuse the concepts we covered in this lesson later in the course but, for now, we'll go back to a minimalist UI class that just renders two rectangles.

In the next lesson, we'll continue developing on this framework as we learn techniques that allow our components to communicate with their parents, and each other.

Files

src

Select a file to view its content

Summary

This lesson focused on structuring SDL programs to help manage complexity. We introduced the UI manager class to simplify main, used std::vector for dynamic component lists, created specialized components like GreenRectangle via inheritance, and managed mixed types using polymorphism and std::unique_ptr.

Key Takeaways:

Manager classes improve organization by encapsulating UI sections.
Use std::vector to manage variable numbers of components.
Inheritance allows extending base component functionality.
Polymorphism provides flexibility in handling different component types via base pointers.
Build UI hierarchies to manage complexity by delegating responsibility.
Component reuse and locality are important design goals.

Structuring SDL Programs

Starting Point

Files

Manager Classes

src/UI.h

src/main.cpp

src/UI.h

Dynamic Children

src/UI.h

src/UI.h

Inheritance

src/GreenRectangle.h

src/UI.h

Polymorphism

src/UI.h

src/UI.h

src/UI.h

The `virtual` Keyword

src/Rectangle.h

src/GreenRectangle.h

src/Rectangle.h

Hierarchy

src/UI.h

Files

Component Reuse

Complete Code

Files

Summary

Creating SDL3 Buttons

Game Development with SDL3

Structuring SDL Programs

Starting Point

Files

Manager Classes

src/UI.h

src/main.cpp

src/UI.h

Dynamic Children

src/UI.h

src/UI.h

Inheritance

src/GreenRectangle.h

src/UI.h

Polymorphism

src/UI.h

src/UI.h

src/UI.h

The virtual Keyword

src/Rectangle.h

src/GreenRectangle.h

src/Rectangle.h

Hierarchy

src/UI.h

Files

Component Reuse

Complete Code

Files

Summary

Creating SDL3 Buttons

The `virtual` Keyword