ilabs-flir 1.0.7 → 2.0.3

package/ios/Flir/Frameworks/ThermalSDK.xcframework/ios-arm64_x86_64-simulator/ThermalSDK.framework/Headers/FLIRCameraEvent.h

@@ -0,0 +1,132 @@
+//
+//  FLIRCameraEvent.h
+//  FLIR Thermal SDK
+//
+//  Copyright © 2019 Teledyne FLIR. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "FLIRCameraDeviceInfo.h"
+#import "FLIRIdentity.h"
+
+/**
+ *
+ * Camera event.
+ *
+ * Handles events from a remotely connected camera
+ *
+ */
+
+@interface FLIRCameraEvent : NSObject
+
+/**
+ Event
+
+ - ImageSavedInCamera: the event
+ */
+typedef NS_ENUM(NSInteger, CameraEvent) {
+    /** Image was saved in the camera */
+    ImageSavedInCamera = 0,
+    /** Connection was lost */
+    CameraConnectionLost = 1, // Always on
+};
+
+/**
+ * Event
+ * CameraConnectionLost
+ *
+ * CameraConnectionLost event will be posted to NSNotificationCenter defaultCenter when camera is lost
+ * This event is always enabled when listening for ImageSavedInCamera
+ * event is separated from the discovery events
+ * object param always nil
+ *
+ *    [[NSNotificationCenter defaultCenter] addObserver:self
+ *                                             selector:@selector(CameraConnectionLost:)
+ *                                                 name:@"CameraConnectionLost"
+ *                                               object:nil];
+ *
+ */
+
+/**
+ *  Create a camera event object
+ *
+ *  @param cameraDeviceInfo the camera device to listen for events from
+ *
+ *  @return FLIRCameraEvent object
+ */
+- (instancetype) initWithCameraDeviceInfo:(FLIRCameraDeviceInfo *) cameraDeviceInfo;
+
+/**
+ *  Create a camera event object
+ *
+ *  @param ipAddress the camera ipAddress to listen for events from
+ *
+ *  @return FLIRCameraEvent object
+ */
+- (instancetype) initWithCameraIpAddress:(NSString *) ipAddress;
+
+/**
+ *  Create a camera event object
+ *
+ *  @param identity the camera identity to listen for events from
+ *
+ *  @return FLIRCameraEvent object
+ */
+- (instancetype) initWithIdentity:(FLIRIdentity *) identity;
+
+/**
+ * start listen for events
+ *
+ * posts the event to NSNotificationCenter defaultCenter
+ *
+ * event with id ImageSavedInCamera will post a named event "ImageSavedInCamera" to the notification center
+ *
+ * the notification object is a `FLIRFileReference` instance containing the full path to the image that was saved
+ *
+ * this image can be downloaded from the camera via FTP
+ *
+ *
+ * typedef NS_ENUM(NSInteger, CameraEvent) {
+ *
+ * - ImageSavedInCamera = 0,
+ * - CameraConnectionLost = 1, // Always on
+ *
+ *};
+ *
+ *	[[NSNotificationCenter defaultCenter] addObserver:self
+ *											 selector:@selector(imageSavedInCamera:)
+ *												 name:@"ImageSavedInCamera"
+ *											   object:nil];
+ *
+ *	self.cameraEvent = [[FLIRCameraEvent alloc] initWithCameraDeviceInfo:self.cameraDeviceInfo];
+ *	[self.cameraEvent listenForEvent:ImageSavedInCamera];
+ *
+ * Event
+ * CameraConnectionLost Always on when listening for ImageSavedInCamera
+ *
+ * CameraConnectionLost event will be posted to NSNotificationCenter defaultCenter when camera is lost
+ *
+ * This event is always enabled when listening for ImageSavedInCamera
+ *
+ * event is separated from the discovery events
+ *
+ * object param always nil
+ *
+ *  [[NSNotificationCenter defaultCenter] addObserver:self
+ *                                           selector:@selector(CameraConnectionLost:)
+ *                                               name:@"CameraConnectionLost"
+ *                                             object:nil];
+ *
+ *  @param eventID the event to listen for
+ *
+ *  @return true if succesful
+ */
+
+- (BOOL) listenForEvent:(CameraEvent) eventID;
+
+/**
+ *  stop listen for events
+ */
+- (void) stopListening;
+
+@end

