ANSI INCITS ISO IEC 19784-1 AMD 1-2007 Information technology BioAPI Biometric Application Programming Interface Part 1 BioAPI Specification AMENDMENT 1 BioGUI specification.pdf

1、INCITS/ISO/IEC 19784-1:2006/AM1-20072008 (ISO/IEC 19784-1:2006/AM1-2007, IDT) Information technology BioAPI Biometric Application Programming Interface Part 1: BioAPI Specification AMENDMENT 1: BioGUI specificationINCITS/ISO/IEC 19784-1:2006/AM1-20072008(ISO/IEC 19784-1:2006/AM1-2007, IDT)INCITS/ISO

2、/IEC 19784-1:2006/AM1-20072008 ii ITIC 2008 All rights reserved PDF disclaimer This PDF file may contain embedded typefaces. In accordance with Adobes licensing policy, this file may be printed or viewed but shall not be edited unless the typefaces which are embedded are licensed to and installed on

3、 the computer performing the editing. In downloading this file, parties accept therein the responsibility of not infringing Adobes licensing policy. The ISO Central Secretariat accepts no liability in this area. Adobe is a trademark of Adobe Systems Incorporated. Details of the software products use

4、d to create this PDF file can be found in the General Info relative to the file; the PDF-creation parameters were optimized for printing. Every care has been taken to ensure that the file is suitable for use by ISO member bodies. In the unlikely event that a problem relating to it is found, please i

5、nform the Central Secretariat at the address given below. Adopted by INCITS (InterNational Committee for Information Technology Standards) as an American National Standard. Date of ANSI Approval: 7/1/2008 Published by American National Standards Institute, 25 West 43rd Street, New York, New York 100

6、36 Copyright 2008 by Information Technology Industry Council (ITI). All rights reserved. These materials are subject to copyright claims of International Standardization Organization (ISO), International Electrotechnical Commission (IEC), American National Standards Institute (ANSI), and Information

7、 Technology Industry Council (ITI). Not for resale. No part of this publication may be reproduced in any form, including an electronic retrieval system, without the prior written permission of ITI. All requests pertaining to this standard should be submitted to ITI, 1250 Eye Street NW, Washington, D

8、C 20005. Printed in the United States of America INCITS/ISO/IEC 19784-1:2006/AM1-20072008 ITIC 2008 - All rights reserved iiiForeword ISO (the International Organization for Standardization) and IEC (the International Electrotechnical ASCommission) form the specialized system for worldwide standardi

9、zation. National bodies that are members of ISO or IEC participate in the development of International Standards through technical committees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mut

10、ual interest. Other international organizations, governmental and non-governmental, in liaison with ISO and IEC, also take part in the work. In the field of information technology, ISO and IEC have established a joint technical committee, ISO/IEC JTC 1. International Standards are drafted in accorda

11、nce with the rules given in the ISO/IEC Directives, Part 2. The main task of the joint technical committee is to prepare International Standards. Draft International Standards adopted by the joint technical committee are circulated to national bodies for voting. Publication as an International Stand

12、ard requires approval by at least 75 % of the national bodies casting a vote. Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. Amendment 1 to

13、ISO/IEC 19784-1 was prepared by Joint Technical Committee ISO/IEC JTC 1, Information technology, Subcommittee SC 37, Biometrics. It defines a new version of BioAPI (BioAPI 2.1) that: a) extends and improves the “application-controlled GUI“ feature of BioAPI; b) produces alignment between BioAPI and

14、ISO/IEC 19785-1:2006, Information technology Common Biometric Exchange Formats Framework Data element specification c) provides for other standards to modify BioAPI framework behaviour to support the use of biometric service providers (BSPs) that are remote from the controlling applications. INCITS/

15、ISO/IEC 19784-1:2006/AM1-20072008 iv ITIC 2008 - All rights reservedIntroduction With this amendment, ISO/IEC 19784-1 specifies two versions of BioAPI: 2.0 and 2.1. All the provisions that apply only to one version of BioAPI (either 2.0 or 2.1) are labeled as such. The main difference of BioAPI 2.1

16、from BioAPI 2.0 is the support it provides for BioGUI. BioGUI stands for “BioAPI Graphical User Interface“. The functionality specified in this amendment enables an application to control the display of graphics at enrollment, verification and identification as an alternative to using the graphical

17、user interface provided by BSPs. Secondly, BioAPI 2.1 also aligns the values of the type definition BioAPI_BIR_BIOMETRIC_TYPE with those specified in ISO/IEC 19785-1:2006. Thirdly, it provides additional functions and parameters that are redundant in a purely local implementation of BIoAPI, but whic

18、h enable other standards (interworking standards - see 4.29) to modify the behaviour of a BioAPI framework to support interactions between an application and remote BSPs. Finally, it provides improvements to some of the functions and parameters defined for BioAPI 2.0, particularly in relation to sup

