[Artwork] / [QisMLib]

QisMBoolFiles Extension

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

QisMBoolFiles performs boolean operations between the polygons of two separate layout files, which may be in GDSII, OASIS or the framework's own loaded-database form. A boolean operation treats each file as a set of shapes and combines them: it can simply collect both sets together, merge them into one, keep only where they overlap, subtract one from the other, or compute the exclusive-or, which keeps only the places where the two files differ. That last operation is the most common use, because it turns the extension into a comparison tool that highlights every difference between two versions of a design.

To handle very large layouts, the work is divided into rectangular windows that are processed in parallel by several processor threads. The results for each window are delivered to the calling program as they finish, and the extension can also write them to a GDSII 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 compare two files, go straight to the script command. Developers integrating the extension should start with the C++ programming interface.


QisMBoolFiles C++ API (qismboolfiles.h)

QisMBoolFilesFlags

Various flags used by QisMBoolFiles

Operation

Op. codes for boolean operations

QisMBoolFilesWindows

Object to store a set of windows

Object_name

Get implementation name and version

Version Control (QisMBoolFilesWindows)

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

Reset

Clear all the windows

Add

Add a new window to this set

Random_shuffle

Randomize the order of the windows in this set

Count

Get the number of windows in this set

Get

Get a specific window from this set

QisMBoolFilesParams

Object to store options for boolean ops between two files

Object_name

Get implementation name and version

Version Control (QisMBoolFilesParams)

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

Reset

Reset options to default values

Set_operation

Get_operation

Set/Get the operation code

Set_clip

Get_clip

Set/Get window clipping to ON (true)/OFF (false)

Set_threads

Get_window_threads

Get_threads_per_window

Set/Get the number of windows to be processed in parallel (n_window_threads) and the number of threads per window for boolean operations (n_threads_per_window)

Set_sliver

Get_sliver

Set/Get sliver value (smallest acceptable size in file units for output polygons).

Set_max_output_vertices

Get_max_output_vertices

Set/Get max. number of vertices per polygon ( >= 4 and <= 8190)

Set_dynamic_windows

Get_dynamic_windows

Turn Dynamic-windowing ON/OFF

QisMBoolFilesClient

A callback to recieve output of boolean operations

Version Control (QisMBoolFilesClient)

Cast a pointer to your handler to any type in the QisMBoolFilesClient hierarchy using the version number

On_qismboolfiles_message_mt

Intercept an informational message from QisMBoolFiles

On_qismboolfiles_warning_mt

Intercept a warning message from QisMBoolFiles. Return non-zero to interrupt execution

On_qismboolfiles_window_mt

Notification that a specific window has been processed

Advanced options for QisMBoolFiles::Booleanize_two_files (argc, argt, argv)

QisMBoolFiles

Primary interface to the QisMBoolFiles extension

Version Control (QisMBoolFiles)

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

Get_last_error_msg

Get_last_error_code

Get message/code for the last error condition

New_object

Delete_object

Create/Destroy objects of specific classes

Booleanize_two_files

Perform boolean operation between sets of polygons of two files

QisMBoolFiles commands

twofiles.xor

QisMBoolFiles Licensing (API)

Product name: QisMBoolFiles License code: 11071

OperationNo. LicensesNotes
Booleanize_two_filesGet_window_threads (via options)license is held only for the duration of the operation

QisMBoolFiles Licensing (SCRIPT)

Product name: QisMBoolFiles License code: 11071

OperationNo. LicensesNotes
twofiles.xor{ntiles} (via thrnum parameter)license is held only for the duration of the operation

QisMBoolFiles Version History

qismboolfiles dll/so v1.4 08-2022

qismboolfiles dll/so v1.3 02-2020

qismboolfiles dll/so v1.2 07-2019

qismboolfiles dll/so v1.1 06-2018

qismboolfiles dll/so v1.0 02-2018


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:07:26 UTC 2026