VIBBOX

VisionX V4

NAME

vibbox − Change the bounding box of a VisionX file

SYNOPSIS

vibbox [if=<infile>] [of=<outfile>] [bb=] [off=] [x=] [y=] [z=] [-z] [-xy] [-f3d]

DESCRIPTION

Vibbox allows for the manipulation of bounding boxes for image files. The bounding box can be manually specified, or bounding boxes can be computed given an offset or new lower left bounding box position.

CONSTRAINTS

This program will work on any VisionX file that contains a bounding box, though it will not correct data elements.

Manually specifying a bounding box with bb= only works if the image size is unchanged. The program will report a warning if this is the case and will not produce an output file.

Vibbox will work with all bounding boxes in an image. Changing the lower corner of the bounding box using the x=, y=, or z= options sets the first bounding box in the image to the appropriate location.

In the case of an image file with 3D images separated by frame markers (as opposed to 3D image files with slices separated by frames), the -f3d option must be used. Using this option, the bounding box will be recomputed for each frame. In addition, the bb= option will not work unless the 3D images are the same size.

Frame marker values are not altered by this program.

For a 2D image, the if the z-coordinate is unchanged, the zlo and zhi coordinates will remain at 0. If the z-coordinate is changed, zhi will be set to one higher than zlo to match the convention for 3D images.

There will be unpredictable results if several different options are specified.

OPTIONS

	if=		A VisionX image file
	of=		A VisionX image file with altered bounding box(es).

bb=<xl,xh,yl,yh,zl,zh>

Manually specify the bounding box definition. New bounding box must not change the image size.

off=<x,y,z>

Specify offsets to use to compute the new bounding box. The values will be added to the respective parts of the bounding box.

	x=<x>
	y=<y>
	z=<z>		Position the lower corner of the bounding box at the position specified by x,y,z. The upper bounds of the bounding box will be recomputed to maintain the same size. If one of the parameters is not specified, it will be left unchanged.
	-z		Rescale bounding box so that xl = yl = zl = 0.
	-xy		Rescale bounding box so that xl = yl = 0; the z dimension will not be affected.
	-f3d		Assume the file contains 3D images separated by frame markers (instead of image files where each image slice is separated by a frame). In this case, the z value will be reset between frames if the z= option is specified and the x and y values will be recomputed (otherwise they are determined from the first frame).

AUTHOR

A. Jirapatnakul and A. P. Reeves