Image Validity ​

While the basic instruction for taking a measurement is simple—just look at the camera and start the measurement—there are a few guidelines that the user must follow to ensure accurate measurement results. These guidelines are listed in Binah.ai's best practices for taking a measurement.

During the measurement, the SDK assists the user in following these guidelines. It validates each camera image and updates the imageValidity with any detected deviations from the guidelines.

An image is considered valid if the SDK did not detect any violations to the Binah.ai's best practices for taking a measurement. If the image is not considered valid the SDK reports the reason for invalidating the image.

The conditions in the table below will invalidate the image for processing by the SDK.

Image validity verification is reported as part of onImageData as part of ImageDataListener:

@override
void onImageData(ImageData imageData) {
    switch (imageData.imageValidity) {
        case ImageValidity.valid:
            // Valid
            break;
        case ImageValidity.invalidDeviceOrientation:
            // Invalid device orientation
            break;
        case ImageValidity.invalidRoi:
            // Invalid ROI
            break;
        case ImageValidity.tiltedHead:
            // Tilted Head
            break;
        case ImageValidity.faceTooFar:
            // Face Too Far
            break;
        case ImageValidity.unevenLight:
            // Uneven Light
            break;
    }
}