ICV 1 BRL-CAD BRL-CAD
icv Convert images to and from various formats
`icv` -h -i file --input-format fmt -o file --output-format fmt -w width input_file output_file

## DESCRIPTION

`icv` is a tool to convert images to and from a variety of image formats. Currently support formats include:

Supported ICV Image Formats

Format | Extension
--- | ---
PIX - pixel sequence of R/G/B values stored as unsigned chars. | pix
Double PIX - double precision pixel sequence | dpix
Portable Network Graphics | png
PPM - "lowest common denominator" Netbpm color iamge format | ppm
BW - black and white image data | bw
(TODO) Utah Raster Toolkit Run-Length Encoded (RLE) | rle

## OPTIONS

File types will be deduced unless explicitly specfied with the `input-format` and/or `output-format` options. For file types like PIX that do not encode dimensional information, `icv` will attempt to guess the image size based on various assumptions (a square image, known sizes for image displays, paper sizes at various dots-per-inch, etc.). If the users does know the correct image width and height, they may be specified with the `w` and `n` options.

`-h`, `--help`

  Print help and exit.

`-i` file, `--input` file

  Specify an input file. If none is specified, the first non-option-related argument will be used as the input file name.

`-o` file, `--output` file

  Specify an input file. If none is specified, the second non-option-related argument will be used as the output file name.

`-w` #, `--width` #

  Specify the width of the input image. Useful for file types such as PIX that do not encode explicit size information.

`-n` #, `--height` #

  Specify the height of the input image. Useful for file types such as PIX that do not encode explicit size information.

`--input-format` fmt

  Explicitly specify input file format.

`--output-format` fmt

  Explicitly specify output file format.

## EXAMPLE

          icv -w 1024 -n 512 tank.pix tank.png

## SEE ALSO

pix 5 bw 5

## AUTHOR

Clifford Yapp

## COPYRIGHT

This software is Copyright (c) 1989-2024 by the United States Government as represented by U.S. Army Research Laboratory.

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org