QR code reading in Raspberry Pi - Step-by-Step Execution

Concept Flow - QR code reading

Start Program

↓

Initialize Camera

↓

Capture Frame

↓

Detect QR Code in Frame?

No→Repeat Capture

Yes↓

Decode QR Code

↓

Display/Use Data

↓

End or Repeat

The program starts by setting up the camera, then captures frames repeatedly until it finds a QR code, decodes it, and uses the data.

Execution Sample

Raspberry Pi

import cv2
from pyzbar import pyzbar

cap = cv2.VideoCapture(0)
while True:
    ret, frame = cap.read()
    codes = pyzbar.decode(frame)
    if codes:
        print(codes[0].data.decode('utf-8'))
        break
cap.release()

This code captures video frames from the camera, looks for QR codes, prints the first found code's data, then stops.

Execution Table

Step	Action	Camera Frame Captured	QR Code Detected?	Decoded Data	Next Step
1	Initialize camera	No frame yet	No	None	Capture frame
2	Capture frame	Frame 1	No	None	Capture next frame
3	Capture frame	Frame 2	No	None	Capture next frame
4	Capture frame	Frame 3	Yes	https://example.com	Print data and break
5	Print data	Frame 3	Yes	https://example.com	Release camera and end

💡 QR code detected at step 4, program prints data and stops capturing frames.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	Final
ret	None	True	True	True	True
frame	None	Frame 1	Frame 2	Frame 3	Frame 3
codes	[]	[]	[]	[QR code object]	[QR code object]

Key Moments - 3 Insights

Why does the program keep capturing frames even if no QR code is found?

Because the detection condition is false (see execution_table rows 2 and 3), the loop continues to capture new frames until a QR code is detected.

What happens when a QR code is detected in a frame?

At step 4 in the execution_table, the program decodes the QR code data, prints it, and breaks the loop to stop capturing frames.

Why do we call cap.release() at the end?

Releasing the camera frees the hardware resource so other programs can use it, as shown in step 5 of the execution_table.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'codes' after step 3?

A [QR code object]

B None

C [] (empty list)

D Error

💡 Hint

Check the 'QR Code Detected?' column at step 3 in the execution_table.

At which step does the program stop capturing frames?

A Step 2

B Step 4

C Step 3

D Step 5

💡 Hint

Look for the step where 'Next Step' says 'Print data and break' in the execution_table.

If no QR code is ever detected, what will happen to the variable 'frame'?

A It will keep updating with new frames

B It will stay None

C It will cause an error

D It will store the first frame only

💡 Hint

Refer to variable_tracker and execution_table steps 2 and 3 where frames are captured repeatedly.

Concept Snapshot

QR code reading on Raspberry Pi:
- Initialize camera with cv2.VideoCapture(0)
- Capture frames in a loop
- Use pyzbar.decode(frame) to find QR codes
- If found, decode and use data
- Release camera after done
Loop continues until QR code detected

Full Transcript

This program starts by initializing the camera. It then captures frames one by one. Each frame is checked for a QR code using pyzbar.decode. If no QR code is found, it captures the next frame. When a QR code is detected, it decodes the data, prints it, and stops capturing frames. Finally, it releases the camera resource. Variables like 'frame' update with each capture, and 'codes' holds detected QR codes. The loop ensures continuous scanning until success.

Practice

1. What is the main purpose of using the pyzbar library on a Raspberry Pi when working with QR codes?

easy

A. To capture images from the camera

B. To decode and read data from QR codes

C. To display images on the screen

D. To create QR codes from text

Solution

1. Step 1: Understand the role of pyzbar

   The pyzbar library is designed to decode barcodes and QR codes from images.

2. Step 2: Identify its use in QR code reading

   On Raspberry Pi, pyzbar reads the data encoded in QR codes, not capturing or displaying images.

3. Final Answer:

   To decode and read data from QR codes -> Option B

4. Quick Check:

   pyzbar = decode QR codes [OK]

Hint: pyzbar reads QR code data, not captures or displays images [OK]

Common Mistakes:

• Confusing pyzbar with camera capture libraries
• Thinking pyzbar creates QR codes
• Assuming pyzbar displays images

