HALCON Extension Package Programmer's Manual

More documents

Recommendations

Info

12 CHAPTER 1. INTRODUCTIONfile ÑÐ in the directory ±ÀÄÇÆÊÇÇÌ±ÒÜÑÔÐ×ÒÜØÒ×ÓÒ ÔÒÐÓÒÙ×Öcontains a makefile for generating the example package itself under UNIX. ÑÐºÒØ is thecorresponding file to be used via ÒÑ under Windows NT and Windows 2000. The makefilesÑÐ Ø×ØÔÖÓ and ÑÐ Ø×ØÔÖÓºÒØ generate example applications usingthe new operators.Now we can use our new operators within C-programs. But they are not yet available withinÀÚÐÓÔ, because the online help files have not been generated so far. There is also stillmissing any kind of documentation, such as the HTML manual pages.ÓÑÔ ¹Ù ¹Å ØÖ×ÓÐºFigure 1.7: Calling the HALCON compiler ÓÑÔ to create the help files.The generation of the online help files (as they are used e.g., by ÀÚÐÓÔ) can also be done withthe help of the HALCON compiler ÓÑÔ, see Fig. 1.7. However, to do so an extended versionof the -file must be available. The generated help files must be placed in the subdirectoryÐÔ of the package.ËÇÍÊËÀÇÅÈ ØÖ×ÓÐº °´ÀÄÇÆÊÇÇÌµ»Ò»°´ÊÀÁÌÌÍÊµ»ÓÑÔÐÐ ÚÐÓÔ ÔÔÚÐÓÔ °´ËÇÍÊËµ°´ÀÇÅÈµ ¹ÄØÐÐ °´ËÇÍÊËµÑÚ ºØÑÐ Ó»ØÑÐ»ÖÖÒ»ÚÐÓÔ °´ËÇÍÊËµ°´ÀÇÅÈµ ¹ÄÐÐ °´ËÇÍÊËµÑÚ ºØÑÐ Ó»ØÑÐ»ÖÖÒ»ÔÔ °´ËÇÍÊËµ°´ÀÇÅÈµ ¹Ä··ÐÐ °´ËÇÍÊËµÑÚ ºØÑÐ Ó»ØÑÐ»ÖÖÒ»ÔÔFigure 1.8: Makefile for generating HTML references.The help files generated by now are used to access information about the new operators bycalling specific HALCON operators like Ø ÓÔÖØÓÖ ÒÓ. This is of importance especiallyfor constructing graphical user interfaces like ÀÚÐÓÔ. For the user a more convenient way toaccess information online is to browse through HTML documents. The HTML documentationof HALCON operators can be generated by ÓÑÔ as well, see Fig. 1.8. In this example, HTMLdocuments are generated in Trias (ÀÚÐÓÔ) syntax (¹ÄØÐÐ), in C-syntax (¹ÄÐÐ),and in C++- syntax (¹Ä··ÐÐ). The HTML files have to be placed in the correspondingsubdirectories ÓÒØÑÐÒÖÖÒÒÚÐÓÔ, , orÔÔ of the package.If you now add the package path to ÀÄÇÆÌÆËÁÇÆË and start ÀÚÐÓÔ theuser extensions, e.g. Ù×Ö ØÖ×, are automatically available in the specified menuHALCON Extension Package Interface / 2000-11-16
1.5. ADDITIONAL SOURCES OF INFORMATION 13(i.e., chapter). In our example this menu is called Í×ÖÜØÒ×ÓÒ× as specified in±ÀÄÇÆÊÇÇÌ±ÒÜÑÔÐ×Ò ÒØÖÒÐÓÒÙ×ÖÒÒØÖ×ÓÐº. 11 You can selectand execute the user-defined operators like all the built-in operators of the HALCON system.The HTML documentation is available via the ÀÐÔ button within the operator window.Examples of how to use the user defined extensions in ÀÚÐÓÔ can be found in the subdirectoryÜÑÔÐ× of ±ÀÄÇÆÊÇÇÌ±ÒÜÑÔÐ×ÒÜØÒ×ÓÒ ÔÒÐÓÒÙ×Ö (ºÚ).Furthermore, the ºÚ programs have been exported as C++ programs. The ºÔÔ filescan be found in the subdirectory ×ÓÙÖ. You can compile the C++ files using the alreadymentioned makefiles. These ºÔÔ files also serve as an example for the integrationof user defined operators into the host language C++. Note, that before compiling theexported C++ code containing operators from the package ÐÓÒÙ×Ö, the correspondinguser extension libraries must have been created. This can be done via the ÑÐ in±ÀÄÇÆÊÇÇÌ±ÒÜÑÔÐ×ÒÜØÒ×ÓÒ ÔÒÐÓÒÙ×Ö which will also generate theneeded user extension C++ library ÐÓÒÙ×ÖÔÔ.Please note, that on some systems not all users have writing permissions in the directoriesmentioned above. To experiment with the example package we recommend to create a privatecopy in your working directory. In such a case you must of course use the actual path to yourcopy when modifying environment variables.1.5 Additional Sources of InformationFor further information you may consult the following manuals:¯ Getting Started with HALCONAn introduction to HALCON in general, including how to install and configure HALCON.¯ HDevelop User’s ManualAn introduction to the graphical development environment of the HALCON system.¯ HALCON/C++ User’s ManualHow to use the HALCON library in your C++ programs.¯ HALCON/C User’s ManualHow to use the HALCON library in your C programs.¯ HALCON/COM User’s ManualHow to use the HALCON library in your COM programs, e.g., in Visual Basic.¯ Frame Grabber Integration Programmer’s ManualA guide on how to integrate a new frame grabber in the HALCON system. Note thatin some cases you might define new operators (using the Extension Package Interface)instead of using the standard HALCON Frame Grabber Integration Interface in order toexploit specific hardware features of a framegrabber board.¯ HALCON/HDevelop, HALCON/C++, HALCON/C, HALCON/COMThe reference manuals for all HALCON operators (versions for HDevelop, C++, C, andCOM).11 Í×ÖÜØÒ×ÓÒ× is integrated into the menu ÇÔÖØÓÖ of ÀÚÐÓÔ.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: 1.4. AN EXAMPLE 11¯ one input cont
Page 23 and 24: Chapter 2Operator Description (-fil
Page 25 and 26: 2.2. EXTENDED OPERATOR DESCRIPTION
Page 33 and 34: 2.3. DESCRIBING THE PARAMETERS 252.
Page 37 and 38: 2.3. DESCRIBING THE PARAMETERS 29Pl
Page 39 and 40: 2.3. DESCRIBING THE PARAMETERS 31¯
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 81 and 82:
Page 83 and 84:
Page 85 and 86:
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 and 104:
6.2. OBJECT GENERATION 95ÀÖÖÓÖ
Page 105 and 106:
6.2. OBJECT GENERATION 97each regio
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 116 and 117:
Page 118 and 119:
Page 120 and 121:
Page 122 and 123:
114 APPENDIX A. HALCON ERROR CODES
Page 124 and 125:
Page 126 and 127:
Page 128 and 129:
Page 130 and 131:
Page 132 and 133:
Page 134 and 135:
Page 136 and 137:
Page 138 and 139:
Page 140:
132 APPENDIX A. HALCON ERROR CODESH
show all

HALCON Extension Package Programmer's Manual

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?