"Fossies" - the Fresh Open Source Software Archive

Member "sip-0.12.1/help/en_US/dewarp.xml" (8 Aug 2012, 3571 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.

    1 <?xml version="1.0" encoding="UTF-8"?> 
    2 <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="dewarp">
    3 <info>
    4   <pubdate>May, 2012</pubdate>
    5 </info>
    6 <refnamediv>
    7   <refname>dewarp</refname>
    8   <refpurpose>Dewarps  a given image</refpurpose>
    9 </refnamediv>
   10   
   11 <refsynopsisdiv>
   12   <title>Calling Sequence</title>
   13       <synopsis>Image = dewarp(image)</synopsis>
   14 </refsynopsisdiv>
   15   
   16 <refsection>
   17 <title>Parameters</title>
   18 <variablelist>
   19       <varlistentry>
   20       <term>image</term>
   21       <listitem>
   22       For truecolor images, this is a MxNx3 matrix in range 0-1 (double
   23          precision); For binary images, image is a MxNx1 matrix (0=black and
   24          1=white).
   25       </listitem> 
   26       </varlistentry>
   27       
   28       <varlistentry>
   29       <term>Image</term>
   30       <listitem>
   31       For truecolor images, this is a MxNx3 matrix in range 0-1 (double
   32          precision); For binary images, image is a MxNx1 matrix (0=black and
   33          1=white).
   34       </listitem> 
   35       </varlistentry>
   36 </variablelist>
   37 </refsection>
   38 
   39 <refsection>
   40 <title>Description</title>
   41    <para>
   42  Function <literal>dewarp</literal> un-distorts scanned book pages by generating a vertical disparity array based on textlines.</para>
   43    <programlisting><![CDATA[
   44        initial_dir = PWD;
   45        chdir (SIPDIR + 'images');
   46      
   47        img = imread('chapter.jpg');
   48        Img = dewarp (img);
   49        clf;
   50        imshow(Img);
   51        
   52        chdir(initial_dir);
   53  ]]></programlisting>
   54 
   55     <para><emphasis role="bold">The result of the preceding example, Original image (left) and Image after background normalisation and binarization (right):</emphasis></para>
   56     <para><imagedata fileref="../images/dewarp-original.jpg" /> <imagedata fileref="../images/dewarp-initial.png" />
   57     </para>
   58     <para><emphasis role="bold">The contours of constant vertical disparity (left), calculated from the smoothed lines, and the dewarped result (right) on the input image after applying the vertical disparity:</emphasis></para>
   59     <para><imagedata fileref="../images/dewarp-vert-disparity.jpg" /> </para>
   60     <para><emphasis role="bold">The horizontal disparity field is then applied to this image. The field (left) and the final result (right):</emphasis></para>
   61     <para><imagedata fileref="../images/dewarp-horiz-disparity.jpg" /> </para>
   62  </refsection>
   63 
   64    <refsection><title>Bibliography</title>
   65    <para>
   66    See http://www.leptonica.com/dewarping.html for a brief description of the
   67    approach. 
   68    </para>
   69    </refsection>
   70 
   71 <refsection><title>Authors</title><simplelist type="vert">
   72    <member>Ricardo Fabbri &lt;ricardofabbri[at]users.sf.net&gt;</member>
   73    <member>Pallan Madhavan &lt;witness123[at]users.sf.net&gt;</member>
   74 </simplelist></refsection>
   75 
   76 <refsection><title>Availability</title>
   77 The latest version of SIP can be found at
   78 <para>http://siptoolbox.sf.net </para>
   79 </refsection>
   80 
   81 <refsection><title>See Also</title><simplelist type="inline">
   82       <member> <link linkend="deskew">deskew</link> </member>
   83       <member> <link linkend="im2gray">im2gray</link> </member>
   84 </simplelist>
   85 </refsection>
   86 
   87 </refentry>
   88 <!-- =================================================== 
   89            SIP - Scilab Image Processing toolbox
   90            Copyright (C) 2002-2012  Ricardo Fabbri
   91 
   92        See the file COPYING for license-related issues
   93      =================================================== -->