2. Which of the following is the correct way to import the decode function from the pyzbar.pyzbar module in Python on Raspberry Pi?

easy

A. from pyzbar.pyzbar import decode

B. import pyzbar.decode

C. from pyzbar import decode

D. import decode from pyzbar.pyzbar

Solution

1. Step 1: Recall correct Python import syntax

   To import a function from a submodule, use from module.submodule import function.

2. Step 2: Apply to pyzbar

   The decode function is inside pyzbar.pyzbar, so the correct import is from pyzbar.pyzbar import decode.

3. Final Answer:

   from pyzbar.pyzbar import decode -> Option A

4. Quick Check:

   Correct import syntax = from pyzbar.pyzbar import decode [OK]

Hint: Use 'from module.submodule import function' for nested imports [OK]

Common Mistakes:

• Using 'import pyzbar.decode' which is invalid
• Writing 'import decode from ...' which is wrong syntax
• Omitting the submodule pyzbar in import

3. Given the following Python code snippet on Raspberry Pi, what will be printed if the image contains a QR code with data 'Hello123'?

from pyzbar.pyzbar import decode
import cv2

image = cv2.imread('qrcode.png')
decoded_objects = decode(image)
for obj in decoded_objects:
    print(obj.data.decode('utf-8'))

medium

A. b'Hello123'

B. obj.data

C. Error: decode() expects a file path

D. Hello123

Solution

1. Step 1: Understand decode output

   The decode function returns a list of objects with a data attribute as bytes.

2. Step 2: Decode bytes to string

   The code calls obj.data.decode('utf-8') to convert bytes to a readable string, so it prints 'Hello123'.

3. Final Answer:

   Hello123 -> Option D

4. Quick Check:

   Decoded bytes to string = Hello123 [OK]

Hint: Decode bytes with .decode('utf-8') to get readable text [OK]

Common Mistakes:

• Printing raw bytes without decoding
• Assuming decode() takes file path instead of image
• Confusing obj.data with string directly

4. What is the error in the following Raspberry Pi Python code for reading a QR code?

from pyzbar.pyzbar import decode
import cv2

image = cv2.imread('qrcode.png')
result = decode('qrcode.png')
print(result)

medium

A. print() cannot print decode results

B. cv2.imread() is missing

C. decode() should receive an image, not a file path string

D. Missing import for numpy

Solution

1. Step 1: Check decode() argument type

   The decode function expects an image object, not a file path string.

2. Step 2: Identify the mistake in code

   The code passes the string 'qrcode.png' directly to decode, which causes an error.

3. Final Answer:

   decode() should receive an image, not a file path string -> Option C

4. Quick Check:

   decode() needs image object, not filename [OK]

Hint: Pass image object to decode(), not filename string [OK]

Common Mistakes:

• Passing filename string directly to decode()
• Forgetting to read image with cv2.imread()
• Assuming decode() reads files itself

5. You want to build a Raspberry Pi program that continuously reads QR codes from a live camera feed and prints the decoded data only once per unique QR code detected. Which approach best solves this problem?

hard

A. Use a set to store decoded QR data and check before printing each frame

B. Print all decoded QR data every frame without filtering duplicates

C. Clear the camera feed buffer after each frame to avoid repeats

D. Restart the camera after each QR code is detected

Solution

1. Step 1: Understand the problem of repeated QR codes

   Live camera frames may detect the same QR code multiple times, causing repeated prints.

2. Step 2: Use a set to track unique QR codes

   Storing decoded data in a set allows checking if a QR code was already printed, avoiding duplicates.

3. Step 3: Avoid inefficient or incorrect methods

   Clearing buffers or restarting camera won't prevent repeated prints logically.

4. Final Answer:

   Use a set to store decoded QR data and check before printing each frame -> Option A

5. Quick Check:

   Use set to track unique QR codes [OK]

Hint: Track seen QR codes in a set to print each once [OK]

Common Mistakes:

• Printing every detection without filtering duplicates
• Trying to clear camera buffer to fix repeats
• Restarting camera unnecessarily