Gamma LAT: Reference Manual

ras_ras

ANSI-C program: ras_ras.c

NAME
ras_ras - Multilooking and left/right flipping of images in SUN raster of BMP image format

SYNOPSIS
ras_ras <ras_in> <ras_out> <col_looks> <row_looks> [LR] [red_lin/log] [green_lin/log] [blue_lin/log]

<ras_in>	input SUN raster or BMP format image (8 or 24 bits/pixel)
<ras_out>	output SUN raster or BMP format image (8 or 24 bits/pixel)
<col_looks>	number of column looks to use in multilooking
<row_looks>	number of row looks to use in multilooking
[LR]	left/right flipping flag (default: 1=normal, -1=mirror image)
[red_lin/log]	lin/log scale red channel (default=0: linear scale data, 1: log scale data)
[green_lin/log]	lin/log scale green channel (default=0: linear scale data, 1: log scale data)
[blue_lin/log]	lin/log scale blue channel (default=0: linear scale data, 1: log scale data)
[force24]	force 24 bits/sample output

EXAMPLES
ras_ras 1825_1868.pwr1.ras 1825_1868.pwr1.3x3.ras 3 3 -1
3x3 multilooking of 8-bit SUN raster file (grey scale image).

ras_ras 1825_1868.flt.ras 1825_1868.flt.ras 1 1 -1
Left/right flipping of 8-bit SUN raster file (image with color table).

ras_ras 1825_1868.rgb.bmp 1825_1868.rgb.5x5.bmp 5 5 1 0 1 0
5x5 multilooking of 24-bit BMP image file. For the second (green channel) logarithmic scale has been selected.

INSTALLATION
Source code ras_ras.c in $LAT_HOME/src. For compilation adjust and use Makefile: Executable version ras_ras in $LAT_HOME/bin

AVAILABILITY
Uses display programs definition file display.h, SUN raster file definition file rasterfile.h, and BMP format definition file, bmp_image.h.

DESCRIPTION
ras_ras reads input images with 8-bit or 24-bit format (SUN raster or BMP format), interprets the color table (if necessary), applies multi-looking in column and row directions, and finally writes out the multi-looked image. Left/right flipping of the image may be applied.

The lin/log flags allow to indicate that the data of a specific channel of the images was generated using logarithmic (dB) scaleing. When this option is selected the lograithmically scaled values are converted back to linear scale prior to the multi-looking. The multilooked values are again converted back to logarithmic scale prior to being written out.

Notice that 24-bit output images are generated when multi-looking 8-bit input images with color tables that are not greyscale .An eample for this case is the multilooking of images containing interferometric phase and image intensity.

OPTIONS
None.

SEE ALSO
display.h, rasterfile.h, bmp_image.h

DIAGNOSTICS
All messages are generally self-explanatory.

NOTES
May also be used to convert between formats and change an 8-bit image into a 24-bit/pixel image.