VBVIEW | VisionX V4 |
vbview − create visualization images from a (vdview) bookmark
SYNOPSISvbview [if=infile] [of=ofile] [zp=number] [n=number] [-a] [-b] [-v]
DESCRIPTIONVbview
will make an image visualization from an annotation (.vxa) or a bookmark file (.bm) such as are created by vdview. The prime function is to create an image as if the bookmark was loaded by vdview but off-line without using vdview. One difference with vdview is that it shows the image that was visible when the bookmark was saved in contrast to the image surrounding the current focal point (which vdview would show on a bookmark load).
The basic operation is to create a 512x512 color index image of the view present when the bookmark was saved. This includes any visible boundary annotations. To do this, the image file is located, the correct portion of the image is selected, windowed and zoomed according to the bookmark and any visible annotations are added.
Since vdview has a simplified interpretation of the VisionX file format, bookmark files and associated boundary files may not exactly match the original images; especially if the images have been clipped from a larger image. Vbview makes appropriate corrections to the boundary file to place the annotations in the correct location.
If the -a option is supplied, then the image created is based on the whole of the input image and all boundary marks are included.
If the -b option is supplied, and the bookmark has an associated boundary, the resulting image will have as many slices as the boundary, with extra frames above and below the region, as specified by zp=. If -b is not used, the result image will only be a single slice. In the case of a bookmark without a boundary, this option has no effect.
If the n= option is supplied, the resulting image will attempt to have n= number of slices. If n= is an odd number, (n-1)/2 image slices are shown before and after the central slice. If n= is an even number, n/2 image slices are shown before the central slice, then the central slice, followed by (n/2)-1 image slices. In the event that n is larger than the number of slices in the image, only the number of slices in the image will be displayed.
CONSTRAINTSWill currently not work with either true color or color index images.
Assumes that, if given a bookmark file name, the boundary file replaces its extension with .bb and, if a .bb file is given, then the extension of the corresponding bookmark file is .bm. Assumes that the image file and boundary file when needed are in a usual known location with respect to the bookmark file.
Does not handle standard input or standard output, only named files.
OPTIONS|
if= |
input file, The input file is a valid annotation (usually with extension .vxa) or bookmark file (usually with extension .bm) | ||
|
of= |
specify the name of the output file | ||
|
zp= |
specify the number of frames to pad the image generated by -b. Default value is 1. Only has an effect with the -b flag. | ||
|
n= |
specify the number of frames the final image should have. This has no effect if -b and zp= are both specified. | ||
|
-a |
create a image that corresponds to the whole image file not just the image view that is associated with the bookmark. | ||
|
-b |
create an image the corresponds to the number of slices in the associated boundary file, plus padding specified by zp=. | ||
|
-v |
verbose operation |
vdview(1)
AUTHORA. Reeves, A.C. Jirapatnakul, A. Biancardi