"Fossies" - the Fresh Open Source Software Archive

Member "sip-0.12.1/help/en_US/edilate.xml" (9 Apr 2012, 5935 Bytes) of package /linux/privat/sip-0.12.1.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) XML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "edilate.xml": 0.5.6_vs_0.12.1.

    1 <?xml version="1.0" encoding="ISO-8859-1"?><refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="en" xml:id="edilate"><info><pubdate>February 2004</pubdate></info><refnamediv><refname>edilate</refname><refpurpose>Euclidean  morphological  dilation  of  binary images</refpurpose></refnamediv>
    2    <refsynopsisdiv><title>Calling Sequence</title><synopsis>Dil = edilate(Img, [radius, form, algorithm])</synopsis></refsynopsisdiv>
    3    <refsection><title>Parameters</title>
    4       <variablelist>
    5          <varlistentry>
    6             <term>Img</term>
    7             <listitem>
    8        M x N Binary image to be dilated. (0 for background, 1 for object)
    9       </listitem>
   10          </varlistentry>
   11          <varlistentry>
   12             <term>radius</term>
   13             <listitem>
   14        of circular Euclidean structuring element to be used. Defaults to 5.
   15       </listitem>
   16          </varlistentry>
   17          <varlistentry>
   18             <term>form</term>
   19             <listitem>
   20        determines the size of <literal>Dil</literal>. It assumes be one of the
   21        following values:
   22        <variablelist>
   23                   <varlistentry>
   24                      <term>'same'</term>
   25                      <listitem>
   26                         <literal>Dil</literal> has the same size as the original image,
   27             <literal>M x N</literal>. The image is assumed to be 0 outside its
   28             bounds.
   29          </listitem>
   30                   </varlistentry>
   31                   <varlistentry>
   32                      <term>'full'</term>
   33                      <listitem>
   34             Dil contains the full dilation, <literal>(M+2*radius-1) x
   35             (N+2*radius-1)</literal>.  The image is assumed to be 0
   36             outside its bounds.
   37          </listitem>
   38                   </varlistentry>
   39                </variablelist>
   40             </listitem>
   41          </varlistentry>
   42 
   43          <varlistentry>
   44           <term>algorithm</term>
   45           <listitem>
   46           the method to be used:
   47           <variablelist>
   48               <varlistentry>
   49                  <term>'cuisenaire pmn'</term>
   50                  <listitem>
   51                     a fast exact linear-time algorithm (default)
   52                  </listitem>
   53               </varlistentry>
   54               <varlistentry>
   55                  <term>'costa-estrozi' or 'exact dilations'</term>
   56                  <listitem>
   57                     a direct exact dilations algorithm
   58                  </listitem>
   59               </varlistentry>
   60            </variablelist>
   61           </listitem>
   62          </varlistentry>
   63       </variablelist>
   64    </refsection>
   65    <refsection><title>Parameters</title>
   66       <variablelist>
   67          <varlistentry>
   68             <term>Dil</term>
   69             <listitem>
   70       Resultant image.
   71       </listitem>
   72          </varlistentry>
   73       </variablelist>
   74    </refsection>
   75    <refsection><title>Description</title>
   76       <para>
   77  Function <literal>edilate</literal> performs exact euclidean dilation of a binary image <literal>Img</literal> using a circle as the structuring element. It is implemented in C with state-of-the-art algorithms, optimized for speed. </para>
   78    </refsection>
   79    <refsection><title>Examples</title><programlisting role="example"><![CDATA[
   80        Img = gray_imread(SIPDIR+'images/tru.jpg');
   81        Img = 1-im2bw(Img, 0.3);
   82        clf
   83        imshow(Img,2);
   84        e = edilate(Img,7);
   85        clf
   86        imshow(e,2);
   87    ]]></programlisting></refsection>
   88 
   89     <para><emphasis role="bold">The original image, its binary image obtained by thresholding (padded with a black border for ease of visualization), and its dilation by a radius of 7px:</emphasis></para>
   90     <para><imagedata fileref="../../images/tru.jpg" /> <imagedata fileref="../images/edilate-bw.png" /> <imagedata fileref="../images/edilate-dilated.png" />
   91     </para>
   92 
   93    <refsection><title>Authors</title><simplelist type="vert">
   94       <member> Ricardo Fabbri &lt;ricardofabbri (AT) users DOT sf DOT net&gt; </member>
   95    </simplelist></refsection>
   96    <refsection><title>Bibliography</title>
   97       <variablelist>
   98          <varlistentry><term>Cuisenaire</term><listitem>
   99             <para>
  100    Cuisenaire, O and  Macq, B,
  101    "Fast Euclidean Distance Transformation by Propagation Using
  102    Multiple Neighborhoods", Computer Vision and Image Understanding, no. 2,
  103    vol 76, 163--172, 76, 1999.
  104    </para>
  105             <para>
  106    Chapter 3 of "Distance transformations: fast algorithms and applications 
  107    to medical image processing", Olivier Cuisenaire's Ph.D. Thesis, October 
  108    1999, Université catholique de Louvain, Belgium.
  109    </para>
  110          </listitem></varlistentry>
  111          <varlistentry><term>Exact Dilations</term><listitem>
  112             <para>
  113    "Multiresolution shape representation without border shifting",
  114    L. da F. Costa, and L. F. Estrozi, Electronics Letters, no. 21, vol. 35, 
  115    pp. 1829-1830, 1999.
  116    </para>
  117             <para>
  118    "Shape Analysis and Classification", 
  119    L. da F. Costa and R.M. Cesar Jr., CRC Press. 
  120    </para>
  121          </listitem></varlistentry>
  122       </variablelist>
  123    </refsection>
  124    <refsection><title>Availability</title>
  125 The latest version of the Scilab Image Processing toolbox can be found at
  126 <para>
  127          http://siptoolbox.sourceforge.net
  128       </para>
  129    </refsection>
  130    <refsection><title>See Also</title><simplelist type="inline">
  131       <member> 
  132          <link linkend="dilate">dilate</link> 
  133       </member>
  134       <member> 
  135          <link linkend="erode">erode</link> 
  136       </member>
  137       <member> 
  138          <link linkend="bwdist">bwdist</link> 
  139       </member>
  140       <member> 
  141          <link linkend="thin">thin</link> 
  142       </member>
  143       <member> 
  144          <link linkend="skel">skel</link> 
  145       </member>
  146    </simplelist></refsection>
  147 </refentry>