[Artwork] / [QisMLib]

QisMSnPUtil Extension

Welcome to the reference page for QisMSnPUtil, an extension of QisMLib, Artwork Conversion's CAD processing framework.

QisMSnPUtil works with paint and scratch databases. These arise when printed circuit board artwork, in Gerber or ODB++ form, is converted to GDSII, one of the two standard formats for storing chip layouts. Instead of holding only the final shapes, such a database keeps a sequence of layers that either add material (paint) or remove it (scratch), and the true picture appears only when that sequence is played back in order. The extension does the playback. It has three jobs:

  1. Extract the polygons inside any rectangular window of such a database, either as the resolved positive-only shapes or as the original ordered paint and scratch sets.

  2. Unionize an entire database into a positive-only GDSII or OASIS file on disk, processing the design as a set of tiles in parallel.

  3. Compare two such databases with a boolean operation such as OR, AND, XOR, union or difference, and write the result to a file.

This page is the complete reference for the extension. Here is what you will find, in the order it appears:

If you just want to produce a positive-only file, go straight to the script commands. If you are using the API into your own software, start with the C++ programming interface and keep the licensing rules in mind.

QisMSnPUtil ExtensionQisMSnPUnion C++ API (qismsnpunion.h)QisMSnPSpec_pQisMSnPOUnitsQisMSnPONewExpFlg_IPNEGKey_IGNLAYERSKey_AFFINEAdd_AFFINE_TXYAdd_AFFINE_ANGLEAdd_AFFINE_SCALEAdd_AFFINE_SHEARAdd_AFFINE_FLIPKey_CORRXQisMSnPOExplodeKey_THRNUMKey_SLIVERKey_BUTTINGFlg_NOSTRIPESKey_SIZINGKey_DBGFlg_CONVEXKey_LAYERKey_RESERVEKey_MAXVERTFlg_CUTLINESQisMSnPOUnionKey_THRNUM_TILESKey_FORMATVal_FORMAT_OASISKey_LOUTKey_TOPKey_AFFINEAdd_AFFINE_TXYAdd_AFFINE_ANGLEAdd_AFFINE_SCALEAdd_AFFINE_SHEARAdd_AFFINE_FLIPKey_CORRXQisMSnPExplodeCbVersion Control (QisMSnPExplodeCb)On_scratch_or_paint_boundariesOn_scratch_or_paint_boundaryGet_scratch_or_paint_error_msgMETAKEY_LAYER_NAMEMETAKEY_SEQQisMSnPExploderVersion Control (QisMSnPExploder)Get_error_msg (QisMSnPExploder)Get_error_condition (QisMSnPExploder)Get_error_context (QisMSnPExploder)Get_boundariesGet_specQisMSnPExploderV2Get_boundaries_paint_scratchQisMSnPUnionVersion Control (QisMSnPUnion)Get_error_msg (QisMSnPExploder)Get_error_condition (QisMSnPExploder)Get_error_context (QisMSnPExploder)Create_exploderDestroy_exploderUnionize_to_fileQisMSnPUnionV2Booleanize_two_filesBooleanize_two_files OptionsQisMSnPUtil Commandssnputil.create_explodersnputil.destroy_explodersnpexploder.get_boundariessnpexploder.destroy_storesnputil.unionize_to_filesnputil.booleanize_two_filesQisMSnPUnion Licensing (API)QisMSnPUtil Licensing (Script)QisMSnpUtil Version Historyqismsnputil dll 1.4.2 09-2026qismsnputil dll 1.4.1 06-2025qismsnputil dll 1.4 19-05-2025qismsnputil dll 1.3 24-07-2024qismsnputil dll 1.2 11-2022qismsnputil dll 1.1 03-2022


QisMSnPUnion C++ API (qismsnpunion.h)

QisMSnPSpec_p

Opaque handle to an object that holds the paint&scratch metadata

QisMSnPOUnits

Acceptable unit specifiers for relevant parameters

QisMSnPONewExp

Parameters that represent information used for creating the QisMSnPExploder

Flg_IPNEG

When used, it indicates that the design has a negative polarity

Key_IGNLAYERS

When used, the specified set of layers (as a comma-separated string) indicates the layers that are to be used for extents calculation but not for it's actual geoemtries (e.g margin around the whole design)

Key_AFFINE

Add_AFFINE_TXY

Add_AFFINE_ANGLE

Add_AFFINE_SCALE

Add_AFFINE_SHEAR

Add_AFFINE_FLIP

