ANSI INCITS 434-2007 Information Technology C Tenprint Capture using BioAPI.pdf

1、American National StandardDeveloped byfor Information Technology Tenprint Capture usingBioAPIANSI INCITS 434-2007ANSIINCITS434-2007ANSIINCITS 434-2007American National Standardfor Information Technology Tenprint Capture using BioAPISecretariatInformation Technology Industry CouncilApproved December

2、10, 2007 American National Standards Institute, Inc.Approval of an American National Standard requires review by ANSI that therequirements for due process, consensus, and other criteria for approval havebeen met by the standards developer.Consensus is established when, in the judgement of the ANSI B

3、oard ofStandards Review, substantial agreement has been reached by directly andmaterially affected interests. Substantial agreement means much more thana simple majority, but not necessarily unanimity. Consensus requires that allviews and objections be considered, and that a concerted effort be made

4、towards their resolution.The use of American National Standards is completely voluntary; theirexistence does not in any respect preclude anyone, whether he has approvedthe standards or not, from manufacturing, marketing, purchasing, or usingproducts, processes, or procedures not conforming to the st

5、andards.The American National Standards Institute does not develop standards andwill in no circumstances give an interpretation of any American NationalStandard. Moreover, no person shall have the right or authority to issue aninterpretation of an American National Standard in the name of the Americ

6、anNational Standards Institute. Requests for interpretations should beaddressed to the secretariat or sponsor whose name appears on the titlepage of this standard.CAUTION NOTICE: This American National Standard may be revised orwithdrawn at any time. The procedures of the American National Standards

7、Institute require that action be taken periodically to reaffirm, revise, orwithdraw this standard. Purchasers of American National Standards mayreceive current information on all standards by calling or writing the AmericanNational Standards Institute.American National StandardPublished byAmerican N

8、ational Standards Institute, Inc.25 West 43rd Street, New York, NY 10036Copyright 2007 by Information Technology Industry Council (ITI)All rights reserved.No part of this publication may be reproduced in anyform, in an electronic retrieval system or otherwise,without prior written permission of ITI,

9、 1250 Eye Street NW, Washington, DC 20005. Printed in the United States of AmericaCAUTION: The developers of this standard have requested that holders of patents that may berequired for the implementation of the standard disclose such patents to the publisher. However,neither the developers nor the

10、publisher have undertaken a patent search in order to identifywhich, if any, patents may apply to this standard. As of the date of publication of this standardand following calls for the identification of patents that may be required for the implementation ofthe standard, no such claims have been ma

11、de. No further patent search is conducted by the de-veloper or publisher in respect to any standard it processes. No representation is made or impliedthat licenses are not required to avoid infringement in the use of this standard.Table of Contents FOREWORD . iii INTRODUCTION . v 1. SCOPE1 2. CONFOR

12、MANCE .1 3. NORMATIVE REFERENCES .1 4. TERMS AND DEFINITIONS .2 4.1 CAPTURE CONTROL BLOCK (CCB) .2 4.2 CAPTURE OUTPUT BLOCK (COB) .2 4.3 ROLLED PRINTS 2 4.4 SLAP PRINTS.2 4.5 TENPRINT CAPTURE 2 5. REQUIREMENTS .2 6. BIOAPI FUNCTION CALLS .3 6.1 BIOAPI_CONTROLUNIT() 3 6.1.1 Usage 3 6.1.2 Prototype .3

13、 6.1.3 Parameters3 6.1.4 Additional Error Return Codes.4 6.2 BIOAPI_CAPTURE() 4 6.2.1 Usage 4 6.2.2 Prototype .4 6.2.3 Parameters4 6.2.4 Additional Error Return Codes.5 6.3 BIOAPI_QUERYUNITS() 5 6.3.1 Usage 5 6.3.2 Prototype .5 6.3.3 Parameters5 6.3.4 BioAPI_UNIT_SCHEMA6 7. CAPTURE CONTROL BLOCKS (C

14、CB).7 8. RECORD TYPES AND FIELDS .8 8.1 CONTROL AND REQUIRED FIELDS 8 8.2 IMAGE HEIGHT AND WIDTH 9 8.3 IMAGE DATA9 8.4 AMPUTATED OR BANDAGED FINGERS 10 8.4.1 Type 4 Records .10 8.4.2 Type 14 Records .10 8.5 CAPTURE RESOLUTION .10 8.6 IMAGE COMPRESSION .10 8.7 SELECTING IMAGES TO BE CAPTURED11 8.8 CA

