FibroScan ®

As operações que fazem parte da interface IBioPassEngineTrait são apresen- tadas a seguir.

Tabela 35. Especificação da operação getTraitType ()

TraitType getTraitType ()

Esta operação recupera o tipo de traço unibiométrico da implementação corrente desta interface. Parâmetros:

Retorno: Esta operação retorna o tipo de traço unibiométrico (enumerado em TraitType) da im-

plementação corrente desta interface.

Exceções:

Tabela 36. Especificação da operação getTemplate (rawTraitData, key, accepta- bleQuality)

byte[] getTemplate (rawTraitData, key, acceptableQuality)

Esta operação cria um template unibiométrico.

Parâmetros: rawTraitData: array de bytes com o traço unibiométrico capturado.

key: chave criptográfica.

acceptableQuality: valor do tipo float correspondente à qualidade mínima que o tra- ço capturado deve ter para que o template seja criado.

Retorno: Esta operação retorna um array de bytes corresponde ao template unibiométrico.

Exceções: InsufficientTraitDataQualityException: O traço de entrada não possui qualidade

suficiente para ser analisado ou não possui qualidade aceitável. InvalidRawTraitDataException: O traço de entrada é inválido.

Tabela 37. Especificação da operação getClassFromRawData (rawTrait)

string getClassFromRawData (rawTrait)

Esta operação constrói uma expressão de classificação biométrica, de acordo com a característica biométrica de entrada.

Parâmetros: rawTrait: array de bytes com o traço capturado.

Retorno: Esta operação retorna uma string correspondente à expressão de classificação biomé-

trica, de acordo com o traço biométrico de entrada.

Exceções: InvalidRawTraitDataException: O traço de entrada é inválido.

NotImplementedException: A operação não foi implementada para o tipo de carac- terística biométrica em questão.

Tabela 38. Especificação da operação getClassFromTemplate (template)

string getClassFromTemplate (template)

Esta operação constrói uma expressão de classificação biométrica, de acordo com o template bi- ométrico de entrada.

Parâmetros: template: array bytes com o template unibiométrico.

Retorno: Esta operação retorna uma string correspondente à expressão de classificação biomé-

trica, de acordo com o template biométrico de entrada.

Exceções: InvalidTemplateFormatException: O formato do template de entrada é inválido.

NotImplementedException: A operação não foi implementada para o tipo de carac- terística biométrica em questão.

Tabela 39. Especificação da operação match (template1, template2)

double match (template1, template2)

Esta operação executa o matching entre dois templates unibiométricos e retorna o seu score de equivalência.

Parâmetros: template1: array de bytes com um template unibiométrico.

template2: array de bytes com outro template unibiométrico.

Retorno: Esta operação retorna um valor double com o score de matching.

Exceções: InvalidTemplateFormatException: O formato de pelo menos um dos templates de

entrada é inválido.

Tabela 40. Especificação da operação getQuality (rawTrait)

float getQuality (rawTrait)

Parâmetros: rawTrait: array de bytes com o traço capturado.

Retorno: Esta operação retorna um valor float com a qualidade do traço de entrada.

Exceções: InvalidRawTraitDataException: O traço de entrada é inválido.

Tabela 41. Especificação da operação isValidTemplate (template)

boolean isValidTemplate (template)

Esta operação verifica se um template unibiométrico é válido.

Parâmetros: template: array de bytes com um template unibiométrico.

Retorno: Esta operação retorna um valor boolean, sendo true caso o formato do template de en-

trada seja válido e false, caso contrário.

Exceções:

Tabela 42. Especificação da operação getMatchingWeight ()

int getMatchingWeight ()

Esta operação recupera o peso que o tipo de característica biométrica em questão exerce na fu- são.

Parâmetros:

Retorno: Esta operação retorna um valor inteiro correspondente ao peso que o tipo de caracterís-

tica biométrica em questão exerce na fusão.

Exceções:

Tabela 43. Especificação da operação setMatchingWeight (weight)

void setMatchingWeight (weight)

Esta operação estabelece o peso que o tipo de característica biométrica em questão exerce na fu- são.

