Black Video Analysis (Legacy Version)

NOTE: This is the legacy version of this analyzer, if you would like the most current version, please visit the current version.

If you want to ensure that your video content has no extended periods of black video, then this is the analysis type you’ll want to use.

Our API Docs list all options, but here is a summary:

• duration_sec
  • minimum: 1, maximum: 3600, default: 10
  • Black video must exceed this duration for triggering detection.
• black_level
  • The video signal level must be above this value for being detected as non-black.
  • maximum: 1, default: 0.1
• black_pixel_ratio
  • Ratio of black vs. non black pixels so that a picture is classified as black. Value set at 1.0: all pixels must be black. Value set at 0.0: no pixels must be black.
  • maximum: 1, default: 0.98
• ire_range_mode
  • options: auto, full, limited

Sample Usage

The sample json below is set to detect black video with black_level at 0.03 or lower (darker), and having a duration of 1 second or longer. You may want to test with the black_level value, as credits with a black background and a small amount of white text could trigger a false positive.

{
  "uid": "analyze_task",
  "kind": "analyze",
  "payload": {
    "general_properties": {
      "enabled": true
    },
    "deep_properties": {
      "video": {
        "black": {
          "enabled": true,
          "black_level": 0.03,
          "duration_sec": 1
        }
      }
    }
  }
}

Analyzer Results

Results from running this analysis on a file with black sections will be reported in the job summary json, in the “analyzer / deep_properties” section of the job result:

{
  "deep_properties": {
    "video": {
      "black": [
        {
          "begin": 0,
          "end": 18.9189,
          "duration": 18.9189
        },
        {
          "begin": 740.34,
          "end": 754.1864,
          "duration": 13.8472
        }
      ]
    }
  }
}