package/ios/Flir/Frameworks/ThermalSDK.xcframework/ios-arm64_x86_64-simulator/ThermalSDK.framework/Headers/FLIRCameraExport.h

@@ -0,0 +1,93 @@
+//
+//  FLIRCameraExport.h
+//
+//  Copyright © 2024 Teledyne FLIR. All rights reserved.
+//
+//  Initialize and perform export (upload files to camera)
+
+#pragma once
+
+#import "FLIRIdentity.h"
+#import "FLIRCameraImport.h"
+
+/**
+ *  Delegate to return events when files are found on a camera.
+ */
+@protocol FLIRCameraExportEventDelegate <NSObject>
+
+/**
+ *  This is called when a file is imported from the camera to the device.
+ *  Note: you should NOT try to call `FLIRCamera.disconnect()` directly from this callback.
+ *
+ *  @param exportFile The path to a local file
+ */
+- (void)fileUploaded:(NSString * _Nonnull)exportFile;
+
+/**
+ *  This is called when error occurs when downloading a file.
+ *  Note: you should NOT try to call `FLIRCamera.disconnect()` directly from this callback.
+ *
+ *  @param e Dictionary with error information (error message and filename)
+ */
+- (void)exportError:(NSDictionary<NSString *, NSString *> * _Nonnull)e;
+
+
+/**
+ *  This is called to show the progress of uploaded files from the device.
+ *  Note: you should NOT try to call `FLIRCamera.disconnect()` directly from this callback.
+ *
+ *  @param progress The number of bytes uploaded so far.
+ *  @param total The total number of bytes of the file downloading.
+ *  @param file   The reference of the file currently being uploaded.
+ */
+- (void)fileProgress:(NSInteger)progress total:(NSInteger)total file:(FLIRFileReference * _Nonnull)file;
+
+@end
+
+@protocol FLIRCameraExportCancel
+
+/**
+ *  Cancels the export (currenty only used for Leia/Scout firmware update)
+ */
+- (void)cancelExport;
+
+@end
+
+/**
+ *  This class facilitates uploading files to camera.
+ */
+@interface FLIRCameraExport : NSObject<FLIRCameraExportCancel>
+
+/**
+ *  Export files to camera.
+ *
+ *  @param exportFile The path to a local file
+ *  @param destFolder  Destination folder.
+ *
+ *  @return TRUE if all is OK.
+ */
+- (BOOL)startExport:(NSString * _Nonnull)exportFile withDestFolder:(FLIRFolderReference * _Nonnull)destFolder
+   withSafeRenaming:(BOOL)safeRenaming;
+
+/**
+ *  Cancels the export
+ */
+- (void)cancelExport;
+
+/**
+ * Rename a file
+ *
+ *  @param exportFile The path to a local file
+ *  @param destFolder  Destination folder.
+ *
+ *  @return TRUE if all is OK.
+ */
+- (BOOL)renameFile:(FLIRFileReference* _Nonnull)file newName:(NSString * _Nonnull)newName error:(out NSError * _Nullable * _Nonnull)error;
+
+/**
+ *  A delegate to handle the events in FLIRCameraExportEventDelegate.
+ */
+@property (nonatomic, weak, nullable) id<FLIRCameraExportEventDelegate> delegate;
+
+@end
+

package/ios/Flir/Frameworks/ThermalSDK.xcframework/ios-arm64_x86_64-simulator/ThermalSDK.framework/Headers/FLIRCameraImport.h

