---
name: "pfscut"
section: "1"
platform: "linux"
package: "pfstools"
version: "2.2.0-9"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pfscut"
---

# pfscut(1)

Extract a rectangle out of a frame in PFS stream

## NAME

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

## SYNOPSIS

**pfscut** \[--left \<columns\>\] \[--right \<columns\>\]  \[--top \<rows\>\] \[--bottom \<rows\>\] \[--width \<new\_width\>\] \[--height \<new\_height\>\] \[--help\] \[x\_ul y\_ul x\_br y\_br\]

## DESCRIPTION

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

## OPTIONS

- \--left \<columns\>, -l \<columns\>

  Number of columns to be cut out from the left edge of an image.

- \--right \<columns\>, -r \<columns\>

  Number of columns to be cut out from the right edge of an image.

- \--top \<rows\>, -t \<rows\>

  Number of rows to be cut out from the top edge of an image.

- \--bottom \<rows\>, -b \<rows\>

  Number of rows to be cut out from the bottom edge of an image.

- \--width \<new\_width\>, -W \<new\_width\>

  Width of an output image. Note that --width can be mixed with either --left or --right option.

- \--height \<new\_height\>, -H \<new\_height\>

  Height of an output image. Note that --height can be mixed with either --top or --bottom option.

- \--help, -h

  Print a list of commandline options.

## EXAMPLES

- pfsin image.hdr \| pfscut --left 20 --top 5 \| pfsout out.hdr

  Cut out 20 columns from the left and 5 rows from the top edge of  image.hdr and save frame as out.hdr.

- pfsin image.hdr \| pfscut --left 20 --width 400 \| pfsout out.hdr

  Cut out 20 columns from the left edge of image.hdr, and create output image 400 pixels in width.

- pfsin image.hdr \| pfscut 0 0 511 511 \| pfsout out.hdr

  Cut left-upper part of the image of the size 512x512 (note that coordinates start with 0 and 512 is the last row/column that is included in the resulting image).

- [**pfsin**(1)](/pfsin/1.md)

  ## SEE ALSO

[**pfsout**(1)](/pfsout/1.md)

## BUGS

Please report bugs and comments to Dorota Zdrojewska \<dzdrojewska@wi.ps.pl\>.