teem-overrgb(1) [debian man page]

TEEM(1) 							   User Commands							   TEEM(1)

NAME

       teem-overrgb - Composites an RGBA nrrd over a background color.

SYNOPSIS

       teem-overrgb -i <nin> [-c <contrast>] [-cfp <fixed point>] fR

DESCRIPTION

       ./teem-overrgb: Composites an RGBA nrrd over a background color (or image), after doing gamma correction, then quantizes to an 8-bit image.
       Actually, the input nrrd can have more than 4 values per pixel, but only the first four are used. If the RGBA nrrd is floating  point,  the
       values  are  taken at face value; if it is fixed point, the values interpreted as having been quantized (so that 8-bit RGBA images will act
       as you expect). When compositing with a background image, the given background image does not have to be the same size as the input  image;
       it will be resampled (with linear interpolation) to fit.

	      [-g <gamma>] [-b <background>] [-bi <nbg>] -o <filename>

       -i <nin> = input nrrd to composite (nrrd)

       -c <contrast> = contrast to apply to RGB values, before gamma. "0.0"
	      means no change, "1.0" means thresholding, "-1.0" means a complete washout. (double); default: "0.0"

       -cfp <fixed point> = component level that doesn't change with contrast

	      (double); default: "0.5"

       -g <gamma> = gamma to apply to image data, after contrast (double);
	      default: "1.0"

       -b <background> = background color to composite against; white is 1 1 1,
	      not 255 255 255. (3 doubles); default: "0 0 0"

       -bi <nbg> = 8-bit RGB background image to composite against (nrrd);
	      default: ""

       -o <filename> = file to write output PPM image to (string)

SEE ALSO

       The full documentation for teem-overrgb is maintained as a Texinfo manual.  If the info and teem-overrgb programs are properly installed at
       your site, the command

	      info teem-overrgb

       should give you access to the complete manual.

1.10.0								 December 10, 2008							   TEEM(1)

pngtopnm(1)						      General Commands Manual						       pngtopnm(1)

NAME

       pngtopnm - convert a Portable Network Graphics file into a portable anymap

SYNOPSIS

       pngtopnm [-verbose] [-alpha | -mix] [-background color]
       [-gamma value] [-text file] [-time] [pngfile]

DESCRIPTION

       Reads a Portable Network Graphics as input.  Produces a portable anymap as output.  The type of the output file depends on the input file -
       if it's black & white, a pbm file is written, else if it's grayscale a pgm file, else a ppm file.

OPTIONS

       -verbose
	      Display the format of the input file and the type of the output file. If the chunks are part of  the  png-file,  the  alpha,  trans-
	      parency and gamma-values will be indicated.

       -alpha Output  the  alpha channel or transparency mask of the image. The result is either a pbm file or pgm file, depending on whether dif-
	      ferent levels of transparency appear.

       -mix   Compose the image with the transparency or alpha mask against a the background. When a background chunk is available that  color	is
	      taken, else black will do.

       -background color
	      If  no  background  color chunck is present in the png-file, or when another color is required this parameter can be used to set the
	      background color of images. This is especially useful for alpha-channel images or those with transparency  chunks.  The  format,	to
	      specify the color in, is either (in the case of orange) "1.0,0.5,0.0", where the values are floats between zero and one, or with the
	      syntax "#RGB", "#RRGGBB" or "#RRRRGGGGBBBB" where R, G and B are hexa-decimal numbers.

       -gamma value
	      Converts the image to a new display-gamma value. When a gAMA chunk is present in the png-file, the image-gamma value will  be  used.
	      When  not, the image-gamma is considered to be 1.0. Based on the image-gamma and the display-gamma given with this option the colors
	      written to the pnm-file will be adjusted.
	      Because the gamma's of uncompensated monitors are around 2.6, which results in an image-gamma of 0.45, some typical situations  are:
	      when  the  image-gamma is 0.45 (use -verbose to check) and the picture is too light, your system is gamma-corrected, so convert with
	      "-gamma 1.0".  When no gAMA chunk is present or the image-gamma is 1.0, use 2.2 to make the picture lighter and  0.45  to  make  the
	      picture darker.

       -text file
	      Writes the tEXt and zTXt chunks to a file, in a format as described in the pnmtopng man-page.  These chunks contain text comments or
	      annotations.

       -time  Prints the tIME chunk to stderr.

       All flags can be abbreviated to their shortest unique prefix.

SEE ALSO

       pnmtopng(1), ptot(1), pnmgamma(1), pnm(5)

NOTE

       Instead of pngtopnm|pnmtoxxx, a specific converter should be used, if available. E.g.  ptot (PNG to TIFF conversion), etc.

BUGS

       There could be an option to read the comment text from pnm comments instead of a separate file.

       The program could be much faster, with a bit of code optimizing.

AUTHORS

       Copyright (C) 1995-1997 by Alexander Lehmann
			       and Willem van Schaik.

								  6 January 1997						       pngtopnm(1)