Is_Getimagehistogram - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.43 is_GetImageHistogram

USB 2.0
USB 3.0
Syntax
INT is_GetImageHistogram (HIDS hCam,
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
nID
ColorMode
pHistoMem
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
IS_CANT_OPEN_DEVICE
IS_INVALID_COLOR_FORMAT
IS_INVALID_CAMERA_HANDLE
IS_INVALID_MEMORY_POINTER
IS_INVALID_PARAMETER
IS_IO_REQUEST_FAILED
IS_NO_SUCCESS
IS_NULL_POINTER
IS_SUCCESS
Related functions
is_SetColorMode()
242
USB 2.0
USB 3.0
int nID, INT ColorMode, DWORD* pHistoMem)
Camera handle
Memory ID
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
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.
319
section.
502
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).
Invalid color format
Invalid camera handle
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_api.dll (API) and the driver file
(uc480_usb.sys) do not match.
General error message
Invalid array
Function executed successfully
© 2013 Thorlabs GmbH