15、LCULATION OF FINGER SEGMENT POSITION.11 8.9 IMAGE QUALITY.11 i 8.9.1 Setting Quality Thresholds 11 8.10 BITS PER PIXEL.11 8.11 DATE PRINTED11 8.12 IMAGE CAPTURE EQUIPMENT.12 9. RETURNED BIR.12 9.1 BIR HEADER.12 9.2 BDB FORMAT .12 10. ERROR CODES .13 10.1 UNABLE TO PARSE13 10.2 ROLL CAPTURE NOT SUPPO

16、RTED13 10.3 SLAP CAPTURE NOT SUPPORTED13 10.4 SLAP SEGMENTATION NOT SUPPORTED.13 10.5 FINGERPRINT EXTRACTION NOT SUPPORTED.13 10.6 QUALITY ALGORITHM NOT SUPPORTED .13 10.7 COMPRESSION ALGORITHM NOT SUPPORTED13 10.8 SEGMENTATION ALGORITHM NOT SUPPORTED.13 10.9 IMAGE RESOLUTION NOT SUPPORTED .13 10.10

17、 TYPE 4 RECORDS NOT SUPPORTED 14 10.11 TYPE 14 RECORDS NOT SUPPORTED 14 10.12 FINGER POSITION NOT SUPPORTED.14 ANNEX A: EXAMPLE CAPTURE CONTROL BLOCKS (CCB) FOR ACQUISITION OF IMAGES (INFORMATIVE)15 A.1 THREE SLAPS (FANC TOT) 15 A.1.1 Type-1 Record.15 A.1.2 Type-2 Record (IDC 0) 15 A.1.3 Type-14 Rec

18、ord (IDC 1) 15 A.1.4 Type-14 Record (IDC 2) 15 A.1.5 Type-14 Record (IDC 3) 16 A.2 TEN PLAIN IMPRESSIONS (NO TOT) .16 A.2.1 Type-1 Record.16 A.2.2 Type-2 Record (IDC 0) 17 A.2.3 Type-4 Record (IDC 1) 17 A.2.4 Type-4 Record (IDC 2) 17 A.2.5 Type-4 Record (IDC 3) 18 A.2.6 Type-4 Record (IDC 4) 18 A.2.

19、7 Type-4 Record (IDC 5) 18 A.2.8 Type-4 Record (IDC 6) 19 A.2.9 Type-4 Record (IDC 7) 19 A.2.10 Type-4 Record (IDC 8) 19 A.2.11 Type-4 Record (IDC 9) 20 A.2.12 Type-4 Record (IDC 10) 20 ANNEX B: BIOAPI CALLING SEQUENCE EXAMPLE (INFORMATIVE).21 ii Foreword (This foreword is not part of American Natio

20、nal Standard ANSI INCITS 434-2007.)INCITS (The International Committee for Information Technology Standards) is theANSI recognized Standards Development Organization for information technologywithin the United States of America. Members of INCITS are drawn from Govern-ment, Corporations, Academia an

21、d other organizations with a material interest in thework of INCITS and its Technical Committees. INCITS does not restrict membershipand attracts participants in its technical work from 13 different countries, and oper-ates under the rules of the American National Standards Institute. In the field o

22、f Biometrics, INCITS has established the Technical Committee M1.Standards developed by this Technical Committee have reached consensusthroughout the development process and have been thoroughly reviewed throughseveral Public Review processes. This document was submitted to INCITS M1-Biometrics by M1

23、.2. This standard contains two informative annexes, both of which are not consideredpart of the standard.Requests for interpretation, suggestions for improvement or addenda, or defect re-ports are welcome. They should be sent to InterNational Committee for InformationTechnology Standards (INCITS), I

24、TI, 1250 Eye Street, NW, Suite 200, Washington,DC 20005.This standard was processed and approved for submittal to ANSI by INCITS. Com-mittee approval of this standard does not necessarily imply that all committee mem-bers voted for its approval. At the time it approved this standard, INCITS had thef

