IShade.hpp

#pragma once
 
#include <opals/IModuleBase.hpp>
#include <opals/ShadingMethod.hpp>
#include <opals/ResamplingMethod.hpp>
#include <opals/GridFeature.hpp>
#include <opals/GridLimit.hpp>
#include <opals/String.hpp>
#include <opals/Path.hpp>
#include <opals/Array.hpp>
#include <opals/Vector.hpp>
 
#if defined(_MSC_VER) && !defined(OPALS_NO_AUTOLINK)
  #if defined _DEBUG && !defined OPALS_NO_DEBUG
      #pragma comment(lib, "opalsShade_d.lib")
  #else
      #pragma comment(lib, "opalsShade.lib")
  #endif
#endif
 
namespace opals {
 
  namespace opts
  {
    /// Options of \ref ModuleShade
    namespace Shade
    {
      /// Options of \ref ModuleShade
      using Options =
        IGroup< Names::_, false,
          ILeaf< Names::inFile, false, Vector<Path>  >,
          ILeaf< Names::feature, false, Vector<opals::GridFeature::Enum>  >,
          ILeaf< Names::outFile, false, Path  >,
          ILeaf< Names::oFormat, false, String  >,
          ILeaf< Names::pixelSize, false, float  >,
          ILeaf< Names::limit, false, GridLimit  >,
          ILeaf< Names::shading, false, ShadingMethod  >,
          ILeaf< Names::sunPosition, false, Array<double,2>  >,
          ILeaf< Names::createAlpha, false, bool  >
        >;
    }
  }
 
  /// Derives shaded relief raster maps (geo-coded hill shading) of DEM grids.
  /** Hill shading is a method to visualize a surface grid model by illuminating it using a light source shining from a certain direction. 
      Artificial shadows are calculated depending on the slope (steepness) and exposition of the surface w.r.t the direction of the light source.
      Depending on the artificial shadow length, grey values (0=shaded..255=exposed) are assigned to each cell of the output raster. */
  /// \see \ref ModuleShade
  class OPALS_API IShade : virtual public IModuleBase
  {
 
  public:
    static IShade* New();
    static IShade* New( IControlObject &controlObject );
    static IShade* New( const IModuleBase &parent );
    static IShade* New( const IModuleBase &parent, IControlObject &controlObject );
 
    virtual ~IShade() {}
 
    /// \name Access to module-specific options.
    ///@{
    using Options = opts::Shade::Options;
    virtual       Options& opts()       = 0;
    virtual const Options& opts() const = 0;
    ///@}
 
  };
 
};