Command Line and Configuration File

QmRTCR can be run via a command line and a configuration file which contains arguments and directives. This is much "cleaner" than attempting to put a large number of arguments on the command line.

The Command Line

qmrtcrclient64.exe @config_file -log:log_file

where

qmrtcrclient64.exe             full path to the RTCR client

@config_file                   the @ indicates to read from a config_file
                               specify the full path and name of the configuration 
                               file

-log:log_file                  full path and name of the log file

The Configuration File

The configuration file will contain at least one job directive. The job directive will point to the input file and the output directory; following the job directive will be all of the arguments associated with this job (One line per argument.).

Input File and Output Directory

+job:{input_file_path},{output_dir_path}

Resolution (Either DPI or Pixel Size) If only one value
is specified then it applies to both X and Y directions.

[-dpi:{dpix}[,{dpiy}] | -pixelsize:{sizex}[,{sizey}]]

Correction and Path to File containing Correction Coordinates

[-correction:{correction_file_path}[,{tolerance}]

Annotation: file containing annotation text and position.

[-annotation:{annotation_file_path}]

Invert the polarity of the image

[-invertimage]

If shift is used, sets the pixel polarity

[-shift:INS_WHITE | -shift:INS_BLACK | -shift:REMOVE]

Used to insert/shift a column into the output file

[-colshift:{col_px},...{col_px}]*

Used to insert/shift a row into the output file

[-rowshift:{row_px},...{row_px}]*

Produce grey level output; specify level and specify layers for gray

[-graylayers:{grey_level},{layer_list}]

Select bitmap output format

[-tiff:packbits | -tiff:bmp | -tiff:raw | -tiff:none]

If present, reverses pixel order from left-to-right to right-to-left

[-right-to-left]

See Documentation for details

[-mask:{minx},{miny},{maxx},{maxy}]

Number of concurrent threads to use. (Default = number of cores)

[-thrnum:{n_threads}]

Tiling (breaking output bitmap into multiple tiles) Select one of the
various options below:

  [-tile:{minx},{miny},maxpt:{maxx},{maxy}]*

  [-tile:{minx},{miny},tilesz:{width},{height}]*

  [-tile:{minx},{miny},tilebuf:{size_mb}]*

  [-autotiles:{roi_minx},{roi_miny},{roi_maxx},{roi_maxy},ntiles:{nx},{ny}]

  [-autotiles:{roi_minx},{roi_miny},{roi_maxx},{roi_maxy},tilesz:{width},{height}]

Tile Reference for Bitmap

[-origin:LL | -origin:LR | -origin:UL  | -origin:UR]

Tile generation and indexing Direction

[-direction:up | -direction:down | -direction:left | -direction:right]

Only rasterize this tile (based on index number)

[-only:{tile_num}[,{tile_num}]*

Only keep results for this tile

[-keep:{tile_num}[,{tile_num}]*

Turn on debug mode (generates additional diagnostics for debugging problems)

[-dbg]

Examples of the command line and Config File

Consider the case where we have installed QmRTCR in the following location:

C:\WCAD\QmRTCR64

The client software, QmRTCRclient64.exe will be found in the directory:

C:\WCAD\QmRTCR64\artwork

Let's also say that our GDSII file and our config file is located in the directory: D:\cad_data\raster and that we have created a subdirectory callled output to hold our bitmaps.

Then our command line will look like this: (carriage returns added for clarity)

C:\WCAD\QmRTCR64\artwork\QmRTCRclient64.exe       full path to client software

@D:\cad_data\raster\p1.cfg                        full path to config file

-log:D:\cad_data\raster\p1.log                    full path to log file

Our config file, p1.cfg, might contain the following job directives and associated arguments. (We have three separate rasterization jobs embedded into a single config file.

## notice that this job uses DPI instead of pixel size
+job:D:\cad_data\raster\p1.gds,D:\cad_data\raster\output\p1_job_1
-dpi:2540
-tiff:packbits
-autotiles:-6350.000,-6350.000,552450.000,615950.000,ntiles:4,4
-origin:LL
-direction:right

## Notice that this job has correction and annotation turned on
+job:D:\cad_data\raster\p1.gds,D:\cad_data\raster\output\p1_job_2
-annotation:D:\cad_data\raster\p1_annotations.txt
-correction:D:\cad_data\raster\p1_correction.txt
-pixelsize:10
-tiff:packbits
-autotiles:-6350.000,-6350.000,552450.000,615950.000,ntiles:4,4
-origin:LL
-direction:right
-keep:4,13


+job:D:\cad_data\raster\p1.gds,D:\cad_data\raster\output\p1_job_3
-pixelsize:10
-tiff:packbits
-autotiles:-6350.000,-6350.000,552450.000,615950.000,ntiles:4,4
-origin:LL
-direction:right
-invertimage
-mask:0,0,400000,400000
-only:1,2,3,5,6,7,9,10,11