THORLABS DCU22 Series Description And Sdk Manual

© 2016 Thorlabs Scientific Imaging238
DCx Camera Functional Description and SDK Manual
4.3.44 is_GetImageHistogram
USB 2.0
USB 3.0
USB 2.0
USB 3.0
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
hCam
Camera handle
nID
Memory ID
ColorMode
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.
pHistoMem
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.
IS_CANT_OPEN_DEVICE
An attempt to initialize or select the camera
failed (no camera connected or initialization
error).
IS_INVALID_COLOR_FORMAT
Invalid color format
IS_INVALID_CAMERA_HANDLE
Invalid camera handle
IS_INVALID_MEMORY_POINTER
Invalid pointer or invalid memory ID
IS_INVALID_PARAMETER
One of the submitted parameters is outside the
valid range or is not supported for this sensor or
is not available in this mode.
IS_IO_REQUEST_FAILED
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.
IS_NO_SUCCESS
General error message
IS_NULL_POINTER
Invalid array
IS_SUCCESS
Function executed successfully
Related functions

THORLABS DCU22 Series Specifications

General

Brand	THORLABS
Model	DCU22 Series
Category	Security Camera
Language	English