morphology.hpp

Go to the documentation of this file.

/* Copyright (c) 2023 Otto Link. Distributed under the terms of the GNU General
   Public License. The full license is in the file LICENSE, distributed with
   this software. */
 
#pragma once
 
#include "highmap/array.hpp"
 
namespace hmap
{
 
enum DistanceTransformType : int
{
  DT_EXACT,     
  DT_APPROX,    
  DT_MANHATTAN, 
  DT_JFA,       
};
 
Array border(const Array &array, int ir);
 
Array closing(const Array &array, int ir);
 
Array dilation(const Array &array, int ir);
 
Array dilation_expand_border_only(const Array &array, int ir);
 
Array dilation_expand_min_value_border_only(const Array &array);
 
Array distance_transform(const Array &array,
                         bool         return_squared_distance = false);
 
Array distance_transform_approx(const Array &array,
                                bool         return_squared_distance = false);
 
Array distance_transform_manhattan(const Array &array,
                                   bool return_squared_distance = false);
 
Array distance_transform_with_closest(const Array     &array,
                                      Mat<glm::ivec2> &closest,
                                      bool return_squared_distance = false);
 
Array erosion(const Array &array, int ir);
 
void flood_fill(Array &array,
                int    i,
                int    j,
                float  fill_value = 1.f,
                float  background_value = 0.f);
 
Array morphological_black_hat(const Array &array, int ir);
 
Array morphological_gradient(const Array &array, int ir);
 
Array morphological_top_hat(const Array &array, int ir);
 
Array opening(const Array &array, int ir);
 
Array relative_distance_from_skeleton(const Array &array,
                                      int          ir_search,
                                      bool         zero_at_borders = true,
                                      int          ir_erosion = 1);
 
Array signed_curvature_from_distance(const Array &array, int prefilter_ir = 0);
 
Array signed_distance_transform(const Array &array, int prefilter_ir = 0);
 
Array skeleton(const Array &array, bool zero_at_borders = true);
 
} // namespace hmap
 
namespace hmap::gpu
{
 
Array border(const Array &array, int ir, bool use_disk_kernel = true);
 
Array closing(const Array &array, int ir, bool use_disk_kernel = true);
 
Array dilation(const Array &array, int ir, bool use_disk_kernel = true);
 
Array dilation_expand_border_only(const Array &array,
                                  int          ir,
                                  bool         use_disk_kernel = true);
 
Array distance_transform_jfa(const Array &array,
                             bool         return_squared_distance = false);
 
Array erosion(const Array &array, int ir, bool use_disk_kernel = true);
 
Array morphological_black_hat(const Array &array,
                              int          ir,
                              bool         use_disk_kernel = true);
 
Array morphological_gradient(const Array &array,
                             int          ir,
                             bool         use_disk_kernel = true);
 
Array morphological_top_hat(const Array &array,
                            int          ir,
                            bool         use_disk_kernel = true);
 
Array opening(const Array &array, int ir, bool use_disk_kernel = true);
 
Array relative_distance_from_skeleton(const Array &array,
                                      int          ir_search,
                                      bool         zero_at_borders = true,
                                      int          ir_erosion = 1,
                                      bool         use_disk_kernel = true);
 
Array signed_curvature_from_distance(const Array &array, int prefilter_ir = 0);
 
Array signed_distance_transform(const Array &array, int prefilter_ir = 0);
 
Array skeleton(const Array &array, bool zero_at_borders = true);
 
} // namespace hmap::gpu