25、ollowing members:Karen Higginbottom, ChairJennifer Garner, SecretaryOrganization Represented Name of RepresentativeAdobe Systems, Inc. Leslie BixelSteve Ziles (Alt.)AIM Global, Inc. Dan MullenCharles Biss (Alt.)Apple Computer, Inc. David MichaelElectronic Industries Alliance . Edward Mikoski, Jr.Dav

26、id Thompson (Alt.)EMC Corporation Gary RobinsonFarance, Inc. Frank FaranceTimothy Schoechle (Alt.)GS1 US Frank SharkeyJames Chronowski (Alt.)Mary Wilson (Alt.)Hewlett-Packard Company. Karen HigginbottomSteve Mills (Alt.)Scott Jameson (Alt.)IBM Corporation . Ronald F. SillettiRobert Weir (Alt.)Sandy

27、Block (Alt.)Richard Schwerdtfeger (Alt.)IEEE . Judith GormanTerry DeCourcelle (Alt.)Bill Ash (Alt.)Jodi Haasz (Alt.)Bob Labelle (Alt.)iiiOrganization Represented Name of RepresentativeIntel .Philip WennblomDave Thewlis (Alt.)Jesse Walker (Alt.)Grace Wei (Alt.)Lexmark InternationalDon WrightDwight Le

28、wis (Alt.)Paul Menard (Alt.)Microsoft CorporationJim HughesDon Stanwyck (Alt.)Isabelle Valet-Harper (Alt.)National Institute of Standards however, there area number of areas where options exist or in which implementation details are left tothe vendor or application. This standard is needed to furthe

29、r constrain the use of theBioAPI standard in the tenprint capture context and to provide additional guidancethat will improve both usability and interoperability.viiAMERICAN NATIONAL STANDARD ANSI INCITS 434-2007American National Standard for Information Technology Tenprint Capture using BioAPI 1. S

30、cope This standard specifies requirements for the use of ISO/IEC 19784-1, BioAPI Specification (also known as BioAPI 2.0), a software interface standard, for the purpose of performing a tenprint capture operation. This includes one or more of the following: 1. Identification of BioAPI functions to b

31、e utilized and the order (if any) in which they are to be called 2. Specification of values for function parameters 3. Definition of GUI (graphical user interface) events (for use with an application controlled GUI) 4. User interface specifications for use with a BSP (biometric service provider) con

32、trolled GUI 5. Sample calling sequences and example inputs/outputs 2. Conformance Biometric Service Providers (BSPs) that claim conformance to this standard shall satisfy the normative requirements as described in Clauses 5 through 9. 3. Normative References The following standards contain provision

33、s which, through reference in this text, constitute provisions of this American National Standard. All standards are subject to revision, and parties to agreements based on this American National Standard are encouraged to investigate the possibility of applying the most recent editions of the stand

34、ards indicated below. 1. ANSI/NIST-ITL 1-2007, Data Format for the Interchange of Fingerprint, Facial, 6.1.3 Parameters 6.1.3.1 BSPHandle (input) The handle of the attached BSP. 6.1.3.2 UnitID (input) ID of the BioAPI Unit. 6.1.3.3 ControlCode (input) Indicates the purpose of this function to differ

35、entiate it from other BioAPI_ControlUnit() calls. The value of “1” shall be used to indicate that a CCB is being set. 6.1.3.4 InputData (input) Pointer to a BioAPI_Data structure. This structure shall contain the address and length of the CCB. 3 ANSI INCITS 434-2007 6.1.3.5 OutputData (output) No ou

36、tput is needed. The buffer address will be NULL and length set to “0” within the BioAPI_DATA structure. Usage of the OutputData parameter to return diagnostic data about the CCB should be considered. 6.1.4 Additional Error Return Codes Error codes should be used to indicate errors detected in the CC

37、B passed in the InputData parameter. See Clause 10. 6.2 BioAPI_Capture() 6.2.1 Usage This function shall trigger a BSP to perform fingerprint image captures and to create a new CCB. The fingers captured and the processing done on the fingers shall be controlled by inclusion of empty fields in the cu

