Class T5FingerClient


  • public class T5FingerClient
    extends java.lang.Object
    • Field Summary

      Fields 
      Modifier and Type Field Description
      int MAX_FINGERS
      maximum count of fingers for minutiae
      int MAX_HEIGHT
      maximum image height
      int MAX_WIDTH
      maximum image width
    • Constructor Summary

      Constructors 
      Constructor Description
      T5FingerClient()  
    • Method Summary

      Modifier and Type Method Description
      byte[] allocateTemplateMinex​(int minexType, int numFingers)
      The function allocates memory for buffer that will receives INCITS 378 compliance template
      byte[] allocateTemplateTech5​(byte fpType)
      The function allocates memory for template variable
      void closeSDK()
      The function uninitializes the Tech5_Client_Edition
      int createTemplateMinex​(int minexType, ai.tech5.sdk.abis.finger.ImageData[] imageArray, byte[] templ, java.lang.Byte[] quality, java.lang.Integer templ_size, int maxTemplateSize)
      The function takes set of images as input and outputs the corresponding ANSI INCITS 378 compliant template.
      int createTemplateMinexEx​(int minexType, ai.tech5.sdk.abis.finger.RawImage[] imageArray, byte[] templ, java.lang.Byte[] quality, java.lang.Integer templ_size, int maxTemplateSize)
      The function takes set of images as input and outputs the corresponding ANSI INCITS 378 compliant template.
      int createTemplateTech5​(ai.tech5.sdk.abis.finger.ImageData image, byte[] fpTemplate, java.lang.Byte quality, java.lang.Integer templSize, byte fpType, int maxWidth, int maxHeight, boolean doSegmentation, byte[] skeleton, java.lang.Integer skeletonSize)
      Processes fingerprint image and build the Tech5 template.
      int createTemplateTech5​(ai.tech5.sdk.abis.finger.ImageData image, byte[] fpTemplate, java.lang.Byte quality, java.lang.Integer templSize, byte fpType, int maxWidth, int maxHeight, boolean doSegmentation, byte[] skeleton, java.lang.Integer skeletonSize, boolean reduceDithering)
      Processes fingerprint image and build the Tech5 template.
      int createTemplateTech5Ex​(ai.tech5.sdk.abis.finger.RawImage srcImage, byte[] fpTemplate, java.lang.Byte quality, java.lang.Integer templSize, byte fpType, int maxWidth, int maxHeight, boolean doSegmentation, byte[] skeleton, java.lang.Integer skeletonSize)
      Processes fingerprint image and build the Tech5 template.
      int createTemplateTech5Ex​(ai.tech5.sdk.abis.finger.RawImage srcImage, byte[] fpTemplate, java.lang.Byte quality, java.lang.Integer templSize, byte fpType, int maxWidth, int maxHeight, boolean doSegmentation, byte[] skeleton, java.lang.Integer skeletonSize, boolean reduceDithering)
      Processes fingerprint image and build the Tech5 template.
      int cutRectFromImage​(ai.tech5.sdk.abis.finger.RawImage srcImage, int x1, int y1, int x2, int y2, int x3, int y3, ai.tech5.sdk.abis.finger.RawImage dstImage)
      Cuts segmented image defined by 3 vertex coordinates from whole image
      int decodeImage​(ai.tech5.sdk.abis.finger.ImageData srcImage, ai.tech5.sdk.abis.finger.RawImage dstImage)
      The function decodes image to RawImage
      int encodeImage​(ai.tech5.sdk.abis.finger.RawImage srcImage, int encode_type, ai.tech5.sdk.abis.finger.ImageData encoded_image, java.lang.Integer image_length, int compress)
      The function converts raw image to some format
      java.lang.String getLastErrorMsg()
      function returns error description by its number Parameters:
      java.util.ArrayList<java.util.ArrayList<ai.tech5.sdk.abis.finger.Minutiae>> getMinutiaeMinex​(int minexType, byte[] fpTemplate, int[] errorCode)  
      java.util.ArrayList<java.util.ArrayList<ai.tech5.sdk.abis.finger.Minutiae>> getMinutiaeMinexEx​(int minexType, byte[] fpTemplate, java.lang.Integer errorCode)
      getMinutiaeMinex Extract information about minutiae from fingerprint template
      java.util.ArrayList<ai.tech5.sdk.abis.finger.Minutiae> getMinutiaeTech5​(byte[] fpTemplate, java.lang.Integer errorCode)
      getMinutiaeTech5 Extract information about minutiae from fingerprint template
      ai.tech5.sdk.abis.finger.SearchParams getSearchParams()
      The function returns structure with current search parameters
      java.lang.String getVersion()
      The function returns version of Tech5_ClientEdition Parameters:
      boolean initSDK()
      The function initializes the Tech5_Client_Edition Parameters:
      int loadTemplateTech5​(byte[] fpProbe)
      This function loads the first template for 1:many searching Parameters:
      int matchTech5Minex​(int minexType, byte[] templateTech5, byte[] templateNIST, java.lang.Double score, java.lang.Double logFAR, ai.tech5.sdk.abis.finger.MatchResult mr, boolean useScale)
      The function compares Tech5 and ANSI INCITS 378 compliant templates and outputs a match score.
      int matchTemplatesMinex​(int minexType, byte[] probeTemplate, byte[] galleryTemplate, java.lang.Double score, java.lang.Double logFAR, ai.tech5.sdk.abis.finger.MatchResult[] mr, boolean useScale)
      The function compares two ANSI INCITS 378 compliant templates and outputs a match score.
      int matchTemplatesTech5​(byte[] fpTempl1, byte[] fpTempl2, java.lang.Double score, java.lang.Double logFAR, ai.tech5.sdk.abis.finger.MatchResult mr)
      Compares two templates Parameters:
      int matchTemplatesTech5Ex​(byte[] fpGallery, java.lang.Double score, java.lang.Double logFAR, ai.tech5.sdk.abis.finger.MatchResult mr)
      This function allows you to perform the 1:many search.
      int scaleImage​(ai.tech5.sdk.abis.finger.RawImage srcImage, ai.tech5.sdk.abis.finger.RawImage dstImage, byte gender, byte age)
      The function scales fingerprint image to 500 ppi
      java.util.ArrayList<ai.tech5.sdk.abis.finger.SegRect> segmentImage​(ai.tech5.sdk.abis.finger.RawImage srcImage, ai.tech5.sdk.abis.finger.SegType sgmType, ai.tech5.sdk.abis.finger.SegHand sgmHand, int rotation, java.lang.Integer retCode)
      Friction ridge (fingerprint / palm print) image segmentation
      int setLicense​(java.lang.String license_file)
      The function sets license file Parameters:
      int setLicenseEx​(byte[] license_data)
      The function sets license data Parameters:
      int setSearchParams​(ai.tech5.sdk.abis.finger.SearchParams params)
      The function sets search parameters NOTE: this change will be valid until you unload SDK.
      int slapDetection​(ai.tech5.sdk.abis.finger.RawImage srcImage, java.lang.Integer slap_direction)
      The function converts raw image to some format
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • T5FingerClient

        public T5FingerClient()
    • Method Detail

      • getVersion

        public java.lang.String getVersion()
        The function returns version of Tech5_ClientEdition Parameters:
        Returns:
        value of current version
      • initSDK

        public boolean initSDK()
        The function initializes the Tech5_Client_Edition Parameters:
        Returns:
        Return value: The function returns true if success
      • closeSDK

        public void closeSDK()
        The function uninitializes the Tech5_Client_Edition
      • setSearchParams

        public int setSearchParams​(ai.tech5.sdk.abis.finger.SearchParams params)
        The function sets search parameters NOTE: this change will be valid until you unload SDK. If you want to make this changers persistent you should set these parameters in Windows Control Panel Parameters:
        Parameters:
        params - (input) - the pointer to structure with the new search parameters
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise
      • getSearchParams

        public ai.tech5.sdk.abis.finger.SearchParams getSearchParams()
        The function returns structure with current search parameters
        Returns:
        current search parameters
      • setLicense

        public int setLicense​(java.lang.String license_file)
        The function sets license file Parameters:
        Parameters:
        license_file - (input) - license file for checking of product legality
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise
      • setLicenseEx

        public int setLicenseEx​(byte[] license_data)
        The function sets license data Parameters:
        Parameters:
        license_data - (input) - license data for checking of product legality
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise
      • createTemplateTech5

        public int createTemplateTech5​(ai.tech5.sdk.abis.finger.ImageData image,
                                       byte[] fpTemplate,
                                       java.lang.Byte quality,
                                       java.lang.Integer templSize,
                                       byte fpType,
                                       int maxWidth,
                                       int maxHeight,
                                       boolean doSegmentation,
                                       byte[] skeleton,
                                       java.lang.Integer skeletonSize,
                                       boolean reduceDithering)
        Processes fingerprint image and build the Tech5 template. Parameters:
        Parameters:
        image - ( input) - image data @see ImageData
        fpTemplate - (output) - the buffer that receives the built template Memory for that buffer should be previously allocated by 'allocateTemplate' function
        quality - (output) - this variable receives the quality of fingerprint image
        templSize - (output) - this variable receives the size of built template
        fpType - (input ) - type of processing. Can be: 'F' - finger, 'L' - latent, 'P' - palm, 'S' - palm latent
        maxWidth - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        maxHeight - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        doSegmentation - (input) - if true then forces to segmentation of image
        skeleton - (output) - if this parameter is non null, then the skeleton information will be copied in this buffer. The memory (with size at least width * height) should be allocated in application
        skeletonSize - (output) - the buffer that receives the real size of copied skeleton data
        reduceDithering - (input) - if true the source image will additionally filtered while processing. The default value is false
        Returns:
        SE_OK - if function succeeds, error code - otherwise
      • createTemplateTech5

        public int createTemplateTech5​(ai.tech5.sdk.abis.finger.ImageData image,
                                       byte[] fpTemplate,
                                       java.lang.Byte quality,
                                       java.lang.Integer templSize,
                                       byte fpType,
                                       int maxWidth,
                                       int maxHeight,
                                       boolean doSegmentation,
                                       byte[] skeleton,
                                       java.lang.Integer skeletonSize)
        Processes fingerprint image and build the Tech5 template. Parameters:
        Parameters:
        image - ( input) - image data @see ImageData
        fpTemplate - (output) - the buffer that receives the built template Memory for that buffer should be previously allocated by 'allocateTemplate' function
        quality - (output) - this variable receives the quality of fingerprint image
        templSize - (output) - this variable receives the size of built template
        fpType - (input ) - type of processing. Can be: 'F' - finger, 'L' - latent, 'P' - palm, 'S' - palm latent
        maxWidth - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        maxHeight - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        doSegmentation - (input) - if true then forces to segmentation of image
        skeleton - (output) - if this parameter is non null, then the skeleton information will be copied in this buffer. The memory (with size at least width * height) should be allocated in application
        skeletonSize - (output) - the buffer that receives the real size of copied skeleton data
        Returns:
        SE_OK - if function succeeds, error code - otherwise
      • createTemplateTech5Ex

        public int createTemplateTech5Ex​(ai.tech5.sdk.abis.finger.RawImage srcImage,
                                         byte[] fpTemplate,
                                         java.lang.Byte quality,
                                         java.lang.Integer templSize,
                                         byte fpType,
                                         int maxWidth,
                                         int maxHeight,
                                         boolean doSegmentation,
                                         byte[] skeleton,
                                         java.lang.Integer skeletonSize,
                                         boolean reduceDithering)
        Processes fingerprint image and build the Tech5 template. Parameters:
        Parameters:
        srcImage - ( input) - image data @see RawImage
        fpTemplate - (output) - the buffer that receives the built template Memory for that buffer should be previously allocated by 'allocateTemplate' function
        quality - (output) - this variable receives the quality of fingerprint image
        templSize - (output) - this variable receives the size of built template
        fpType - (input ) - type of processing. Can be: 'F' - finger, 'L' - latent, 'P' - palm, 'S' - palm latent
        maxWidth - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        maxHeight - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        doSegmentation - (input) - if true then forces to segmentation of image
        skeleton - (output) - if this parameter is non null, then the skeleton information will be copied in this buffer. The memory (with size at least width * height) should be allocated in application
        skeletonSize - (output) - the buffer that receives the real size of copied skeleton data
        reduceDithering - (input) - if true the source image will additionally filtered while processing. The default value is false
        Returns:
        SE_OK - if function succeeds, error code - otherwise
      • createTemplateTech5Ex

        public int createTemplateTech5Ex​(ai.tech5.sdk.abis.finger.RawImage srcImage,
                                         byte[] fpTemplate,
                                         java.lang.Byte quality,
                                         java.lang.Integer templSize,
                                         byte fpType,
                                         int maxWidth,
                                         int maxHeight,
                                         boolean doSegmentation,
                                         byte[] skeleton,
                                         java.lang.Integer skeletonSize)
        Processes fingerprint image and build the Tech5 template. Parameters:
        Parameters:
        srcImage - ( input) - image data @see RawImage
        fpTemplate - (output) - the buffer that receives the built template Memory for that buffer should be previously allocated by 'allocateTemplate' function
        quality - (output) - this variable receives the quality of fingerprint image
        templSize - (output) - this variable receives the size of built template
        fpType - (input ) - type of processing. Can be: 'F' - finger, 'L' - latent, 'P' - palm, 'S' - palm latent
        maxWidth - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        maxHeight - - if this parameters greater 0 and source image have size bigger than these values, then source image will cut to this size(input)
        doSegmentation - (input) - if true then forces to segmentation of image
        skeleton - (output) - if this parameter is non null, then the skeleton information will be copied in this buffer. The memory (with size at least width * height) should be allocated in application
        skeletonSize - (output) - the buffer that receives the real size of copied skeleton data
        Returns:
        SE_OK - if function succeeds, error code - otherwise
      • createTemplateMinex

        public int createTemplateMinex​(int minexType,
                                       ai.tech5.sdk.abis.finger.ImageData[] imageArray,
                                       byte[] templ,
                                       java.lang.Byte[] quality,
                                       java.lang.Integer templ_size,
                                       int maxTemplateSize)
        The function takes set of images as input and outputs the corresponding ANSI INCITS 378 compliant template. Parameters:
        Parameters:
        minexType - (input) - type of template for creation. @see MinexTemplateType
        imageArray - (input )- array of ImageData structure
        templ - (output) - The processed ANSI INCITS 378 compliant template. The memory for the template should be allocated by caller
        quality - (output) - Array of quality of images in template
        templ_size - (output) - size of created template in bytes
        maxTemplateSize - (input) - the maximum size of template. If size of template is more than this value, then some of minutiae will be eliminated from template to satisfy this parameter. If it's 0, then all minutiae will be put into template.
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise. In case of failure the null template will be output.
      • createTemplateMinexEx

        public int createTemplateMinexEx​(int minexType,
                                         ai.tech5.sdk.abis.finger.RawImage[] imageArray,
                                         byte[] templ,
                                         java.lang.Byte[] quality,
                                         java.lang.Integer templ_size,
                                         int maxTemplateSize)
        The function takes set of images as input and outputs the corresponding ANSI INCITS 378 compliant template. Parameters:
        Parameters:
        minexType - (input) - type of template for creation. @see MinexTemplateType
        imageArray - (input )- array of source RawImage structures
        templ - (output) - The processed ANSI INCITS 378 compliant template. The memory for the template should be allocated by 'allocateNISTtemplate' function
        quality - (output) - Array of quality of images in template
        templ_size - (output) - size of created template in bytes
        maxTemplateSize - (input) - the maximum size of template. If size of template is more than this value, then some of minutiae will be eliminated from template to satisfy this parameter. If it's 0, then all minutiae will be put into template.
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise. In case of failure the null template will be output.
      • matchTemplatesTech5

        public int matchTemplatesTech5​(byte[] fpTempl1,
                                       byte[] fpTempl2,
                                       java.lang.Double score,
                                       java.lang.Double logFAR,
                                       ai.tech5.sdk.abis.finger.MatchResult mr)
        Compares two templates Parameters:
        Parameters:
        fpTempl1 - (input) - the first fingerprint template
        fpTempl2 - (input) - the second fingerprint template
        score - (output) - this variable receives the value that shows how two fingerprints similarity one to other in percent
        logFAR - (output) : logFAR may be null if unused
        mr - (output) - contains the final match result details. May be null if unused
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise
      • loadTemplateTech5

        public int loadTemplateTech5​(byte[] fpProbe)
        This function loads the first template for 1:many searching Parameters:
        Parameters:
        fpProbe - (input) : the probe fingerprint template
        Returns:
        The function returns SE_OK if success and error code otherwise
      • matchTemplatesTech5Ex

        public int matchTemplatesTech5Ex​(byte[] fpGallery,
                                         java.lang.Double score,
                                         java.lang.Double logFAR,
                                         ai.tech5.sdk.abis.finger.MatchResult mr)
        This function allows you to perform the 1:many search. Parameters:
        Parameters:
        fpGallery - (input) : the gallery fingerprint template
        score - (output): this variable receives the value that shows how two fingerprints similarity one to other in percent
        logFAR - (output) : logFAR may be null if unused
        mr - (output) - contains the final match result details. May be null if unused
        Returns:
        The function returns SE_OK if success and error code otherwise
      • matchTemplatesMinex

        public int matchTemplatesMinex​(int minexType,
                                       byte[] probeTemplate,
                                       byte[] galleryTemplate,
                                       java.lang.Double score,
                                       java.lang.Double logFAR,
                                       ai.tech5.sdk.abis.finger.MatchResult[] mr,
                                       boolean useScale)
        The function compares two ANSI INCITS 378 compliant templates and outputs a match score. Parameters:
        Parameters:
        minexType - (input) : type of template for creation. @see MinexTemplateType
        probeTemplate - (input) : the first ANSI INCITS 378 compliant template
        galleryTemplate - (input) : the second ANSI INCITS 378 compliant template
        score - (output) : a similarity score resulting from comparison of the templates.
        logFAR - (output) : logFAR may be null if unused
        mr - (output) : contains the final match result details. max length is MAX_FINGERS. May be null if unused
        useScale - (input) : if true, will be used a special matching mode, more tolerate to image scale
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise. NOTE: At this version of software templates (probeTemplate and galleryTemplate) can keeps information about two fingers
      • matchTech5Minex

        public int matchTech5Minex​(int minexType,
                                   byte[] templateTech5,
                                   byte[] templateNIST,
                                   java.lang.Double score,
                                   java.lang.Double logFAR,
                                   ai.tech5.sdk.abis.finger.MatchResult mr,
                                   boolean useScale)
        The function compares Tech5 and ANSI INCITS 378 compliant templates and outputs a match score. Parameters:
        Parameters:
        minexType - (input) : the type of template. @see MinexTemplateType
        templateTech5 - (input) : the Tech5 template
        templateNIST - (input) : the second ANSI INCITS 378 compliant template
        score - (output) : a similarity score resulting from comparison of the templates.
        logFAR - (output) : logFAR may be null if unused
        mr - (output) : contains the final match result details. max length is MAX_FINGERS. May be null if unused
        useScale - (input) : if true, will be used a special matching mode, more tolerate to image scale
        Returns:
        Return value: The function returns SE_OK if success and error code otherwise.
      • getLastErrorMsg

        public java.lang.String getLastErrorMsg()
        function returns error description by its number Parameters:
        Returns:
        The last error descriptions
      • getMinutiaeTech5

        public java.util.ArrayList<ai.tech5.sdk.abis.finger.Minutiae> getMinutiaeTech5​(byte[] fpTemplate,
                                                                                       java.lang.Integer errorCode)
        getMinutiaeTech5 Extract information about minutiae from fingerprint template
        Parameters:
        fpTemplate - (input) : pointer to the fingerprint template
        errorCode - (output) - SE_OK if success and error code otherwise
        Returns:
        The function returns minutiae information - if function succeeds, null - otherwise
      • getMinutiaeMinexEx

        public java.util.ArrayList<java.util.ArrayList<ai.tech5.sdk.abis.finger.Minutiae>> getMinutiaeMinexEx​(int minexType,
                                                                                                              byte[] fpTemplate,
                                                                                                              java.lang.Integer errorCode)
        getMinutiaeMinex Extract information about minutiae from fingerprint template
        Parameters:
        minexType - (input) : type of template for creation. @see MinexTemplateType enumeration
        fpTemplate - (input) : pointer to the fingerprint template
        errorCode - (output) - SE_OK if success and error code otherwise
        Returns:
        The function returns array of minutiae information SE_OK - if function succeeds, error code - otherwise
      • getMinutiaeMinex

        public java.util.ArrayList<java.util.ArrayList<ai.tech5.sdk.abis.finger.Minutiae>> getMinutiaeMinex​(int minexType,
                                                                                                            byte[] fpTemplate,
                                                                                                            int[] errorCode)
      • allocateTemplateTech5

        public byte[] allocateTemplateTech5​(byte fpType)
        The function allocates memory for template variable
        Parameters:
        fpType - (input ) - type of processing. Can be: 'F' - finger, 'L' - latent, 'P' - palm, 'S' - palm latent
        Returns:
        allocated buffer
      • allocateTemplateMinex

        public byte[] allocateTemplateMinex​(int minexType,
                                            int numFingers)
        The function allocates memory for buffer that will receives INCITS 378 compliance template
        Parameters:
        minexType - (input) - type of template. @see MinexTemplateType
        numFingers - (input) : count of fingers in template
        Returns:
        allocated buffer
      • decodeImage

        public int decodeImage​(ai.tech5.sdk.abis.finger.ImageData srcImage,
                               ai.tech5.sdk.abis.finger.RawImage dstImage)
        The function decodes image to RawImage
        Parameters:
        srcImage - (input) - image file with one of supported image format @see IMAGE_TYPES
        dstImage - (output) - decoded image . Memory must be allocated by caller. If NULL the function will return only sizes of image.
        Returns:
        The function returns SE_OK if success and error code otherwise.
      • encodeImage

        public int encodeImage​(ai.tech5.sdk.abis.finger.RawImage srcImage,
                               int encode_type,
                               ai.tech5.sdk.abis.finger.ImageData encoded_image,
                               java.lang.Integer image_length,
                               int compress)
        The function converts raw image to some format
        Parameters:
        srcImage - (input) - source raw image
        encode_type - (input) - image format for encoded image @see IMAGE_TYPES
        encoded_image - (output) - encoded image . Memory must be allocated by caller. If NULL the function will return only length of image.
        image_length - (output) - length of encoded image
        compress - (input) - compression level that depends from image type. If zero encoder will use default value. (e.g : 10 for wsq, 95 for jpeg , 1000 for jpeg 2000)
        Returns:
        The function returns SE_OK if success and error code otherwise.
      • segmentImage

        public java.util.ArrayList<ai.tech5.sdk.abis.finger.SegRect> segmentImage​(ai.tech5.sdk.abis.finger.RawImage srcImage,
                                                                                  ai.tech5.sdk.abis.finger.SegType sgmType,
                                                                                  ai.tech5.sdk.abis.finger.SegHand sgmHand,
                                                                                  int rotation,
                                                                                  java.lang.Integer retCode)
        Friction ridge (fingerprint / palm print) image segmentation
        Parameters:
        srcImage - (input) - source image (RAW; 8 bit per pixel, 256 gray levels; left-right, top-bottom; without alignment).
        sgmType - (input) - segmentation type. Defines the objects of segmentation. If value of sgmType is not present in SEG_TYPE enum (SEG_TYPE_...), function returns SGM_RES_ERR_TYPE.
        sgmHand - (input) - hand. It's used only for SEG_TYPE_SLAP, SEG_TYPE_PALM and SEG_TYPE_EDGE segmentation types: SEG_HAND_UNKNOWN - unknown hand (autodetect hand); SEG_HAND_LEFT / SEG_HAND_RIGHT - segmentation is performed for defined hand; SEG_HAND_PROBABLY_LEFT / SEG_HAND_PROBABLY_RIGHT - segmentation give preference to defined hand but if it can found more fingers with supposition that it's another hand, then function returns SE_SGM_RES_WRN_HAND and perform segmentation for another hand. If value of sgmHand is not present in SEG_HAND enum (SEG_HAND_...), function returns SE_SGM_RES_ERR_HAND.
        rotation - (input) - defines the possibility of rotated rectangles segmentation. If rotation == true, quality of segmentation algorithm is better.
        retCode - (output) - error code.
        Returns:
        The function returns array of of segmented rectangles if success and zero otherwise.
      • slapDetection

        public int slapDetection​(ai.tech5.sdk.abis.finger.RawImage srcImage,
                                 java.lang.Integer slap_direction)
        The function converts raw image to some format
        Parameters:
        srcImage - (input) - source raw image
        slap_direction - (output) - possible value of detected hand : 0 - unknown hand, 1 - left hand, 2 - right hand
        Returns:
        The function returns SE_OK if success and error code otherwise.
      • cutRectFromImage

        public int cutRectFromImage​(ai.tech5.sdk.abis.finger.RawImage srcImage,
                                    int x1,
                                    int y1,
                                    int x2,
                                    int y2,
                                    int x3,
                                    int y3,
                                    ai.tech5.sdk.abis.finger.RawImage dstImage)
        Cuts segmented image defined by 3 vertex coordinates from whole image
        Parameters:
        srcImage - (input ) source image
        x1 - (input ) left-top coordinates
        y1 - (input ) left-top coordinates
        x2 - (input ) right-top coordinates
        y2 - (input ) right-top coordinates
        x3 - (input ) left-bottom coordinates
        y3 - (input ) left-bottom coordinates
        dstImage - (output ) cut image (if res == NULL only resWidth and resHeight are filled)
        Returns:
        The function returns SE_OK if success and error code otherwise.
      • scaleImage

        public int scaleImage​(ai.tech5.sdk.abis.finger.RawImage srcImage,
                              ai.tech5.sdk.abis.finger.RawImage dstImage,
                              byte gender,
                              byte age)
        The function scales fingerprint image to 500 ppi
        Parameters:
        srcImage - (input) source fingerprint image
        dstImage - (output) result image. Memory must be allocated by caller. If dstImage.m_image is NULL then will return sizes of image only
        gender - (input) gender 0 unspecified 1 male 2 female
        age - (input) age 0 unspecified 1-99 in years
        Returns:
        The function returns SE_OK if success and error code otherwise.