class Aws::Rekognition::Types::BlackFrame

A filter that allows you to control the black frame detection by specifying the black levels and pixel coverage of black pixels in a frame. As videos can come from multiple sources, formats, and time periods, they may contain different standards and varying noise levels for black frames that need to be accounted for. For more information, see StartSegmentDetection.

@note When making an API call, you may pass BlackFrame

data as a hash:

    {
      max_pixel_threshold: 1.0,
      min_coverage_percentage: 1.0,
    }

@!attribute [rw] max_pixel_threshold

A threshold used to determine the maximum luminance value for a
pixel to be considered black. In a full color range video, luminance
values range from 0-255. A pixel value of 0 is pure black, and the
most strict filter. The maximum black pixel value is computed as
follows: max\_black\_pixel\_value = minimum\_luminance +
MaxPixelThreshold *luminance\_range.

For example, for a full range video with BlackPixelThreshold = 0.1,
max\_black\_pixel\_value is 0 + 0.1 * (255-0) = 25.5.

The default value of MaxPixelThreshold is 0.2, which maps to a
max\_black\_pixel\_value of 51 for a full range video. You can lower
this threshold to be more strict on black levels.
@return [Float]

@!attribute [rw] min_coverage_percentage

The minimum percentage of pixels in a frame that need to have a
luminance below the max\_black\_pixel\_value for a frame to be
considered a black frame. Luminance is calculated using the BT.709
matrix.

The default value is 99, which means at least 99% of all pixels in
the frame are black pixels as per the `MaxPixelThreshold` set. You
can reduce this value to allow more noise on the black frame.
@return [Float]

Constants

SENSITIVE