Programming Notes; Programming In C/C - THORLABS DCU223x Operation Manual And Sdk

4.6 Programming Notes

Note
Parameter Validity
Functions that refer to an initialized camera have the camera handle HIDS hCam as the first parameter. All
parameters that are set using these functions remain valid for as long as the handle is valid, that is, until you close
the corresponding camera or exit the program. The next time you open the camera, it is initialized with the defaults
again.
Attention
All input parameters of a function have to be initialized with valid values before the function is called; this also
applies to parameters that are not used. Variables can be preset with '0', for example. For unused parameters, the
NULL pointer has to be passed.
The uc480.h header file
The uc480.h header file contains all the definitions and constants needed for the uc480 API. After the installation
of the uc480 drivers you will find this file in the directory:
Windows: C:\Program Files\Thorlabs\DCx Cameras\Develop\include
Linux: /usr/include
Note
Note on older functions
If it is necessary to continue working with the older functions, it is possible to add the uc480_deprecated.h
header file additionally to the uc480.h header file. The uc480_deprecated.h header file contains all obsolete
function definitions and constants which are no longer part of the uc480.h header file.
See also:
Programming in C / C++
Programming in C#
452
Programming in VB.NET
Programming in Delphi
Programming with ActiveX
Thread programming

4.6.1 Programming in C/C++

For programming with the uc480 API, we suggest to use the C/C++ programming language. This programming
language offers efficient access to all functions of the uc480 API. Enabling access to image memory contents
through pointers, C/C++ is especially suitable for image processing applications.
Most of the uc480 sample programs were created in Microsoft Visual Studio using the C++ programming language.
Hint
We suggest that you keep the function libraries (DLL, AX and OCX files) in the default directory. After the
installation, these files reside e.g. under Window (32 bit) in C:\Windows\System32\.
Copying these files to other locations may result in version conflicts.
Required Files
In order to access the uc480 API, make sure to include the following files in your project:
Header file: uc480.h
Lib file: uc480_api.lib
Function library (DLL): uc480_Api.dll
In order to access the DCx Camera AVI functions, make sure to include the following files in your project:
Header file: uc480_tools.h
Lib file: uc480_tools.lib
© 2013 Thorlabs GmbH
451
452
452
453
453
4 Programming (SDK)
451