HALCON Extension Package Programmer's Manual

24 CHAPTER 2. OPERATOR DESCRIPTION (’DEF’-FILES)Note that the slot ÑØÓ may contain any combination of the strings ‘split tuple’,‘split channel’, and ‘split domain’, because an operator may be parallelized by using anycombination of those three methods. However, if ‘none’ is specified with the slot ÑØÓ,no other string should be specified with it in order to keep the description consistent.If no slot ÑØÓ is filled in with an operator, it is assumed that the operator is not suitablefor being automatically parallelized (“pessimistic” assumption).ÓÑÒ ×ÔÐØ an unsigned integer valueThis subslot of ÔÖÐÐÐÞØÓÒ must (only) be set for operators that are suitable forbeing parallelized by splitting the domain of iconic input objects (i.e. slot ÑØÓ contains‘split domain’). For such operators the value of ÓÑÒ ×ÔÐØ assigns, whether the inputdomain may be split disjunctively (value ‘0’) or not. In the latter case the domain is splitinto several ÓÚÖÐÔÔÒ stripes (note, that the splitting of domain regions is alwaysdone row-wise).If the domain is split disjunctively, the value ( ¼) ofÓÑÒ ×ÔÐØ assigns the index([1..n]) of that input control parameter which determines the extent of the overlappingregions (in number of pixels) by its content. For example, for the operatorÐÑÒØ ÑÒ ÑÜ the extent of the overlapping regions depends on the height of thefilter mask. Therefore, the content of the second input control parameter (compare theoperator’s description in the Reference Manuals) directly determines the extent of theoverlapping regions. Thus, the slot ÓÑÒ ×ÔÐØ is set to ‘2’ for ÐÑÒØ ÑÒ ÑÜ.The example below shows the whole ÔÖÐÐÐÞØÓÒ slot for ÐÑÒØ ÑÒ ÑÜ.ÔÖÐÐÐÞØÓÒÔÖÓ××ÜÐÙ×ÚÐÝ Ð×ÔÖÓ××ÐÓÐÐÝ Ð×ÔÖÓ××ÑÙØÙÐ Ð×ÑØÓ×ÔÐØØÙÔи ×ÔÐØÒÒи ×ÔÐØÓÑÒÓÑÒ×ÔÐØ ¾If ÑØÓ contains ‘split domain’, the slot ÓÑÒ ×ÔÐØ must be filled in. In all othercases, the slot should be omitted!Though, we recommend to specify the whole slot ÔÖÐÐÐÞØÓÒ, it is also possible tocompletely leave it out in an operator’s description. In this case, it is assumed that the operatoris reentrant, i.e.itisnot processed under (complete or mutual) exclusion, and that it must beprocessed “locally”. The latter also means that no parallelization is used when processing theoperator. This assumption corresponds exactly to those which are used in the case of missingsingle subslots (see descriptions above).2.2.13 complexityThe slot ÓÑÔÐÜØÝ describes the complexity of the operation in terms of number of pointsalong a contour, the area of an image region etc.ÓÑÔÐÜØݺÒÐ×ÄØ °° Ø Ö Ó Ø ÒÔÙØ ÖÓÒºÓÑÔÐÜØÝ × °Ç´µ°ºÌÒ Ø ÖÙÒØÑHALCON Extension Package Interface / 2000-11-16