IMedicalMaskEstimator.h

#pragma once

#pragma once

#include <fsdk/IObject.h>
#include <fsdk/FSDKError.h>
#include <fsdk/Optional.h>
#include <fsdk/Types.h>

namespace fsdk {

#ifndef DOXYGEN_SHOULD_SKIP_THIS
    DECLARE_SMARTPTR(IMedicalMaskEstimator);
#endif

    enum class MedicalMask {
        Mask = 0,    
        NoMask,      
        OccludedFace 
    };

    enum class MedicalMaskExtended {
        Mask = 0,       
        NoMask,         
        MaskNotInPlace, 
        OccludedFace    
    };

    enum class DetailedMaskType {
        CorrectMask = 0,            
        MouthCoveredWithMask,       
        ClearFace,                  
        ClearFaceWithMaskUnderChin, 
        PartlyCoveredFace,          
        FullMask,                   
        Count
    };

    struct MedicalMaskEstimation {
        MedicalMask result;        
        DetailedMaskType maskType; 

        // scores
        float maskScore;         
        float noMaskScore;       
        float occludedFaceScore; 

        float scores[static_cast<int>(DetailedMaskType::Count)]; 

        inline float getScore(DetailedMaskType type) const;
    };

    struct MedicalMaskEstimationExtended {
        MedicalMaskExtended result; 
        // scores
        float maskScore;         
        float noMaskScore;       
        float maskNotInPlace;    
        float occludedFaceScore; 
    };

    struct IMedicalMaskEstimator : IRefCounted {
        virtual Result<FSDKError>
        estimate(const Image& warp, MedicalMaskEstimation& estimation) const noexcept = 0;

        virtual Result<FSDKError>
        estimate(const Image& warp, MedicalMaskEstimationExtended& estimation) const noexcept = 0;

        virtual Result<FSDKError> estimate(
            const Image& image,
            const Detection& detection,
            MedicalMaskEstimation& estimation) const noexcept = 0;

        virtual Result<FSDKError> estimate(
            const Image& image,
            const Detection& detection,
            MedicalMaskEstimationExtended& estimation) const noexcept = 0;

        virtual Result<FSDKError>
        estimate(Span<const Image> warps, Span<MedicalMaskEstimation> estimations) const noexcept = 0;

        virtual Result<FSDKError>
        estimate(Span<const Image> warps, Span<MedicalMaskEstimationExtended> estimations) const noexcept = 0;

        virtual Result<FSDKError> estimate(
            Span<const Image> images,
            Span<const Detection> detections,
            Span<MedicalMaskEstimation> estimations) const noexcept = 0;

        virtual Result<FSDKError> estimate(
            Span<const Image> images,
            Span<const Detection> detections,
            Span<MedicalMaskEstimationExtended> estimations) const noexcept = 0;
        virtual Result<FSDKError>
        validate(Span<const Image> warps, Span<Result<FSDKError>> errors) const noexcept = 0;

        virtual Result<FSDKError> validate(
            Span<const Image> images,
            Span<const Detection> detections,
            Span<Result<FSDKError>> errors) const noexcept = 0;
    };

    /*
        Implementation details.
    */
    float MedicalMaskEstimation::getScore(DetailedMaskType type) const {
        switch(type) {
        case DetailedMaskType::CorrectMask:
        case DetailedMaskType::MouthCoveredWithMask:
        case DetailedMaskType::ClearFace:
        case DetailedMaskType::ClearFaceWithMaskUnderChin:
        case DetailedMaskType::PartlyCoveredFace:
        case DetailedMaskType::FullMask:
            return scores[static_cast<int>(type)];
        default:
            return 0.f;
        }
    }

} // namespace fsdk