Canvas

Goal for this part

Draw freehand strokes on a QML Canvas.

Treat 05-Canvas as the source of truth for this checkpoint. If your local tree drifted, re-clone that folder rather than mixing files from neighbors.

What you should already know

You do not need prior Qt Quick experience for part 1. Later parts assume you finished the earlier snapshots on the same machine.

• You can open a terminal and run python3
• You are comfortable editing a .py file and saving it
• You have a desktop session (not a headless SSH box without display forwarding)

Why Qt Quick fits Brushnook

Qt Quick (QML) is a different path from widgets—declarative UI plus a Canvas for drawing strokes.

Expose brush settings from Python to QML. Keep the stroke list serializable so undo stays understandable.

Code shape

Snapshots stay small on purpose. Look for this kind of core call as you read the folder:

ctx.beginPath(); ctx.moveTo(x, y);

How to run it

Clone the teaching repo, open 05-Canvas, install what the README asks for, then run python app.py.

git clone https://github.com/michaeldunga1/fcc-qml-paint.git
cd fcc-qml-paint/05-Canvas
python3 -m venv .venv
source .venv/bin/activate
pip install -r ../requirements.txt
python app.py

Common mistakes

• Ignoring platform-specific install notes in the snapshot README
• Binding the wrong field to the list/table column
• Refreshing the view before the query finishes
• Assuming sample rows exist when you deleted the local DB file