HALCON Extension Package Programmer's Manual

Chapter 4HALCON Data TypesThe HALCON Extension Package Interface provides special data types to handle iconic objects.All iconic objects in the application layer are represented by a key refering to the HAL-CON data base. The internal structure is hidden from the HALCON user. However, using theExtension Package Interface it is possible to work directly on the data structures for images,regions, and XLDs. Special macros can be used to access the internal representation of suchan object. Furthermore, data structures for contol parameters are provided. All data types describedin the following sections are defined in the files ±´ÀÄÇÆÊÇÇ̵»ÒÐÙÒÁÈØÝÔº±and ±´ÀÄÇÆÊÇÇ̵»ÒÐÙÒÀ׺±.4.1 Pixel Data (ÀÑ)Gray value images are represented by a rectangular image matrix. Several matrices (calledcomponents) can be combined to a multi-channel image . Each channel can be accessed separately,i.e. the components are not interleaved. The structure ÀÑ contains size, pixel type,and pixel data of one component. Furthermore, a time-stamp is included. Fig. 4.1 shows thecorresponding type declaration.The maximum for ÛØ and Ø (Å ÇÊÅÌ) is currently set to 32768. The origin ofan image matrix is at position ´¼ ¼µ. Row coordinates range from ¼ to Ø ¹ ½, columncoordinates from ¼ to ÛØ ¹ ½. The image pointer (ÀÈÜÐÁÑ) refers to the first pixelof the matrix (index: 0,0). Different pixel types are supported. They are distinguished by aselector (Ò), see Fig. 4.2. The pixel types include basic types like ÀÌ, ÁÆ̽, ÁÆÌ, andÐÓØ as well as composed types. Their definitions can be seen in Fig. 4.3.The pixel data is stored as a one-dimensional array (vector) of one of the pixel types. Theindices of the array range from ¼ to ÛØع½. Alinear coordinate L within an imageis derived from the row index R and column index C as follows:Ä Ê ÑºÛØ · This transformation is performed by the following macro :Ä ÀÄÒÓÓִʸ¸ÑºÛص49