HALCON Extension Package Programmer's Manual

5.2. ADDITIONAL ROUTINES FOR ACCESSING INPUT IMAGE OBJECTS 67ÀÝ ÓÝÀÖÐÖÓÒ ÖÓÒºººÀØÊÄ´ÔÖÓÒиÓݸ²ÖÓÒµ» ÔÖÓ××Ò ´Ò ÒÖÐ Ø× ×ÓÙÐ ÓÒ ÐÐÒ Ò ØÓÒ ÔÖÓºµ »Ö ¼ÓÖ ´¼ ÖÓÒ¹ÒÙÑ ··µÖ · ÖÓÒ¹ÖÐ℄º ¹ ÖÓÒ¹ÖÐ℄º · ½Figure 5.11: Application of ÀØÊÄ.(e.g., by using ÀÐÐÓÊÄÌÑÔ, see section 3.2.1). Therefore, this region data can be overwrittenwithout side effects. On the other hand, the memory must be deallocated at the end of the supplyprocedure (e.g., by using ÀÖÊÄÌÑÔ). Fig. 5.12 shows an application of ÀØÍÊÄ. Note, thatthe area calculated in the example may differ from the sum of the areas of all single regions,because the single regions may overlap.ÀÖÐÖÓÒ ÖÓÒºººÀÈ´ÀÐÐÓÊÄÌÑÔ´ÔÖÓÒи²ÖÓÒµµÀØÍÊÄ´ÔÖÓÒиÔÖÒÙѸÖÓÒµ» ÔÖÓ××Ò ´Ò ÒÖÐ Ø× ×ÓÙÐ ÓÒ ÐÐÒ Ò ØÓÒ ÔÖÓºµ »Ö ¼ÓÖ ´¼ ÖÓÒ¹ÒÙÑ ··µÖ · ÖÓÒ¹ÖÐ℄º ¹ ÖÓÒ¹ÖÐ℄º · ½ÀÈ´ÀÖÊÄÌÑÔ´ÔÖÓÒиÖÓÒµµFigure 5.12: Application of ÀØÍÊÄ.5.2.4 ÀØÁÑÀØÁÑ (see Fig. 5.9) combines ÀØÓÑÔ (section 5.1.2) and ÀØÁÑ (section 5.1.4).It reads the data of the gray value component ÒÒÐ of the image object specified by the database key Ó Ý and returns it in the ÀÑ structure (Ñ).For the sake of efficiency, only a pointer to the image matrix is copied to Ñ, instead ofcopying the data itself. So, only read access to the image data is recommended in order to avoidunpredictable side effects. Fig. 5.13 shows an application of ÀØÁÑ.5.2.5 ÀØÇÆÙÑÀØÇÆÙÑ (see Fig. 5.9) returns the number of iconic objects which are stored in the inputobject parameter denoted by its index ÔÖ ÒÙÑ (from ½ to Ò). It is an alternative to the usageof ÀÊÎ (compare page 61). By using ÀØÇÆÙÑ, the example of figure 5.3 (page 61)looks as follows (see figure 5.14).HALCON 6.0