ItalaApiC  1.3.3
Functions
Polarization

Functions

ITALA_API_C ItalaError ExtractPolarComponent (H_IMAGE hImage, PolarComponent component, PolarDemosaicingAlgorithm algorithm, H_IMAGE *hComponent)
 
ITALA_API_C ItalaError ExtractAllPolarComponents (H_IMAGE hImage, PolarDemosaicingAlgorithm algorithm, PolarComponents *componentsMono)
 
ITALA_API_C ItalaError ExtractAllPolarComponentsColor (H_IMAGE hImage, PolarDemosaicingAlgorithm algorithm, PolarComponentsColor *componentsColor)
 
ITALA_API_C ItalaError ComputeStokesS0 (PolarComponents *polarComponents, H_IMAGE *hS0)
 
ITALA_API_C ItalaError ComputeStokesS1 (PolarComponents *polarComponents, H_IMAGE *hS1)
 
ITALA_API_C ItalaError ComputeStokesS2 (PolarComponents *polarComponents, H_IMAGE *hS2)
 
ITALA_API_C ItalaError ComputeAllStokes (PolarComponents *polarComponents, StokesVectors *stokesVectors)
 
ITALA_API_C ItalaError ComputeAoLP (StokesVectors *stokesVectors, H_IMAGE *hImageAoLP)
 
ITALA_API_C ItalaError ComputeDoLP (StokesVectors *stokesVectors, H_IMAGE *hImageDoLP)
 
ITALA_API_C ItalaError ComputeIntensity (StokesVectors *stokesVectors, PfncFormat rawImagePixelFormat, H_IMAGE *hIntensity)
 
ITALA_API_C ItalaError InstantComputeAoLP (H_IMAGE hImage, PolarDemosaicingAlgorithm algorithm, H_IMAGE *hImageAoLP)
 
ITALA_API_C ItalaError InstantComputeDoLP (H_IMAGE hImage, PolarDemosaicingAlgorithm algorithm, H_IMAGE *hImageDoLP)
 
ITALA_API_C ItalaError InstantComputeIntensity (H_IMAGE hImage, PolarDemosaicingAlgorithm algorithm, H_IMAGE *hIntensity)
 
ITALA_API_C ItalaError ComputePolarQuadrantsImage (H_IMAGE hImage, H_IMAGE *hPolarQuadrants)
 

Detailed Description

All the methods related to the polarization image process.

Function Documentation

◆ ExtractPolarComponent()

ITALA_API_C ItalaError ExtractPolarComponent ( H_IMAGE  hImage,
PolarComponent  component,
PolarDemosaicingAlgorithm  algorithm,
H_IMAGE *  hComponent 
)

Extract a specific component (or angle) of the polarizer filter. The resulting image represents the captured light at the angle specified in degrees.

Note
Only monochrome images are supported.
Parameters
[in]hImageHandle to Image instance, acquired using a monochrome polarization filter array.
[in]componentComponent of the polarizer sensor.
[in]algorithmDemosaicing algorithm to be applied to the image.
[out]hComponenthandle to Image containing the requested polar component.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ExtractAllPolarComponents()

ITALA_API_C ItalaError ExtractAllPolarComponents ( H_IMAGE  hImage,
PolarDemosaicingAlgorithm  algorithm,
PolarComponents componentsMono 
)

Extract an image for each component (or angle) of the polarizer filter. Each resulting image represents the captured light at 0, 45, 90 and 135 degrees respectively.

Parameters
[in]hImageHandle to Image instance, acquired using a monochrome polarization filter array.
[in]algorithmDemosaicing algorithm to be applied to the image.
[out]componentsMonocontaining the pointers to the polar component images.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ExtractAllPolarComponentsColor()

ITALA_API_C ItalaError ExtractAllPolarComponentsColor ( H_IMAGE  hImage,
PolarDemosaicingAlgorithm  algorithm,
PolarComponentsColor componentsColor 
)

For each color channel, extract an image for each component (or angle) of the polarizer filter. Each resulting image represents the captured light at 0, 45, 90 and 135 degrees respectively, for each color channel.

Parameters
[in]hImageHandle to Image instance, acquired using a color polarization filter array.
[in]algorithmDemosaicing algorithm to be applied to the image.
[out]componentsColorcontaining the pointers to the polar component images, for each color channel.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputeStokesS0()

ITALA_API_C ItalaError ComputeStokesS0 ( PolarComponents polarComponents,
H_IMAGE *  hS0 
)

Computes only the S0 component of the Stokes vectors from the extracted polar components.

Parameters
[in]polarComponentsPolarization components demosaiced from the raw image.
[out]hS0handle to Image ccontaining the requested stokes vectors.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputeStokesS1()

