1pfscut(1)                   General Commands Manual                  pfscut(1)
2
3
4

NAME

6       pfscut - Extract a rectangle out of a frame in PFS stream
7

SYNOPSIS

9       pfscut  [--left <columns>] [--right <columns>] [--top <rows>] [--bottom
10       <rows>] [--width <new_width>] [--height  <new_height>]  [--help]  [x_ul
11       y_ul x_br y_br]
12

DESCRIPTION

14       Extract  a  rectangle  out  of each frame in PFS stream. You can either
15       specify x and y coordinates of upper left and lower right  corner  (the
16       coordinates start with 0 and rise in the left-to-right and up-to-botton
17       directions) or give a combination of the options listed below.
18

OPTIONS

20       --left <columns>, -l <columns>
21              Number of columns to be cut out from the left edge of an image.
22
23       --right <columns>, -r <columns>
24              Number of columns to be cut out from the right edge of an image.
25
26       --top <rows>, -t <rows>
27              Number of rows to be cut out from the top edge of an image.
28
29       --bottom <rows>, -b <rows>
30              Number of rows to be cut out from the bottom edge of an image.
31
32       --width <new_width>, -W <new_width>
33              Width of an output image. Note that --width can  be  mixed  with
34              either --left or --right option.
35
36       --height <new_height>, -H <new_height>
37              Height  of an output image. Note that --height can be mixed with
38              either --top or --bottom option.
39
40       --help, -h
41              Print a list of commandline options.
42

EXAMPLES

44       pfsin image.hdr | pfscut --left 20 --top 5 | pfsout out.hdr
45              Cut out 20 columns from the left and 5 rows from the top edge of
46              image.hdr and save frame as out.hdr.
47
48       pfsin image.hdr | pfscut --left 20 --width 400 | pfsout out.hdr
49              Cut  out  20 columns from the left edge of image.hdr, and create
50              output image 400 pixels in width.
51
52       pfsin image.hdr | pfscut 0 0 511 511 | pfsout out.hdr
53              Cut left-upper part of the image of the size 512x512 (note  that
54              coordinates  start with 0 and 512 is the last row/column that is
55              included in the resulting image).
56
57
58       SEE ALSO
59              pfsin(1) pfsout(1)
60

BUGS

62       Please  report  bugs  and  comments  to  Dorota  Zdrojewska  <dzdrojew‐
63       ska@wi.ps.pl>.
64
65
66
67                                                                     pfscut(1)