ROTBIT

Description

Rotates bitmap data in an image file by 90 degrees, 180 degrees or 270 degrees.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO *	String	Output file name	1 - 192
DBIB *	Integer	Input bitmap segment	1 -
ANGLE *	Integer	Rotation angle (degrees)	1 - 1
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the PCIDSK image file containing the bitmap to rotate.

FILO

Specifies the name of the PCIDSK image file to receive the rotated bitmap. If the specified file does not already exist. it will be created.

If the specified rotation angle (ANGLE) is 90 or 270 degrees, the output file must have exactly as many lines as the input file has pixels, and exactly as many pixels as the input file has lines. If ANGLE is 180 degrees, the output file must be exactly the same size as the input file, and may be the same file.

DBIB

Specifies the input bitmap segment(s) to be rotated.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

ANGLE

Specifies the clockwise angle (in degrees) by which to rotate the input bitmap(s).

Supported rotation angles are 90, 180 or 270 degrees.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

ROTBIT rotates specified bitmap segment(s) about the bitmap center, by an angle of 90, 180 or 270 degrees.

The result is placed in a newly created bitmap segment(s) in the output image file.

If the angle of rotation (ANGLE) is 90 or 270 degrees, the output file must have exactly as many lines as the input file has pixels, and exactly as many pixels as the input file has lines. If ANGLE is 180 degrees, the output file must be exactly the same size as the input file, and may be the same file.

If the output file (FILO) does not already exist, it will be created with the appropriate size to contain the results.

Examples

A large plot (10,000 pixels by 2000 lines) has been generated to print on the CalComp Electrostatic Plotter. If printed directly using the CALCOMP function, the plot will be produced as several short strips which must be pasted together. To avoid this, ROTBIT is used to rotate the plot into 2000 x 10000 which will all fit on one strip.

EASI>fili	=	"plotwide.pix"	! input plot file
EASI>filo	=	"plotlong.pix"	! output plot file
EASI>dbib	=	1,2,3	! bitmaps to rotate
EASI>angle	=	90	! rotate 90 degrees

EASI>RUN ROTBIT

Rotate channels 9, 10, and 11 in the input file by 180 degrees.

EASI>fili	=	"irvine.pix"	    ! input file
EASI>filo	=	"rotate_bit.pix"	! output file
EASI>dbib	=	9,10,11	            ! bitmaps to rotate
EASI>angle	=	180	                ! rotate 180 degrees

EASI>RUN ROTBIT