10.07.2015 Views

HALCON Extension Package Programmer's Manual

HALCON Extension Package Programmer's Manual

HALCON Extension Package Programmer's Manual

SHOW MORE
SHOW LESS
  • No tags were found...

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Chapter 6Special Routines for Typical SupplyProceduresIn the previous chapter the basic routines for handling iconic objects, object parameters, andcontol parameters of a <strong>HALCON</strong> operator have been introduced. Based on these this chapterdescribes a set of convenience routines that facilitate the programming of supply procedures intypical situations.6.1 Loop MacrosA frequently needed task is to process all image objects (images or regions) passed to an operatorby one or two input object parameters. This is true for example for most filter and manysegmentation operators. Loop macros provide a framework for this problem, see also section5.3.All macros described in this section have in common that they implement a loop over all imageobjects within the first input object parameter. ÀÐÐÐØÖ¾ also includes a parallel loop overall objects within the second input object parameter. It is assumed that the operator does nothave any more input object parameters. The macros provide users with the region and pixeldata of each image object so that they can work on the data within the loop. Some also createoutput image objects .The macros return the index of the current object Ó ÒÜ (½ Ò) within the input objectparameter. Thus, Ó ÒÜ can be seen as a reference parameter of the macro and therefore isnotated 1 with ’²Ó ÒÜ’. The following table contains an overview of all loop macros, theirareas of application, and the provided image data. Their syntax is defined in Fig. 6.1.1 Note, that this is a specific notation only - do not pass pointers to the macros!87

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!