HALCON Extension Package Programmer's Manual

Chapter 7Creating a New HALCON Package7.1 The HALCON Compiler ÓÑÔThe HALCON compiler ÓÑÔ is the most important tool for creating a new HALCON package.It automatically generates the interface code for the desired host language, the help files,and the documentation files. ÓÑÔ processes -files that contain descriptions of all operatorsas a basic resource, see chapter 2. The HALCON compiler uses the same mechanism forgenerating the original system operators and user-defined operators.The syntax of the ÓÑÔ command is as follows:ÓÑÔ ÓÔØÓÒ× Ð×Example:ÓÑÔ ¹Ù ¹ ¹ÔÔ ÅÝÍ×ÖÇÔ׺The parameter “¹Ù” signals that an interface for user-defined operators should be generated.This parameter can be omitted as it is the default 1 . One or more definition files that are separatedby blanks must be specified as files argument. The extension º may be omitted:ÓÑÔ ¹ ¹ÔÔ ÅÝÍ×ÖÇÔ×½ ÅÝÍ×ÖÇÔ×¾ ÅÝÍ×ÖÇÔ׿To generate the appropriate interface code, the correct option must specify the desired hostlanguage (for C as host language: ¹). Then, ÓÑÔ generates a couple of source files (inthe example above: ÀÔº and ÀÔº) for the package Ô. Their namesdepend on the host language and the specified package, not on the names of the input -file(s).7.1.1 Selection of the Host LanguageOne call of ÓÑÔ can always create only one interface, i.e, the options described as followscan only be switched on under mutual exclusion. Use1 Note, that ÓÑÔ also is used by MVTec to generate the interface code for the standard HALCON system.99