QisMOdbrip Web Page Header

QisMOdbrip - High Performance ODB++ Raster Application

This application is a very high performance rasterizer for ODB++ data. It replaces ODBRIP our previous high performance ODB++ RIP.

Further, this new RIP operates inside of our QisMLib framework which makes adding functionality to the rasterizer much easier due to the modular approach to handling large amounts of vector and bitmap data. It relies on QisMLib, QisMRaster, QisMOdbScan, and QisMOdbPS.


Usage

The application is driven from a command line. A summary of the command line and it's arguments is shown below:

qismodbrip64.exe {REQUIRED} [APP OPTIONS] [ODB OPTIONS] [OUTPUT OPTIONS] [G2K OPTIONS] [ADVANCED OPTIONS]

Required Arguments

Input ODB++ file

-job:{path_to_odb_file}

path_to_odb_file is the path of a valid ODB file


Output Directory

-outdir:{path_to_output_directory}

path_to_output_directory is the path to a valid directory for output.


Temporary Working Directory

-workdir:{path_to_working_directory}

path_to_working_directory is the path to a valid directory for temporary working files.


Step and Layer(s) to Process

-step:{stepname[,layer1,layer2,...]}

stepname is a valid stepname from the ODB input file
The layers listed after the stepname are optional and specific layers you want to process
If no layers are provided then all relevant layers from the stepname will be processed.


Application Options

Silent Mode

-silent

Enables silent mode so no messages will be sent to STDOUT


Logging to a Specific File

-log:{path_to_logging_file}

path_to_logging_file is where the logging messages will be saved
By default logging is enabled and will use the output file name as the basename


Keep Temporary Working Files

-keep_tmpfiles

Prevents clean up of the temporary working files located in the working directory.


Maximum Thread Usage

-thrnum:{integer}

Set the maximum number of threads availble for execution.


Raster Buffer Size

-ram:{integer}

Sets the maximum raster buffer size with a minimum of 200MB.



ODB++ Options

ODB Scan Mode

-scan_mode:{board_only | net_layers}

board_only filters the ODB file and required the layers' context to be "board only"
net_layers filters the ODB file and only processes net specific layers
By default there is no filtering and all layers will be processed regardless of context or type


Dynamic Time Strings

-defdate

Disables dynamic time strings.


Step Repeat Optimizations

-nosropt

Disables step repeat optizimation.


ODB File Reading in Place

-nocopyin

Use/modify the ODB++ file in place.


Exclude Specific Layers

-excludel:{layer1[,layer2,...]}

Provide a list of layernames to be excluded during processing.


Filter Textual Fonts

-filter_barc

Enable filtering of barcode fonts.
Barcodes from fonts will be ignored.


Cutline Mode for Unionization

-cutlines

Enables cutlines as the mode for unionizing.
By default butting is used .


Poly Edge Patch

-polyedge

Enables butting or cutline edge patch.


Counter Clockwise Rotation Mode

-cc_ir

Enables counter clockwise rotation for IR.



Output Options

Output Basename Prefix

-out:{basename}

Uses the basename as a basename for the output.
i.e. 'basename_layername.tif'
By default the name will be derived from the 'layername' being processed


Output Format - PACK

-pack

Sets output type to be TIFF (packbits)


Output Format - TIFF

-tiff

Sets output type to be TIFF (packbits)


Output Format - BIG TIFF

-bigtiff

Sets output type to be Big TIFF (packbits)


Output Format - BMP

-bmp

Output file is type BMP (unencoded)


Dots per Inch

-dpi:{double}

Sets the dots per mm


Pixel Size

-pixelsize:{double}

Sets the pixel size in the units provided. Default is 0.005 in mm


Units of Conversion

-unit:{inch | mm}

Sets the unit of conversion to inch or mm.
By default the unit is mm


Arc Resolution

-arcres:{double}

Sets the Arc Resolution.
The default auto-selects a value based on the data


Arc Sag

-arcsag:{double}

Sets the arc sag (also called Chord Error).
The default auto-selects a value based on the data


Complement / Inverse Polarity

-complement

Reverses the polarity of the bitmap.


Align Output Mode

-align

Align all rip output to the profile extents


Profile Extents Mode

-profile_extents

Use the profile extents instead of the data extents


Margin

-margin:{double}

Adds a margin in the units specified


Out Scale Mode

-out_scale:{default | sf | scale | local}

Sets the out_scale mode of conversion.
This requires g2k_ver be set to 0


Window Clip - Extents

-extents:{LLx,LLy,URx,URy}

Sets the window clip.
Format is: Lower Left X, Lower Left Y, Upper Left X, Upper Right Y


Window Clip - Window

-window:{LLx,LLy,URx,URy}

Sets the window clip.
Format is: Lower Left X, Lower Left Y, Upper Left X, Upper Right Y


Super Sample Mode

-super:{2 | 4 | 8 | 28 | 48}

Enables super sampled output.
28 is the same as -super:2 but each sample is saved in 8 bits.
48 is the same as -super:4 but each sample is saved in 8 bits


G2K Options

Genesis Emulation Version

-g2k_ver:{0 | 1 | 2 | 3}

Set genesis emulation version


Genesis Tranlation Order

-g2k_order:{0 | 1 | 2}

Sets the translation order (2 is no mirror)


Genesis Step Repeat Mode

-g2k_break_sr:{0 | 1 | 2}

Sets "break SR" on or off


Genesis Scaling Mode

-g2k_scale_mode:{1 | 2 | 3}

Sets scaling mode


Genesis Scaling

-g2k_scalexy:{x,y}

Overrides 'out_x_scale' and 'out_y_scale'


Genesis Anchor Mode

-g2k_anchor:{0 | 1 | 2 | 3}

Sets anchor mode


Genesis Anchor (inch)

-g2k_inch_anchor:{x,y}

Sets anchor inch value


Genesis Offset Mode

-g2k_offset:{0 | 1 | 2 | 3 | 4 | 5}

Sets offset mode


Genesis Offset (inch)

-g2k_inch_offset:{x,y}

Sets offset inch value


Genesis Offset (mm)

-g2k_mm_offset:{x,y}

Sets offset mm value


Advanced Options

Advanced Options for Odb2Gdx Engine

-engargs {arguments_to_pass} -eng_arg

Passes the option(s) listed in arguments_to_pass to the odb2gdx engine.
-end_arg must be present after the last option listed






Platform

Linux - RHEL5 64 or later
(and equivalents)

Windows - Win 10/11
64 bit version

Documentation

C++ APIs

QisMScript Commands and equivalent C++ code

Console Application for Exercising the Library