Parâmetros: weight: valor inteiro correspondente ao peso que o tipo de característica biométrica em questão deve exercer na fusão.

Retorno: Esta operação não retorna nenhum valor (void).

Exceções: InvalidParameterValue: O valor passado no parâmetro é inválido ou não está den-

tro da faixa de valores permitidos.

Tabela 44. Especificação da operação getAcceptanceThreshold ()

Esta operação recupera o limiar de aceitação direta para a operação de matching. Parâmetros:

Retorno: Esta operação retorna um valor double correspondente ao limiar de aceitação direta para a operação de matching.

Exceções:

Tabela 45. Especificação da operação setAcceptanceThreshold (acceptanceThre- shold)

void setAcceptanceThreshold (acceptanceThreshold)

Esta operação estabelece o limiar de aceitação direta para a operação de matching.

Parâmetros: acceptanceThreshold: valor double correspondente ao limiar de aceitação direta

para a operação de matching.

Retorno: Esta operação não retorna nenhum valor (void).

Exceções: InvalidParameterValue: O valor passado no parâmetro é inválido ou não está den-

tro da faixa de valores permitidos.

Tabela 46. Especificação da operação getRejectionThreshold ()

double getRejectionThreshold ()

Esta operação recupera o limiar de rejeição direta para a operação de matching. Parâmetros:

Retorno: Esta operação retorna um valor double correspondente ao limiar de rejeição direta para

a operação de matching.

Exceções:

Tabela 47. Especificação da operação setRejectionThreshold (rejectionThreshold)

void setRejectionThreshold (rejectionThreshold)

Esta operação estabelece o limiar de rejeição direta para a operação de matching.

Parâmetros: rejectionThreshold: valor double correspondente ao limiar de rejeição direta para a

operação de matching.

Retorno: Esta operação não retorna nenhum valor (void).

Exceções: InvalidParameterValue: O valor passado no parâmetro é inválido ou não está den-

Tabela 48. Especificação da operação getMaxScore ()

double getMaxScore ()

Esta operação recupera um valor de score considerado o valor máximo possível obtido na opera- ção de matching.

Parâmetros:

Retorno: Esta operação retorna um valor double correspondente ao score considerado o valor

máximo possível obtido na operação de matching. Exceções:

Tabela 49. Especificação da operação setMaxScore (maxScore)

void setMaxScore (maxScore)

Esta operação estabelece o valor de score a ser considerado o valor máximo possível obtido na operação de matching.

Parâmetros: maxScore: valor double correspondente ao score a ser considerado o valor máxi-

mo possível obtido na operação de matching.

Retorno: Esta operação não retorna nenhum valor (void).

Exceções: InvalidParameterValue: O valor passado no parâmetro é inválido ou não está den-

tro da faixa de valores permitidos.

Tabela 50. Especificação da operação getAcceptableQualityThreshold (qualityT- hresholdType)

float getAcceptableQualityThreshold (qualityThresholdType)

Esta operação recupera o limiar de qualidade aceitável para o tipo de limiar de qualidade passa- do como parâmetro.

Parâmetros: qualityThresholdType: tipo de limiar de qualidade (enumerado em Accep-

tableQualityThresholdType).

Retorno: Esta operação retorna um valor float correspondente ao limiar de qualidade aceitá-

vel para o tipo de limiar de qualidade passado como parâmetro. Exceções:

Tabela 51. Especificação da operação setAcceptableQualityThreshold (acceptab- leQualityThreshold, qualityThresholdType)

sholdType)

Esta operação estabelece o limiar de qualidade aceitável para o tipo de limiar de qualidade pas- sado como parâmetro.

Parâmetros: acceptableQualityThreshold: valor float correspondente ao limiar de quali-

dade aceitável para o tipo de limiar de qualidade passado como parâmetro. qualityThresholdType: tipo de limiar de qualidade (enumerado em Accep-

tableQualityThresholdType).

Retorno: Esta operação não retorna nenhum valor (void).

Exceções: InvalidParameterValue: O valor acceptableQualityThreshold passado no parâme-

tro é inválido ou não está dentro da faixa de valores permitidos.