19、port for tenprint capture, the electronic capture of ten human fingerprints. This amendment redefines (in the specificaton of BioAPI 2.1) portions of the BioAPI 2.0 specification that define BioAPI types, macros, functions and callback functions (particularly those related to the application-control

20、led GUI feature) with a new set of definitions that provide more functionality. Some of the old BioAPI 2.0 definitions are completely replaced by new definitions (with the same or with different names), while others are extended by the addition of one or more parameters. Some types and functions are

21、 entirely new in BioAPI 2.1. The resulting specification is expected to better meet the needs of biometric applications that wish to have full control of the user interface during enrollment, verification and identification, that need to be able to work with remote BSPs, or that need added functiona

22、lity for interaction with local BSPs. INCITS/ISO/IEC 19784-1:2006/AM1-20072008 ITIC 2008 - All rights reserved 1Information technology Biometric application programming interface Part 1: BioAPI specification AMENDMENT 1: BioGUI specification 1) General amendment items 1-1) Replace the last paragraph

23、 of the Foreword with the following: The first edition of this part of ISO/IEC 19784 was the first ISO/IEC standard on BioAPI. Previous versions of the specification were published by ANSI and the BioAPI Consortium. As the last official non-ISO specification was designated BioAPI 1.1, the versions s

24、pecified in this part of ISO/IEC 19784 are designated BioAPI 2.0 and BioAPI 2.1. 1-2) Replace the first paragraph of the Introduction with: This part of ISO/IEC 19784 provides a high-level generic biometric authentication model suited to most forms of biometric technology. No explicit support for mu

25、ltimodal biometrics is provided. 1-3) Insert the following paragraph after the third paragraph of the Introduction This part of ISO/IEC 19784 specifies the behaviour of the BioAPI Framework when applications and BSPs are in the same system. Other interworking standards (see 4.29) specify modificatio

26、ns of that behaviour that enable both BSPs and Graphical User Interfaces to be remote from the system containing an application. NOTE: ISO/IEC 24708 specifying the BioAPI Interworking Protocol (BIP) 6 is an example of an interworking standard. 2) Amendment items for the application-controlled GUI 2-

27、1) Add the following text after 4.28: 4.29 interworking standards standards that modify the behaviour of the BioAPI Framework (and BioAPI conformance requirements) to support the use of communications links to enable an application to interact with a remote BSP using a standardised protocol INCITS/I

28、SO/IEC 19784-1:2006/AM1-20072008 2 ITIC 2008 - All rights reserved4.30 test-verify test-verification one-to-one process of comparing a single biometric sample against a candidate of a biometric reference template at enrollment to determine whether the candidate template matches the test sample 4.31

29、enroll type value denoting a pattern of suboperations performed by a BSP during an enroll operation 2-2) Add the following text after 6.1.8 d), after replacing “.” at the end of c) with “; and”: e) providing graphical information to the application about an ongoing enrollment, verification, or ident

30、ification operation. 2-3) Replace the heading of subclause 7.8 with the following text: 7.8 BioAPI_BIR_BIOMETRIC_TYPE (BioAPI 2.0) This subclause applies only when the BioAPI version number in use is 2.0. 2-4) Add the following text after subclause 7.57 (BioAPI_VERSION): 7.58 BioAPI_BIR_BIOMETRIC_TY

31、PE (BioAPI 2.1) This subclause applies only when the BioAPI version number in use is 2.1. A mask that describes the set of biometric types (factors) contained within a BioAPI BIR or supported by a BSP. typedef uint32_t BioAPI_BIR_BIOMETRIC_TYPE; #define BioAPI_NO_BIOTYPE_AVAILABLE (0x00000000) #defi

32、ne BioAPI_TYPE_MULTIPLE_BIOMETRIC_TYPES (0x00000001) #define BioAPI_TYPE_FACE (0x00000002) #define BioAPI_TYPE_VOICE (0x00000004) #define BioAPI_TYPE_FINGER (0x00000008) #define BioAPI_TYPE_IRIS (0x00000010) #define BioAPI_TYPE_RETINA (0x00000020) #define BioAPI_TYPE_HAND_GEOMETRY (0x00000040) #defi

33、ne BioAPI_TYPE_SIGNATURE_SIGN (0x00000080) #define BioAPI_TYPE_KEYSTROKE (0x00000100) #define BioAPI_TYPE_LIP_MOVEMENT (0x00000200) #define BioAPI_TYPE_GAIT (0x00001000) #define BioAPI_TYPE_VEIN (0x00002000) #define BioAPI_TYPE_DNA (0x00004000) #define BioAPI_TYPE_EAR (0x00008000) #define BioAPI_TYP

34、E_FOOT (0x00010000) #define BioAPI_TYPE_SCENT (0x00020000) #define BioAPI_TYPE_OTHER (0x40000000) #define BioAPI_TYPE_PASSWORD (0x80000000) NOTE 1: BioAPI_TYPE_MULTIPLE_BIOMETRIC_TYPES is used to indicate that the biometric samples contained within the BDB (BIR BiometricData) include biometric sampl

