Polarization#

Functions

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:
  • hImage[in] Handle to Image instance, acquired using a monochrome polarization filter array.

  • component[in] Component of the polarizer sensor.

  • algorithm[in] Demosaicing algorithm to be applied to the image.

  • hComponent[out] handle to Image containing the requested polar component.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • hImage[in] Handle to Image instance, acquired using a monochrome polarization filter array.

  • algorithm[in] Demosaicing algorithm to be applied to the image.

  • componentsMono[out] containing the pointers to the polar component images.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • hImage[in] Handle to Image instance, acquired using a color polarization filter array.

  • algorithm[in] Demosaicing algorithm to be applied to the image.

  • componentsColor[out] containing the pointers to the polar component images, for each color channel.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • polarComponents[in] Polarization components demosaiced from the raw image.

  • hS0[out] handle to Image ccontaining the requested stokes vectors.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • polarComponents[in] Polarization components demosaiced from the raw image.

  • hS1[out] handle to Image ccontaining the requested stokes vectors.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • polarComponents[in] Polarization components demosaiced from the raw image.

  • hS2[out] handle to Image containing the requested stokes vectors.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • polarComponents[in] polarization components demosaiced from the raw image.

  • stokesVectors[out] struct containing all handles of the stokes vectors.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

ITALA_API_C ItalaError ComputeAoLP(StokesVectors *stokesVectors, H_IMAGE *hImageAoLP)#

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

Parameters:
  • stokesVectors[in] Stokes vectors computed from the polarization components.

  • hImageAoLP[out] handle to the AoLP image.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

ITALA_API_C ItalaError ComputeDoLP(StokesVectors *stokesVectors, H_IMAGE *hImageDoLP)#

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

Parameters:
  • stokesVectors[in] Stokes vectors computed from the polarization components.

  • hImageDoLP[out] handle to the DoLP image.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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

Compute the intensity image from the Stokes vectors.

Parameters:
  • stokesVectors[in] Stokes vectors computed from the polarization components.

  • rawImagePixelFormat[in] The format of the raw polarization image.

  • hIntensity[out] handle to intensity image.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • hImage[in] handle to Image instance, acquired using a monochrome polarization filter array.

  • algorithm[in] Demosaicing algorithm to be applied to the image.

  • hImageAoLP[out] handle to the AoLP image.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • hImage[in] handle to Image instance, acquired using a monochrome polarization filter array.

  • algorithm[in] Demosaicing algorithm to be applied to the image.

  • hImageDoLP[out] handle to the AoLP image.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • hImage[in] handle to Image instance, acquired using a monochrome polarization filter array.

  • algorithm[in] Demosaicing algorithm to be applied to the image.

  • hIntensity[out] handle to the to intensity image.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.

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:
  • hImage[in] handle to Image instance, acquired using a monochrome polarization filter array.

  • hPolarQuadrants[out] handle to quadrants image.

Returns:

ItalaError the error code; return ItalaErrorSuccess (0) if no errors occures.