HALCON Extension Package Programmer's Manual

76 CHAPTER 5. HANDLING ICONIC OBJECTS AND CONTROL PARAMETERSÀÝÀÖÐÖÓÒÀÑÓݸÑÝÒ¸ÑÝÓÙظÝÓÙØÖÓÒÑÒ¸ÑÓÙغººÀØËÈÖ´ÔÖÓÒи½¸ÄÇÆÈʸ²ÊÓÛ׸½µ » Ø ÐØÖ Ñ× »ÀØËÈÖ´ÔÖÓÒи¾¸ÄÇÆÈʸ²ÓÐ׸½µ » ÛØ ÐØÖ Ñ× »ÀÐÐÇ´ÔÖÓÒи½¸Óݸµ ß » ÐÐ ÑÔÙØ Ñ× »ÀØÊÄ´ÔÖÓÒиÓݸ²ÖÓÒµ » Ø ÖÓÒ Ø »ÀØÓÑÔ´ÔÖÓÒиÓݸÁŽ¸²ÑÝÒµ ´ÑÝÒ ÍÆÁƵÖØÙÖÒ´ÀÊÊÍÆÁµ » ³ÙÒÒ Ñ³ »ÀØÁÑ´ÔÖÓÒиÑÝÒ¸²ÑÒµ »Ø Ñ Ø»ÀÈ´ÀÖÁÑ´ÔÖÓÒиÑÝÒ¸½¸ÑÒºÒ¸ÑÒºÛظÑҺظ²ÑÝÓÙظ²ÑÓÙصµÐÀÈ´ÁÈÐØÖÇÔÖØÓÒ´²ÑÒ¸ÖÓÒ¸ÊÓÛ׸ÓÐ׸²ÑÓÙصµÀÓÔÝÇ´ÔÖÓÒиÓݸ½¸²ÝÓÙص » ÖØ Ö×ÙÐØ Óº»ÀÇ´ÔÖÓÒиÝÓÙظÑÝÓÙظÁŽµ» Ò×ÖØ Ø Ö×ÙÐØ Ñ Ò ÓÙØÔÙØ ÓØ »Figure 5.23: A typical example for using ÀÖÁÑ: Providing an empty image matrix for a filteroperation.matrices per input matrix. ÀÖÁÑ checks, whether there already exists an output matrix withthe specified index ÒÜ (see below) for a given input image Ñ Ý Ò. If there is any,only a reference to it is returned in Ñ ÓÙØ and Ñ Ý ÓÙØ instead of creating a newmatrix. Without this mechanism, a new matrix would be created again and again within theloop over all input objects (ÀÐÐÇ).The parameter ÒÜ is only of importance, if more than one output matrix per input matrixis needed: This is necessary for example, if an edge filter is performed in x- and y-directionindependently. In this case ÀÖÁÑ must be called several times for every input component– one time for each output matrix to be created. Assign increasing numbers (1, 2, 3, ...) totheparameter ÒÜ to indicate a new output matrix. If there is only one matrix to create for theoutput image set ÒÜ to 1.Fig. 5.23 shows an exemplary application of ÀÖÁÑ.5.4.8 ÀÖÄÀÖÄ (see Fig. 5.18) is used for creating XLD objects in the HALCON data base. Theparameter ÜÐ ØÝÔ allows to specify the kind of XLD to be created: It has to be set toÄ ÇÆÌÇÍÊ Á in case of a contour and to Ä ÈÇÄÇÆ Á in case of a polygon. Correspondingto the selected type ÀÖÄ expects a pointer to ÀÓÒØ or a pointer to ÀÔÓÐÝ in theHALCON Extension Package Interface / 2000-11-16