# pnmpad(1) - man - phpman

> **TLDR:** Add borders to a PNM image.
>
- Add borders of the specified sizes to the image:
  `pnmpad {{-l|-left}} {{100}} {{-ri|-right}} {{150}} {{-t|-top}} {{123}} {{-bo|-bottom}} {{456}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
- Pad the image to the specified size:
  `pnmpad {{-wi|-width}} {{1000}} {{-he|-height}} {{500}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
- Pad the width of the image to the specified size, controlling the ratio between right and left padding:
  `pnmpad {{-wi|-width}} {{1000}} {{-ha|-halign}} {{0.7}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`
- Pad the width of the image using the specified color:
  `pnmpad {{-wi|-width}} {{1000}} {{-c|-color}} {{red}} {{path/to/image.pnm}} > {{path/to/output.pnm}}`

*Source: tldr-pages*

---

[pnmpad(1)](https://www.chedong.com/phpMan.php/man/pnmpad/1/markdown)                              General Commands Manual                             [pnmpad(1)](https://www.chedong.com/phpMan.php/man/pnmpad/1/markdown)



## NAME
       pnmpad - add borders to portable anymap

## SYNOPSIS
       **pnmpad** [**-verbose**] [**-white**|**-black**]
       [[[**-width=**_width_ [**-halign=**_ratio_]] |
          [**-left=**_leftpad_] [**-right=**_rightpad_]]]
       [[[**-height=**_height_ [**-valign=**_ratio_]] |
          [**-top=**_toppad_] [**-bottom=**_botpad_]]]
       [_pnmfile_]

       All  options can be abbreviated to their shortest unique prefix.  You may use two hyphens in‐
       stead of one to designate an option.  You may use either white space or an  equals  sign  be‐
       tween an option name and its value.


## DESCRIPTION
       Reads  a  PNM image as input. Outputs a PNM image that is the input image plus black or white
       borders of the sizes specified.

       If you just need to convert an image to a certain size regardless of the original dimensions,
       **pnmcut** with the **-pad** option may be a better choice.



## OPTIONS
### -verbose
              Verbose output.

### -white
### -black (default)
              Set pad color.

### -left
### -right
### -top
### -bottom
              Specify amount of padding in pixels.

### -width
              Set  desired width of image. Overrides **-left** and **-right** if specified. If _width_ is less
              than the actual image width, it is ignored. Use [**pnmcut**(1)](https://www.chedong.com/phpMan.php/man/pnmcut/1/markdown) to cut off parts of images.

### -height
              Set desired height of image. Overrides **-top** and **-bottom** if  specified.  If  _height_  is
              less  than  the  actual image height, it is ignored. Use [**pnmcut**(1)](https://www.chedong.com/phpMan.php/man/pnmcut/1/markdown) to cut off parts of
              images.

### -halign
              A real number between 0 and 1. Used in conjunction with **-width**, sets the alignment ra‐
              tio between left padding and right padding.

              Useful values:

              **0.0**    - left aligned;

              **0.5**    - center aligned (default);

              **1.0**    - right aligned.

### -valign
              A  real  number  between 0 and 1. Used in conjunction with **-height**, sets the alignment
              ratio between bottom padding and top padding.

              Useful values:

              **0.0**    - bottom aligned;

              **0.5**    - center aligned (default);

              **1.0**    - top aligned.


## HISTORY
       Before February 2002,
              **pnmpad** had a different option syntax which was less expressive and  not  like  conven‐
              tional  Netpbm  programs.  That syntax is still understood by **pnmpad** for backward com‐
              patibility, but not documented or supported for future use.


## SEE ALSO
       [**pbmmake**(1)](https://www.chedong.com/phpMan.php/man/pbmmake/1/markdown), [**pnmpaste**(1)](https://www.chedong.com/phpMan.php/man/pnmpaste/1/markdown), [**pnmcut**(1)](https://www.chedong.com/phpMan.php/man/pnmcut/1/markdown), [**pnmcrop**(1)](https://www.chedong.com/phpMan.php/man/pnmcrop/1/markdown), [**pbm**(5)](https://www.chedong.com/phpMan.php/man/pbm/5/markdown)


## AUTHOR
       Copyright (C) 2002 by Martin van Beilen
       Copyright (C) 1990 by Angus Duggan
       Copyright (C) 1989 by Jef Poskanzer.

       Permission to use, copy, modify, and distribute this software and its documentation  for  any
       purpose and without fee is hereby granted, provided that the above copyright notice appear in
       all copies and that both that copyright notice and this permission notice appear in  support‐
       ing documentation.  This software is provided "as is" without express or implied warranty.



                                           26 January 2002                                 [pnmpad(1)](https://www.chedong.com/phpMan.php/man/pnmpad/1/markdown)