HALCON Extension Package Programmer's Manual

3.3. STRUCTURING PROGRAMS 453.2.3 DebuggingThe HALCON memory management provides debugging mechanisms. Every time a memoryblock is deallocated a couple of consistency checks is performed automatically. Moreover, theconsistency of memory blocks can be checked for debugging reasons at any time using specificExtension Package Interface routines, see Fig. 3.5.NamesÀÌ×ØÅѸ ÀÌ×ØÈØÖ¸ ÀÌ×ØÐÐÌÑÔ¸ ÀÌ×ØÌÑÔSynopsisÒÐÙ ÀÐÓÒºÀÖÖÓÖ ÀÌ×ØÅÑ´ÚÓµÀÖÖÓÖ ÀÌ×ØÈØÖ´ ÚÓ ÔÓÒØÖµÀÖÖÓÖ ÀÌ×ØÐÐÌÑÔ´ ÀÔÖÓÒÐÔÖÓÒеÀÖÖÓÖ ÀÌ×ØÌÑÔ´ ÀÔÖÓÒÐ ÔÖÓÒиÚÓÔÓÒØÖµFigure 3.5: HALCON memory management: Check of consistency.ÀÌ×ØÅÑ checks all the memory allocated with ÀÐÐÓ or ÀÐÐÓÄÓÐ, whereas ÀÌ×ØÈØÖchecks only the specified memory block. Similar to that ÀÌ×ØÐÐÌÑÔ checks all the memoryallocated via ÀÐÐÓÌÑÔ and ÀÌ×ØÌÑÔ checks the specified block. With any failure of theconsistency check, the routines return an error number (À ÊÊ ÁÅ – inconsistent memory).Furthermore, if the global variable ÀÓÄÓÛÖÖÓÖ is set to ÌÊÍ, they display a description of theerror either on ×ØÖÖ (UNIX) or within an alert box (Windows NT/ 2000). This variable canbe set in an application with the operator ×Ø ×Ý×ØÑ´Ó ÐÓÛ ÖÖÓÖ¸ØÖÙ»Ð×µor used directly inside the newly written operator.3.3 Structuring ProgramsHALCON operators are typically implemented by at least two routines: one procedure (supplyprocedure) receives/unpacks all input data and checks it’s consistency. Afterwards it calls theaction procedure that performs the image processing. In some cases it might be convenient toimplement several action procedures dependent on special parameter values or pixel types ofimage data. Generally, these steps are performed within a loop over all input objects that mayinclude further loops over different parameter values and over all image channels. The resultsare collected and finally returned to the HALCON interface to the application.HALCON 6.0