HALCON Extension Package Programmer's Manual

70 CHAPTER 5. HANDLING ICONIC OBJECTS AND CONTROL PARAMETERSWithin the loop all iconic objects contained in the input object parameter number 2 ÔÖ ÒÙÑ areaccessed one by one. ÒÜ is set to the number of the current iconic object to be processedand Ó Ý is set to the corresponding data base key. Thus, using ÀÐÐÇ is equivalent toprogramming an explicit loop over all objects contained in a parameter and determining the database keys via ÀØÇ, see also Fig. 5.3. Fig. 5.16 shows an application of ÀÐÐÇ.5.3.2 ÀÐÐÓÑÔÀÐÐÓÑÔ performs a loop over all gray value channels (components) of the image object denotedby the data base key Ó Ý. Within the loop, Ñ Ò Ý is set to the data base keyof the current image object and the corresponding image data is delivered in Ñ Ò. UsingÀÐÐÓÑÔ is equivalent to programming an explicit loop over all channels of an image objectusing ÀØÁÑ. This also implies that the raw image data, that is the image matrix itself,is not copied. Instead, only a pointer to this data is inserted in Ñ Ò. So please restrictyourself to reading this data. Any write access to the image matrix will cause unpredictableside effects.Note, that ÀÐÐÓÑÔ does not check, whether the image object contains at least one channel.Note further, that any region processing should be done outside the loop (otherwise you willprocess the same region again and again for each channel).ÀÝ ÓÒÀÝ ÓÓÙØÀÝ ÑÒÝÁÆÌ ÓÑÔÒÜÀÑ ÑÒ¸ÑÓÙغººÀÐÐÇ´ÔÖÓÒи½¸ÓÒ¸µ ßÀÖÇ´ÔÖÓÒи½¸²ÓÓÙصÀÐÐÓÑÔ´ÔÖÓÒиÓÒ¸ÑÒݸÑÒ¸ÓÑÔÒܵ ßÀÈ´ÀÖÁÑ´ÔÖÓÒиÑÒݸ½¸ÌÁŸÑҺظÑÒºÛظ²ÑÓÙØݸ²ÑÓÙصµÀÈ´ÁÈÊÓؼ´ÑÒºÔÜк¸ÑÒºÛظÖÓÒÒ¸ÑÓÙغÔÜк¸ÛظصµÀÇ´ÔÖÓÒиÓÓÙظÑÓÙØݸÓÑÔÒܵÐÐFigure 5.17: Application of ÀÐÐÓÑÔ: rotate all channels of all image objects of the first inputobject parameter.Fig. 5.17 shows an example of how to use ÀÐÐÓÑÔ. Within the ÀÐÐÇ loop for each inputimage object an output image object is created and added to the object list of the first outputobject parameter (ÀÖÇ, see section 5.4.1). After that, a loop over all gray value channelsof the current image object is performed (ÀÐÐÓÑÔ). Within this loop, for every gray value2 So in contrast to the routines described in section 6.1, ÀÐÐÇ allows to specify the desired parameter by itsnumber.HALCON Extension Package Interface / 2000-11-16