HALCON Extension Package Programmer's Manual

5.1. BASIC ACCESS TO ICONIC INPUT OBJECTS 63NamesÀÈÆÙÑÇÒÒÐ×SynopsisÒÐÙ ÀÐÓÒºÀÖÖÓÖ ÀÈÆÙÑÇÒÒÐ×´ ÀÔÖÓÒÐ ÔÖÓÒиÁÆÌÔÖÒÙѸÁÆÌ ÓÒÙѸÁÆÌÒÒÙѵFigure 5.5: Auxiliary routine ÀÈÆÙÑÇÒÒÐ×.5.1.3 ÀØÊÄÀØÊÄ (see Fig. 5.1) reads the chord encoding of a region (type: ÀÖÐÖÓÒ, see section 4.2)denoted by the data base key ÖÓÒ Ý from the HALCON data base.ÀÖÐÖÓÒ ÖÓÒÀÝ ÓÝÀÝ ÖÓÒݺººÀÈ´ÀÐÐÓÊÄÌÑÔ´ÔÖÓÒи²ÖÓÒµµÀØÇ´ÔÖÓÒиԸӸ²ÓݵÀØÓÑÔ´ÔÖÓÒиÓݸÊÁÇƸ²ÖÓÒݵÀØÊÄ´ÔÖÓÒиÖÓÒݸÖÓÒµ» ÔÖÓ××Ò ´Ò ÒÖÐ Ø× ×ÓÙÐ ÓÒ ÐÐÒ Ò ØÓÒ ÔÖÓºµ »Ö ¼ÓÖ ´¼ ÖÓÒ¹ÒÙÑ ··µÖ · ÖÓÒ¹ÖÐ℄º ¹ ÖÓÒ¹ÖÐ℄º · ½ÀÈ´ÀÖÊÄÌÑÔ´ÔÖÓÒиÖÓÒµµFigure 5.6: Example for ÀØÊÄ: Calculate the area of a region.Since the region data is copied to ÖÓÒ, it might be overwritten with new values (in contrastto ÀØÁÑ and ÀØÊÄ, cf. section 5.1.4 and 5.2.2). However, this means that enoughmemory for ÖÓÒ must be allocated before calling ÀØÊÄ, see section 3.2.1. Fig. 5.6 and5.7 show exemplary applications of ÀØÊÄ.5.1.4 ÀØÁÑÀØÁÑ (see Fig. 5.1) reads the image data (type: ÀÑ, see section 4.1) of a specific grayvalue component (channel) of an image object referenced by its key in the HALCON data base.The data structure ÀÑ contains the gray values, the gray value type, and the size of theimage matrix. Instead of copying the image matrix, ÀØÁÑ only returns a pointer to theHALCON 6.0