HALCON Extension Package Programmer's Manual

More documents

Recommendations

Info

96 CHAPTER 6. SPECIAL ROUTINES FOR TYPICAL SUPPLY PROCEDURESNamesÀÆÛÊÓÒ¸ ÀÈÙØÊØ¸ ÀÙÔÇSynopsisÒÐÙ ÀÐÓÒºÀÆÛÊÓÒ´ÀÔÖÓÒÐÀÖÐÖÓÒÔÖÓÒÐ¸ÖÓÒµÀÈÙØÊØ´ ÀÔÖÓÒÐ ÔÖÓÒÐ¸ÀÝÓÝ¸ÁÆÌÛØ¸ØµÀÙÔÇ´ ÀÔÖÓÒÐ ÔÖÓÒÐ¸ÁÆÌ ÓÒÜµFigure 6.8: Convenience routines for creating output objects.definition) of the new object is defined: It contains a copy of ÖÓÒ. Itiscommontocallanimage object region, when only its region component is used.ÀÍ×ÖÜÔÓÖØ ÀÖÖÓÖ ÁÈÓÒÚÜ´ÀÔÖÓÒÐßÀÖÐÖÓÒ ÖÓÒÀÖÐÖÓÒ ÖÓÒÒÛÔÖÓÒÐµÐÀÈ´ÀÐÐÓÊÄÌÑÔ´ÔÖÓÒÐ¸²ÖÓÒÒÛµ » ÐÐÓØ ÑÑÓÖÝ »ÀÐÐÊ´ÔÖÓÒÐ¸²ÖÓÒ¸µ ß » ÐÐ ÖÓÒ× »ÀÈ´ÀÊÄÓÒÚÜ¾´ÔÖÓÒÐ¸ÖÓÒ¸ÖÓÒÒÛµµ» ÖØ Ò ÓÙØÔÙØ ÖÓÒ ÓØ ´Ö×Ø ÓÙØÔÙØ ÔÖÑºµ »ÀÆÛÊÓÒ´ÔÖÓÒÐ¸ÖÓÒÒÛµÐÀÈ´ÀÖÊÄÌÑÔ´ÔÖÓÒÐ¸ÖÓÒÒÛµµ » Ö ÑÑÓÖÝ »ÖØÙÖÒ´ÀÅËÌÊÍµFigure 6.9: A typical application of ÀÆÛÊÓÒ: The region transformation “convex hull”.Typically, ÀÆÛÊÓÒ is used within segmentation procedures (see Fig. 6.4) and region transformingprocedures such as the procedure ÁÈÓÒÚÜ shown in Fig. 6.9. ÁÈÓÒÚÜ correspondsto a hypothetical operator ØÖÒ× ÓÒÚÜ which might be defined likeØÖÒ×ÓÒÚÜ ¹ ÁÈÓÒÚÜÊÓÒÊÓÒÓÒÚÜ℄In the example all regions within ÊÓÒ are provided in ÖÓÒ by ÀÐÐÊ (see section6.1.1) one after the other. The HALCON procedure ÀÊÄÓÒÚÜ¾ computes the convex hull forHALCON Extension Package Interface / 2000-11-16
6.2. OBJECT GENERATION 97each region and writes it to ÖÓÒ ÒÛ. Furthermore, a new region object in the HALCONdata base is created and added to the output object parameter ÊÓÒÓÒÚÜ.Note, that ÀÆÛÊÓÒ was also used in the example in Fig. 6.4 on page 91.6.2.2 ÀÈÙØÊØÀÈÙØÊØ (see Fig. 6.8) inserts a rectangular region in an already existing output object withdata base key Ó Ý. Mostly it is used in connection with operators that create new imageobjects like in the example in Fig. 6.10.ÀÍ×ÖÜÔÓÖØ ÀÖÖÓÖ ÁÇÖÁÑ´ÀÔÖÓÒÐßÀÝ ÓÝ¸ÑÝÀÑ ÑÔÖÓÒÐµÐÀÖÇ´ÔÖÓÒÐ¸½¸²ÓÝµÀÈ´ÀÆÛÁÑ´ÔÖÓÒÐ¸²Ñ¸ÌÁÅ¸¼¸¼µµ» Ö Ò ÆÌË Ñ ¼ Ü ¼ ÔÜÐ¸ Ø »ÀÈ´ÁÇÖÁÑ´²ÑµµÀÈÙØÁÑ´ÔÖÓÒÐ¸ÓÝ¸½¸²Ñ¸ÄË¸²ÑÝµÀÈÙØÊØ´ÔÖÓ¸ÓÝ¸ÑºÛØ¸ÑºØµÖØÙÖÒ´ÀÅËÌÊÍµFigure 6.10: A typical application of ÀÈÙØÊØ: Grabbinganimage.Note, that ÀÖÇ (see section 5.4.1) creates an object with empty region. In many situationsthe default area of definition for a new image will be the full image domain which is a rectangle.In this situation the use of ÀÈÙØÊØ is very convenient.6.2.3 ÀÙÔÇÀÙÔÇ (see Fig. 6.8) is a combination/simplification of ÀØÇ (see section 5.1.1) andÀÓÔÝÇ (see section 5.4.2). It duplicates iconic input objects (images, regions, XLD) inorder to pass them directly to the first output object parameter. The objects to be duplicated arespecified by their index Ó ÒÜ within the first input object parameter. Note, that this indexcorresponds to Ó ÒÜ as defined for the loop macros (ÀÐÐ) in section 6.1. ÀÙÔÇ istypically used for operators that examine objects and select them by a given criteria. SomeHALCON operators of this kind are ×ÐØ ×Ô, × ×Ô, or×ÐØ ÖÝ.Fig. 6.11 shows an application of ÀÙÔÇ: ÁÈÍ×ÖËÐØ computes the length of the contourof each input region (in parameter 1). All regions with a contour of at least the minimal lengthÑÒ are passed to the output.Since ÀÙÔÇ only increases the number of references to a data base object instead of copyingit physically, its memory costs and computational costs are neglectable. In contrast, e.g.,ÀÆÛÊÓÒ and ÀÐÐÐØÖ always allocate new memory for the output objects. So wheneverpossible, ÀÙÔÇ should be used.HALCON 6.0
Page 1:
HALCON Version 6.0MVTec Software Gm
Page 7 and 8:
Dl Iosub menţionează că diferen
Page 9 and 10:
Chapter 1IntroductionHALCON can be
Page 11:
1.1. HALCON OPERATORS 3objects (or
Page 15 and 16:
1.3. INSTALLING A HALCON PACKAGE 76
Page 17 and 18:
1.4. AN EXAMPLE 9Note, that it is n
Page 19 and 20:
1.4. AN EXAMPLE 11¯ one input cont
Page 21 and 22:
1.5. ADDITIONAL SOURCES OF INFORMAT
Page 23 and 24:
Chapter 2Operator Description (-fil
Page 25 and 26:
2.2. EXTENDED OPERATOR DESCRIPTION
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
2.3. DESCRIBING THE PARAMETERS 252.
Page 35 and 36:
Page 37 and 38:
2.3. DESCRIBING THE PARAMETERS 29Pl
Page 39 and 40:
2.3. DESCRIBING THE PARAMETERS 31¯
Page 41 and 42:
Page 43 and 44:
2.4. TEXT IN ’DEF’-FILES 35Umla
Page 45 and 46:
Chapter 3Style Guide for Programmin
Page 47 and 48:
3.2. MEMORY MANAGEMENT 39If you use
Page 49 and 50:
3.2. MEMORY MANAGEMENT 41NamesÀÐ
Page 51 and 52:
3.2. MEMORY MANAGEMENT 43NamesÀÐ
Page 53 and 54: 3.3. STRUCTURING PROGRAMS 453.2.3 D
Page 55 and 56: 3.6. ERROR HANDLING 47or via Extens
Page 57 and 58: Chapter 4HALCON Data TypesThe HALCO
Page 59 and 60: 4.2. REGION DATA (’HRLREGION’)
Page 61 and 62: 4.3. XLDS (’HCONT’, ’HPOLY’
Page 63 and 64: 4.4. CONTROL PARAMETERS (’HPAR’
Page 65 and 66: 4.4. CONTROL PARAMETERS (’HPAR’
Page 67 and 68: Chapter 5Handling Iconic Objects an
Page 69 and 70: 5.1. BASIC ACCESS TO ICONIC INPUT O
Page 71 and 72: 5.1. BASIC ACCESS TO ICONIC INPUT O
Page 73 and 74: 5.2. ADDITIONAL ROUTINES FOR ACCESS
Page 75 and 76: 5.2. ADDITIONAL ROUTINES FOR ACCESS
Page 77 and 78: 5.3. LOOP MACROS FOR ACCESSING SING
Page 79 and 80: 5.4. CREATING OBJECTS AND WRITING O
Page 87 and 88: 5.5. READING AND WRITING CONTROL PA
Page 89 and 90: 5.5. READING AND WRITING CONTROL PA
Page 91 and 92: 5.6. AUXILIARY MACROS AND PROCEDURE
Page 93 and 94: 5.6. AUXILIARY MACROS AND PROCEDURE
Page 95 and 96: Chapter 6Special Routines for Typic
Page 97 and 98: 6.1. LOOP MACROS 89NamesÀÐÐÊ¸
Page 99 and 100: 6.1. LOOP MACROS 91contains less ch
Page 101 and 102: 6.1. LOOP MACROS 93ÀÖÖÓÖ ÁÈ
Page 103: 6.2. OBJECT GENERATION 95ÀÖÖÓÖ
Page 107 and 108: Chapter 7Creating a New HALCON Pack
Page 109 and 110: 7.1. THE HALCON COMPILER ’HCOMP
Page 111 and 112: 7.2. GENERATING HALCON PACKAGES 103
Page 114 and 115: 106 CHAPTER 7. CREATING A NEW HALCO
Page 122 and 123: 114 APPENDIX A. HALCON ERROR CODES
Page 140: 132 APPENDIX A. HALCON ERROR CODESH
show all

HALCON Extension Package Programmer's Manual

Create successful ePaper yourself

Delete template?

Save as template?