HALCON Extension Package Programmer's Manual

66 CHAPTER 5. HANDLING ICONIC OBJECTS AND CONTROL PARAMETERS5.2 Additional Routines for Accessing Input Image ObjectsThis section introduces some routines that ease the programming of supply procedures in manyapplications, see Fig. 5.9. Basically they are combinations of the routines described in theprevious section. These additional routines only require the data base keys of the input objectsthat can be extracted by using the routines ÀØÇ (se section 5.1.1) or ÀÐÐÇ (see section5.3.1). For ÀØÍÊÄ even this step can be omitted.5.2.1 ÀØÊÄÀÖÐÖÓÒ ÖÓÒÀÝ ÓݺººÀÈ´ÀÐÐÓÊÄÌÑÔ´ÔÖÓÒи²ÖÓÒµµÀØÇ´ÔÖÓÒиÔÖÒÙѸÓÒÙѸ²ÓݵÀØÊÄ´ÔÖÓÒиÓݸÖÓÒµ» ÔÖÓ××Ò ´Ò ÒÖÐ Ø× ×ÓÙÐ ÓÒ ÐÐÒ Ò ØÓÒ ÔÖÓºµ »Ö ¼ÓÖ ´¼ ÖÓÒ¹ÒÙÑ ··µÖ · ÖÓÒ¹ÖÐ℄º ¹ ÖÓÒ¹ÖÐ℄º · ½ÀÈ´ÀÖÊÄÌÑÔ´ÔÖÓÒиÖÓÒµµFigure 5.10: Application of ÀØÊÄ.ÀØÊÄ (see Fig. 5.9) combines ÀØÓÑÔ (section 5.1.2) and ÀØÊÄ (section 5.1.3). It readsthe chord encoding of a region (type: ÀÖÐÖÓÒ, see section 4.2) specified by the data base keyÓ Ý of an image object. The region data is copied to ÖÓÒ that must have been allocatedbefore with a suitable size (e.g., by using ÀÐÐÓÊÄÌÑÔ, see section 3.2.1). Therefore, thisregion data can be overwritten without side effects. On the other hand, the memory must bedeallocated at the end of the supply procedure (e.g., by using ÀÖÊÄÌÑÔ). Fig. 5.10 shows anexample application of ÀØÊÄ.5.2.2 ÀØÊÄIn contrast to ÀØÊÄ only a pointer to the region data is returned by ÀØÊÄ (see Fig. 5.9).So there is no need to allocate memory for the data. On the other hand, only read access to thedata is allowed. An example application of ÀØÊÄ can be seen in Fig. 5.11.5.2.3 ÀØÍÊÄÀØÍÊÄ (see Fig. 5.9) reads all regions passed in the input object parameter with numberÔÖ ÒÙÑ, computes the union of all these regions, and returns the resulting region in ÖÓÒ.The ÀÖÐÖÓÒ data referenced by ÖÓÒ must have been allocated before with a suitable sizeHALCON Extension Package Interface / 2000-11-16