Package com.flir.thermalsdk.androidsdk.image

package com.flir.thermalsdk.androidsdk.image
Allows to interpret the data stored in files or received from FLIR Thermal cameras as Visual or Thermal images [Android].
Make sure you put the correct permissions in the Manifest.xml file in order to use the image related features.
Depending on the Android target API level, you may require READ_EXTERNAL_STORAGE and WRITE_EXTERNAL_STORAGE permissions and some extra code to safely access public space -
mostly because on Android 10, apps in the scoped storage environment cannot access files using the file path.
When targeting API level 33 the READ_EXTERNAL_STORAGE and WRITE_EXTERNAL_STORAGE permissions are ignored and not granted to the app. In consequence app will not see the content of these public dirs as it used to before targeting API 33.
Possible ways to access files may include usage of Storage Access Framework (SAF), Media Store API, Scoped Storage (Android 11 and above).
For details you may refer to documentation and learning resources:
Storage
Storage blog

Classes defined in this package allow to read, write and display the the image. The package provides the main class used to access both Thermal and Visual image. The ThermalImage class defined here is capable of turning the temperature's data into an image and present it to the User. The class can be used to describe the data loaded from file or obtained from FLIR Thermal cameras.

Any image, regardless of the source it was created from, can be edited. All operations performed on Thermal or Visual image don't affect the data received. These operations change the way the data is used to create an image. Thank to this feature it is always possible to restore the original state of the image.

The definition of data stored in the Thermal image can be categorized in few groups. These are:

  1. temperature data and parameters that change the way it is interpreted,
  2. presentation data deciding, how temperature is displayed on the image and if there is any additional data to display,
  3. additional information attached to the image, that helps to interpret it.

The classes fitting in the first group are ImageParameters, Scale or ColorDistribution. These classes affects the reference values of the environment the image was taken at. This allows User to precisely define his object of interest. He has means to outline the most important parts of the image to ensure he won't miss any detail. It makes the observation and measurement of the process easier and more precise.

The second group consists of classes such as PaletteManager or Fusion. The decide how the image looks like to the User. These classes are used to show the details of the image without measuring temperature. Thanks to them the observation of the process is easier. However the image with only right Palette or FusionMode applied should not be uses as a source for the decision. The Thermal image should be taken correctly and adjusted through classes fitting into the first group mentioned here.

The last group provides more information about the image. Classes that fits here are CameraInformation, GpsInformation or VoiceAnnotation. They provide information where the image was taken and the hardware used. It provides access to the comments added to the file by the User on his FLIR Thermal camera.