@@ -0,0 +1,204 @@
+//
+//  FLIRCameraImport.h
+//
+//  Copyright © 2019 Teledyne FLIR. All rights reserved.
+//
+//  Initialize and perform import (list and import images).
+
+#import <UIKit/UIKit.h>
+
+#import "FLIRIdentity.h"
+
+/** Describes different possible file locations in the cameras filesystem. */
+typedef NS_ENUM(NSInteger, FLIRLocation)
+{
+    /** Unknown root. */
+    FLIRLocationUnknown,
+    /** The active camera folder used for storing images. */
+    FLIRLocationActive,
+    /** Base folder for images (e.g. "DCIM" on the SD card). */
+    FLIRLocationImageBase
+};
+
+/// Options for listing images
+typedef NS_OPTIONS(NSInteger, FLIRListImagesFlags) {
+    /// recurse all found folders
+    FLIRListImagesRecursive = 1 << 0,
+    /// include hidden files
+    FLIRListImagesShowHidden = 1 << 1
+};
+
+/**
+ *  Abstract file path on camera's filesystem.
+ */
+@interface FLIRFileReference : NSObject
+/** Defines base part of the file path. */
+@property (nonatomic, readwrite) FLIRLocation location;
+/** Relative path to location.
+ *
+ * Example: Both "image.jpg" and "/image.jpg" would refer to an image file in the folder of `location`, and both "" and "/" would refer to the folder of `location`.
+ * @note The path is expressed in a camera-compatible format using forward slashes (/) as the separator.
+ */
+@property (nonatomic, nonnull, readwrite) NSString *path;
+@end
+
+/**
+ *  Abstract directory path on camera's filesystem.
+ */
+@interface FLIRFolderReference : NSObject
+/** Defines base part of the file path. */
+@property (nonatomic, readwrite) FLIRLocation location;
+/** Relative path to location.
+ *
+ * @note The path is expressed in a camera-compatible format using forward slashes (/) as the separator.
+ */
+@property (nonatomic, nonnull, readwrite) NSString *path;
+
+@end
+
+@class FLIRThumbnail;
+
+/**
+ *  Delegate to return events when files are found on a camera.
+ */
+@protocol FLIRCameraImportEventDelegate <NSObject>
+
+/**
+ *  This is called when a file is imported from the camera to the device.
+ *  Note: you should NOT try to call `FLIRCamera.disconnect()` directly from this callback. Instead i.e. spawn a new thread.
+ *
+ *  @param filename The path to a new file.
+ */
+- (void)fileAdded:(NSString * _Nonnull)filename;
+
+/**
+ *  This is called when error occurs when downloading a file.
+ *  Note: you should NOT try to call `FLIRCamera.disconnect()` directly from this callback. Instead i.e. spawn a new thread.
+ *
+ *  @param e Dictionary with error information (error message and filename)
+ */
+- (void)importError:(NSDictionary<NSString *, NSString *> * _Nonnull)e;
+
+
+/**
+ *  This is called to show the progress of downloading image files from the device.
+ *  Note: you should NOT try to call `FLIRCamera.disconnect()` directly from this callback. Instead i.e. spawn a new thread.
+ *
+ *  @param progress The number of bytes downloaded so far.
+ *  @param total The total number of bytes of the file downloading.
+ *  @param file   The reference of the file currently being downloaded. Remember to compare files using `isEqual`.
+ */
+- (void)fileProgress:(NSInteger)progress total:(NSInteger)total file:(FLIRFileReference * _Nonnull)file;
+
+@optional
+
+/**
+ *  This is called when a thumbnail is downloaded
+ *
+ *  @param thumbnail A thumbnail with a reference to the original image and a thumbnail as a UIImage
+ */
+- (void)gotThumbnail:(FLIRThumbnail * _Nonnull)thumbnail;
+
+/**
+ * This is called when a file is deleted
+ * @param file The reference of the file that was deleted
+ */
+- (void)fileDeleted:(FLIRFileReference * _Nonnull)file;
+
+@end
+
+/**
+ *  Objects returned by listImages
+ */
+
+@interface  FLIRFileInfo : NSObject
+/** The name of the file, without the path (like Unix's basename)  */
+@property (nonatomic, nonnull) NSString *name;
+/** Abstract path to the file. */
+@property (nonatomic, nonnull) FLIRFileReference *reference;
+/** The time this file was last changed */
+@property (nonatomic, nonnull) NSDateComponents *time;
+/** The file size in bytes */
+@property (nonatomic) long long size;
+/** True if this file object represents a directory, false otherwise */
+@property (nonatomic) bool isDirectory;
+@end
+
+@interface FLIRThumbnail : NSObject
+/** File reference */
+@property (nonatomic, nonnull) FLIRFileReference *reference;
+/** Thumbnail */
+@property (nonatomic, nonnull) UIImage* thumbnail;
+@end
+
+/**
+ *  This class facilitates importing images from Camera.
+ */
+@interface FLIRCameraImport : NSObject
+
+/**
+ *  Import files from camera.
+ *
+ *  @param imageList List of files to import. Use `listImages` or `listImagesInWorkFolder` to obtain an image list.
+ *  @param destPath  Destination path.
+ *
+ *  @return TRUE if all is OK.
+ */
+- (BOOL)startImport:(NSArray<FLIRFileReference *> * _Nonnull)imageList withDestPath:(NSString * _Nonnull)destPath;
+
+/**
+ * Import thumbnails for files.
+ *
+ * @param imageList List of images. If a thumbnail is available, it will be imported, and the delegate will be called.
+ */
+- (void)startImportThumbnails:(NSArray<FLIRFileReference *> * _Nonnull)imageList;
+
+/**
+ *  Cancels the import session
+ */
+- (void)cancelImport;
+
+/**
+ *  A delegate to handle the events in FLIRCameraImportEventDelegate.
+ */
+@property (nonatomic, weak, nullable) id<FLIRCameraImportEventDelegate> delegate;
+
+/**
+ *  List all Flir files from default active folder in camera.
+ *
+ *  @return Array with FLIRFileInfos.
+ */
+-(NSArray<FLIRFileInfo *> * _Nullable)listImages:(out NSError *_Nullable *_Nullable)error;
+
+/**
+ *  List all Flir files in camera.
+ *
+ *  @param folder the folder to list, nil will use the active default folder
+ *  @param flags flags for recursive listing and including hidden folder
+ *
+ *  @return Array with FLIRFileInfos.
+ */
+- (NSArray<FLIRFileInfo *> * _Nullable)listImages:(FLIRFileReference * _Nullable)folder
+                                            flags:(FLIRListImagesFlags)flags
+                                            error: (out NSError *_Nullable *_Nullable)error;
+
+/**
+ *  List all Flir files from folder in camera.
+ *
+ *  @param folder workfolder with files.
+ *
+ *  @return Array with FLIRFileInfos.
+ */
+
+- (NSArray<FLIRFileInfo *> * _Nullable)listImagesInWorkFolder:(FLIRFileReference * _Nonnull)folder error:(out NSError *_Nullable *_Nullable)error;
+
+/**
+ * Gets workfolders as a list of folders from the specified camera.
+ *
+ * @return Returns workfolders as a list of folders from the camera. List may be empty.
+ */
+- (NSArray<FLIRFileInfo *> * _Nullable)listWorkfolders:(out NSError *_Nullable *_Nullable)error;
+
+- (void)startDeleteFiles:(NSArray<FLIRFileReference *> * _Nonnull)fileList;
+
+@end