38、rrent CCB, which was specified in the BioAPI_ControlUnit() call. 6.2.2 Prototype BioAPI_RETURN BioAPI BioAPI_Capture (BioAPI_HANDLE BSPHandle, BioAPI_BIR_PURPOSE Purpose, BioAPI_BIR_SUBTYPE Subtype, BioAPI_BIR_BIOMETRIC_DATA_FORMAT *OutputFormat, BioAPI_BIR_HANDLE *CapturedBIR, Int32_t Timeout, BioA

39、PI_BIR_HANDLE *AuditData); 6.2.3 Parameters 6.2.3.1 BSPHandle (input) The handle of the attached BSP. 6.2.3.2 Purpose (input) A value indicating the purpose of the biometric data capture. For the purposes of tenprint capture, the value BioAPI_PURPOSE_ENROLL shall be used. 6.2.3.3 Subtype (input/opti

40、onal) Specifies which subtype to capture. This parameter does not have the flexibility to describe the range of possible finger image sets that might be captured. A value of BioAPI_NO_SUBTYPE_AVAILABLE (0x00) shall be used to indicate that the BSP is to select the subtypes using the current CCB. 6.2

41、.3.4 OutputFormat (input/optional) Specifies which BDB (biometric data block) format to use for the returned CapturedBIR. Format Owner and Format Type shall be set to 0x001B and 0x8013 respectively to designate that the 4 ANSI INCITS 434-2007 BIR (biometric information record) shall consist of a COB

42、. Alternatively a NULL pointer shall be used to indicate that output format selection will be handled by the BSP. 6.2.3.5 CapturedBIR (output) A handle to a BIR containing captured data, the COB. See Clause 9 for a specification of this BIR. 6.2.3.6 Timeout (input) Specifies the timeout value (in mi

43、lliseconds) for the capture operation. If this timeout is reached, the function returns an error, and no results. This value can be any positive number. A -1 value means the BSPs default timeout value will be used. 6.2.3.7AuditData (output/optional) A handle value of BioAPI_UNSUPPORTED_BIR_HANDLE sh

44、all be used to indicate that AuditData is not available. 6.2.4 Additional Error Return Codes BioAPI includes codes such as BioAPIERR_UNABLE_TO_CAPTURE to indicate that the BSP could not collect the data that it is meant to. Additional error codes specific to tenprint capture are specified in Clause

45、10. 6.3 BioAPI_QueryUnits() 6.3.1 Usage Applications will use this function to determine if the device attached to the BSP conforms to this standard and if so, to discover what specific capabilities are supported by the attached tenprint capture device (unit). 6.3.2 Prototype BioAPI_RETURN BioAPI Bi

46、oAPI_QueryUnits (const BioAPI_UUID *BSPUuid, BioAPI_UNIT_SCHEMA *UnitSchemaArray, uint32_t *NumberOfElements); 6.3.3 Parameters 6.3.3.1 BSPUuid (input) The unique identifier for the (tenprint) BSP to which the unit (tenprint scanning device) is attached and for which the unit information is to be re

47、turned. 6.3.3.2 UnitSchemaArray (output) A pointer to the address of the array of elements of type BioAPI_UNIT_SCHEMA containing the unit schema information. Specific elements of interest are defined in 6.3.4, below. 5 ANSI INCITS 434-2007 6.3.3.3 NumberOfElements (output) A pointer to the number of

48、 elements in the array. 6.3.4 BioAPI_UNIT_SCHEMA This schema is defined in Clause 7.55 of the base standard (BioAPI specification). There are three elements of this structure that are of particular interest for the purpose of tenprint capture (the UnitProperties, UnitPropertyID, and UnitProperty ele

49、ments), though other elements of the schema may also be of general use (e.g., vendor information, firmware version, etc.). If more than one type of BioAPI Unit is attached to the BSP, more than one Unit schema may be returned. Tenprint scanner devices shall set UnitCategory to BioAPI_CATEGORY_SENSOR (0x00000008). 6.3.4.1 UnitProperties UUID indicating a set of properties of the BioAPI Unit. The indicated set can either be specified by each vendor or follow a related standard. The UUID “ba38567f-66be-468c-9