pamrestack - Man Page

Rearrange rows of a Netpbm image

Updated:

Synopsis

pamrestack

[-width=width]

[-trim={fill|crop|abort}]

[-verbose]

[pamfile]

Minimum unique abbreviations of option are acceptable.  You may use double hyphens instead of single hyphen to denote options.  You may use white space in place of the equals sign to separate an option name from its value.

Description

This program is part of Netpbm(1).

pamrestack rearranges the pixels of a Netpbm image into different size rows.  E.g. if an image is 100 pixels wide and 50 pixels high, you can rearrange it to 125 wide and 40 high.  In that case, 25 pixels from the start of the 2nd row of the input would be moved to the end of the 1st row of input, 50 pixels from the 3rd row would be moved to the 2nd row, etc.

Put another way, pamrestack arranges all the input rows into one long sequence and produces output rows therefrom, in FIFO order.

Input is from Standard Input if you don't specify the input file pamfile.

Output is to Standard Output.

pamrestack works on a multi-image stream.  It cuts each image in the stream independently and produces a multi-image stream output.

Options

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options ), pamrestack recognizes the following command line options:

-width=width

The width of the output.  If this option is not specified, the output will
 consist of a single row wide enough to contain all the pixels of the input
 image.

-trim={fill|crop|abort}

This option specifies what to do when the new width does not cleanly divide the number of pixels in the input image.

fill

  (Default) Complete the final row by adding black pixels as necessary.

crop

    Discard the final partial row.  If this means there is nothing to
   output, fail the program.

abort

  Fail the program..

 

-verbose

Print information about the processing to Standard Error.

Usage

pamrestack is a general editor with many possible uses.

Examples

See Also

pamseq(1), ppmhist(1), pnmshear(1), pamdeinterlace(1), pamdice(1), pamundice(1), pnmcat(1), pam(1)

History

pamrestack was new in Netpbm 10.99 (June 2022).

Author

By Akira F. Urushibata.  Contributed to the public domain by the author.

Document Source

This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation is at

http://netpbm.sourceforge.net/doc/pamrestack.html

Referenced By

pamseq(1).

netpbm documentation