HALCON Extension Package Programmer's Manual

82 CHAPTER 5. HANDLING ICONIC OBJECTS AND CONTROL PARAMETERSÀÔÖ ØÖÐÚн » ÖÖÝ Ó ÀÔÖ ×ØÖÙØÙÖ× »ÁÆÌ ÒÙÑ » ÒÙÑÖ Ó ÚÐÙ× Ó ÔÖÑØÖ ½ »ÀÔÖ ØÖÐÚоÀÔÖ ØÖÐÚп» Ö ÐÐ ÚÐÙ× Ó ÔÖÑØÖ ÒÙÑÖ ½ »ÀØÈÈÖ´ÔÖÓÒи½¸²ØÖÐÚн¸²ÒÙѵ» ÒÓÛ ØÖÐÚн¼℄ºÔֺР»» Ö ×ØÖÒ Ò ÔÖÑØÖ ÒÙÑÖ ¾ »ÀØÈÈÖ´ÔÖÓÒи¾¸²ØÖÐÚо¸²ÒÙѵ» ÒÓÛ ØÖÐÚо¼℄ºÔÖº× ÌÜØ »» Ö ØÙÔÐ Ó ÐÓØ ÚÐÙ× Ò ÔÖÑØÖ ÒÙÑÖ ¿ »» ´ÑÝ ÒÝ ÒÙÑÖ Ó ÚÐÙ×µ »ÀØÈÈÖ´ÔÖÓÒи¿¸²ØÖÐÚп¸²ÒÙѵÓÖ ´¼ ÒÙÑ ··µ ß» ØÖÐÚп℄ºÔÖº ¼º¸½º¸º »ºººFigure 5.30: Read the control parameter values of the operator callÑÓ´¸³ÌÜس¸¼º¸½º¸º℄µ using ÀØÈÈÖ.ÀÔÖÔÖ¾℄ÔÖ¼℄ºÔֺРÔÖ¼℄ºØÝÔ ÄÇÆÈÊÔÖ½℄ºÔÖº ºÔÖ½℄ºØÝÔ ÄÇÌÈÊÀÈÙØÈÖ´ÔÖÓÒи½¸ÔÖ¸¾µFigure 5.31: Write the control parameter values ¸º℄ using ÀÈÙØÈÖ.5.5.6 ÀÈÙØÈÈÖÀÈÙØÈÈÖ (see Fig. 5.26) is an alternative to ÀÈÙØÈÖ and writes control data to the outputcontrol parameter number ÔÖ ÒÙÑ. However, instead of copying the ÒÙÑ values like ÀÈÙØÈÖdoes, ÀÈÙØÈÈÖ directly stores the pointer to the array of ÀÔÖ structures (ÚÐ). Thus, itcauses less overhead. As ÀÈÙØÈÈÖ directly uses the passed ÀÔÖ array without copying, thisarray has to be allocated “permanently”, i.e. it must be allocated by using ÀÐÐÓ (see section3.2.2 on page 42). Furthermore, the array must not be given free after passing it to ÀÈÙØÈÈÖ.Figure 5.32 shows how to write output control data with ÀÈÙØÈÈÖ.Note again, that the types of the parameter values (ÄÇÆ ÈÊ, ÄÇÌ ÈÊ, ËÌÊÁÆ ÈÊ ) arestored with each ÀÔÖ structure, so that every data element may use a different type.5.5.7 ÀÐÐÓËØÖÒÅÑIn case of string parameters, additional memory for the parameter values has to be allocated,because the ÀÔÖ structure only contains a pointer to Ö. The easiest way to do this is to useHALCON Extension Package Interface / 2000-11-16