Teledyne Princeton Instruments PICam 5.x, Programmer'S Manual

Page: 235 / 357

Chapter 7 Advanced Function APIs 235
7.4.6 Accessory-Specific Information APIs
This section provides programming information about advanced accessory-specific
information APIs.
7.4.6.1
PicamAccessory_GetLightSourceReference()
Description
PicamAccessory_GetLightSourceReference()
returns a wavelength reference
calibration for an accessory.
NOTE:
Prior to program termination, memory that has been
dynamically allocated to
calibration_array
must be
released by calling
Picam_DestroyCalibrations()
.
Syntax
The syntax for
PicamAccessory_GetLightSourceReference()
is:
PICAM_API PicamAccessory_GetLightSourceReference(
PicamHandle accessory,
const PicamCalibration** counts_vs_nm);
Input Parameters
Input parameters for
PicamAccessory_GetLightSourceReference()
are:
Output Parameters
Output parameters for
PicamAccessory_GetLightSourceReference()
are:
Related APIs
For additional information, refer to the following related APIs:
•
Picam_DestroyCalibrations()
.
Related Structures
For additional information, refer to the following related structure definition:
•
PicamCalibration
.
accessory: Handle for the accessory for which the light source reference is
returned.
counts_vs_nm: Pointer to the allocated wavelength reference calibration where the
x-coordinates are wavelengths, in nanometers (nm), and the
y-coordinates are the intensity values at those wavelengths.