Matrox Imaging Library(MIL)双语手册.doc

《Matrox Imaging Library(MIL)双语手册.doc》由会员分享，可在线阅读，更多相关《Matrox Imaging Library(MIL)双语手册.doc（61页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、如有侵权，请联系网站删除，仅供学习与交流Matrox Imaging Library(MIL)双语手册【精品文档】第 80 页MIL 8.0 GUIDEIncluding Active MILOverviewMatrox Imaging Library (MIL) is a modular programming library with commands for image capture, image processing, patternrecognition, blob analysis, edge extraction and analysis, measurement, chara

2、cter recognition, 1D and 2D code reading, calibration, graphics, image compression, image display and archiving. Included with MIL is ActiveMIL, a collection of ActiveX controls (OCXs) for managing image capture, processing, analysis, display and archiving.This guide has been designed to complement

3、the Matrox Imaging Library (MIL) brochure by providing a list of benchmarkson different platforms and a comprehensive overview of the MIL and ActiveMIL APIs. Included with the command and parame- ter descriptions of MIL are real programming examples for each module. Also included are brief descripti

4、ons of some of the control methods, events and properties available in ActiveMIL. For additional information on MIL commands and parameters, as well as ActiveMIL control methods, events, and properties, refer to the MIL and ActiveMIL Command Reference respectively.re ArchitectureMatrox Imaging Libra

5、ry (MIL) and ActiveMILApplication ControlBlob AnalysisBuffer ControlCalibrationCode ReaderDigitizer ControlDisplayGeometricModel FinderGraphicsImage ProcessingMeasurementOCRPattern MatchingString ReaderBoard-Level DriversMatrox CronosPlusMatrox Meteor-IIfamilyMatrox Orion familyMatrox Corona-IIFutur

6、eMatrox HardwareIEEE 1394* IIDC DriverMatrox Morphis familyMatrox Solios familyMatrox Helios familyMatrox Odyssey family*MIL/ActiveMIL has a common API across Matrox Imagings entire hardware line.* Matrox Meteor-II/1394, 4Sight-II or third-party adapter.* Matrox Odyssey family supported through Matr

7、ox Odyssey SDK.Table ofOverviewContents1MIL/ActiveMIL Benchmarks4MIL Command Listing and Description1D and 2D Code Reader module71D and 2D code symbologies7Composite code symbologies8Application and System modules9Blob analysis module10Blob features11Buffer and Data generation modules12Calibration m

8、odule14Digitizer module15Display module15Edge Finder module16Edge features16Function Developers Toolkit18Geometric Model Finder module19Graphics module20Image processing module21Measurement module23OCR module24Pattern matching module25String Reader module26Thread module27Programming ExamplesBlob ana

9、lysis28Calibration 29Camera auto-focus 31Capture and display a video sequence33Code Reader34Digitizer allocation and control35Displaying a MIL buffer under Windows36Edge Finder 37Geometric Model Finder 39Image processing (convolution)41Measurement 42Multi-buffered image capture and processing 44OCR4

10、7Pattern matching 49String Reader51Watershed segmentation 54ActiveMIL Control Listing and DescriptionApplication and System control55BlobAnalysis control56Blob features and results57Calibration control58CharacterRecognition control59Code control60Digitizer control62Display control64EdgeFinder contro

11、l65EdgeFinder features and results66GraphicsContext control67Image control68ImageProcessing control69Measurement control72ModelFinder control74PatternMatching control76StringReader control*77Threading control79*Available as of Processing Pack 1.MIL/ActiveMIL BenchmarksThe following benchmarks provid

12、e a performance overview for a range of imaging operations running on different platforms. A brief description of all functions, parameters and imagesused are included. Note that the benchmarks assume full processor and memor y bandwidth (i.e., no other system activity), and include command overhead

