Draw reads a CSV file and then writes tiff images, as is provided as a companion tool to -write. The writer function embeds dynamically drawn images directly into the x9.37 file that is being constructed, while draw can be used to create those images and directly save them to external tiff files, instead of inserting them into the type 52 records. Draw can be used to create single page tiff’s for the front-back images, but can also be used to create multi-page tiff images, which will be a single tiff image that contains both the front and back within a single image file.
Command line options
| Switch | Description |
| -dpi: | Assigns the output image dpi used to draw images, with a default of 240. Assigned values must be either 200 or 240. |
| -l | Will list all incoming csv lines to the log. |
| -batch | Invokes batch (folder based processing; see that earlier topic for more information. |
| -workUnit: | Assigns command line parameters and files from an xml file that was previously created and saved by the X9Utilities facility within X9Assist. This allows you to easily repeat an X9Assist task directly in X9Utilities batch. |
Draw csv line types
| Switch | Description |
| imageFolder | Defines the folder used to load template images that are referenced when drawing images from pre-constructed templates. The folder name is provided as the second parameter, and typically would always be enclosed in quotes since it may contain embedded blanks. |
| outputFolder | Defines an optional high level folder to be used when writing the output images. This line is not needed when the output image file names are fully qualified. The output folder name can be changed as often as desired. The folder name is provided as the second parameter, and typically would always be enclosed in quotes since it may contain embedded blanks. |
| paidStamp | Defines a paid stamp to be applied to back-side images. The paid stamp is optional and can appear as often as needed within the csv file, and must appear before the items to which it applies. The paid stamp can appear as often as needed within the csv file, even at the item level. |
| item | Provided information about each logical item to be drawn. Columns are as follows: Auxiliary OnUs External Processing Code (EPC) Routing OnUs Amount Identifier (any string you desire; for example the item sequence number) Front image file name Back image file name. This file name can be defined as “omit”, which means that the back side image will not be created. It can also be defined as “multi”, which means that a multi-page tiff image is to be created that contains the front and back side images within a single tiff file. |
| drawImages | Provides information for the two images that are to be drawn. Refer to the -write function for documentation and usage. |
Command line examples
x9util -draw <input.csv>
reads <input.csv> and creates images per the item level csv lines.
x9util -draw <input.csv> <output.csv>
reads <input.csv> and creates images per the item level csv lines. The output csv is essentially an echo of the input csv, but also contains confirmation of each of the images that are created including their file size.