Apply affine transformation to all output polygons

Key_CORRX

QisMSnPOExplode

Parameters that control the explosion

Key_THRNUM

Specify the number of threads to be used for boolean computations

Key_SLIVER

Specify the sliver value for filtering tiny output polygons

Key_BUTTING

Convert polygons with holes to butting polygons with a specific overlap

Flg_NOSTRIPES

Remove partitioning lines from the output

Key_SIZING

Specify sizing along X and Y

Key_DBG

Generate debug data for daignostics & troubleshooting

Flg_CONVEX

Ensures that each output polygon is convex in X and Y

Key_LAYER

Sets a target layer:datatype for the output polygons

Key_RESERVE

Pre-allocate memory to store polygon data

Key_MAXVERT

Specify the max. num vertices for any polygon (default 8190)

Flg_CUTLINES

When specified, polygons with holes will be converted into a single polygon with cutlines

QisMSnPOUnion

Parameters that flavor the whole db unionization

Key_THRNUM_TILES

Set the number of tiles to be processed in parallel

Key_FORMAT

Val_FORMAT_OASIS

Output unionized data as an OASIS file

Key_LOUT

Specify a layer,datatype for output polygons

Key_TOP

Set the output (top) cell name

Key_AFFINE

Add_AFFINE_TXY

Add_AFFINE_ANGLE

Add_AFFINE_SCALE

Add_AFFINE_SHEAR

Add_AFFINE_FLIP

Apply affine transformation to all output polygons

Key_CORRX

QisMSnPExplodeCb

Callback for receiving polygons from the QisMSnPExploderV2

Version Control (QisMSnPExplodeCb)

Cast to a pointer of another version in the class hierarchy (base/derived)

On_scratch_or_paint_boundaries

On_scratch_or_paint_boundary

Callback to receive one or more polygons

Get_scratch_or_paint_error_msg

Return an error message string to explain the reason for terminating the explosion

METAKEY_LAYER_NAME

METAKEY_SEQ

Represents parameters for the metadata associated with paint and scratch polygons (see On_scratch_or_paint_boundaries)

QisMSnPExploder

API to generate unionized (paint-only) polygons from any window of the paint & scratch db

Version Control (QisMSnPExploder)

Cast to a pointer of another version in the class hierarchy (base/derived)

Get_error_msg (QisMSnPExploder)

Get_error_condition (QisMSnPExploder)

Get_error_context (QisMSnPExploder)

Get_boundaries

Get the paint-only (flat) boundaries for a window of a paint & scratch db

Get_spec

Get the paint & scratch specification held/computed by this object

QisMSnPExploderV2

Extension V2 for QisMSnPExploder

Get_boundaries_paint_scratch

Get boundaries from a window of a paint & scratch database as ordered sets of paint & scratch polygons

QisMSnPUnion

API to perform unionization (flattening) of the paint & scratch data and therefore creating GDSII-style paint-only data

Version Control (QisMSnPUnion)

Cast to a pointer of another version in the class hierarchy (base/derived)

Get_error_msg (QisMSnPExploder)

Get_error_condition (QisMSnPExploder)

Get_error_context (QisMSnPExploder)

Create_exploder

Destroy_exploder

Create a Paint&Scratch exploder object

Unionize_to_file

Perform whole design unionization and write the output to a file on disk

QisMSnPUnionV2

Extension to QisMSnPUnion

Booleanize_two_files

Perform boolean operation between two files

Booleanize_two_files Options

QisMSnPUtil Commands

snputil.create_exploder

snputil.destroy_exploder

snpexploder.get_boundaries

snpexploder.destroy_store

snputil.unionize_to_file

snputil.booleanize_two_files

QisMSnPUnion Licensing (API)

Product name : QisMSnPUnion License code : 11527

QisMSnPUtil Licensing (Script)

Product name : QisMSnPUtil License code : 11527

QisMSnpUtil Version History

qismsnputil dll 1.4.2 09-2026

qismsnputil dll 1.4.1 06-2025

qismsnputil dll 1.4 19-05-2025

qismsnputil dll 1.3 24-07-2024

qismsnputil dll 1.2 11-2022

qismsnputil dll 1.1 03-2022


ARTWORK CONVERSION SOFTWARE, INC.
509 N. Sepulveda Blvd. Suite 201 Manhattan Beach, CA 90266  tel: 831.426.6163  email: info@artwork.surf

Last Updated -- Thu Oct 1 19:02:49 UTC 2026