35、es from more than one type of biometric sensor unit (e.g., INCITS/ISO/IEC 19784-1:2006/AM1-20072008 ITIC 2008 - All rights reserved 3fingerprint and facial data). Location of the individual samples within the BDB is specified by the Format Owner and identified by the value of the Format Type. NOTE 2

36、: The condition NO VALUE AVAILABLE is indicated by setting the value to zero. BIRs that are not originally created by BioAPI BSPs should use this value when transformed into a BioAPI BIR if Biometric Type information is not available in the original source record. Transformed BIRs whose biometric ty

37、pe does not correspond to one of the defined types shall use the value for OTHER. NOTE 3: The BioAPI BIR Biometric Type corresponds to the “CBEFF_BDB_biometric_type” in ISO/IEC 19785-1. NOTE 4: Although “password” is not a biometric characteristic, BioAPI_TYPE_PASSWORD is included as a valid BioAPI_

38、BIR_BIOMETRIC_TYPE to support its use a) for development #define BioAPI_BIR_SUBTYPE_VEIN_ONLY_MASK (0x80) #define BioAPI_BIR_SUBTYPE_LEFT_MASK (0x01) #define BioAPI_BIR_SUBTYPE_RIGHT_MASK (0x02) #define BioAPI_BIR_SUBTYPE_THUMB (0x04) #define BioAPI_BIR_SUBTYPE_POINTERFINGER (0x08) #define BioAPI_BI

39、R_SUBTYPE_MIDDLEFINGER (0x10) #define BioAPI_BIR_SUBTYPE_RINGFINGER (0x20) #define BioAPI_BIR_SUBTYPE_LITTLEFINGER (0x40) #define BioAPI_BIR_SUBTYPE_VEIN_PALM (0x04) #define BioAPI_BIR_SUBTYPE_VEIN_BACKOFHAND (0x08) #define BioAPI_BIR_SUBTYPE_VEIN_WRIST (0x10) #define BioAPI_NO_SUBTYPE_AVAILABLE (0x

40、00) 7.59.3 This structure is a bitmask, with the bits defined as shown below. Bit 7 is used to indicate the interpretation of the lower-order bits. Bit positions zero (0) and one (1) always indicate left and right respectively. When bit position 7 is not set, these bit positions may apply to any bio

41、metric type; however, bit positions 2-6 are specific to the finger and vein biometric types. When bit position 7 is set, then the remaining bit positions apply to the vein biometric type only. Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 0 (Any) Little Ring Middle Pointer Thumb Right Left 1 (Vein

42、 only) Reserved Reserved Wrist Back of Hand Palm Right Left NOTE: Vein biometric data may be obtained from the fingers (Bit 7 set to zero), or from the wrists, palm, or backs of either hand (Bit 7 set to 1). 7.59.4 Zero or more bits may be set.The abstract value NO VALUE AVAILABLE is indicated by se

43、tting all bits to zero. NOTE The abstract value NO VALUE AVAILABLE can be used with BIRs that are not originally created by a BioAPI BSP but have been transformed from another data format. It can also be used when none of the other values are applicable or information is not available. 7.59.5 The bi

44、t positions BioAPI_BIR_SUBTYPE_THUMB through BioAPI_BIR_SUBTYPE_LITTLEFINGER can be used to identify the instance(s) of a biometric type related to the fingers. NOTE: The BioAPI BIR Subtype corresponds to the “CBEFF_BDB_biometric_subtype” in ISO/IEC 19785-1. 7.59.6 If one or more of the bit position

45、s BioAPI_BIR_SUBTYPE_THUMB through BioAPI_BIR_SUBTYPE_LITTLEFINGER are set, then either or both the bit positions BioAPI_BIR_SUBTYPE_LEFT_MASK and BioAPI_BIR_SUBTYPE_RIGHT_MASK shall also be set. When only the former is set, the subtype value designates one or more fingers of the left hand. When onl

46、y the latter is set, the subtype value designates one or more fingers of the right hand. When both are set, the value designates one or more fingers of both hands (the same finger locations in both). NOTE: It is not possible to designate, for example, a set of fingers consisting of the index finger

47、of the left hand and the medium finger of the right hand. INCITS/ISO/IEC 19784-1:2006/AM1-20072008 ITIC 2008 - All rights reserved 57.59.7 When a value with multiple finger bits set occurs in a BIR header (or is used as an input parameter of a BioAPI function that performs capture), it is not strict

48、ly required that all the specified finger instances be actually present in the BDB of the BIR (or be actually captured). However, it is recommended that all the designated finger instances be present in the BDB except in the case of missing fingers and similar exceptional situations. Likewise, if th

49、e subtype field of a BIR designates multiple fingers, it is acceptable for the BDB of that BIR to include data about an extra finger if the subject happens to have six fingers in his or her hand. 7.59.8 If none of the finger bit positions BioAPI_BIR_SUBTYPE_THUMB through BioAPI_BIR_SUBTYPE_LITTLEFINGER are set, then the bit positions BioAPI_BIR_SUBTYPE_LEFT_MASK and BioAPI_BIR_SUBTYPE_RIGHT_MASK can be used to identify an instance of a biometric type for which there is one left instance and one righ