[Artwork] / [QisMLib]

QisMLayerSynth Extension

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

QisMLayerSynth creates brand-new layers in a chip layout by combining existing layers with boolean operations. A boolean operation treats each layer as a set of shapes and merges, subtracts, intersects or compares them, in the same way one might overlay two stencils and keep only where they overlap. You describe the result you want in a short text expression, for example "take layer 2, add layer 5, then remove layer 7", and the extension flattens the layout hierarchy, performs the operations across several processor threads, and hands back the resulting polygons one by one. Typical uses are deriving a mask layer from several drawn layers, or building a difference layer that highlights where two layers disagree.

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

If you only want to write an expression, start with the layer synthesis specification. Developers using the API should then continue to the C++ programming interface, and script users to the commands.

QisMLayerSynth ExtensionLAYER SYNTHESIS SPEC.DEFAULT SPECPOSTFIX SPEC (compact and efficient)QisMLayerSynth C++ API (qismlayersynth.h)LSynthNotifyVersion Control (LSynthNotify)Begin_synthSynthesized_polygonInfo_messageWarning_messageEnd_synthLSynthNotifyV2Terminate_synthesisLSynthSpecObject_name (LSynthSpec)Version Control (LSynthSpec)Set_view_cellGet_view_cellSet_layer_specGet_layer_specSet_clipGet_clipSet_view_windowGet_view_window_llxGet_view_window_llyGet_view_window_urxGet_view_window_urySet_butting_modeGet_butting_modeGet_butting_overlapSet_remove_partitionsGet_remove_partitionsLSynthSpecV2Set_paramsQisMLayerSynthObjectObject_name (QisMLayerSynthObject)Version Control (QisMLayerSynthObject)Get_last_error_msg (Get_last_error_msg)Get_last_error_code (Get_last_error_code)New_specDelete_specSynthesize_layersQisMLayerSynthObjectV2Synthesize_layers_advQisMLayerSynthVersion Control (QisMLayerSynth)Get_last_error_msg (QisMLayerSynth)Get_last_error_code (QisMLayerSynth)New_synthesizerDelete_synthesizerIs_layerspec_validQisMLayerSynth commandslsynth.new_synthesizerlsynth.delete_synthesizerlsynth.synthesize_layerslsynth.delete_storeQisMLayerSynth Licensing (API)QisMLayerSynth Licensing (Script)QisMLayerSynth Version Historyqismlayersynth dll/so v2.8 07-2026qismlayersynth dll/so v2.7 06-2020qismlayersynth dll/so v2.6 08-2019qismlayersynth dll/so v2.5 06-2018qismlayersynth dll/so v2.4 02-2018qismlayersynth dll/so v2.3 11-2017qismlayersynth dll/so v2.1 08-2017qismlayersynth dll/so v2.0 07-2017qismlayersynth dll/so v1.0 03-2017


LAYER SYNTHESIS SPEC.

DEFAULT SPEC

Examples:

POSTFIX SPEC (compact and efficient)

Example:

QisMLayerSynth C++ API (qismlayersynth.h)

LSynthNotify

API for the QismLayerSynth notifications handler (callback client)

Version Control (LSynthNotify)

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

Begin_synth

Notification at the start of the synthesis of a new layer

Synthesized_polygon

Notification to recieve a single synthesized polygon

Info_message

Notifying any information related to the layer synthesis

Warning_message

Notifying any warnings related to the layer synthesis

End_synth

Notification at the end of the synthesis of a new layer

LSynthNotifyV2

Handlers of this class MUST define LSynthNotify_cast, LSynthNotify_cast const and LSynthNotify_latest_version correctly for version = 2

Terminate_synthesis

Return non-zero value to terminate the layer synthesis

LSynthSpec

Layer synthesis specification object

Object_name (LSynthSpec)

Get implementation name and version

Version Control (LSynthSpec)

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

Set_view_cell

Get_view_cell

Set/Get the view cell

Set_layer_spec

Get_layer_spec

Set/Get the layer synthesis specification (Required)

Set_clip

Get_clip

Set/Get clipping ON/OFF. Default: OFF

Set_view_window

Get_view_window_llx

Get_view_window_lly

Get_view_window_urx

Get_view_window_ury

Set/Get extraction/clipping window

Set_butting_mode

Get_butting_mode

Get_butting_overlap

Set/Get mode to represent output polygons with holes

Set_remove_partitions

Get_remove_partitions

Set/Get mode to remove thread partition lines after the boolean operation is complete

LSynthSpecV2

Layer synthesis specification object (version = 2)

Set_params

Set additional parameters

QisMLayerSynthObject

An API to work with a single instance of the layer synthesizer object

Object_name (QisMLayerSynthObject)

Get implementation name and version

Version Control (QisMLayerSynthObject)

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

Get_last_error_msg (Get_last_error_msg)

Get_last_error_code (Get_last_error_code)

Get the error message and code corresponding to the last error condition

New_spec

Delete_spec

Create/Destroy a layer synthesis specification (settings) object

Synthesize_layers

Synthesize one or more layers as per the layer synthesis specification

QisMLayerSynthObjectV2

Extension v2 to QisMLayerSynthObject with support for advanced control on the boolean operations by specifying the boolean settings object directly (qismbool.h)

Synthesize_layers_adv

Works just like Synthesize_layers except:

QisMLayerSynth

API to synthesize/create new layers of polygons by performing a sequence of boolean operations between layers

Version Control (QisMLayerSynth)

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

Get_last_error_msg (QisMLayerSynth)

Get_last_error_code (QisMLayerSynth)

Get the error message and code corresponding to the last error condition

New_synthesizer

Delete_synthesizer

Create/Destroy a new instance of the layer synthesis object

Is_layerspec_valid

Check if a layer synthesis specification is syntactically correct

QisMLayerSynth commands

lsynth.new_synthesizer

lsynth.delete_synthesizer

lsynth.synthesize_layers

lsynth.delete_store

QisMLayerSynth Licensing (API)

Product name: QisMLayerSynth License code: 11069

BEGINEND
New_synthesizerDelete_synthesizer

QisMLayerSynth Licensing (Script)

Product name: QisMLayerSynth License code: 11069

BEGINEND
lsynth.new_synthesizerlsynth.delete_synthesizer

QisMLayerSynth Version History

qismlayersynth dll/so v2.8 07-2026

qismlayersynth dll/so v2.7 06-2020

qismlayersynth dll/so v2.6 08-2019

qismlayersynth dll/so v2.5 06-2018

qismlayersynth dll/so v2.4 02-2018

qismlayersynth dll/so v2.3 11-2017

qismlayersynth dll/so v2.1 08-2017

qismlayersynth dll/so v2.0 07-2017

qismlayersynth dll/so v1.0 03-2017


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

Last Updated -- Fri Oct 2 00:08:57 UTC 2026