[Artwork] / [QisMLib] / [Programmer's Corner]
QisMGbrip AppUsageRequired ArgumentsInput file pathOutput base pathImage resolutionGERBER OptionsWorking directoryQisMFile unitsMax. points per polygonArc resolutionChord errorKeep temporary filesApply TransformationsAdvanced Gerber optionsGDSII/OASIS/DBLOAD OptionsView LayersView CellWindow OptionsLower left upper rightLower left width heightCenter width heightLower left upper right text fileWidth height lower left text fileWidth height center text fileRow column tilesRow column tiles by sizeArbitrary clipsRandomly generated clipsRaster OptionsInvert image polarityReverse raster direction along XReverse raster direction along YImage file formatDithering using a 8x8 Bayer MatrixForce the use of large disk image rasterizationGenerate gray scale imageMisc. OptionsThread controlLoggingRun quietly in the backgroundVersion Historyqismgbrip exe v1.0 2021-06-10
xxxxxxxxxxqismgbrip64.exe {REQUIRED} [GERBER OPTIONS] [WINDOW OPTIONS] [RASTER OPTIONS] [MISC. OPTIONS]
xxxxxxxxxx+input:{gds_oas_dbload_gbr_path}
{gds_oas_dbload_gbr_path} is the path of a valid GDSII/OASIS/DBLOAD or RS274X Gerber filexxxxxxxxxx+out:{output_dir+filename}
xxxxxxxxxx+resolution:{xres}[,{yres}[,{unit}|dpi]]
{xres} and {yres} are the resolution along X and Y respectively. If only {xres} is specified, the resolution is uniform along X and Y (square pixels)
If {unit} is omitted, the resolution values are interpreted as the size of a pixel in the same units as the loaded QisMFile database. See QisMFile units for more information
If {unit} is specified, the resolution values are interpreted as size of a pixel in the specified units. Allowed values are:
inchmilscmmmumnmIf dpi is specified, the resolution values are interpreted as dots per inch
Resolution values can be floating point
xxxxxxxxxx-workdir:{temp_dir_path}
qismgbrpsxxxxxxxxxx-um
QisMFile database is in microns. This will also be the default units for all the command-line parametersQisMFile database is in the same units as the source Gerber file (inch or mm)xxxxxxxxxx-maxpts:{upto_8190}
xxxxxxxxxx-arcres:{degrees}
xxxxxxxxxx-arcsag:{chord_error}[,{unit}]
Specify the chord error for segmenting arc-like edges of polygons
{unit} if specified, can be one of the following:
inchmilscmmmum If {unit} is omitted, the chord error is assumed to be in QisMFile units
If the Arc resolution is specified, the finer of the two values is used
If not specified, a default chord error of 1.0,um is used
xxxxxxxxxx-dbg
xxxxxxxxxx-rotate:{90x}-mirror:x | -mirror:y | -mirror:xy-scale:{sx}[,{sy}]
{sx} is specified, the scaling is uniform ({sx} == {sy}). Otherwise, scaling applied along X and Y separatelyxxxxxxxxxx-advanced:GBR,{option}[,{option}]*
-layers:1,2:2,3,4:4,4:5xxxxxxxxxx-tile:LLUR,{lx},{ly},{ux},{uy}[,{unit}]
Add one tile by specifying it's lower left {lx},{ly} and upper right {ux},{uy} co-ordinates
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx-tile:LLWH,{lx},{ly},{width},{height}[,{unit}]
Add one tile by specifying it's lower left {lx},{ly} and size {width},{height}
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx-tile:CWH,{cx},{cy},{width},{height}[,{unit}]
Add one tile by specifying it's center {cx},{cy} and size {width},{height}
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx@tiles:LLUR,{file_path}[,{unit}]
Specify a list of tiles from a text file at {file_path} where each line is the lower left and upper right co-ordinates of one tile
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx@tiles:WHLL,{file_path},{width},{height}[,{unit}]
Specify a list of tiles from a text file at {file_path} where each line is the lower left co-ordinates of one of many equal sized tiles
{width},{height} is the size of every tile in the file
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx@tiles:WHC,{file_path},{width},{height}[,{unit}]
Specify a list of tiles from a text file at {file_path} where each line is the center co-ordinate of one of many equal sized tiles
{width},{height} is the size of every tile in the file
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx-tiles:RC,{nx},{ny}[,{lx},{ly},{ux},{uy}[,{unit}]]
Break the region on interest into {nx} x {ny} columns x rows of equal sized tiles
{lx}..{uy} if specified are the extents of the region of interest. If omitted, the home view (extents of the design) is the region of interest
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx-tiles:WH,{width},{height}[,{unit}[,{lx},{ly},{ux},{uy}]]
Break the region on interest into equal sized tiles of size {width} x {height}
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
{lx}..{uy} if specified are the extents of the region of interest. If omitted, the home view (extents of the default top cell) is the region of interest
xxxxxxxxxx-tiles:LIST,[{unit}:]{width},{height}{,{cx},{cy}}+
Specify an arbitrary list of points that are centers ({cx},{cy}) of equal sized ({width},{height}) tiles
At least one such point MUST be present
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
xxxxxxxxxx-tiles:RAND,{width},{height},{count}[,{unit}[,{lx},{ly},{ux},{uy}]]
Generate a somewhat uniformly distributed yet randomly located list of equal size ({width},{height}) tiles
{count} MUST be > 0
{unit} if specified associates the co-ordinates of the tile in one of the following:
inchmilscmmmumIf {unit} is omitted, the co-ordinates are assumed to be in QisMFile units
{lx}..{uy} if specified serves as the overall bounds a.k.a region of interest. If omitted, the home view (extents of the design) is the region of interest
xxxxxxxxxx-invert
xxxxxxxxxx-right-to-left
xxxxxxxxxx-bottom-to-top
xxxxxxxxxx-format:TIF | -format:{BTF | TIF8} | -format:RAW | -format:BMP | -format:VBMP | -format:NONE
Specify the output file format (and the file extension)
TIF refers to TIFF file format with packbits compression and 1bit/pixel (bpp)
BTF or TIF8 refers to Big TIFF file format with packbits compression and 1bit/pixel (bpp)
RAW refers to a dump of the raster image with a small header. The header is defined as follows:
BMP is the Bitmap file format without compression and 1bpp
VBMP is same as BMP except that the height parameter in the header is positive (thereby having the same effect at -bottom-to-top depending on how the BMP reader makes use of the height paramter)
NONE generates the raster image but does not write it to disk
Default file format is TIF
xxxxxxxxxx-dither:{0.0_to_1.0}
xxxxxxxxxx-band:{est_buf_size_mb}[,{allocation_scheme}]
If specified and no. tiles = 1, force the rasterizer to use the large disk image technique
By default, the rasterizer uses information such as no. tiles, raster image size and available system memory to determine the best approach for generating raster image(s). The large disk image technique is used only of no. tiles = 1 and the image size > 75% of the available system memory
{est_buf_size_mb} controls how much memory to use for rasterization and formatting (writing to disk). Default is 2048 mb.
{allocation_scheme} controls the ratio of the amount allocated for rasterization and that for formatting depending on performance bottle-neck
{A}{B}{C}{D}{A} * {est_buf_size_mb} / {B}{C} * {est_buf_size_mb} / {D}-band:{1/3 total phys. mem},1111xxxxxxxxxx-grayscale:{sample_rate},{bits_per_px}
If specified, the raster output is converted to gray scale
Only select values are allowed for {sample_rate},{bits_per_px} based on the desired format as shown below:
| Format | {sample_rate},{bits_per_px} |
|---|---|
TIF, BTF, NONE | 2,2 2,4 2,8 4,4 4,8 8,8 |
BMP, VBMP | 2,4 2,8 4,4 4,8 8,8 |
xxxxxxxxxx-thrnum:{primary}[,{secondary}]
Control the number of threads to be allocation to different parts of the operation
For importing Gerber, no. threads = greater value of {primary} and {secondary}
For rasterization, the use of {primary} and {secondary} depends on the rasterization technique used
For ONE tile :-
{primary} controls the no. sub-bands to be rasterized in parallel and {secondary} controls the no. threads to rasterize each sub-band{primary} and {secondary}For more than one tiles :-
{primary} controls no. tiles to be rasterized in parallel and {secondary} controls no. threads to rasterize each tileDefault: {primary} = {secondary} = no. cpu(s) / 2
xxxxxxxxxx-log:{new_log_file_path} | -log+:{append_log_file_path}
xxxxxxxxxx-silent