Detect frames that are (almost) completely black. Can be useful to detect chapter transitions or commercials. Output lines consist of the frame number of the detected frame, the percentage of blackness, the position in the file if known or -1 and the timestamp in seconds.

In order to display the output lines, you need to set the loglevel at least to the AV_LOG_INFO value.

The filter accepts the following options:

amount

Set the percentage of the pixels that have to be below the threshold, defaults to 98.

threshold, thresh

Set the threshold below which a pixel value is considered black, defaults to 32.