DocumentationDynamic Media Image Serving and Rendering API

validate

Last update: June 6, 2024
  • Topics:
  • Dynamic Media Classic,SDK/API

CREATED FOR:

  • Developer
  • User

Image validation utility. This command-line utility verifies image files to make sure they are valid and can be read by Image Serving without difficulty.

All non-PTIFF image files must pass validation before the file is made available to Image Serving as a source image. PTIFF images should be validated after potentially unreliable copy operations.

Usage

validate *fileType* [ *options*] [ *sourceFile* [ … ]]

fileType

-jpeg | -ptif | -any

Source file type; at least one must be specified (-any allows the same image file types supported by IC).

optionsOther command options (see below).
sourceFileImage file. None or more, separated by spaces.

Returns

0 if successful. If an error occurs, a non-zero value is returned and error details are sent to stderr.

Options

-fileList listFileSpecifies a separate text file containing the list of image files. One record per file. If -fileList is included, sourceFile must not be specified.
-readPixelsEnables verification of the entire image file. By default, only the image header is validated.
-validatecolorprofileVerifies the embedded color profile for validity. By default, the body profile is not checked.
-reject16BitPerComponentRejects images with 16 bits per image component. Always specified by the Image Server when it validates remote source images.
-verbosePrints more information if the image is invalid.
-silentDisables stdout / stderr output. Only a status is returned.
-stopOnErrorTerminates processing when a file validation failure occurs, even if additional files are yet to be validated. By default, processing continues when a validation error occurs
-versionReturns version info for this utility. Specify with no other options.
recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49