be_view_an2kview_varres.h

Go to the documentation of this file.

/*
 * This software was developed at the National Institute of Standards and
 * Technology (NIST) by employees of the Federal Government in the course
 * of their official duties. Pursuant to title 17 Section 105 of the
 * United States Code, this software is not subject to copyright protection
 * and is in the public domain. NIST assumes no responsibility whatsoever for
 * its use by other parties, and makes no guarantees, expressed or implied,
 * about its quality, reliability, or any other characteristic.
 */
 
#ifndef __BE_VIEW_AN2KVIEW_VARRES_H__
#define __BE_VIEW_AN2KVIEW_VARRES_H__
 
#include <iostream>
#include <map>
#include <string>
 
#include <be_error_exception.h>
#include <be_feature.h>
#include <be_view_an2kview.h>
 
/* an2k.h forward declares */
struct field;
typedef field FIELD;
 
namespace BiometricEvaluation 
{
        namespace View
        {
                class AN2KViewVariableResolution : public AN2KView {
                public:
                        struct AN2KQualityMetric
                        {
                                Feature::FGP            fgp;
                                uint8_t                 score;
                                uint16_t                vendorID;
                                uint16_t                productCode;
                        };
                        using AN2KQualityMetric = struct AN2KQualityMetric;
                        using QualityMetricSet = std::vector<AN2KQualityMetric>;
 
                        struct PrintPositionCoordinate {
                                Finger::FingerImageCode fingerView;
                                Finger::FingerImageCode segment;
                                Image::CoordinateSet coordinates;
                        };
                        using PrintPositionCoordinate =
                            struct PrintPositionCoordinate;
                        using PrintPositionCoordinateSet =
                            std::vector<PrintPositionCoordinate>;
 
                        static QualityMetricSet
                        extractQuality(FIELD *field, Feature::PositionType type);
 
                        Finger::Impression getImpressionType() const;
 
                        std::string getSourceAgency() const;
 
                        std::string getCaptureDate() const;
 
                        std::string getComment() const;
 
                        Finger::CaptureTechnology
                        getCaptureTechnology()
                            const;
 
                        Memory::uint8Array
                        getUserDefinedField(
                            const uint16_t field) const;
 
                        static Memory::uint8Array
                        parseUserDefinedField(
                            const RECORD* const record,
                            int fieldID);
 
                        static Finger::CaptureTechnology
                        convertCaptureTechnology(
                            const char *str);
 
                protected:
                        AN2KViewVariableResolution(
                            const std::string &filename,
                            const RecordType typeID,
                            const uint32_t recordNumber);
 
                        AN2KViewVariableResolution(
                            Memory::uint8Array &buf,
                            const RecordType typeID,
                            const uint32_t recordNumber);
 
                        Feature::FGPSet
                        getPositions() const;
 
                        Finger::PositionDescriptors
                        getPositionDescriptors()
                            const;
 
                        PrintPositionCoordinateSet
                        getPrintPositionCoordinates()
                            const;
 
                        QualityMetricSet
                        getQualityMetric()
                            const;
 
                private:
                        void readImageRecord(
                            const RecordType typeID);
 
                        Feature::FGPSet _positions;
                        Finger::Impression _imp;
                        Finger::CaptureTechnology _frct{
                            Finger::CaptureTechnology::Unknown};
                        std::string _sourceAgency;
                        std::string _captureDate;
                        std::string _comment;
                        Finger::PositionDescriptors _pd;
                        PrintPositionCoordinateSet _ppcs;
                        QualityMetricSet _qms;
                        mutable std::map<uint16_t, Memory::uint8Array> _udf;
                };
                
                std::ostream&
                operator<<(
                    std::ostream &s,
                    const AN2KViewVariableResolution::AN2KQualityMetric &qm);
 
                std::ostream&
                operator<<(
                    std::ostream &stream,
                    const AN2KViewVariableResolution::PrintPositionCoordinate
                    &ppc);
        }
}
#endif /* __BE_VIEW_AN2KVIEW_VARRES_H__ */