Programming Notes - THORLABS DCU223 SERIES Description And Sdk Manual

4.7 Programming Notes

Note
Parameter Validity
Functions that refer to an initialized camera have the camera handle
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 header file contains all the definitions and constants needed for the uc480 API. After
uc480.h
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 contains all obsolete function definitions and constants which are no longer part of the
header file.
uc480.h
See also:
Programming in C / C++
Programming in C#
Programming in VB.NET
Programming in Delphi
Programming with ActiveX
Thread programming
4.7.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
© 2016 Thorlabs Scientific Imaging
header file additionally to the header file. The
uc480.h
C:\Windows\System32\.
4 Programming (SDK)
as the first
HIDS hCam
uc480_deprecated.h
425