/// <summary>
/// Disconnects the camera, either connected via USB or TCP
/// </summary>
public void Disconnect()
{
if (_isConnected)
{
CheckResult(IrDirectInterfaceInvoke.evo_irimager_terminate());
_isConnected = false;
}
}
/// <summary>
/// Accessor to thermal image.
/// Conversion to temperature values are to be performed as follows:
/// t = ((double)data[row,column] - 1000.0) / 10.0
/// </summary>
/// <returns>Thermal Image as ushort[height, width]</returns>
/// <exception cref="System.Exception">Thrown on error</exception>
public ushort[,] GetThermalImage()
{
CheckConnectionState();
int width, height;
CheckResult(IrDirectInterfaceInvoke.evo_irimager_get_thermal_image_size(out width, out height));
ushort[,] buffer = new ushort[height, width];
CheckResult(IrDirectInterfaceInvoke.evo_irimager_get_thermal_image(out width, out height, buffer));
return(buffer);
}
/// <summary>
/// Initializes the TCP connection to the daemon process (non-blocking)
/// </summary>
/// <param name="hostname">Hostname or IP-Adress of the machine where the daemon process is running ("localhost" can be resolved)</param>
/// <param name="port">Port of daemon, default 1337</param>
/// <exception cref="System.Exception">Thrown on error</exception>
public void Connect(string hostname, int port)
{
int error;
if ((error = IrDirectInterfaceInvoke.evo_irimager_tcp_init(hostname, port)) < 0)
{
throw new Exception($"Error at camera init: {error}");
}
_isConnected = true;
IsAutomaticShutterActive = true;
}
/// <summary>
/// sets radiation properties, i.e. emissivity and transmissivity parameters (not implemented for TCP connection, usb mode only)
/// </summary>
/// <param name="emissivity">emissivity emissivity of observed object [0;1]</param>
/// <param name="transmissivity">transmissivity transmissivity of observed object [0;1]</param>
/// <param name="tAmbient">tAmbient ambient temperature, setting invalid values (below -273,15 degrees) forces the library to take its own measurement values.</param>
public void SetRadiationParameters(float emissivity, float transmissivity, float tAmbient = -999.0f)
{
if (emissivity < 0 || emissivity > 1)
{
throw new ArgumentOutOfRangeException(nameof(emissivity), "Valid range is 0..1");
}
if (transmissivity < 0 || transmissivity > 1)
{
throw new ArgumentOutOfRangeException(nameof(transmissivity), "Valid range is 0..1");
}
CheckConnectionState();
CheckResult(IrDirectInterfaceInvoke.evo_irimager_set_radiation_parameters(emissivity, transmissivity, tAmbient));
}
/// <summary>
/// Accessor to false color coded palette image
/// </summary>
/// <returns>RGB palette image</returns>
/// /// <exception cref="System.Exception">Thrown on error</exception>
public Bitmap GetPaletteImage()
{
CheckConnectionState();
int width, height;
CheckResult(IrDirectInterfaceInvoke.evo_irimager_get_palette_image_size(out width, out height));
Bitmap image = new Bitmap(width, height, PixelFormat.Format24bppRgb);
BitmapData bmpData = image.LockBits(new Rectangle(0, 0, image.Width, image.Height), ImageLockMode.WriteOnly, image.PixelFormat);
CheckResult(IrDirectInterfaceInvoke.evo_irimager_get_palette_image(out width, out height, bmpData.Scan0));
image.UnlockBits(bmpData);
return(image);
}
/// <summary>
/// Connected to this computer via USB
/// </summary>
/// <param name="xmlConfigPath">Path to xml config</param>
/// <param name="formatsDefPath">Path to folder containing formants.def (for default path use: "")</param>
/// <param name="logFileDirectory">Path to folder containing log files (for default path use: "")</param>
/// <exception cref="System.Exception">Thrown on error</exception>
public void Connect(string xmlConfigPath, string formatsDefPath = "", string logFileDirectory = "")
{
if (!File.Exists(xmlConfigPath))
{
throw new ArgumentException("XML Config file doesn't exist: " + xmlConfigPath, nameof(xmlConfigPath));
}
if (formatsDefPath.Length > 0 && !File.Exists(formatsDefPath))
{
throw new ArgumentException("Format Definition file doesn't exist: " + xmlConfigPath, nameof(formatsDefPath));
}
int error;
if ((error = IrDirectInterfaceInvoke.evo_irimager_usb_init(xmlConfigPath, formatsDefPath, logFileDirectory ?? "")) < 0)
{
throw new Exception($"Error at camera init: {error}");
}
_isConnected = true;
IsAutomaticShutterActive = true;
}
/// <summary>
/// Accessor to false color coded palette image and thermal image from same frame
/// </summary>
/// <returns cref="ThermalPaletteImage">False color coded palette and thermal image</returns>
/// <exception cref="System.Exception">Thrown on error</exception>
public ThermalPaletteImage GetThermalPaletteImage()
{
CheckConnectionState();
int paletteWidth, paletteHeight;
int thermalWidth, thermalHeight;
CheckResult(IrDirectInterfaceInvoke.evo_irimager_get_palette_image_size(out paletteWidth, out paletteHeight));
CheckResult(IrDirectInterfaceInvoke.evo_irimager_get_thermal_image_size(out thermalWidth, out thermalHeight));
Bitmap paletteImage = new Bitmap(paletteWidth, paletteHeight, PixelFormat.Format24bppRgb);
ushort[,] thermalImage = new ushort[thermalHeight, thermalWidth];
BitmapData bmpData = paletteImage.LockBits(new Rectangle(0, 0, paletteImage.Width, paletteImage.Height), ImageLockMode.WriteOnly, paletteImage.PixelFormat);
CheckResult(IrDirectInterfaceInvoke.evo_irimager_get_thermal_palette_image(
thermalWidth, thermalHeight, thermalImage,
paletteImage.Width, paletteImage.Height, bmpData.Scan0));
paletteImage.UnlockBits(bmpData);
return(new ThermalPaletteImage(thermalImage, paletteImage));
}
/// <summary>
/// Triggers a shutter flag cycle
/// </summary>
public void TriggerShutterFlag()
{
CheckConnectionState();
CheckResult(IrDirectInterfaceInvoke.evo_irimager_trigger_shutter_flag());
}
/// <summary>
/// Sets the minimum and maximum temperature range to the camera (also configurable in xml-config)
/// </summary>
/// <param name="tMin"></param>
/// <param name="tMax"></param>
public void SetTemperatureRange(int tMin, int tMax)
{
CheckConnectionState();
CheckResult(IrDirectInterfaceInvoke.evo_irimager_set_temperature_range(tMin, tMax));
}
/// <summary>
/// Sets palette format and scaling method.
/// </summary>
/// <param name="format">Palette format</param>
/// <param name="scale">Scaling method</param>
public void SetPaletteFormat(OptrisColoringPalette format, OptrisPaletteScalingMethod scale)
{
CheckConnectionState();
CheckResult(IrDirectInterfaceInvoke.evo_irimager_set_palette((int)format));
CheckResult(IrDirectInterfaceInvoke.evo_irimager_set_palette_scale((int)scale));
}
