bytedeco/javacv

FFmpegFrameGrabber should throw an exception when attempting to access stream metadata before calling start()

Open

#2 382 ouverte le 19 févr. 2026

Voir sur GitHub
 (4 commentaires) (0 réactions) (0 assignés)Java (6 985 stars) (1 583 forks)batch import
enhancementhelp wantedquestion

Description

As stated in the title, when using FFmpegFrameGrabber, if start() is not called beforehand, methods such as getImageWidth() will return 0. This behavior may cause errors to propagate downstream and lead to issues that are more difficult to trace. I believe an IllegalStateException should be thrown immediately to clearly indicate that this operation is invalid.

Guide contributeur

Stack technique
java
Domaine
backendapi
Type d'issue
bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
under 1 hour
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
fresh
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
clear
Prérequis
Basic understanding of FFmpegFrameGrabber lifecycle
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
90
Direction de recherche
Look at the source code of FFmpegFrameGrabber (likely in a file like FFmpegFrameGrabber.java) to identify methods such as getImageWidth(), getImageHeight(), etc. that return metadata. Currently they return 0 when start() has not been called. The fix is to check if start() has been called (possibly using a flag) and throw an IllegalStateException with a descriptive message. Ensure consistent behavior across all such metadata access methods. No linked PRs or assignees exist, so this is available for implementation.