granicus.if.org Git - imagemagick/blob - magick/morphology.h

   1 /*
   2   Copyright 1999-2010 ImageMagick Studio LLC, a non-profit organization
   3   dedicated to making software imaging solutions freely available.
   4
   5   You may not use this file except in compliance with the License.
   6   obtain a copy of the License at
   7
   8     http://www.imagemagick.org/script/license.php
   9
  10   Unless required by applicable law or agreed to in writing, software
  11   distributed under the License is distributed on an "AS IS" BASIS,
  12   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13   See the License for the specific language governing permissions and
  14   limitations under the License.
  15
  16   MagickCore morphology methods.
  17 */
  18 #ifndef _MAGICKCORE_MORPHOLOGY_H
  19 #define _MAGICKCORE_MORPHOLOGY_H
  20
  21 #if defined(__cplusplus) || defined(c_plusplus)
  22 extern "C" {
  23 #endif
  24
  25 #include <magick/geometry.h>
  26
  27 typedef enum
  28 {
  29   UndefinedKernel,    /* also the 'no-op' kernel */
  30   GaussianKernel,     /* Convolution Kernels */
  31   BlurKernel,
  32   CometKernel,
  33   LaplacianKernel,
  34   LOGKernel,
  35   DOGKernel,
  36   RectangleKernel,    /* Shape Kernels */
  37   SquareKernel,
  38   DiamondKernel,
  39   DiskKernel,
  40   PlusKernel,
  41   ChebyshevKernel,    /* Distance Measuring Kernels */
  42   ManhattenKernel,
  43   EuclideanKernel,
  44   UserDefinedKernel   /* user specified kernel values */
  45 } KernelInfoType;
  46
  47 typedef enum
  48 {
  49   UndefinedMorphology,
  50 /* Convolve / Correlate weighted sums */
  51   ConvolveMorphology,          /* Weighted Sum with reflected kernel */
  52   CorrelateMorphology,         /* Weighted Sum using a sliding window */
  53 /* Low-level Morphology methods */
  54   ErodeMorphology,             /* Minimum Value in Neighbourhood */
  55   DilateMorphology,            /* Maximum Value in Neighbourhood */
  56   ErodeIntensityMorphology,    /* Pixel Pick using GreyScale Erode */
  57   DilateIntensityMorphology,   /* Pixel Pick using GreyScale Dialate */
  58   DistanceMorphology,          /* Add Kernel Value, take Minimum */
  59 /* Second-level Morphology methods */
  60   OpenMorphology,              /* Dilate then Erode */
  61   CloseMorphology,             /* Erode then Dilate */
  62   OpenIntensityMorphology,     /* Pixel Pick using GreyScale Open */
  63   CloseIntensityMorphology,    /* Pixel Pick using GreyScale Close */
  64 /* Difference Morphology methods */
  65   EdgeInMorphology,            /* Dilate difference from Original */
  66   EdgeOutMorphology,           /* Erode difference from Original */
  67   EdgeMorphology,              /* Dilate difference with Erode */
  68   TopHatMorphology,            /* Close difference from Original */
  69   BottomHatMorphology,         /* Open difference from Original */
  70 /* Recursive Morphology methods */
  71   HitAndMissMorphology,        /* Foreground/Background pattern matching */
  72   ThinningMorphology,          /* Remove matching pixels from image */
  73   ThickenMorphology            /* Add matching pixels from image */
  74 } MorphologyMethod;
  75
  76 typedef struct
  77 {
  78   KernelInfoType
  79     type;
  80
  81   unsigned long
  82     width,
  83     height;
  84
  85   long
  86     x,
  87     y;
  88
  89   double
  90     *values,
  91     minimum,
  92     maximum,
  93     negative_range,
  94     positive_range;
  95
  96   unsigned long
  97     signature;
  98 } KernelInfo;
  99
 100 extern MagickExport KernelInfo
 101   *AcquireKernelInfo(const char *),
 102   *AcquireKernelBuiltIn(const KernelInfoType,const GeometryInfo *),
 103   *CloneKernelInfo(const KernelInfo *),
 104   *DestroyKernelInfo(KernelInfo *);
 105
 106 extern MagickExport Image
 107   *MorphologyImage(const Image *,const MorphologyMethod,const long,
 108     const KernelInfo *,ExceptionInfo *),
 109   *MorphologyImageChannel(const Image *,const ChannelType,
 110     const MorphologyMethod,const long,const KernelInfo *,ExceptionInfo *);
 111
 112 extern MagickExport void
 113   ScaleKernelInfo(KernelInfo *,const double,const GeometryFlags),
 114   ShowKernelInfo(KernelInfo *);
 115
 116 #if defined(__cplusplus) || defined(c_plusplus)
 117 }
 118 #endif
 119
 120 #endif