1Pnmshear User Manual(0)                                Pnmshear User Manual(0)
2
3
4

NAME

6       pnmshear - shear a PNM image by a specified angle
7
8

SYNOPSIS

10       pnmshear
11
12       [-noantialias] [-background=color] angle [pnmfile]
13
14       All  options  can  be abbreviated to their shortest unique prefix.  You
15       may use two hyphens instead of one to designate an option.  You may use
16       either  white  space  or  equals  signs  between an option name and its
17       value.
18
19

DESCRIPTION

21       This program is part of Netpbm(1).
22
23       pnmshear reads a PNM image as input and  shears  it  by  the  specified
24       angle  and  produce  a  PNM  image  as output.  If the input file is in
25       color, the output will be too, otherwise it  will  be  grayscale.   The
26       angle is in degrees (floating point), and measures this:
27
28           +-------+  +-------+
29           |       |  |\       \
30           |  OLD  |  | \  NEW  \
31           |       |  |an\       \
32           +-------+  |gle+-------+
33
34       If the angle is negative, it shears the other way:
35           +-------+  |-an+-------+
36           |       |  |gl/       /
37           |  OLD  |  |e/  NEW  /
38           |       |  |/       /
39           +-------+  +-------+
40
41       The angle should not get too close to 90 or -90, or the resulting image
42       will be unreasonably wide.  In fact, if it gets too  close,  the  width
43       will be so large that pnmshear cannot do computations in the word sizes
44       it uses, and the program detects this and fails.
45
46       pnmshear does the shearing by looping over the source pixels  and  dis‐
47       tributing  fractions  to  each  of the destination pixels.  This has an
48       "anti-aliasing" effect - it avoids jagged edges and similar  artifacts.
49       However,  it also means that the original colors in the image are modi‐
50       fied and there are typically more of them than you  started  with.   If
51       you need to keep precisely the same set of colors, see the -noantialias
52       option.  If the expanded palette is a problem, you can run  the  result
53       through pnmquant.
54
55

OPTIONS

57       In  addition  to  the options common to all programs based on libnetpbm
58       (most notably -quiet, see
59        Common Options ⟨index.html#commonoptions⟩ ), pnmshear  recognizes  the
60       following command line options:
61
62
63
64       -background=color
65              This determines the color of the background on which the sheared
66              image sits.
67
68              Specify the color (color) as described for the argument  of  the
69              pnm_parsecolor()                 library                 routine
70              ⟨libnetpbm_image.html#colorname⟩ .
71
72              By default, if you don't specify this option,  pnmshear  selects
73              what  appears  to  it to be the background color of the original
74              image.  It determines this color rather simplistically, by  tak‐
75              ing  an  average  of  the  colors  of the two top corners of the
76              image.
77
78              This option was new in Netpbm  10.37  (December  2006).   Before
79              that, pnmshear always behaved as is the default now.
80
81
82       -noantialias
83              This option forces pnmshear to simply move pixels around instead
84              of synthesizing output pixels from multiple input  pixels.   The
85              latter  could cause the output to contain colors that are not in
86              the input, which may not be desirable.  It also  probably  makes
87              the  output  contain  a  large  number of colors.  If you need a
88              small number of colors, but it doesn't matter if  they  are  the
89              exact ones from the input, consider using pnmquant on the output
90              instead of using -noantialias.
91
92              Note that to ensure the output does not contain colors that  are
93              not  in  the input, you also must consider the background color.
94              See the -background option.
95
96
97
98

SEE ALSO

100       pnmrotate(1), pamflip(1), pamhomography(1), pnmquant(1), pnm(1)
101
102
103

AUTHOR

105       Copyright (C) 1989, 1991 by Jef Poskanzer.
106

DOCUMENT SOURCE

108       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
109       source.  The master documentation is at
110
111              http://netpbm.sourceforge.net/doc/pnmshear.html
112
113netpbm documentation             22 March 2020         Pnmshear User Manual(0)
Impressum