Skip to content

Commit 3ac6363

Browse files
Jorgen-haJorgen-ha
authored
Merge pull request #75 from zivid/2025-04-07-update-halcon-samples
Samples: Update to SDK 2.15.0
2 parents f4541a1 + 272bc90 commit 3ac6363

19 files changed

+124
-60
lines changed

‎README.md‎

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# HDevelop samples
22

3-
This repository contains halcon code samples for Zivid SDK v2.14.2. For
3+
This repository contains halcon code samples for Zivid SDK v2.15.0. For
44
tested compatibility with earlier SDK versions, please check out
55
[accompanying
66
releases](https://github.com/zivid/zivid-halcon-samples/tree/master/../../releases).
@@ -40,8 +40,10 @@ from the camera can be used.
4040
configured settings for each frame.
4141
- [CaptureSavePLY](https://github.com/zivid/zivid-halcon-samples/tree/master/source/Camera/Basic/CaptureSavePLY.hdev) - Capture a 3D color point cloud from the camera and save it
4242
to a PLY file format.
43-
- [CaptureWithSettingsFromYML](https://github.com/zivid/zivid-halcon-samples/tree/master/source/Camera/Basic/CaptureWithSettingsFromYML.hdev) - Capture a 3D color point cloud from the camera and use it
44-
to generate a HALCON ObjectModel3D which is then visualized.
43+
- [CaptureWithSettingsFromYML](https://github.com/zivid/zivid-halcon-samples/tree/master/source/Camera/Basic/CaptureWithSettingsFromYML.hdev) - Capture a 2D color image, a 3D point cloud without colour
44+
and 2D color image + 3D color point cloud from the camera
45+
and use them to generate HALCON ObjectModel3D which is then
46+
visualized.
4547
- [ConnectToSerialNumberCamera](https://github.com/zivid/zivid-halcon-samples/tree/master/source/Camera/Basic/ConnectToSerialNumberCamera.hdev) - Connect to a specific Zivid 3D camera based on its serial
4648
number.
4749
- **Advanced**
@@ -71,8 +73,16 @@ from the camera can be used.
7173

7274
## Installation
7375

74-
If you want to use Zivid in HALCON, we provide a GenICam GenTL producer
75-
that comes with the [Zivid Software](http://www.zivid.com/downloads).
76+
Zivid offers two ways of interfacing with HALCON:
77+
78+
1. Through the Zivid SDK, utilizing the C++/C\# libraries available for
79+
HALCON. We provide samples for both
80+
[C++](https://support.zivid.com/latest//api-reference/samples/cpp.html)
81+
and
82+
[C\#](https://support.zivid.com/latest//api-reference/samples/csharp.html).
83+
(**Recommended**)
84+
2. Directly through a GenICam GenTL producer that comes with the [Zivid
85+
Software](https://support.zivid.com/latest//getting-started/software-installation.html).
7686

7787
Zivid and HALCON are compatible with Windows 10 and 11, and Ubuntu
7888
20.04, 22.04, 24.04.
@@ -104,7 +114,8 @@ their respective instructions on the following pages:
104114
The following HALCON versions have been tested and confirmed to work
105115
with Zivid cameras:
106116

107-
- 19.05 Progress, 20.05 Progress, 21.11 Progress
117+
- 19.05 Progress, 20.05 Progress, 21.11 Progress, 24.05 Progress,
118+
24.11 Progress-Steady
108119

109120
We recommend using one of the HALCON versions we have tested.
110121

‎source/Applications/Advanced/ObjectMatching/SurfaceMatchingCreateModel.hdev‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>
@@ -25,6 +25,7 @@
2525
<l>open_framegrabber ('GenICamTL', 1, 1, 0, 0, 0, 0, 'progressive', -1, 'default', -1, 'false', 'default', Device, 0, 0, AcqHandle)</l>
2626
<c/>
2727
<c>* Configuring 3D-settings</c>
28+
<l>set_framegrabber_param (AcqHandle, 'CaptureMode', 'Capture2D3D')</l>
2829
<l>set_framegrabber_param (AcqHandle, 'create_objectmodel3d', 'enable')</l>
2930
<l>set_framegrabber_param (AcqHandle, 'add_objectmodel3d_overlay_attrib', 'enable')</l>
3031
<c/>

‎source/Applications/Advanced/ObjectMatching/SurfaceMatchingCreateModelFromFile.hdev‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>

‎source/Applications/Advanced/ObjectMatching/SurfaceMatchingFindModel.hdev‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>
@@ -42,6 +42,7 @@
4242
<l>open_framegrabber ('GenICamTL', 1, 1, 0, 0, 0, 0, 'progressive', -1, 'default', -1, 'false', 'default', Device, 0, 0, AcqHandle)</l>
4343
<c/>
4444
<c>* Configuring 3D-settings</c>
45+
<l>set_framegrabber_param (AcqHandle, 'CaptureMode', 'Capture2D3D')</l>
4546
<l>set_framegrabber_param (AcqHandle, 'create_objectmodel3d', 'enable')</l>
4647
<l>set_framegrabber_param (AcqHandle, 'add_objectmodel3d_overlay_attrib', 'enable')</l>
4748
<c/>

‎source/Applications/Advanced/ObjectMatching/SurfaceMatchingFindModelFromFile.hdev‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>
@@ -24,11 +24,11 @@
2424
<c/>
2525
<c>* Specify the object for surface-based 3D matching</c>
2626
<c>* Existing Twinings tea box model</c>
27-
<l>* SurfaceModelFile := 'TwiningsTeaBox'</l>
27+
<l>SurfaceModelFile := 'TwiningsTeaBox'</l>
2828
<c>* Existing Pepsi can model</c>
2929
<l>* SurfaceModelFile := 'PepsiCan'</l>
3030
<c>* Existing Coca-Cola bottle model</c>
31-
<l>SurfaceModelFile := 'CocaColaBottle'</l>
31+
<l>* SurfaceModelFile := 'CocaColaBottle'</l>
3232
<c/>
3333
<l>import './../../../Procedures'</l>
3434
<l>get_zivid_sample_data_dir(ZividDataDir)</l>

‎source/Applications/Basic/FileFormats/ReadPLY.hdev‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>

‎source/Camera/Advanced/CaptureHDRLoop.hdev‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>
@@ -26,26 +26,27 @@
2626
<c/>
2727
<c>* Connecting to Zivid camera</c>
2828
<l>open_framegrabber ('GenICamTL', 1, 1, 0, 0, 0, 0, 'progressive', -1, 'default', -1, 'false', 'default', Device, 0, 0, AcqHandle)</l>
29-
<l>get_framegrabber_param (AcqHandle, 'DeviceModelName', DeviceModelName)</l>
30-
<l>get_zivid_model_folder_name (DeviceModelName, DeviceModelFolder)</l>
29+
<l>get_framegrabber_param (AcqHandle, 'CameraInfoModel', CameraInfoModel)</l>
30+
<l>get_zivid_model_folder_name (CameraInfoModel, CameraModelFolder)</l>
3131
<c/>
3232
<c>* Configuring 3D-settings</c>
33+
<l>set_framegrabber_param (AcqHandle, 'CaptureMode', 'Capture2D3D')</l>
3334
<l>set_framegrabber_param (AcqHandle, 'create_objectmodel3d', 'enable')</l>
3435
<l>set_framegrabber_param (AcqHandle, 'add_objectmodel3d_overlay_attrib', 'enable')</l>
3536
<c/>
36-
<c>* Seting the timeout for aborting a pending grab to infinity; useful for longer exposure times</c>
37+
<c>* Setting the timeout for aborting a pending grab to infinity; useful for longer exposure times</c>
3738
<l>set_framegrabber_param (AcqHandle, 'grab_timeout', -1)</l>
3839
<c/>
3940
<c>* Switching to HDR mode (multiple acquisitions)</c>
4041
<l>set_framegrabber_param (AcqHandle, 'AcquisitionMode', 'MultiAcquisitionFrame')</l>
4142
<c/>
4243
<l>for Index := 1 to 3 by 1</l>
4344
<c/>
44-
<c> * Reseting any previous HDR settings</c>
45+
<c> * Resetting any previous HDR settings</c>
4546
<l> set_framegrabber_param (AcqHandle, 'ResetAcquisitions', 1)</l>
4647
<c/>
4748
<c> * Configuring HDR settings for frames</c>
48-
<l> set_framegrabber_param( AcqHandle, 'LoadSettingsFromFile', ZividDataDir + '/Settings/' + DeviceModelFolder + '/Settings0' + Index + '.yml')</l>
49+
<l> set_framegrabber_param( AcqHandle, 'LoadSettingsFromFile', ZividDataDir + '/Settings/' + CameraModelFolder + '/Settings0' + Index + '.yml')</l>
4950
<c/>
5051
<c> * Capturing frame (HDR)</c>
5152
<l> grab_data (Image, Region, Contours, AcqHandle, ObjectModel3D)</l>

‎source/Camera/Basic/Capture.hdev‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>
@@ -26,6 +26,7 @@
2626
<l>open_framegrabber ('GenICamTL',1, 1, 0, 0, 0, 0, 'progressive', -1, 'default', -1, 'false', 'default', Device, 0, 0, AcqHandle)</l>
2727
<c/>
2828
<c>* Configuring 3D-settings</c>
29+
<l>set_framegrabber_param (AcqHandle, 'CaptureMode', 'Capture2D3D')</l>
2930
<l>set_framegrabber_param (AcqHandle, 'create_objectmodel3d', 'enable')</l>
3031
<l>set_framegrabber_param (AcqHandle, 'add_objectmodel3d_overlay_attrib', 'enable')</l>
3132
<c/>

‎source/Camera/Basic/CaptureHDR.hdev‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>
@@ -26,6 +26,7 @@
2626
<l>open_framegrabber ('GenICamTL', 1, 1, 0, 0, 0, 0, 'progressive', -1, 'default', -1, 'false', 'default', Device, 0, 0, AcqHandle)</l>
2727
<c/>
2828
<c>* Configuring 3D-settings</c>
29+
<l>set_framegrabber_param (AcqHandle, 'CaptureMode', 'Capture2D3D')</l>
2930
<l>set_framegrabber_param (AcqHandle, 'create_objectmodel3d', 'enable')</l>
3031
<l>set_framegrabber_param (AcqHandle, 'add_objectmodel3d_overlay_attrib', 'enable')</l>
3132
<c/>
@@ -39,10 +40,10 @@
3940
<l>set_framegrabber_param (AcqHandle, 'ResetAcquisitions', 1)</l>
4041
<c/>
4142
<c>* Configuring HDR settings</c>
42-
<l>set_framegrabber_param (AcqHandle, 'Aperture', 11.31)</l>
43-
<l>set_framegrabber_param (AcqHandle, 'AddAcquisition', 1)</l>
4443
<l>set_framegrabber_param (AcqHandle, 'Aperture', 5.66)</l>
4544
<l>set_framegrabber_param (AcqHandle, 'AddAcquisition', 1)</l>
45+
<l>set_framegrabber_param (AcqHandle, 'Aperture', 4.0)</l>
46+
<l>set_framegrabber_param (AcqHandle, 'AddAcquisition', 1)</l>
4647
<l>set_framegrabber_param (AcqHandle, 'Aperture', 2.83)</l>
4748
<l>set_framegrabber_param (AcqHandle, 'AddAcquisition', 1)</l>
4849
<c/>

‎source/Camera/Basic/CaptureHDRCompleteSettings.hdev‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<hdevelop file_version="1.2" halcon_version="21.11.0.0">
2+
<hdevelop file_version="1.2" halcon_version="24.05.0.0">
33
<procedure name="main">
44
<interface/>
55
<body>
@@ -28,6 +28,7 @@
2828
<l>open_framegrabber ('GenICamTL',1, 1, 0, 0, 0, 0, 'progressive', -1, 'default', -1, 'false', 'default', Device, 0, 0, AcqHandle)</l>
2929
<c/>
3030
<c>* Configuring 3D-settings</c>
31+
<l>set_framegrabber_param (AcqHandle, 'CaptureMode', 'Capture2D3D')</l>
3132
<l>set_framegrabber_param (AcqHandle, 'create_objectmodel3d', 'enable')</l>
3233
<l>set_framegrabber_param (AcqHandle, 'add_objectmodel3d_overlay_attrib', 'enable')</l>
3334
<c/>

0 commit comments

Comments
 (0)