1、American National StandardDeveloped byfor Information Technology Tenprint Capture usingBioAPIANSI INCITS 434-2007ANSIINCITS434-2007Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-
2、,-Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-ANSIINCITS 434-2007American National Standardfor Information Technology Tenprint Capture using BioAPISecretariatInformation Tec
3、hnology Industry CouncilApproved December 10, 2007 American National Standards Institute, Inc.Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-Approval of an American National St
4、andard 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 Board ofStandards Review, substantial agreement has been reached by directly andmaterial
5、ly 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 madetowards their resolution.The use of American National Standards is completely voluntary
6、; 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 standards.The American National Standards Institute does not develop standards andwill in
7、 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 AmericanNational Standards Institute. Requests for interpretations should beaddressed to the
8、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 StandardsInstitute require that action be taken periodically to reaffirm, revise, orwithdraw thi
9、s standard. Purchasers of American National Standards mayreceive current information on all standards by calling or writing the AmericanNational Standards Institute.American National StandardPublished byAmerican National Standards Institute, Inc.25 West 43rd Street, New York, NY 10036Copyright 2007
10、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, 1250 Eye Street NW, Washington, DC 20005. Printed in the United States of AmericaCAUTI
11、ON: 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 publisher have undertaken a patent search in order to identifywhich, if any, patents ma
12、y 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 made. No further patent search is conducted by the de-veloper or publisher in respect to
13、any standard it processes. No representation is made or impliedthat licenses are not required to avoid infringement in the use of this standard.Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without licens
14、e from IHS-,-,-Table of Contents FOREWORD . iii INTRODUCTION . v 1. SCOPE1 2. CONFORMANCE .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.
15、BIOAPI FUNCTION CALLS .3 6.1 BIOAPI_CONTROLUNIT() 3 6.1.1 Usage 3 6.1.2 Prototype .3 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 P
16、rototype .5 6.3.3 Parameters5 6.3.4 BioAPI_UNIT_SCHEMA6 7. CAPTURE CONTROL BLOCKS (CCB).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 R
17、ESOLUTION .10 8.6 IMAGE COMPRESSION .10 8.7 SELECTING IMAGES TO BE CAPTURED11 8.8 CALCULATION OF FINGER SEGMENT POSITION.11 8.9 IMAGE QUALITY.11 i Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without lic
18、ense from IHS-,-,-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 SUPPORTED13 10.3 SLAP CAPTURE NOT SUPPORTED13 10.4
19、 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 TYPE 4 RECORDS NOT SUPPORTED 14 10.11 TYPE 1
20、4 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 Record (IDC 1) 15 A.1.4 Type-14 Record (IDC 2) 1
21、5 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.7 Type-4 Record (IDC 5) 18 A.2.8 Type-4 Recor
22、d (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 Copyright American National Standards Institute Provided by IHS under license with ANSI Not for Re
23、saleNo reproduction or networking permitted without license from IHS-,-,-Foreword (This foreword is not part of American National Standard ANSI INCITS 434-2007.)INCITS (The International Committee for Information Technology Standards) is theANSI recognized Standards Development Organization for info
24、rmation technologywithin the United States of America. Members of INCITS are drawn from Govern-ment, Corporations, Academia and other organizations with a material interest in thework of INCITS and its Technical Committees. INCITS does not restrict membershipand attracts participants in its technica
25、l work from 13 different countries, and oper-ates under the rules of the American National Standards Institute. In the field of Biometrics, INCITS has established the Technical Committee M1.Standards developed by this Technical Committee have reached consensusthroughout the development process and h
26、ave been thoroughly reviewed throughseveral Public Review processes. This document was submitted to INCITS M1-Biometrics by M1.2. This standard contains two informative annexes, both of which are not consideredpart of the standard.Requests for interpretation, suggestions for improvement or addenda,
27、or defect re-ports are welcome. They should be sent to InterNational Committee for InformationTechnology Standards (INCITS), ITI, 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 no
28、t necessarily imply that all committee mem-bers voted for its approval. At the time it approved this standard, INCITS had thefollowing members:Karen Higginbottom, ChairJennifer Garner, SecretaryOrganization Represented Name of RepresentativeAdobe Systems, Inc. Leslie BixelSteve Ziles (Alt.)AIM Globa
29、l, Inc. Dan MullenCharles Biss (Alt.)Apple Computer, Inc. David MichaelElectronic Industries Alliance . Edward Mikoski, Jr.David Thompson (Alt.)EMC Corporation Gary RobinsonFarance, Inc. Frank FaranceTimothy Schoechle (Alt.)GS1 US Frank SharkeyJames Chronowski (Alt.)Mary Wilson (Alt.)Hewlett-Packard
30、 Company. Karen HigginbottomSteve Mills (Alt.)Scott Jameson (Alt.)IBM Corporation . Ronald F. SillettiRobert Weir (Alt.)Sandy Block (Alt.)Richard Schwerdtfeger (Alt.)IEEE . Judith GormanTerry DeCourcelle (Alt.)Bill Ash (Alt.)Jodi Haasz (Alt.)Bob Labelle (Alt.)iiiCopyright American National Standards
31、 Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-Organization Represented Name of RepresentativeIntel .Philip WennblomDave Thewlis (Alt.)Jesse Walker (Alt.)Grace Wei (Alt.)Lexmark InternationalDon WrightDwight Lewis
32、 (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 further c
33、onstrain the use of theBioAPI standard in the tenprint capture context and to provide additional guidancethat will improve both usability and interoperability.viiCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permit
34、ted without license from IHS-,-,-Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-AMERICAN NATIONAL STANDARD ANSI INCITS 434-2007American National Standard for Information Techno
35、logy Tenprint Capture using BioAPI 1. Scope 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.
36、Identification of BioAPI functions to be 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
37、 a BSP (biometric service provider) controlled 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 Th
38、e following standards contain provisions 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 applyin
39、g the most recent editions of the standards 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
40、 the purpose of this function to differentiate 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 Copyright Ameri
41、can National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-ANSI INCITS 434-2007 6.1.3.5 OutputData (output) No output is needed. The buffer address will be NULL and length set to “0” within the BioAPI_DA
42、TA 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 CCB passed in the InputData parameter. See Clause 10. 6.2 BioAPI_Capture() 6.2.1 Usage This
43、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 current CCB, which was specified in the BioAPI_ControlUnit() call. 6.2.2 Prototype BioAPI_RE
44、TURN 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, BioAPI_BIR_HANDLE *AuditData); 6.2.3 Parameters 6.2.3.1 BSPHandle (input) The handle of the at
45、tached 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/optional) Specifies which subtype to capture. This parameter does not have the flexibility to
46、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.3.4 OutputFormat (input/optional) Specifies which BDB (biometric data block) format to us
47、e for the returned CapturedBIR. Format Owner and Format Type shall be set to 0x001B and 0x8013 respectively to designate that the 4 Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,
48、-,-ANSI INCITS 434-2007 BIR (biometric information record) shall consist of a COB. 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 milliseconds) for the capture operation. If this timeout is reached, the function returns an error, and no results. This