package/ios/Flir/Frameworks/ThermalSDK.xcframework/ios-arm64_x86_64-simulator/ThermalSDK.framework/Headers/FLIRColorDistributionSettings.h

@@ -0,0 +1,204 @@
+//
+//  FLIRColorDistributionSettings.h
+//  ThermalSDK
+//
+//  Created by FLIR on 2021-09-03.
+//  Copyright © 2022 Teledyne FLIR. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ *  These methods transform each slot histogram bin x into the weight y.
+ */
+typedef NS_ENUM(NSUInteger, FLIRHistogramModifier) {
+    /** y = x^(1/2).
+    * If all pixels in a slot were collected within a circle,
+    * the radius of this circle is proportional to the slot weight.
+    */
+    FLIRSquareRoot,
+
+    /**  y = x^(1/3) */
+    FLIRCubicRoot,
+
+    /**  ln(x) if x >= 2 else 0. Every doubling of a slot's pixel count
+    *  will increase the slot weight by a fixed amount.
+    */
+    FLIRLn,
+
+    /**  Scaled LN (y = y_LN / 2.3), which has no effect on the normalized weights. */
+    FLIRLog10,
+
+    /** y = min(x, plateauCount)
+    * Put the cap @p ulPlateauCount on each of this histogram's bins.
+    */
+    FLIRPlateau,
+
+    /** y = x */
+    FLIRNone
+};
+
+/**
+ *  Specifies the color distributions used when running the colorizer on an image.
+ */
+@interface FLIRColorDistributionSettings : NSObject
+
+@end
+
+/**
+ *  The color information in the image is distributed linear to the temperature values of the image.
+ *
+ *  @note The palette colors used for each pixel is mapped in a linear fashion between the min and max temperatures of the image.
+ *  Pixels above and below min and max will contain a color defined in the @ref atlas::image::Palette.
+ */
+@interface FLIRTemperatureLinearSettings : FLIRColorDistributionSettings
+
+@end
+
+/**
+ *  The colors are evenly distributed over the existing temperatures of the image and enhance the contrast.
+ *
+ *  This color distribution can be particularly successful when the image contains few peaks of very low or
+ *  high temperature's values.
+ */
+@interface FLIRHistogramEqualizationSettings : FLIRColorDistributionSettings
+
+/** Minimum heq slope limit. */
+@property (nonatomic, assign) float linearPercent;
+/** Maximum heq slope limit. */
+@property (nonatomic, assign) int plateauTruncation;
+/** How many pixels to ignore. */
+@property (nonatomic, assign) float tailPercent;
+/** Decrease to make the histogram more responsive to new scene content. */
+@property (nonatomic, assign) float histogramDf;
+/** Temporal filtering of span limits. */
+@property (nonatomic, assign) float scaleDf;
+/** Mode to transform each slot histogram bin x into the weight y. */
+@property (nonatomic, assign) FLIRHistogramModifier modifierMode;
+
+@end
+
+/**
+ *  The color information in the image is distributed linear to the signal values of the image.
+ *
+ *  @note The palette colors used for each pixel is mapped in a linear fashion between the min and max signal values of the image. Pixels above and below min and max will contain a color defined in the @ref atlas::image::Palette.
+*/
+@interface FLIRSignalLinearSettings : FLIRColorDistributionSettings
+
+@end
+
+/**
+ *  Specifies parameters for the plateau histogram equalization mode.
+ *
+ *  The colors are evenly distributed over the existing temperatures of the image and enhance the contrast.
+ *  @note This color distribution can be particularly successful when the image contains few peaks
+ *  of very low or high temperature's values.
+ */
+@interface FLIRPlateauHistogramEqSettings : FLIRColorDistributionSettings
+
+/** Limits the maximum slope of the mapping function. */
+@property (nonatomic, assign) float maxGain;
+/** Limits the population of any single histogram bin. */
+@property (nonatomic, assign) float percentPerBin;
+/** Increasing values of Linear Percent more accurately preserves the visual representation of an object */
+@property (nonatomic, assign) float linearPercent;
+/** Determines the percentage of the histogram tails which are not ignored when generating the mapping function.*/
+@property (nonatomic, assign) float outlierPercent;
+/** Used to adjust the perceived brightness of the image. */
+@property (nonatomic, assign) float gamma;
+
+@end
+
+/**
+ *  Specifies parameters for the Digital Detail Enhancement (DDE) and Entropy modes.
+ *  Entropy modes reserve more shades of gray/colors for areas with more entropy by assigning areas with lower entropy lesser gray shades.
+ *
+ *  @note In this mode one color might not map to a specific temperature. Which means that the output
+ *  scale is not radiometric accurate.
+ */
+@interface FLIRDDESettings : FLIRPlateauHistogramEqSettings
+
+/** Detail to background ratio. */
+@property (nonatomic, assign) float detailToBackground;
+/** DDE smoothing factor */
+@property (nonatomic, assign) float smoothingFactor;
+/** Headroom for detail at dynamic range extremes */
+@property (nonatomic, assign) float detailHeadroom;
+
+@end
+
+
+/**
+ *  Specifies parameters for Entropy modes.
+ *  Entropy modes reserve more shades of gray/colors for areas with more entropy by assigning areas
+ *  with lower entropy lesser gray shades.
+ *
+ *  @note In this mode one color might not map to a specific temperature. Which means that the output
+ *  scale is not radiometric accurate.
+ */
+@interface FLIREntropySettings : FLIRDDESettings
+
+@end
+
+/**
+ *  Specifies parameters for the Adaptive Detail Enhancement (ADE) mode.
+ *  Adaptive detail enhancement which is using a edge-preserving and noise-reducing smoothing filter
+ *  to enhance the contrast in the image.
+ *
+ *  @note In this mode one color might not map to a specific temperature. Which means that the
+ *  output scale is not radiometric accurate.
+ */
+@interface FLIRADESettings : FLIRColorDistributionSettings
+
+/** Noise amplification limit (LF) (Low value=Disable this feature) */
+@property (nonatomic, assign) float alphaNoise;
+/** Edge preserving limit (LF); Too avoid halos around sharp edges (High value=Disable this feature). */
+@property (nonatomic, assign) float betaLf;
+/** Edge preserving limit (HF); Too avoid halos around sharp edges (High value=Disable this feature). */
+@property (nonatomic, assign) float betaHf;
+/** LF/HF crossover level; Low value=Only HF enhancement;High value=Only LF enhancement. */
+@property (nonatomic, assign) float betaMix;
+/** Amount of the high pass filter that should be used. */
+@property (nonatomic, assign) float hpBlendingAmount;
+/** Low part of the histogram that is discarded. */
+@property (nonatomic, assign) float lowLimit;
+/** High part of the histogram that is discarded. */
+@property (nonatomic, assign) float highLimit;
+/** Headroom for details at dynamic range extremes. */
+@property (nonatomic, assign) float headRoom;
+/** Footroom for details at dynamic range extremes. */
+@property (nonatomic, assign) float footRoom;
+/** Limits the maximum slope of the mapping function. */
+@property (nonatomic, assign) float gain;
+/** Linear portion used for mapping the colors. */
+@property (nonatomic, assign) float linearMix;
+
+@end
+
+/**
+ *  Specifies parameters for the FSX mode.
+ *  FSX is using a edge-preserving and noise-reducing smoothing filter
+ *  to enhance the contrast in the image.
+ */
+@interface FLIRFSXSettings : FLIRColorDistributionSettings
+
+/** Maximum allowed difference in the bilateral filtering. */
+@property (nonatomic, assign) float sigmaR;
+/** The weight factor applied to image details. */
+@property (nonatomic, assign) unsigned short alpha;
+
+@end
+
+/**
+ *  Specifies parameters for the local contrast enhancement (LCE) mode.
+ */
+@interface FLIRLCESettings : FLIRDDESettings
+
+/** Can be used to enhance the contrast. */
+@property (nonatomic, assign) int contrast;
+
+@end
+
+NS_ASSUME_NONNULL_END