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