Taak 2: Video opnemen met VideoWriter

Met cv2.imshow() zie je frames live op het scherm. Maar zodra de loop stopt, is alles weg. cv2.VideoWriter lost dit op: het schrijft elk frame naar een bestand terwijl de loop loopt.

Het 3-stap patroon

# Stap 1 — éénmalig aanmaken (vóór de loop)
fourcc = cv2.VideoWriter_fourcc(*'mp4v')
writer = cv2.VideoWriter('opname.mp4', fourcc, 25.0, (640, 480))

# Stap 2 — elk frame schrijven (in de loop)
writer.write(frame)

# Stap 3 — afsluiten (na de loop)
writer.release()

Elk frame dat je doorgeeft aan writer.write() wordt direct naar het bestand geschreven. Na writer.release() is het bestand klaar om af te spelen.

De vier parameters van VideoWriter

cv2.VideoWriter(
    'opname.mp4',    # bestandsnaam
    fourcc,          # codec
    25.0,            # fps — frames per seconde
    (640, 480)       # (breedte, hoogte) van elk frame
)

De codec geeft je aan hoe frames gecomprimeerd worden. cv2.VideoWriter_fourcc(*'mp4v') is de meest gebruikte keuze voor .mp4-bestanden.

Demo: opname simulatie

Druk op REC om frames te schrijven naar het gesimuleerde bestand. Stop de opname om de bestandsstats te zien.

Waarom VideoWriter en niet losse PNG's?

In S3 sloeg je losse frames op als PNG-bestanden. Dat werkt voor een handvol afbeeldingen, maar bij een stream van 25fps geeft dat 25 bestanden per seconde. Een 10-secondenopname wordt dan 250 afzonderlijke bestanden. VideoWriter bundelt alle frames in één bestand, met compressie, en je kunt het direct afspelen in elke mediaspeler.

Bovendien schrijft VideoWriter frames in realtime weg — het vertraagt de loop nauwelijks. PNG's op schijf schrijven kost per frame meer overhead.

FOURCC — vier letters die de codec bepalen

Een videobestand bevat gecomprimeerde frames. Hoe die compressie werkt, bepaalt de codec. OpenCV identificeert codecs via een FOURCC-code: vier letters die samen één integer vormen.

fourcc = cv2.VideoWriter_fourcc(*'mp4v')  # mp4v codec
fourcc = cv2.VideoWriter_fourcc(*'XVID')  # XVID codec
fourcc = cv2.VideoWriter_fourcc(*'MJPG')  # Motion JPEG

De sterretje-notatie (*'mp4v') is een Python-truc: het spreidt de vier karakters van de string uit als vier losse argumenten, zodat de functie precies vier chars ontvangt.

Op een Tello met Windows werkt XVID + .avi het meest betrouwbaar. Wil je een .mp4-bestand, gebruik dan mp4v.

Frame size: de meest gemaakte fout

De (breedte, hoogte) die je meegeeft aan de VideoWriter constructor is een belofte: "elk frame dat ik aanlever heeft precies deze afmetingen." OpenCV controleert dit niet en geeft geen foutmelding — frames met de verkeerde grootte worden stilzwijgend genegeerd. Het bestand groeit dan niet, of het bestand is kapot bij afspelen.

# Frame is 960x720 (Tello default)
# Maar writer verwacht 640x480
writer = cv2.VideoWriter(
    'out.avi', fourcc, 25.0, (640, 480)
)
writer.write(frame)  # frame 960x720
# → frame genegeerd, bestand leeg

# Lees eerst de werkelijke afmetingen
hoogte, breedte = frame.shape[:2]
writer = cv2.VideoWriter(
    'out.avi', fourcc, 25.0, (breedte, hoogte)
)
writer.write(frame)  # zelfde grootte: OK

Let op: NumPy-arrays (frames) gebruiken shape als (rijen, kolommen) = (hoogte, breedte). VideoWriter wil het omgekeerde: (breedte, hoogte). Dit is een klassieke volgorde-verwisseling.

isOpened() — controleer of het gelukt is

Als het aanmaken van de VideoWriter mislukt (schijf vol, codec niet beschikbaar, ongeldige bestandsnaam), geeft de constructor geen fout. Het object bestaat, maar is onbruikbaar. Gebruik isOpened() om dit te detecteren:

writer = cv2.VideoWriter('opname.avi', fourcc, 25.0, (breedte, hoogte))

if not writer.isOpened():
    print("Fout: kon bestand niet aanmaken")
else:
    # Loop met write()...

fps: instelling versus realtime

De fps-waarde die je opgeeft is een afspeelsnelheid, geen garantie over hoe snel frames worden aangeleverd. Als je in de loop 25 frames per seconde aanmaakt maar de camera geeft er slechts 15, zal het bestand versneld afspelen.

• Gebruik de camera's eigen fps als referentie (Tello geeft ~30fps).
• Bij een langzamere loop: verlaag de fps instelling zodat afspelen klopt.
• Bij een snellere loop: de schrijfsnelheid van de schijf wordt de bottleneck.

Veelgemaakte fouten

for frame in stream:
    writer.write(frame)
# writer.release() vergeten
# → bestand corrupt of
#   niet afspeelbaar

for frame in stream:
    writer.write(frame)
writer.release()  # finaliseert bestand

hoogte, breedte = frame.shape[:2]
writer = cv2.VideoWriter(
    'out.avi', fourcc, 25.0,
    (hoogte, breedte)  # omgekeerd!
)

hoogte, breedte = frame.shape[:2]
writer = cv2.VideoWriter(
    'out.avi', fourcc, 25.0,
    (breedte, hoogte)  # (x, y) = (w, h)
)

fourcc = cv2.VideoWriter_fourcc(*'mp4v')
writer = cv2.VideoWriter(
    'opname.avi',  # .avi maar mp4v codec
    fourcc, 25.0, (w, h)
)

fourcc = cv2.VideoWriter_fourcc(*'XVID')
writer = cv2.VideoWriter(
    'opname.avi',  # .avi + XVID: OK
    fourcc, 25.0, (w, h)
)

Demo: framegrootte-controle

Kies een cameraresolutie en een VideoWriter-instelling. Zie wat er gebeurt als ze niet matchen.