13、s.Note: Operations executed on 512 x 512 images1.Image ProcessingPoint-to-pointAdd two 8-bit images and store results in an 8-bit destination image.0.58 ms0.08 ms0.08 ms0.05 ms0.23 ms2Edge Detection (sobel)Perform an edge detection (sobel) on an 8-bit source image and store results in an 8-bit desti

14、nation image.1.4 ms0.74 ms0.51 ms0.74 ms0.17 ms2Convolution (3 x 3)Perform a general 3 x 3 convolution with arbitrary coefficients on an 8-bit source image and store results in an 8-bit destination image. Results are saturated.1.8 ms1.1 ms0.63 ms0.54 ms0.15 ms2Convolution (5 x 5)Same as above except

15、 with a 5 x 5 kernel.4.6 ms2.9 ms1.6 ms1.5 ms0.21 ms2Convolution (11 x 11)Same as above except with a 11 x 11 kernel.19.8 ms12.7 ms7.1 ms5.8 ms0.96 ms2Erosion/Dilation (3 x 3, predefined, binary)Perform a binary erosion/dilation on a 1-bit source image using a predefined 3 x 3 structuring element an

16、d store results in a 1-bit destination image.0.08 ms0.05 ms0.04 ms0.04 ms0.09 ms2Erosion/Dilation (3 x 3, predefined, grayscale)Same as above except perform a grayscale operation.3.5 ms0.17 ms0.13 ms0.16 ms0.16 ms2Erosion/Dilation (3 x 3, user-defined, binary)Perform a binary erosion/dilation on a 1

17、-bit source image using an arbitrary 3 x 3 structuring element and store results in a 1-bit destination image.0.34 ms0.22 ms0.15 ms0.14 ms0.10 ms2Erosion/Dilation (3 x 3, user-defined, grayscale)Same as above except perform a grayscale erosion/dilation operation.0.92 ms0.51 ms0.39 ms0.51 ms0.16 ms2E

18、rosion/Dilation (5 x 5, user-defined, binary)Perform a binary erosion/dilation on a 1-bit source image using an arbitrary5 x 5 structuring element and store results in a 1-bit destination image.1.4 ms0.88 ms0.58 ms0.55 ms0.09 ms2Erosion/Dilation (5 x 5, user-defined, grayscale)Same as above except p

19、erform a grayscale erosion/dilation.1.8 ms1.1 ms0.75 ms1.1 ms0.22 ms2LUT mapPerform a point-to-point LUT mapping operation for an 8-bit source image and store results in an 8-bit destination image.0.59 ms0.33 ms0.54 ms0.24 ms0.28 ms2HistogramCalculate the histogram of an 8-bit source image and store

20、 result in a 32-bit buffer.0.58 ms0.38 ms0.28 ms0.31 ms0.31 msLossy JPEG Compression (monochrome)Perform lossy JPEG compression on an 8-bit source image and store results in an 8-bit destination image.2.5 ms1.6 ms1.2 ms1.5 ms1.5 msImage Processing (cont.)Lossless JPEG Compression (monochrome)Perform

21、 lossless JPEG compression on an 8-bit source image and store results in an 8-bit destination image.2.9 ms1.9 ms2.2 ms2.3 ms2.3 msRotate (30)Rotate by 30 an 8-bit source image and store results in 8-bit destination image.1.2 ms0.64 ms0.90 ms0.69 ms0.69 msWarp PolynomialWarping using a first-order po

22、lynomial mapping with nearest neighbor interpolation on an 8-bit source image and store results in an 8-bit destination image.1.2 ms0.64 ms0.90 ms0.69 ms0.69 msGeometric Model Finder 3, 4Find a Model (1 model, 1 occurrence, very high speed, limited scaling)Find a single 128 x 128 model in an 8-bit i

23、mage. The whole image is searched for a model rotated within 0-360and scaled within 90-110% using the highest speed (lowest robustness and accuracy) setting.6.2 ms3.7 ms2.8 ms3.4 ms3.4 msFind a Model (1 model, 1 occurrence, medium speed, limited scaling)Find a single 128 x 128 model in an 8-bit imag

