Vignette Converter

The Vignette Converter (vntc) is a command line utility used to prepare content created with Image Authoring for deployment with Image Rendering.

vntc is located in install_root\ImageServing\bin. It has the following capabilities:

  • Converts primary vignettes to single resolution, multi-resolution, or pyramid production vignettes (see Vignette Scaling).

  • Produces production cabinet and window covering style files (see -resolution and -jpegquality).

  • Can produce different file versions of vignettes, cabinets, and window coverings style files for use with older versions of Image Rendering.

  • Extracts view images from vignettes, either full resolution or thumbnails (see -thumbwidth and -image).

  • Extracts relevant properties from the source file (see -info) and sends them to stdout or an optional log file (see -log).

While the use of vntc is optional, it is highly recommended for best server performance. vntc also implements extensive error checking and can prevent serious server issues, including crashes, when used diligently.

When generating production vignettes, the pixel width of the output vignette (or 0 in case of pyramid or multi-resolution vignettes) is appended to the name of the generated output vignette file. When processing cabinet style files, the output resolution is appended to the output file name. All output files, including the optional thumbnail, image, and log files as well as the production vignette or cabinet style file are placed in the same directory where sourceFile is located (unless -destPath is specified).

vntc limits itself by default to at most 3GB of memory. When Vntc hits this limit it will stop processing and will produce an error. This limit can be changed using -maxmem.


The Vignette Update Tool in Image Authoring can also be used to prepare vignettes for Image Rendering use. Similarly, the Content Authoring Tool is capable of generating cabinet style files for use with Image Rendering. Use vntc if processing is to be automated. The tools in Image Authoring include a graphical user interface, thus are typically easier to use interactively.

See also

Image Authoring Documentation

On this page