source-git / netpbm

Clone
Source Code
GIT

Blame userguide/pampaintspill.html

c8 master
  1.   2370ca3409fa2bb893cef32391629a9e08ed607d
  2.   userguide
  3.   pampaintspill.html
Blob History Raw
Packit 78deda
Packit Service 2370ca 
<html xmlns="http://www.w3.org/1999/xhtml">
Packit 78deda 
<head>
Packit 78deda 
<title>Pampaintspill User Manual</title>
Packit Service 2370ca 
<meta http-equiv="content-type" content="text/html; charset=us-ascii" />
Packit 78deda 
</head>
Packit 78deda
Packit 78deda 
<body>
Packit 78deda
Packit 78deda 
pampaintspill
Packit 78deda
Packit 78deda 
Table Of Contents
Packit 78deda
Packit 78deda 
pampaintspill - smoothly spill colors into the background
Packit 78deda
Packit 78deda 
SYNOPSIS
Packit 78deda
Packit 78deda
Packit 78deda 
pampaintspill
Packit 78deda 
[--bgcolor=color]
Packit 78deda 
[--wrap] [--all]
Packit 78deda 
[--downsample=number]
Packit 78deda 
[--power=number] [filename]
Packit 78deda
Packit 78deda 
Minimum unique abbreviations of option are acceptable.  You may use
Packit 78deda 
double hyphens instead of single hyphen to denote options.  You may use
Packit 78deda 
white space in place of the equals sign to separate an option name
Packit 78deda 
from its value.
Packit 78deda
Packit 78deda 
DESCRIPTION
Packit 78deda
Packit 78deda 
This program is part of Netpbm.
Packit 78deda
Packit 78deda 
pampaintspill produces a smooth color gradient from all of the
Packit 78deda 
non-background-colored pixels in an input image, effectively "spilling
Packit 78deda 
paint" onto the background.  pampaintspill is similar to
Packit 78deda 
pamgradient but differs in the following characteristics:
Packit 78deda
Packit 78deda
    Packit 78deda 
      
  • pampaintspill accepts any number of paint
    		•
    Packit 78deda 
          sources (non-background-colored pixels), which can lie anywhere
    Packit 78deda 
          on the canvas.  pamgradient accepts exactly
    Packit 78deda 
          four paint sources, one in each corner of the image.
    Packit 78deda
    Packit 78deda 
      
  • pampaintspill requires an input image while
    		•
    Packit 78deda 
          pamgradient generates a new image from
    Packit 78deda 
          scratch.
    Packit 78deda
    Packit 78deda 
      
  • pampaintspill can produce tileable output and
    		•
    Packit 78deda 
          can control how tightly the gradient colors bind to their source
    Packit 78deda 
          pixels.
    Packit 78deda
    Packit 78deda
    Packit 78deda 
    Results are generally best when the input image contains just a few, crisp
    Packit 78deda 
    spots of color. Use your drawing program's pencil tool — as opposed to a
    Packit 78deda 
    paintbrush or airbrush tool — with a small nib.
    Packit 78deda
    Packit 78deda 
    OPTIONS
    Packit 78deda
    Packit 78deda
    Packit 78deda 
      
    --bgcolor=color
    Packit 78deda 
      
    Explicitly specify the background color. color can be
    Packit 78deda 
          specified using any of the formats accepted by the
    Packit 78deda 
          href="libppm.html#colorname">ppm_parsecolor() library
    Packit 78deda 
          routine such as red or #ff0000.  If
    Packit 78deda 
          --bgcolor is not specified, pampaintspill makes an
    Packit 78deda 
          educated guess about the background color based on the colors in the
    Packit 78deda 
          image's corners.
    Packit 78deda
    Packit 78deda 
      
    --wrap
    Packit 78deda 
      
    Allow gradients to wrap around image borders. That is, colors
    Packit 78deda 
          that spill off the right side of the image reappear on the left side of
    Packit 78deda 
          the image and likewise for left/right, top/bottom, and
    Packit 78deda 
          bottom/top. --wrap makes images tileable, which is nice for
    Packit 78deda 
          producing desktop backgrounds.
    Packit 78deda
    Packit 78deda 
      
    --all
    Packit 78deda 
      
    Recolor all pixels, not just background pixels. Normally,
    Packit 78deda 
          non-background-colored pixels in the input image appear unmodified in
    Packit 78deda 
          the output image. With --all, all pixels are colored
    Packit 78deda 
          based on their distance from all of the (other) non-background-colored
    Packit 78deda 
          pixels.
    Packit 78deda
    Packit 78deda 
      
    --downsample=number
    Packit 78deda 
      
    Ignore all but number non-background-colored pixels.
    Packit 78deda 
          When a large number of pixels in the input image differ in color from
    Packit 78deda 
          the background, pampaintspill runs very slowly. The
    Packit 78deda 
          --downsample option randomly selects a given number of colored
    Packit 78deda 
          pixels to use as paint sources for the gradients and ignores the rest,
    Packit 78deda 
          thereby trading off image quality for speed of execution.
    Packit 78deda
    Packit 78deda 
      
    --power=number
    Packit 78deda 
      
    Control how color intensity changes as a function of the
    Packit 78deda 
          distance from a paint source. The default value for number is
    Packit 78deda 
          -2.0, which means that intensity drops (because of the minus sign) with
    Packit 78deda 
          the square (because of the 2.0) of the distance from each paint
    Packit 78deda 
          source. -2.0 generally works well in practice, but other values can be
    Packit 78deda 
          specified for various special effects. With very small numbers of paint
    Packit 78deda 
          sources, -1.0 may produce subtler gradients, but these get muddier as
    Packit 78deda 
          the number of paint sources increases. Positive numbers (e.g., 1.0 and
    Packit 78deda 
          2.0) make the paint sources stand out in the output image by pushing the
    Packit 78deda 
          gradients away from them.
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda 
    SEE ALSO
    Packit 78deda
    Packit 78deda
      Packit 78deda 
    • pamgradient
      		•
      Packit 78deda 
    • ppmmake,
      		•
      Packit 78deda 
    • ppmrainbow,
      		•
      Packit 78deda 
    • pgmramp,
      		•
      Packit 78deda 
    • ppmpat,
      		•
      Packit 78deda 
    • pam
      		•
      Packit 78deda
      Packit 78deda
      Packit 78deda 
      HISTORY
      Packit 78deda
      Packit 78deda 
      pampaintspill was new in Netpbm 10.50 (March 2010).
      Packit 78deda
      Packit 78deda
      Packit 78deda 
      COPYRIGHT
      Packit 78deda
      Packit 78deda 
      Copyright © 2010 Scott Pakin,
      Packit 78deda 
      scott+pbm@pakin.org.
      Packit 78deda
      Packit 78deda 
      Table Of Contents
      Packit 78deda
      Packit 78deda
        Packit 78deda 
          
      • NAME
        		•
        Packit 78deda 
          
      • SYNOPSIS
        		•
        Packit 78deda 
          
      • DESCRIPTION
        		•
        Packit 78deda 
          
      • OPTIONS
        		•
        Packit 78deda 
          
      • SEE ALSO
        		•
        Packit 78deda 
          
      • HISTORY
        		•
        Packit 78deda 
          
      • COPYRIGHT
        		•
        Packit 78deda
        Packit 78deda
        Packit 78deda 
        </body>
        Packit 78deda 
        </html>
        Packit 78deda

        Powered by Pagure 5.14.1

        SSH Hostkey/Fingerprint | Documentation