24、e. The whole image is searched for a model rotated within 0-360and scaled within 90-110% using medium speed setting.15.6 ms10.2 ms6.5 ms8.1 ms8.1 msFind a Model (1 model, 1 occurrence, medium speed, max. scaling)Find a single 128 x 128 model in an 8-bit image. The whole image is searched for a model

25、 rotated within 0-360and scaled within 50-200% using medium speed setting.16.2 ms10.7 ms7.1 ms8.5 ms8.5 msFind Models (1 model, 4 occurrences, medium speed, limited scaling)Same as above except find four occurrences of a single 128 x 128 model.21.6 ms13.5 ms9.3 ms11.8 ms11.8 msFind Models (4 models,

26、 4 occurrences, medium speed, limited scaling)Same as above except find a single occurrence of four 128 x 128 models.25.6 ms15.7 ms11.1 ms14.2 ms14.2 msPattern Matching (Normalized Grayscale Correlation) 3, 4Find a Model (128 x 128, non-rotated)Find a 128 x 128 model in an 8-bit grayscale image. The

27、 whole image is searched for a model that is not rotated.0.42 ms0.19 ms0.16 ms0.19 ms0.19 msFind a Model (128 x 128, -5 to +5)Find a 128 x 128 model located at 0 in an 8-bit grayscale image. The whole image is searched for a a model rotated within +/-5.1.7 ms0.89 ms0.70 ms0.89 ms0.89 msFind a Model

28、(32 x 32, non-rotated)As above except perform a pattern match of a 32 x 32 model.2.1 ms1.0 ms0.71 ms0.83 ms0.83 msFind a Model (32 x 32, -5 to +5)As above except perform a pattern match of a 32 x 32 model.3.4 ms1.8 ms1.2 ms1.4 ms1.4 msEdge Finder (4000 edge elements or edgels)4Extract contours15.4 m

29、s9.0 ms6.2 ms8.0 ms8.0 msExtract thin line crests68.3 ms24.3 ms19.5 ms24.8 ms24.0 msBlob Analysis (100 blobs that occupy 25% of area)4Calculate Area0.24 ms0.15 ms0.15 ms0.12 ms0.12 msCalculate Area and Binary Center of Gravity0.28 ms0.18 ms0.17 ms0.15 ms0.15 msCalculate Area and Grayscale Center of

30、Gravity0.86 ms0.56 ms0.43 ms0.45 ms0.45 msMeasurementFind an EdgeLocate an edge in a 16 x 4 measurement region of an 8-bit image.0.06 ms0.02 ms0.03 ms0.07 ms0.08 msFind Multiple StripesLocate 24 stripes in a 128 x 16 measurement region of an 8-bit image.0.17 ms0.08 ms0.08 ms0.09 ms0.15 msString Read

31、erString ReadingRead a 6 character string using a 28 character font within a 512 x 512 image region.OCR42.7 ms26.4 ms20.3 ms25.0 ms25.0 msOCR ReadingRead an unknown string of twelve 33 x 21 characters (no grammar rules) within a 404 x 54 image region.10.6 ms6.6 ms4.9 ms5.8 ms5.8 msVerificationVerify

32、 that a known string of 12 SEMI font characters (33 x 21) within a 404 x 54 image region can be read properly.4.0 ms0.83 ms0.59 ms0.84 ms0.84 msBar and Matrix Code RecognitionBar Code ReadingRead a EAN13 bar code (no rotation).0.28 ms0.18 ms0.15 ms0.18 ms0.27 msDataMatrix ReadingRead a DataMatrix co

33、de.3.7 ms1.6 ms2.1 ms2.2 ms2.3 ms1. Benchmarks for larger images do not necessarily scale linearly due to CPU cache effects.2. Performed using PA.3. Faster search speeds can be obtained by reducing accuracy.4. Search speeds will vary with image content.MIL指令简介MIL Command Listing and DescriptionThis

