radar_conversion_interface.h

Go to the documentation of this file.

#ifndef SDK_ECDIS_RADAR_CONVERSION_INTERFACE_H_
#define SDK_ECDIS_RADAR_CONVERSION_INTERFACE_H_
#pragma once
 
#include <base/inc/platform.h>
#include <base/inc/base_types.h>
#include <base/inc/forward_declarations.h>
#include <base/inc/sdk_component_interface.h>
#include <base/inc/interfaces/properties/properties_interface.h>
#include <base/inc/math/matrix3x2.h>
#include <base/inc/float_util.h>
#include <geometry/inc/coordinate_systems/crs_coordinate_transformation.h>
#include <geometry/inc/coordinate_systems/crs_projection.h>
#include <ecdislayer/inc/ecdislayer_const.h>
 
SDK_ECDISLAYER_BEGIN_NAMESPACE
namespace radar {
 
FWD_DECL_INTERFACE(IRadarConversion);
 
// Properties of RadarConversion component
enum RadarConversionPropertyIDs {
  kRadarConversion_BlurFilter = 1,
  kRadarConversion_AsterixCAT240 = 2,
  kRadarConversion_AntennaInProjectionX = 3,
  kRadarConversion_AntennaInProjectionY = 4,
  kRadarConversion_FrameInProjectionMinX = 5,
  kRadarConversion_FrameInProjectionMinY = 6,
  kRadarConversion_FrameInProjectionMaxX = 7,
  kRadarConversion_FrameInProjectionMaxY = 8,
  kRadarConversion_ProjectionToBitmapScaleX = 9,
  kRadarConversion_ProjectionToBitmapScaleY = 10,
  kRadarConversion_BitmapWidth = 11,
  kRadarConversion_BitmapHeight = 12,
  kRadarConversion_AntennaInBitmapX = 13,
  kRadarConversion_AntennaInBitmapY = 14,
  kRadarConversion_ConversionMode = 15,
};
 
enum RadarBlurFilter {
  kRadarBlurFilter_NoFilter = 0,
  kRadarBlurFilter_Gaussian_3x3 = 1,
  kRadarBlurFilter_Gaussian_5x5 = 2,
  kRadarBlurFilter_ArithmeticMean_3x3 = 3,
  kRadarBlurFilter_ArithmeticMean_5x5 = 4,
};
 
enum RadarConversionMode {
  kRadarConversionMode_Direct = 1,   // Just map the radar pixels to raster using the projection and the matrix
  kRadarConversionMode_Inscribe = 2, // Inscribe the radar image into the raster box. The matrix is calculated.
};
 
struct RADAR_SCAN_DATA {
  SDKUInt8* m_data;           
  SDKUInt32 m_data_size;      
  SDKUInt16 m_bits_per_pixel; 
  SDKUInt16 m_alignment;      
  SDKUInt32 m_sweep_header_size;  
  SDKUInt32 m_sweep_size;     
  SDKUInt32 m_pixel_count;    
  SDKUInt32 m_sweep_count;    
};
typedef struct RADAR_SCAN_DATA RADAR_SCAN_DATA;
 
struct IMAGE_PARAMETERS {
  SDKUInt8* m_data;           
  SDKUInt32 m_data_size;      
  SDKUInt16 m_bits_per_pixel; 
  SDKUInt16 m_alignment;      
  SDKUInt32 m_line_size;      
  SDKUInt32 m_width;          
  SDKUInt32 m_height;         
};
typedef struct IMAGE_PARAMETERS IMAGE_PARAMETERS;
 
class IRadarConversion : public ISDKProperties {
public:
  
  virtual SDKResult SDK_CALLTYPE SetRadarScanData(
    const RADAR_SCAN_DATA& radar_scan_data) throw() = 0;
 
  virtual SDKResult SDK_CALLTYPE SetRadarPosition(
    double lat, double lon) throw() = 0;
 
  virtual SDKResult SDK_CALLTYPE SetRadarParameters(
    double range,
    double dead_range = 0,
    double antenna_azimuth = 0,
    double range1 = 0,
    double antenna_azimuth2 = IEEE754_2008::dbl_NaN()) throw() = 0;
 
  inline SDKResult SetRadarScanDataAndPosition(
    const RADAR_SCAN_DATA& radar_scan_data,
    double lat, double lon,
    double range,
    double dead_range = 0,
    double antenna_azimuth = 0,
    double range1 = 0,
    double antenna_azimuth2 = IEEE754_2008::dbl_NaN()) throw()
  {
    SDKResult res = SetRadarScanData(radar_scan_data);
    if (!SDK_SUCCEEDED(res))
      return res;
    res = SetRadarPosition(lat, lon);
    if (!SDK_SUCCEEDED(res))
      return res;
    res = SetRadarParameters(range, dead_range, antenna_azimuth,
      range1, antenna_azimuth2);
    return res;
  }
 
  inline SDKResult GenerateRadarImage(
    SDKUInt32 width, SDKUInt32 height, 
    ::sdk::crs::IProjection* projection = NULL,
    const SDKMatrix3X2& transformation_matrix = CMatrix3X2()) throw() {
      IMAGE_PARAMETERS image_params;
      image_params.m_data           = NULL;   // [in]  A pointer to memory where the bitmap will be copied
      image_params.m_data_size      = 0;      // [in, out] The data size
      image_params.m_bits_per_pixel = 0;      // [in, out] Pixel intensity depth, have to be one of 2, 4, 8, 16, 32 or 0 - same as source
      image_params.m_alignment      = 0;      // [in, out] Required byte alignment for raster line, have to be from 1 up to 256 or 0 - same as source
      image_params.m_line_size      = 0;      // [out] Raster line size in bytes
      image_params.m_width          = width;  // [out] Bitmap width
      image_params.m_height         = height; // [out] Bitmap height
      return GenerateRadarImage(
        image_params, projection, transformation_matrix);
  }
 
  virtual SDKResult SDK_CALLTYPE GenerateRadarImage(
    IMAGE_PARAMETERS& image_params,
    ::sdk::crs::IProjection* projection = NULL,
    const SDKMatrix3X2& transformation_matrix = CMatrix3X2()) throw() = 0;
 
  virtual SDKResult SDK_CALLTYPE GetRadarImage(
    IMAGE_PARAMETERS& image_params,
    SDKInt32* radar_pos_x, SDKInt32* radar_pos_y,
    SDKGeoPointRect *frame,
    SDKInt32 image_offset_x = 0, SDKInt32 image_offset_y = 0) throw() = 0;
 
  SDK_IMPLEMENT_IID(IRadarConversion)
  SDK_END_INTERFACE(IRadarConversion)
};
SDK_DECLARE_IID(IRadarConversion)
 
} // namespace radar
SDK_ECDISLAYER_END_NAMESPACE
 
#endif // SDK_ECDIS_RADAR_CONVERSION_INTERFACE_H_