aboutsummaryrefslogtreecommitdiff
path: root/man/man1/resample.1
blob: f41d9e5129aedb7ed024d79e943541178c0ba00f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
.TH RESAMPLE 1
.SH NAME
resample \- resample a picture
.SH SYNOPSIS
.B resample
[
.B -x
.I size
] [
.B -y
.I size
] [
.I file
]
.SH DESCRIPTION
.I Resample
resamples its input image (default standard input) to a new size.
The image is decimated or interpolated using
a Kaiser window.
.PP
The size of the resampled image can be specified
with the
.B -x
and
.B -y
options.
An unadorned value sets the number of pixels of that dimension; a suffixed percent sign specifies a percentage.
If only one of
.B -x
or
.B -y
is given, the other dimension is scaled to preserve
the aspect ratio of the original image.
Thus,
.B -x50%
will reduce the image to half its original dimension in both
.B x
and
.BR y .
.PP
The input should be a Plan 9 image
as described in 
.IR image (7),
and the output will be a compressed 24-bit
.B r8g8b8
image.
To uncompress the image or change the pixel format, use
.I iconv
(see
.IR crop (1)).
.PP
.SH SOURCE
.B \*9/src/cmd/resample.c
.SH "SEE ALSO
.IR crop (1),
.IR image (7)
.SH BUGS
Faster algorithms exist, but this implementation produces correct pictures.