Common options common-options

-destpath string

Folder in which output files are to be placed (including the log file, if -log is specified). It can be an absolute path or a relative path to the current working directory. The folder hierarchy is created if it does not exist, however, it does not apply to the file specified with -log . If not specified, output files are written to the folder in which the sourceFile is located. If destFile is specified, it is always written to that location, and -destpath only applies to the secondary output files.

-image

If specified, the (first) view image is extracted from the vignette, a suitable panel image from a cabinet style, or the first illumination image of a window covering style. The extracted image is saved as a full-resolution TIFF file.

-info

Prevents generation of target files. Useful to quickly extract attributes from a sourceFile . Only the optional thumbnail ( -thumbwidth ), image ( -image ), and log files ( -log ) are generated.

-jpegquality ival

Selects lossy JPEG encoding for RGB and gray-scale image data embedded in the output file, instead of lossless PNG. Images with alpha (RGBA) are always saved using PNG encoding. ival specifies the JPEG quality (1...100); 85 or higher is recommended. The default is -jpegquality 0 , which selects PNG encoding.

-log path

Creates a log file with the specified path/name. The full paths of all output files written to the destination folder are written to the log file, and some additional settings, such as version info and any warnings or errors encountered (see Outputfor details). No log file is created if -log is not specified; in this case, all text output is written to stdout .

-lowerpriority ival

Lower the priority of the vntc process. This process can be used so that vntc does not take over an entire CPU while processing a vignette. It allows the operating system to give more time to other, more important, processes. ival specifies the lower priority percentage (0..100). The default is -lowerpriority 0 , which does not lower the priority of the vntc process.

-maxmem ival

Specify the maximum amount of memory that vntc is allowed to use in bytes. When vntc reaches the maximum memory limit, it stops processing and produces an error. The ival specifies the maximum memory limit in bytes (0.. 3,758,096,384 (3.5 GB)). When ival is 0, the maximum memory limit is turned off. The default is -maxmem 3221225472 , which means a maximum memory limit of 3 GB.

-separator " string "

Specifies the separator placed between the filename and the size/resolution suffix for auto-generated output file names. Defaults to "-" if not specified. Ignored if destFile or -info is specified.

-sharpen ival

Enables sharpening of images resampled (scaled) during processing. Only applies to thumbnail sharpening in cabinet-style files.

Specify 0 to disable sharpening (default), 1 to enable normal sharpening, 2 to enable unsharp-masking for brightness only, or 3 to enable unsharp-masking for each color component.

-tracelevel

Sets the log level. The default is 1, which outputs all informational, warning, and error messages. Set to 0 to disable all but error messages.

-usm amount radius threshold

Sets the unsharp-masking parameters. Ignored if -sharpen is set to 0 or 1; required if -sharpen is set to 2 or 3. The amount is a real value in the range 0.0...500.0, the radius is a real value in the range 0.0…10.0, and the threshold is an integer from 0 through 255. See the description of op_usm= in the Image Serving Protocol Reference for additional information.

-validateproduction ival

Validate that the given vignette is a proper production vignette. The ival represents the minimum file version of the vignette.

-version ival

File version for the output file. If specified, it must be 0 or a valid vignette file version (no larger than the default file version). If set to 0 or not specified, the output file is created using the most current file version. Ignored if -info is specified.

-versioninfo

Returns version information for this utility. Specify without filename and other options.