ItalaApiC  1.3.3
Functions
DefectDetection

Functions

ITALA_API_C ItalaError DD_AccumulateDark (H_DEFECTDETECTION hDefDet, uint8_t *pImageBuffer)
 
ITALA_API_C ItalaError DD_AccumulateGray (H_DEFECTDETECTION hDefDet, uint8_t *pImageBuffer)
 
ITALA_API_C ItalaError DD_ResetDark (H_DEFECTDETECTION hDefDet)
 
ITALA_API_C ItalaError DD_ResetGray (H_DEFECTDETECTION hDefDet)
 
ITALA_API_C ItalaError DD_FindLeaky (H_DEFECTDETECTION hDefDet, uint64_t maxFound, float threshold)
 
ITALA_API_C ItalaError DD_GetLeakyCount (size_t *leakyCount)
 
ITALA_API_C ItalaError DD_GetLeakyByIndex (size_t index, DefectivePixel *defectivePixel)
 
ITALA_API_C ItalaError DD_FindHotNCold (H_DEFECTDETECTION hDefDet, uint64_t maxFound, float threshold)
 
ITALA_API_C ItalaError DD_GetHotNColdCount (size_t *hotNColdCount)
 
ITALA_API_C ItalaError DD_GetHotNColdByIndex (size_t index, DefectivePixel *defectivePixel)
 
ITALA_API_C ItalaError DD_Dispose (H_DEFECTDETECTION hDefDet)
 
ITALA_API_C ItalaError CreateDefectDetection (size_t width, size_t height, PixelDepth depth, H_DEFECTDETECTION *hDefDet)
 

Detailed Description

All the methods related to the defective pixel detection.

Function Documentation

◆ DD_AccumulateDark()

ITALA_API_C ItalaError DD_AccumulateDark ( H_DEFECTDETECTION  hDefDet,
uint8_t *  pImageBuffer 
)

Dark images are used for both leaky and hotc/cold pixel detection. These images are accumulated via this function. The statistical properties needed for the detection are calculated instantaneously and kept when an image buffer is accumulated. The image buffer memory must be managed by the client code. The image buffer data is passed as generic byte pointer to keep the procedure generic and decoupled from the PFNC formats.

Parameters
[in]hDefDetHandle to DefectDetection instance.
[out]pImageBufferThe image buffer data in a generic byte pointer.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_AccumulateGray()

ITALA_API_C ItalaError DD_AccumulateGray ( H_DEFECTDETECTION  hDefDet,
uint8_t *  pImageBuffer 
)

Gray images are used for hot/cold pixels detection. These images are accumulated via this function. The statistical properties needed for the detection are calculated instantaneously and kept when an image buffer is accumulated. The image buffer memory must be managed by the client code. The image buffer data is passed as generic byte pointer to keep the procedure generic and decoupled from the PFNC formats.

Parameters
[in]hDefDetHandle to DefectDetection instance.
[out]pImageBufferThe image buffer data in a generic byte pointer.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_ResetDark()

ITALA_API_C ItalaError DD_ResetDark ( H_DEFECTDETECTION  hDefDet)

Flush the results computed for the accumulated dark images. This way a new accumulation and detection can be performed.

Parameters
[in]hDefDetHandle to DefectDetection instance.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_ResetGray()

ITALA_API_C ItalaError DD_ResetGray ( H_DEFECTDETECTION  hDefDet)

Flush the results computed for the accumulated gray images. This way a new accumulation and detection can be performed.

Parameters
[in]hDefDetHandle to DefectDetection instance.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_FindLeaky()

ITALA_API_C ItalaError DD_FindLeaky ( H_DEFECTDETECTION  hDefDet,
uint64_t  maxFound,
float  threshold 
)

Run the leaky pixel detection given the accumulated dark images. To retrive how many pxel have been found and retrive them

See also
DD_GetLeakyCount and
DD_GetLeakyByIndex .
Parameters
[in]hDefDetHandle to DefectDetection instance.
[in]maxFoundMaximum amount of leaky pixels to look for.
[in]thresholdDistance from the mean, measured in units of standard deviation, beyond which a pixel is considered defective.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_GetLeakyCount()

ITALA_API_C ItalaError DD_GetLeakyCount ( size_t *  leakyCount)

Get the amount of leadky detected pixels.

Parameters
[out]leakyCountAmount of pixel found.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_GetLeakyByIndex()

ITALA_API_C ItalaError DD_GetLeakyByIndex ( size_t  index,
DefectivePixel defectivePixel 
)

Get a defective pixel given the index.

Parameters
[in]indexIndex of defective pixel to retrive.
[out]defectivePixelDefective pixel retrived.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_FindHotNCold()

ITALA_API_C ItalaError DD_FindHotNCold ( H_DEFECTDETECTION  hDefDet,
uint64_t  maxFound,
float  threshold 
)

Run the hot/cold pixel detection given the accumulated gray images. To retrive how many pxel have been found and retrive them

See also
DD_GetHotNColdCount and
DD_GetHotNColdByIndex .
Parameters
[in]hDefDetHandle to DefectDetection instance.
[in]maxFoundMaximum amount of leaky pixels to look for.
[in]thresholdDistance from the mean, measured in units of standard deviation, beyond which a pixel is considered defective.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_GetHotNColdCount()

ITALA_API_C ItalaError DD_GetHotNColdCount ( size_t *  hotNColdCount)

Get the amount of hot and cold detected pixels.

Parameters
[out]hotNColdCountAmount of pixel found.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_GetHotNColdByIndex()

ITALA_API_C ItalaError DD_GetHotNColdByIndex ( size_t  index,
DefectivePixel defectivePixel 
)

Get a defective pixel given the index.

Parameters
[in]indexIndex of defective pixel to retrive.
[out]defectivePixelDefective pixel retrived.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ DD_Dispose()

ITALA_API_C ItalaError DD_Dispose ( H_DEFECTDETECTION  hDefDet)

Dispose the instance of the DefectDetection.

Parameters
[in]hDefDetHandle to DefectDetection instance.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ CreateDefectDetection()

ITALA_API_C ItalaError CreateDefectDetection ( size_t  width,
size_t  height,
PixelDepth  depth,
H_DEFECTDETECTION *  hDefDet 
)

Creation function for DefectDetection instance. The image width, height and pixel depth that will be used for the detection must be specified and kept identical for all images. Keep in mind that when using color formats (e.g. BayerRG8) the detection must be performed on every color separately.

Parameters
[in]widthWidth of the images the detection will be performed on.
[in]heightHeight of the images the detection will be performed on.
[in]depthDepth of the images the detection will be performed on.
[out]hDefDetHandle to DefectDetection instance.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.