VDRAWSPH | VisionX V4 |
vdrawsph − draw colored circles/spheres at specified locations in an image
SYNOPSISvdrawsph if=<inputfile> of=<outputfile> f=<featurefile> [r=<float>] [xy=<float>] [z=<float>] [tl=<int>] [th=<int>] [l=<int>] [-c] [-2d] [-t] [-r] [-z] [-v] [-h]
DESCRIPTIONvdrawsph draws spheres at locations specified in feature file. Alternatively, circles may be drawn on the axial slices using -2d flag.
The feature file should be a VisionX file with the list of V3D elements indicating the center coordinates of the spheres. The radius of a sphere (in mm) may be specified with VX_GFLOAT element and should be included before V3D elements. One VX_GFLOAT element sets the radius of all subsequent V3D elements before another VX_GFLOAT element. When no VX_GFLOAT element is found, default value is used. Alternatively, the feature file can be an ascii text file (when -t flag is used). The format for ascii feature file is "x,y,z,radius" on each line.
The radius may be specified using [r=]. This value is used when radius is not specified in the feature file. (Default = 10 mm)
The resolution of the image is specified in mm/voxel using [xy=] and [z=]. When the resolutions are not passed in, default value of 1.0 is used for all dimensions.
The program allows the user to specify the window of pixel values that the output image should contain. The program clips the image intensities from [tl=] to [th=] and scales from 0 to 254. The intensity of 255 is reserved for marking spheres/circles.
When -c flag is used, the spheres/circles are marked using color using "split" look-up table. In this case, the intensities are clipped from [tl=] to [th=] and scaled from 128 to 255. The default marking intensity for color mode is 127 (red). Other colors may be specified using [l=].
When not specified, [tl=] and [th=] are set to the minimum and maximum intensities from the input image, respectively.
CONVENTIONSAccepts as input any VisionX format image Outputs a byte image with circles/spheres drawn.
OPTIONSif=<input filename>
Specifies the input file name
of=<output file>
Specifies the output file name
f=<feature file>
Feature input file
|
r=<float> |
Radius (mm) to use when not specified in feature file (default=10.0) |
xy=<float>
XY resolution (mm/voxel) of input image (default=1.0)
|
z=<float> |
Z resolution (mm/voxel) of input image (default=1.0) | ||
|
tl=<int> |
Low image value for windowing (default=lowest) | ||
|
th=<int> |
High image value for windowing (default=highest) | ||
|
l=<int> |
Label to draw circles/spheres (default=white, red when -c is used) | ||
|
-c |
Use color labels (using "split" look-up table) | ||
|
-2d |
Draw a circle on axial slice | ||
|
-r |
render squares(rectangles)/blocks rather than circles/spheres | ||
|
-z |
set the background value to zero. | ||
|
-t |
Read feature file as an ascii file | ||
|
-h |
Ascii feature file as header line | ||
|
-v |
Verbose option |
A.A Enquobahrie, A. Browder, J. Lee