Unified · Split
| @@ -6532,11 +6532,20 @@ Default is disabled. · 6531 unmodified lines | ||
| 6532 | 6532 | |
| 6533 | 6533 | Detect video intervals that are (almost) completely black. Can be |
| 6534 | 6534 | useful to detect chapter transitions, commercials, or invalid |
| 6535 | −recordings. Output lines contains the time for the start, end and | |
| 6536 | −duration of the detected black interval expressed in seconds. | |
| 6537 | − | |
| 6538 | −In order to display the output lines, you need to set the loglevel at | |
| 6539 | −least to the AV_LOG_INFO value. | |
| 6535 | +recordings. | |
| 6536 | + | |
| 6537 | +The filter outputs its detection analysis to both the log as well as | |
| 6538 | +frame metadata. If a black segment of at least the specified minimum | |
| 6539 | +duration is found, a line with the start and end timestamps as well | |
| 6540 | +as duration is printed to the log with level @code{info}. In addition, | |
| 6541 | +a log line with level @code{debug} is printed per frame showing the | |
| 6542 | +black amount detected for that frame. | |
| 6543 | + | |
| 6544 | +The filter also attaches metadata to the first frame of a black | |
| 6545 | +segment with key @code{lavfi.black_start} and to the first frame | |
| 6546 | +after the black segment ends with key @code{lavfi.black_end}. The | |
| 6547 | +value is the frame's timestamp. This metadata is added regardless | |
| 6548 | +of the minimum duration specified. | |
| 6540 | 6549 | |
| 6541 | 6550 | The filter accepts the following options: |
| 6542 | 6551 | |
| @@ -136,7 +136,6 @@ static int request_frame(AVFilterLink *outlink) · 135 unmodified lines | ||
| 136 | 136 | return ret; |
| 137 | 137 | } |
| 138 | 138 | |
| 139 | −// TODO: document metadata | |
| 140 | 139 | static int filter_frame(AVFilterLink *inlink, AVFrame *picref) |
| 141 | 140 | { |
| 142 | 141 | AVFilterContext *ctx = inlink->dst; |