vbrand − add or validate image resolution or scale

vbrand [if=infile] [of=ofile] [-v] [x=] [y=] [z=] [u=] [s=] [i=]

vbrand adds information to the image history that specifies image pixel resolution and pixel scale values. It has two modes of operation; a legacy implicit mode for DICOM images and an explicit mode that is available for all images.

The legacy implicit operation is selected when no parameter options are specified. In this case, the information for a DICOM image is marked as "still valid" by adding a line "vdcme -brand" to the end of the file history.

In the explicit mode scale and size parameters specified in the command line are copied into the last line of the file history.

Commands that require scale and size information obtain it from the last line of the file history; if the implicit mode is specified then the parameter values are extracted from the body of the file history (assuming that the file was created with vdcmtovx). In the explicit mode, values for parameters explicitly specified in the vbrand command line are used.

By default VisionX commands add a new line to the end of the file history and this invalidates the branding since the command may have modified the image and changed the image scale or image resolution. Scale aware commands may add a vbrand line to the beginning of the file history; alternatively, a processed image file may be rebranded by using the vbrand command.

-v

The verbose option

if=<fname>

specifies the input image file name.

of=<fname>

This specifies the output file name

x=<value>

This specifies the size of the pixels in the x direction (default 1.0)

y=<value>

This specifies the size of the pixels in the y direction (default 1.0)

z=<value>

This specifies the size of the pixels in the z direction (default 0.0) which implies a 2D image.

u=<value>

This specifies the units of the pixel size. Currently, two units are defined: pixels units are 0 and millimeter units are 1. By default pixels are specified for when there is not branding by default and mm are specified when either implicit branding or when the x= parameter is specified.

s=<value>

This specifies the slope of the pixels direction (default 1.0)

i=<value>

This specifies the intercept value for pixel scaling (default 0.0)

A. P. Reeves

VXgetresinfo(3)