{"id":29414,"date":"2026-08-23T14:10:00","date_gmt":"2026-08-23T12:10:00","guid":{"rendered":"https:\/\/www.heliotis.com\/tutorials2\/getting-started-with-the-heliotis-gen4-sdk-part-3-acquiring-3d-data-with-halcon\/"},"modified":"2026-08-23T20:56:01","modified_gmt":"2026-08-23T18:56:01","slug":"getting-started-with-the-heliotis-gen4-sdk-part-3-acquiring-3d-data-with-halcon","status":"publish","type":"tutorial","link":"https:\/\/www.heliotis.com\/en\/tutorials2\/getting-started-with-the-heliotis-gen4-sdk-part-3-acquiring-3d-data-with-halcon\/","title":{"rendered":"Getting Started with the Heliotis Gen4 SDK \u2013 Part 3: Acquiring 3D Data with HALCON"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\">Summary<\/h3>\n\n<p class=\"wp-block-paragraph\">In this tutorial, we show, using a HALCON example installed with C4Utility, how a Heliotis Gen4 device is integrated into HALCON HDevelop. We configure the basic measurement parameters, start a 3D measurement via software trigger, and transfer the resulting 3D data to HALCON.<\/p>\n\n<figure class=\"wp-block-video\"><video height=\"1080\" style=\"aspect-ratio: 1920 \/ 1080;\" width=\"1920\" controls=\"\" src=\"https:\/\/www.heliotis.com\/wp-content\/uploads\/2026\/08\/SDK-part3.mp4\"><\/video><\/figure>\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n<h2 class=\"wp-block-heading\">Acquiring 3D Data with HALCON<\/h2>\n\n<p class=\"wp-block-paragraph\">C4Utility contains a simple HALCON example that demonstrates the basic steps for integrating a Heliotis Gen4 device \u2013 from establishing a connection to acquiring and displaying 3D data.<\/p>\n\n<h3 class=\"wp-block-heading\">1. Open HALCON Example<\/h3>\n\n<p class=\"wp-block-paragraph\">If the HALCON examples were selected during the C4Utility installation, they are located in the C4Utility installation directory (C:\\Program Files\\C4Utility\\examples\\HALCON).<\/p>\n\n<p class=\"wp-block-paragraph\">Open the simple &#8220;h8SurfSimple.hdev&#8221; in HALCON HDevelop.<\/p>\n\n<h3 class=\"wp-block-heading\">2. Configure Device Connection<\/h3>\n\n<p class=\"wp-block-paragraph\">At the beginning of the script, the <strong>IP address<\/strong> of the Heliotis device is set. It must match the device address displayed in the Heliotis Update Tool.<\/p>\n\n<p class=\"wp-block-paragraph\">The factory default IP address of a Heliotis Gen4 device is:<\/p>\n\n<p class=\"wp-block-paragraph\"><code>192.168.2.71<\/code><\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Diafus<\/strong> is selected as the GenTL Producer. Diafus provides the communication interface between HALCON and the Heliotis device. The script then opens the frame grabber and establishes the connection to the device.<\/p>\n\n<h3 class=\"wp-block-heading\">3. Set Measurement Parameters<\/h3>\n\n<p class=\"wp-block-paragraph\">The example contains an initialization procedure with the most important parameters for an initial measurement.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Scan Position<\/strong> defines the vertical position of the measurement.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Scan Range<\/strong> defines the vertical measurement range.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Scan Speed<\/strong> can be adjusted depending on the surface and required signal quality.<\/p>\n\n<p class=\"wp-block-paragraph\">After executing the initialization procedure, the device is configured and ready for measurement.<\/p>\n\n<h3 class=\"wp-block-heading\">4. Start 3D Measurement<\/h3>\n\n<p class=\"wp-block-paragraph\">The HALCON command <code>grab_image_start<\/code> puts the device into acquisition mode.<\/p>\n\n<p class=\"wp-block-paragraph\">In the example, a 3D measurement is then started via a <strong>software trigger<\/strong>. After the measurement is complete, the acquired 3D data is transferred to HALCON with <code>grab_data_async<\/code>.<\/p>\n\n<h3 class=\"wp-block-heading\">5. Display and Further Process 3D Data<\/h3>\n\n<p class=\"wp-block-paragraph\">The resulting height data can be visualized directly in HALCON as a 3D surface. The data is then available for further image processing and analysis functions in HALCON or in custom routines.<\/p>\n\n<p class=\"wp-block-paragraph\">Further measurements can be performed by re-triggering and reading out the data.<\/p>\n\n<p class=\"wp-block-paragraph\">After completing the measurements, <code>close_framegrabber<\/code> closes the connection and releases the Heliotis device for other applications.<\/p>\n\n<h3 class=\"wp-block-heading\">Next Step<\/h3>\n\n<p class=\"wp-block-paragraph\">In <strong>Part 4 \u2013 Updating Device Firmware<\/strong>, we show how to update the firmware of a Heliotis Gen4 device using the Heliotis Update Tool.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Part 3 shows, using a HALCON example installed with C4Utility, how a Heliotis Gen4 device is integrated into HALCON HDevelop. We configure the basic measurement parameters, start a 3D measurement via software trigger, and transfer the resulting 3D data to HALCON.<\/p>\n","protected":false},"author":4,"featured_media":29415,"template":"","class_list":["post-29414","tutorial","type-tutorial","status-publish","has-post-thumbnail","hentry"],"_links":{"self":[{"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/tutorial\/29414","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/tutorial"}],"about":[{"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/types\/tutorial"}],"author":[{"embeddable":true,"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/users\/4"}],"version-history":[{"count":1,"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/tutorial\/29414\/revisions"}],"predecessor-version":[{"id":29416,"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/tutorial\/29414\/revisions\/29416"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/media\/29415"}],"wp:attachment":[{"href":"https:\/\/www.heliotis.com\/en\/wp-json\/wp\/v2\/media?parent=29414"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}