© 2016 Thorlabs Scientific Imaging238
DCx Camera Functional Description and SDK Manual
4.3.44 is_GetImageHistogram
Syntax
INT is_GetImageHistogram (HIDS hCam,
int nID, INT ColorMode, DWORD* pHistoMem)
Description
is_GetImageHistogram() computes the histogram of the submitted image. The histogram always
contains 256 values per channel. For color modes with a bit depth of more than 8 bits, the system
evaluates the 8 most significant bits (MSBs).
Input parameters
Color mode of the image with the nID memory ID
For a list of all available color formats and the associated input
parameters, see the Appendix: Color and memory formats section.
Pointer to a DWORD array
The array must be allocated in such a way that it can accommodate
3*256 values for color formats and in raw Bayer mode. In
monochrome mode, the array must be able to accommodate 1*256
values.
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
Communication with the driver failed because
no driver has been loaded.
An attempt to initialize or select the camera
failed (no camera connected or initialization
error).
IS_INVALID_MEMORY_POINTER
Invalid pointer or invalid memory ID
One of the submitted parameters is outside the
valid range or is not supported for this sensor or
is not available in this mode.
An IO request from the uc480 driver failed.
Possibly the versions of the uc480.dll (API) and
the driver file (uc480_usb.sys) do not match.
Function executed successfully
Related functions