ITALA_API_C ItalaError ComputeStokesS1 ( PolarComponents polarComponents,
H_IMAGE *  hS1 
)

Computes only the S1 component of the Stokes vectors from the extracted polar components.

Parameters
[in]polarComponentsPolarization components demosaiced from the raw image.
[out]hS1handle to Image ccontaining the requested stokes vectors.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputeStokesS2()

ITALA_API_C ItalaError ComputeStokesS2 ( PolarComponents polarComponents,
H_IMAGE *  hS2 
)

Computes only the S2 component of the Stokes vectors from the extracted polar components.

Parameters
[in]polarComponentsPolarization components demosaiced from the raw image.
[out]hS2handle to Image containing the requested stokes vectors.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputeAllStokes()

ITALA_API_C ItalaError ComputeAllStokes ( PolarComponents polarComponents,
StokesVectors stokesVectors 
)

Compute all the Stokes vectors to determine the polarization state of the light given the extracted components. The Stokes vector components are expressed as 32-bit or 64-bit floating point numbers depending on the raw image format.

Parameters
[in]polarComponentspolarization components demosaiced from the raw image.
[out]stokesVectorsstruct containing all handles of the stokes vectors.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputeAoLP()

ITALA_API_C ItalaError ComputeAoLP ( StokesVectors stokesVectors,
H_IMAGE *  hImageAoLP 
)

Compute the AoLP (Angle of Linear Polarization) image from the Stokes vectors.

Parameters
[in]stokesVectorsStokes vectors computed from the polarization components.
[out]hImageAoLPhandle to the AoLP image.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputeDoLP()

ITALA_API_C ItalaError ComputeDoLP ( StokesVectors stokesVectors,
H_IMAGE *  hImageDoLP 
)

Compute the DoLP (Degree of Linear Polarization) image from the Stokes vectors.

Parameters
[in]stokesVectorsStokes vectors computed from the polarization components.
[out]hImageDoLPhandle to the DoLP image.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputeIntensity()

ITALA_API_C ItalaError ComputeIntensity ( StokesVectors stokesVectors,
PfncFormat  rawImagePixelFormat,
H_IMAGE *  hIntensity 
)

Compute the intensity image from the Stokes vectors.

Parameters
[in]stokesVectorsStokes vectors computed from the polarization components.
[in]rawImagePixelFormatThe format of the raw polarization image.
[out]hIntensityhandle to intensity image.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ InstantComputeAoLP()

ITALA_API_C ItalaError InstantComputeAoLP ( H_IMAGE  hImage,
PolarDemosaicingAlgorithm  algorithm,
H_IMAGE *  hImageAoLP 
)

Convenience function which computes the AoLP (Angle of Linear Polarization) image directly from the raw polarization image without manual intermediate steps.

Note
Only monochrome images are supported.
Parameters
[in]hImagehandle to Image instance, acquired using a monochrome polarization filter array.
[in]algorithmDemosaicing algorithm to be applied to the image.
[out]hImageAoLPhandle to the AoLP image.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ InstantComputeDoLP()

ITALA_API_C ItalaError InstantComputeDoLP ( H_IMAGE  hImage,
PolarDemosaicingAlgorithm  algorithm,
H_IMAGE *  hImageDoLP 
)

Convenience function which computes the DoLP (Degree of Linear Polarization) image directly from the raw polarization image without manual intermediate steps.

Note
Only monochrome images are supported.
Parameters
[in]hImagehandle to Image instance, acquired using a monochrome polarization filter array.
[in]algorithmDemosaicing algorithm to be applied to the image.
[out]hImageDoLPhandle to the AoLP image.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ InstantComputeIntensity()

ITALA_API_C ItalaError InstantComputeIntensity ( H_IMAGE  hImage,
PolarDemosaicingAlgorithm  algorithm,
H_IMAGE *  hIntensity 
)

Convenience function which computes the intensity image directly from the raw polarization image without manual intermediate steps.

Note
Only monochrome images are supported.
Parameters
[in]hImagehandle to Image instance, acquired using a monochrome polarization filter array.
[in]algorithmDemosaicing algorithm to be applied to the image.
[out]hIntensityhandle to the to intensity image.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

◆ ComputePolarQuadrantsImage()

ITALA_API_C ItalaError ComputePolarQuadrantsImage ( H_IMAGE  hImage,
H_IMAGE *  hPolarQuadrants 
)

Computes an image split in quadrants containing the four extracted polarization components (angles), of the same width and height of the raw polarization image.

Note
Only monochrome images are supported.
Parameters
[in]hImagehandle to Image instance, acquired using a monochrome polarization filter array.
[out]hPolarQuadrantshandle to quadrants image.
Returns
ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.