home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / gimp / 2.0 / help / en / script-fu-addborder.html < prev    next >
Encoding:
Extensible Markup Language  |  2008-05-03  |  10.1 KB  |  262 lines
  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4.   <head>
  5.     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  6.     <title>16.3.¬† Add Border</title>
  7.     <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
  8.     <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
  9.     <link rel="stylesheet" href="gimp-help-custom.css" type="text/css" />
  10.     <link rel="alternate stylesheet" href="gimp22.css" type="text/css" title="gimp22" />
  11.     <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
  12.     <link rel="start" href="index.html" title="GNU Image Manipulation Program" />
  13.     <link rel="up" href="filters-decor.html" title="16.¬† Decor Filters" />
  14.     <link rel="prev" href="script-fu-add-bevel.html" title="16.2.¬† Add Bevel" />
  15.     <link rel="next" href="script-fu-coffee-stain.html" title="16.4.¬† Coffee Stain" />
  16.   </head>
  17.   <body>
  18.     <div class="navheader">
  19.       <table width="100%" summary="Navigation header">
  20.         <tr>
  21.           <th colspan="3" align="center">16.3.¬†
  22.     <span lang="en" xml:lang="en">Add Border</span>
  23.   </th>
  24.         </tr>
  25.         <tr>
  26.           <td width="20%" align="left"><a accesskey="p" href="script-fu-add-bevel.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  27.           <th width="60%" align="center">16.¬†
  28.     <span lang="en" xml:lang="en">Decor Filters</span>
  29.   </th>
  30.           <td width="20%" align="right">¬†<a accesskey="n" href="script-fu-coffee-stain.html"><img src="../images/next.png" alt="Next" /></a></td>
  31.         </tr>
  32.       </table>
  33.       <hr />
  34.     </div>
  35.     <div class="sect2" lang="en" xml:lang="en">
  36.       <div class="titlepage">
  37.         <div>
  38.           <div>
  39.             <h3 class="title"><a id="script-fu-addborder"></a>16.3.¬†
  40.     <span lang="en" xml:lang="en">Add Border</span>
  41.   </h3>
  42.           </div>
  43.           <div>
  44.             <div class="revhistory">
  45.               <table border="1" width="100%" summary="Revision history">
  46.                 <tr>
  47.                   <th align="left" valign="top" colspan="3">
  48.                     <b>Revision History</b>
  49.                   </th>
  50.                 </tr>
  51.                 <tr>
  52.                   <td align="left">Revision $Revision: 2357 $</td>
  53.                   <td align="left">2007-08-18</td>
  54.                   <td align="left">ude</td>
  55.                 </tr>
  56.               </table>
  57.             </div>
  58.           </div>
  59.         </div>
  60.       </div>
  61.       <a id="id2789478" class="indexterm"></a>
  62.       <a id="id2789491" class="indexterm"></a>
  63.       <div class="sect3" lang="en" xml:lang="en">
  64.         <div class="titlepage">
  65.           <div>
  66.             <div>
  67.               <h4 class="title"><a id="id2789500"></a>16.3.1.¬†
  68.       <span lang="en" xml:lang="en">Overview</span>
  69.     </h4>
  70.             </div>
  71.           </div>
  72.         </div>
  73.         <div class="figure">
  74.           <a id="id2789511"></a>
  75.           <p class="title">
  76.             <b>Figure¬†16.325.¬†
  77.         <span lang="en" xml:lang="en">
  78.           Example for the ‚Äú<span class="quote">Add Border</span>‚Äù filter
  79.         </span>
  80.       </b>
  81.           </p>
  82.           <div class="figure-contents">
  83.             <div class="mediaobject">
  84.               <img src="../images/filters/examples/taj_orig.jpg" alt="Example for the Add Border filter" />
  85.               <div class="caption">
  86.                 <p>Original image</p>
  87.               </div>
  88.             </div>
  89.             <div class="mediaobject">
  90.               <img src="../images/filters/examples/decor-taj-addborder.jpg" alt="Example for the Add Border filter" />
  91.               <div class="caption">
  92.                 <p>Added border</p>
  93.               </div>
  94.             </div>
  95.           </div>
  96.         </div>
  97.         <br class="figure-break" />
  98.         <p>
  99.       This filter just does what its name says: it adds a border to the image.
  100.       You can specify the thickness of the border as well as the color. The
  101.       four sides of the border are colored in different shades, so the image
  102.       area will appear raised.
  103.     </p>
  104.         <p>
  105.       The image will be enlarged by the border size, it won't be painted over.
  106.     </p>
  107.       </div>
  108.       <div class="sect3" lang="en" xml:lang="en">
  109.         <div class="titlepage">
  110.           <div>
  111.             <div>
  112.               <h4 class="title"><a id="id2789591"></a>16.3.2.¬†
  113.       <span lang="en" xml:lang="en">Options</span>
  114.     </h4>
  115.             </div>
  116.           </div>
  117.         </div>
  118.         <div class="figure">
  119.           <a id="id2789602"></a>
  120.           <p class="title">
  121.             <b>Figure¬†16.326.¬†
  122.         <span lang="en" xml:lang="en">‚Äú<span class="quote">Add Border</span>‚Äù options</span>
  123.       </b>
  124.           </p>
  125.           <div class="figure-contents">
  126.             <div class="mediaobject">
  127.               <img src="../images/filters/options-decor-addborder.png" alt="Add Border options" />
  128.             </div>
  129.           </div>
  130.         </div>
  131.         <br class="figure-break" />
  132.         <div class="variablelist">
  133.           <dl>
  134.             <dt>
  135.               <span class="term">Border X size, Border Y size</span>
  136.             </dt>
  137.             <dd>
  138.               <p>
  139.             Here you can select the thickness of the added border, in pixels.
  140.             X size (left an right) and Y size (top and bottom) may be
  141.             different. Maximum is 250 pixels.
  142.           </p>
  143.             </dd>
  144.             <dt>
  145.               <span class="term">Border color</span>
  146.             </dt>
  147.             <dd>
  148.               <p>
  149.             Clicking on this button brings up the color selector dialog that
  150.             allows you to choose an ‚Äú<span class="quote">average</span>‚Äù border color (see
  151.             below, <span class="guilabel">Delta value on color</span>).
  152.           </p>
  153.             </dd>
  154.             <dt>
  155.               <span class="term">Delta value on color</span>
  156.             </dt>
  157.             <dd>
  158.               <p>
  159.             This option makes the border sides to be colored in different
  160.             shades and thus makes the image to appear raised. The actual
  161.             color of the respective border side is computed for every color
  162.             component red, green, and
  163.             blue<sup>[<a id="id2789706" href="#ftn.id2789706" class="footnote">11</a>]</sup>
  164.             from the ‚Äú<span class="quote">average</span>‚Äù <span class="guilabel">Border color</span>
  165.             as follows:<sup>[<a id="id2789735" href="#ftn.id2789735" class="footnote">12</a>]</sup>
  166.           </p>
  167.               <div class="itemizedlist">
  168.                 <ul type="disc">
  169.                   <li>
  170.                     <p>Top shade = Border color + Delta</p>
  171.                   </li>
  172.                   <li>
  173.                     <p>Right shade = Border color - ¬Ω Delta</p>
  174.                   </li>
  175.                   <li>
  176.                     <p>Bottom shade = Border color - Delta</p>
  177.                   </li>
  178.                   <li>
  179.                     <p>Left shade = Border color + ¬Ω Delta</p>
  180.                   </li>
  181.                 </ul>
  182.               </div>
  183.               <div class="figure">
  184.                 <a id="id2789785"></a>
  185.                 <p class="title">
  186.                   <b>Figure¬†16.327.¬†
  187.               <span lang="en" xml:lang="en">Delta examples</span>
  188.             </b>
  189.                 </p>
  190.                 <div class="figure-contents">
  191.                   <div class="mediaobject">
  192.                     <img src="../images/filters/examples/addborder-delta.png" alt="Delta examples" />
  193.                     <div class="caption">
  194.                       <p>
  195.                   ‚Äú<span class="quote">Add Border</span>‚Äù filter applied with
  196.                   <span class="guilabel">Delta value</span> 25, then with 75, 125, 175,
  197.                   and 225.
  198.                 </p>
  199.                     </div>
  200.                   </div>
  201.                 </div>
  202.               </div>
  203.               <br class="figure-break" />
  204.               <p>
  205.             Example: the default color is blue (38,31,207), default delta is
  206.             25. So the shades of the borders are: top: (38,31,207) +
  207.             (25,25,25) = (63,56,232), right: (38,31,207) + (-13,-13,-13) =
  208.             (25,18,194), etc.
  209.           </p>
  210.             </dd>
  211.           </dl>
  212.         </div>
  213.       </div>
  214.       <div class="footnotes">
  215.         <br />
  216.         <hr width="100" align="left" />
  217.         <div class="footnote">
  218.           <p><sup>[<a id="ftn.id2789706" href="#id2789706" class="para">11</a>] </sup>
  219.               See <a class="link" href="gimp-images-in.html#gimp-concepts-image-types" title="1.¬† Image Types">image types</a> or
  220.               <a class="xref" href="glossary.html#glossary-rgb" title="RGB">
  221.       <span lang="en" xml:lang="en">RGB</span>
  222.     </a>.
  223.             </p>
  224.         </div>
  225.         <div class="footnote">
  226.           <p><sup>[<a id="ftn.id2789735" href="#id2789735" class="para">12</a>] </sup>
  227.               Resulting values less than 0 are set to 0, values greater than
  228.               255 are set to 255.
  229.             </p>
  230.         </div>
  231.       </div>
  232.     </div>
  233.     <div class="navfooter">
  234.       <hr />
  235.       <table width="100%" summary="Navigation footer">
  236.         <tr>
  237.           <td width="40%" align="left"><a accesskey="p" href="script-fu-add-bevel.html"><img src="../images/prev.png" alt="Prev" /></a>¬†</td>
  238.           <td width="20%" align="center">
  239.             <a accesskey="u" href="filters-decor.html">
  240.               <img src="../images/up.png" alt="Up" />
  241.             </a>
  242.           </td>
  243.           <td width="40%" align="right">¬†<a accesskey="n" href="script-fu-coffee-stain.html"><img src="../images/next.png" alt="Next" /></a></td>
  244.         </tr>
  245.         <tr>
  246.           <td width="40%" align="left" valign="top"><a accesskey="p" href="script-fu-add-bevel.html">16.2.¬†
  247.     <span lang="en" xml:lang="en">Add Bevel</span>
  248.   </a>¬†</td>
  249.           <td width="20%" align="center">
  250.             <a accesskey="h" href="index.html">
  251.               <img src="../images/home.png" alt="Home" />
  252.             </a>
  253.           </td>
  254.           <td width="40%" align="right" valign="top">¬†<a accesskey="n" href="script-fu-coffee-stain.html">16.4.¬†
  255.     <span lang="en" xml:lang="en">Coffee Stain</span>
  256.   </a></td>
  257.         </tr>
  258.       </table>
  259.     </div>
  260.   </body>
  261. </html>
  262.