Datasheet

WIC SDK for Windows

Introduction
Workswell s.r.o. is pleased to introduce you WIC SDK for Windows which is written in C# for .NET platform
and gives you full control of your WIC thermal camera. You might write programs in every .NET programming
language using this SDK. It supports communication and streaming using Gigabit and USB interfaces. Main
goal of this WIC SDK is to allow you fast conversion from raw signal data to temperature data.

Your thermal camera can be used in many ways, so this SDK architecture is designed to give you full support
for all your projects and to give you possibility of quick software development as well.

All technical explanations are fully described in documentation, which you can find in your WIC SDK folder
after installation of WIC SDK on your PC (usually in: \Program Files\WIC_SDK\Documentation.chm).

Workswell company has created WIC SDK samples to present some possibilities and to introduce its
advantages. You are kindly invited to continue reading and let us explain those possibilities in this document.

Discovering cameras and connection

Before discovering a camera, it is important to select folder with the camera licences which is necessary, if
you wish to add your camera to WIC SDK collection of cameras. If at least one of the licences is appropriate
for connected camera, this camera will be added to WIC SDK collection of cameras.

Workswell WIC SDK

In the code example 1, which is below, there is a short example of usage of WIC SDK which describes
connection to the first detected camera.

First of all, there is defined the path to the directory of licences. If at least one camera is detected, system is
asked to connect to the first one.

Discovering cameras and connection - Code example 1

1 CameraCenter cameraCenter; // cameraCenter variable
2 // Find the specific path to folder with licences (e.g. Documents)
3 string path =
4 Environment.GetFolderPath(Environment.SpecialFolder.CommonDocuments);
5 // CameraCenter already with the specific path
6 cameraCenter = new CameraCenter(path);
7 cameraCenter.CollectionChanged += cameraCenter_CollectionChanged;
8 // If at least one camera detected, connect to the first one
9 if (cameraCenter.Cameras.Count != 0)
10 {
11 Camera myCam = cameraCenter.Cameras.First();
12 // Connection to the camera
13 myCam.Connect();
14 }

Phone numbers E-mail and Web ID Headquarters

Revision 1.0 EN, 20. 4. 2016
+420 725 877 063 [email protected] Reg. No.: 29048575 Libocka 653/51b All pictures are only for illustration.
+420 725 955 464 www.workswell.eu VAT No. CZ29048575 Prague, Czech Republic Real values may vary.
In case you have physically connected new camera, which can’t be found, you may refresh the list of cameras
and update it. It is similar with physical disconnection of camera.

Both changes, such as addition or removal of camera will be visible, because the list of found cameras in
WIC SDK will be updated.

Refreshing of the list of cameras - Code example 2

