ICV(1)

NAME

icv - Convert images to and from various formats

SYNOPSIS

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:

Table 1. 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

AUTHOR

Clifford Yapp

This software is Copyright (c) 1989-2021 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