The Qt Graphics View Framework.

24 Aug 2024 by Daniel Gakwaya | comments

The Graphics View framework in Qt is a powerful and flexible system for managing and displaying custom 2D graphics. It provides a way to create interactive, custom graphics scenes that can be viewed and manipulated through one or more views. This framework is ideal for applications that require complex graphic manipulation, such as CAD programs, diagram editors and games. Below is one of the applications we build in my Qt C++ GUI Intermediate course.

A complex app using the Graphics View framework

The Graphics View framework is made up of three main parts:

  1. The scene:
    • Powered by the QGraphicsScene class, it acts as a container for QGraphicsItems, managing their positions, states, and interactions. It’s where all the items in the scene live, and it handles tasks like collision detection, item selection, and propagation of events.
  2. Items
    • Powered by the QGraphicsItem class, they represent objects in the scene. These can be simple shapes like rectangles or ellipses, or more complex custom shapes. QGraphicsItems can handle events like mouse clicks and can have advanced properties like transformations, custom painting, and bounding regions.
  3. The View
    • Powered by the QGraphicsView class, this is a visual representation of the QGraphicsScene. It provides the interface through which the user interacts with the scene. QGraphicsView supports zooming, panning, and transformations, allowing for highly interactive and flexible UI designs.

Here’s a simple example that demonstrates the basic structure:

#include <QApplication>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsEllipseItem>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // Create a scene
    QGraphicsScene scene;

    // Add an item to the scene
    QGraphicsEllipseItem *ellipse = scene.addEllipse(0, 0, 100, 100);

    // Create a view to visualize the scene
    QGraphicsView view(&scene);

    // Display the view
    view.show();

    return app.exec();
}

In this example, we create a QGraphicsScene and add a QGraphicsEllipseItem to it. Then, we use a QGraphicsView to display the scene. The flexibility of this framework shines through as you can easily scale this to include complex shapes, text, or even custom QGraphicsItems.

The Graphics View framework is one of the few remaining areas where one needs to rely on the C++ side of things. QML has no close equivalent as far as I know. I have a strong personal connection to this framework because it’s one of the big projects I worked on in my first professional contract as a Qt developer. If you need to build highly interactive applications with thousands of items in play, there aren’t a lot of technologies out there that can rival with the Qt Graphics View framework. If you want to dive right into this framework, I have an old course that takes you from the fundamentals up to a point where you can build a very complex painting application. Check it out.

The Qt Widgets API is given less and less love these days, but the Qt Graphics View frameworks is one of the areas that constantly pulls me back to using Qt Widgets and admiring what a great design they display. Are you still using Qt Widgets in a professional setting? Do share your thoughts in the comments section below.

Three Dashboards, One Weekend

Beginner 63 pages Free

Build the same professional dashboard three times, in Qt Widgets with C++, in PySide6 and in QML. Six themes, complete source code, cross-platform.

GET IT FREE!

Qt6 QML For Beginners Book

⭐ 4.8/5 Beginner 400+ pages $45

Master the fundamentals of Qt6 QML development with this comprehensive 400+ page guide. Learn declarative UI programming from scratch with real-world examples and cross-platform development techniques.

GET YOUR COPY!

Desktop Apps with Qt Widgets and C++

Beginner to Advanced 63 hours

Master professional desktop application development using Qt Widgets and modern C++. 63 hours of content with 5+ real projects, from your first window to a polished product.

View on Squared Academy

Desktop Apps with Qt Widgets and PySide6

Beginner to Advanced 24 hours

Learn to build powerful desktop applications using Qt Widgets and Python. 24 hours of hands-on content with 4+ real-world projects to boost your Python GUI skills.

View on Squared Academy

Qt QML From Beginner to Pro

Beginner to Advanced 30 hours

Master modern UI development with Qt QML and Qt Quick. 30 hours of training with 6+ real projects. Build fluid, dynamic interfaces for desktop, mobile, and embedded devices.

View on Squared Academy

Qt QML: Deploy to Desktop, Mobile and Embedded

Intermediate 15 hours

Take one Qt QML application and ship it to Windows, Linux, macOS, Android, iOS and embedded ARM, with installers, signed bundles and a GitHub Actions pipeline driven by one git tag.

View on Squared Academy