34、section provides an overview of each MIL module and a brief description of each MIL command. For a complete description of the syntax and use of each command, refer to the MIL Command Reference manual.1维和2维条形码识别模块1D and 2D Code Reader module用于读写各种1维和2维条形码及编码机制Used to read (and write) various 1D and

35、2D code symbologies.指令Commands形参Command parameters功能DescriptionMcodeAlloc()SystemId, CodeType, ControlFlag, CodeIdPtr分配一个条形码对象Allocate a code object.McodeControl()CodeId, ControlType, ControlValue控制一个条形码对象Control a code object.McodeFree()CodeId释放一个条形码对象Free a code object.McodeGetResult()CodeId, Resu

36、ltType, ResultPtr从读写操作中获得一个结果Get a result from a read or write operation.McodeInquire()CodeId, InquireType, UserVarPtr查询条形码的参数设置Inquire about a code object parameter setting.McodeRead()CodeId, ImageBufId, ControlFlag从图中读取特定类型的条形码Read a specific type of code in an image.McodeRestore()FileName, System

37、Id, ControlFlag, CodeIdPtr从磁盘文件中恢复从前保存的条形码对象Restore a code object previously saved to a file.McodeSave()FileName, CodeId, ControlFlag将特定的条形码对象保存到磁盘文件中Save the specified code object in a file.McodeStream()MemPtrOrFileName, SystemId Operation, StreamType, Version ControlFlag, CodeIdPtr, SizeByteVarPtr

38、从（到）文件或内存中加载、恢复或者保存条形码对象Load, restore, or save a code object from/to a file or memory.McodeVerify()CodeId, ImageBufId, String, ControlFlag从源图像中计算不同质量等级的条形码Compute the different quality-grades of the code in the specified source image.McodeWrite()CodeId, ImageBufId, String, ControlFlag以ASCII码的格式进行编码E

39、ncode an ASCII string.1维和2维条形码编码机制1D and 2D code symbologies对于指令McodeAlloc()，编码的方式包括以下几种类型：For the McodeAlloc() command, the code type(s) that can be read or written include(s):编码类型Code Type编码方式Encoding Type纠错Error CorrectionBC412标准编码方式Standard encoding type无纠错No error correctionCodabar标准编码方式Standar

40、d encoding type无纠错No error correctionCode39ASCII编码，标准编码ASCII encoding, Standard encoding type无纠错；检验位错误No error correction; check-digit error correctionCode93ASCII编码ASCII encoding检验位纠错Check-digit error correctionCode128 (UCC/EAN128)Continued.ASCII编码ASCII encoding检验位纠错Check-digit error correction1D an

41、d 2D code symbologies (cont.)For the McodeAlloc() command, the code type(s) that can be read or written include(s):编码类型Code Type编码方式Encoding Type纠错Error CorrectionDataMatrixNumeric encoding, Alpha encoding,10, 40, 50, 60, 70, 80,90, 100, 110, 120, 130,AlphaNumericPunc encoding,140 or 200 error corre

42、ctionAlphaNumeric encoding,ASCII encoding, IS08 encodingEAN8Numeric encodingCheck-digit error correctionEAN13Numeric encodingCheck-digit error correctionInterleaved 2/5Numeric encodingNo error correction; check-digit error correcionMaxicodeEncoding mode 2, 3, 4, 5, 6Reed Solomon error correctionMicr

43、oPDF417Standard encoding typeReed Solomon error correctionPDF417Standard encoding typeReed Solomon 1 - 8 error correctionPharmaNumeric encodingNo error correctionPlanetNumeric encodingCheck-digit error correctionPostnetNumeric encodingCheck-digit error correctionQRQR code Model 1, 2 encodingLowest-level QR, Low-level QR, High-level QR, Highest-level QRRSSRSS 14, RSS 14 Stacked, RSS 14 Stacked Omni,RSS 14 Truncated, RSS ExpandedRSS Expanded Stacked, RSS Limited encoding.Check-digit error correction