HALCON Extension Package Programmer's Manual

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