1 // Count available cameras
2 int count = cameraCenter.Cameras.Count;
3 if (count > FoundCameras.Count)
4 { // New camera was found
4 Camera addedCam = cameraCenter.Cameras.Last();
5 FoundCameras.Add(new CameraViewModel(addedCam, this));
6 }
7 else
8 { // One of the cameras was removed
9 List<int> removedIndexes = new List<int>();
10 foreach (var Cam in FoundCameras)
11 {
12 if (cameraCenter.Cameras.Where(x => x.SerialNumber ==
13 Cam.SerialNumber).Count() == 0)
14 {
15 removedIndexes.Insert(0, FoundCameras.IndexOf(Cam));
16 }
17 }

Finally, in the list of cameras you see all cameras and you can select one to work with.

Workswell WIC SDK

Settings

Every acquisition of the scene is different, so it should be possible to change thermal parameters of the
environment, which affects a measurement, like Emissivity, Reflected temperature, Atmospheric
temperature, Humidity and Distance. WIC SDK allows you all that and more.

You can also choose between low and high Gain (temperature range). Then there is a possibility to select one
of predefined Palette and finally, you can select one of the Calibrated lens.

In the next code example, there is described settings of two parameters: Emissivity and Reflected
temperature which were mentioned higher and both are adjustable.

Phone numbers E-mail and Web ID Headquarters

Revision 1.0 EN, 20. 4. 2016
+420 725 877 063 [email protected] Reg. No.: 29048575 Libocka 653/51b All pictures are only for illustration.
+420 725 955 464 www.workswell.eu VAT No. CZ29048575 Prague, Czech Republic Real values may vary.
 Settings of the environment parameters - Code example 3
1 public float? Emisivity // Emisivity settings
2 {
3 get{…}
4 set
5 {
6 Settings.Emissivity = (float)value;
7 }
8 }
9 public float? ReflectedTemperature // Reflected temperature settings
10 {
11 get{…}
12 set
13 {
14 Settings.ReflectedTemperatureC = (float)(value);
15 }
16 }

As we have already mentioned, you can also change gain (temperature range). You are allowed to choose
between two modes. First of them – law gain is made for measurement, that will be highly accurate in range
from -40°C to 160°C. Second of those – high gain is preferred for measurement in much higher range, up to
very high temperatures.

You might use one of those modes according to the present application, so that your final image corresponds
to the reality and does not contain thermal noise.

Workswell WIC SDK

Settings of Gain mode - Code example 4
1 public string SelectedGainMode // Selection of Gain Mode
2 {
3 get{…}
4 set
5 {
6 switch (value)
7 {
8 case "Low": // Switch gain to law
9 myCam.GainMode = CameraSerialSettings.GainModes.Low;
10 break;
11 case "High": // Switch gain to high
12 myCam.GainMode = CameraSerialSettings.GainModes.High;
13 break;
14 default:
15 break;
16 }
17 }
18 }

Phone numbers E-mail and Web ID Headquarters

Revision 1.0 EN, 20. 4. 2016
+420 725 877 063 [email protected] Reg. No.: 29048575 Libocka 653/51b All pictures are only for illustration.
+420 725 955 464 www.workswell.eu VAT No. CZ29048575 Prague, Czech Republic Real values may vary.
Streaming from camera

After connect to the camera, it is convenient to see live stream from it. WIC SDK is also prepared for
a requirement like this.

Using a method StartAcquisition you can start the acquisition from the selected camera, using
a property ThermoImageSource you might get the thermal image from the camera which is currently
connected. Eventually, for stopping the acquisition there is a similar method StopAcquisiton.

In the short code example below, you may see a usage of those commands.

System connects to the first detected camera, if there is some. Then the acquisition is started and finally the
thermal image is acquired from camera.

Streaming from camera - Code example 5

1 // If at least one camera found
2 if (cameraCenter.Cameras.Count != 0)
3 {
4 Camera myCam = cameraCenter.Cameras.First();
5 // Connect to the first camera which was found
6 myCam.Connect();
7 // Start camera acquisition
8 myCam.StartAcquisition();
9 // Get source for thermal image
10 BitmapSource ThermalImage = myCam.ThermoImageSource;
11 }

Workswell WIC SDK

WIC SDK also gives you possibility of getting temperature array directly. This is made by a method
ConvertToTemperatureArray, which belongs to CameraSerialSettings class and calculates
temperatures.

Thanks to this possibility, it is also possible to get current temperature under your cursor. Short code example
is below.

Current temperature in the thermal image area - Code example 6

1 // Get pixel temperature from the current position
2 public float GetPixelTemperature(int x, int y)
3 {
4 int width = myCam.Settings.ResolutionX; // Width dimension of the image
5 int height = myCam.Settings.ResolutionY; // Hight dimension of the image
6
7 // Get an array of all temperatures in the image
8 float[] temperatures = Settings.ConvertToTemperatureArray(myCam.ImageInfo);
9
10 // Return specific temperature for a positition
11 return temperatures[y * width + x];
12 }

Phone numbers E-mail and Web ID Headquarters

Revision 1.0 EN, 20. 4. 2016
+420 725 877 063 [email protected] Reg. No.: 29048575 Libocka 653/51b All pictures are only for illustration.
+420 725 955 464 www.workswell.eu VAT No. CZ29048575 Prague, Czech Republic Real values may vary.
Getting device information

As it is very convenient and sometimes necessary to read device information, for these cases WIC SDK is also
capable to find information about camera and to let you know them.

If you want to read specific information, you can simply ask WIC SDK for them. There is need to connect to
the right camera instance, then you ask for a specific property and finally you might get it using getter
method.

In the following code example, we are showing an example of how to get property like: Manufacturer info,
Model Name and Serial Number.

Getting device information - Code example 7

1 // Manufacturer info
2 public string ManufacturerInfo
3 {
4 get
5 {
6 return myCam.ManufacturerInfo;
7 }
8 }
9 // Model name
10 public string ModelName
11 {
12 get
13 {
14 return myCam.ModelName;
15 }

Workswell WIC SDK

16 }
17 // Serial number
18 public string SerialNumber
19 {
20 get
21 {
22 return myCam.SerialNumber;
23 }
24 }

As it is only the example, you can certainly read much more properties of your camera from WIC SDK. For
example: Version of the device, User-defined device name, MAC address etc.

WIC SDK will automatically detect the maximum and minimum temperature so you might also read these
values on every frame, without any need to go through temperature array. It is made by MaxTemperature
and MinTemperature properties which belongs to Camera class.

Phone numbers E-mail and Web ID Headquarters

Revision 1.0 EN, 20. 4. 2016
+420 725 877 063 [email protected] Reg. No.: 29048575 Libocka 653/51b All pictures are only for illustration.
+420 725 955 464 www.workswell.eu VAT No. CZ29048575 Prague, Czech Republic Real values may vary.
Lens calibration

There is always some difference between two lenses. Every property of two lenses might be more or less
different, which may cause the inaccuracy in conversion of raw data to temperature. That is why it is
important to set correctly your camera’s lens.

As you might use more than one lens, it is necessary to tell WIC SDK which one is currently used, so that it
may use the appropriate calibration data for selected lens.

Searching for available calibrated lenses is demonstrated in the code example below.

Lens calibration - Code example 8

1 foreach (var lens in myCam.AvailableCalibratedLenses)
2 {
3 AvailableCalibratedLenses.Add(lens);
4 }

Conclusion

To conclude, WIC SDK was created by Workswell company and is very useful tool in cases when you deal with
software development for WIC thermal camera. It will help you simplify your work a lot.

Workswell WIC SDK

WIC SDK might be solution for your WIC thermal camera discovering and connection to PC, its settings and
live streaming of the thermal images and more.

This documents describes WIC SDK in version for windows users, but we would like to ensure you, that also
Linux version is available from Workswell company. It is definitely prepared to help you improve your own
projects, where you can use your thermal camera in the unlimited number of ways.

Phone numbers E-mail and Web ID Headquarters

Revision 1.0 EN, 20. 4. 2016
+420 725 877 063 [email protected] Reg. No.: 29048575 Libocka 653/51b All pictures are only for illustration.
+420 725 955 464 www.workswell.eu VAT No. CZ29048575 Prague, Czech Republic Real values may vary.
 Contacts

Workswell WIC SDK

Distribuidor Oficial para España y Portugal:

teléfono: +34 93 706 36 79

E-mail: [email protected]

Web: www.apliter.com

Phone numbers E-mail and Web ID Headquarters

Revision 1.0 EN, 20. 4. 2016
+420 725 877 063 [email protected] Reg. No.: 29048575 Libocka 653/51b All pictures are only for illustration.
+420 725 955 464 www.workswell.eu VAT No. CZ29048575 Prague, Czech Republic Real values may vary.