[Artwork] / [QisMLib]

QisMLib

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

Here is the foundation that every other component in this framework plugs into. It reads chip and board layout files in the GDSII and OASIS formats, the two industry standards for storing chip layouts, as well as the framework's own fast-loading cache files, and turns them into an in-memory database that other tools can query, draw, measure, clip, and rewrite. The framework itself handles the essentials:

  1. Start up and shut down the system once per program, reserving the licenses the program will need and loading the extensions listed in a small configuration file.

  2. Load and unload layout files into databases, with control over layer mapping, text handling, memory versus disk storage, and progress reporting, and optionally pre-process a file on the way in to clip, resize, transform, or simplify it.

  3. Give access to the extensions, such as extractors, counters, and boolean engines, that add specialized capabilities on top of the core.

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

If you are new to the framework, read the Initialization section and the script commands first. If you are building the framework into your own software, start with the C++ programming interface.

QisMLib QisMLib C++ API (qismlib.h)Data Structures (qismbase.h)Logging (qismlog.h)Extensions (qismextension.h)QisMFile (qismfile.h)typedef QisMCriticalFailureCb_fnstruct CadFileclass QisMLibVersion ControlGet_last_error_msg()Get_license_count()New_loadFile_ctrl()Delete_loadFile_ctrl()Get_file_type()Get_dbload_version()Load_file()Unload_file()Get_extension_api()Get_extension_report()class QisMLibV2Set_working_dir()class QisMLibV3Load_gds_with_memory_maps()class QisMLibV4Set_critical_failure_cb()QisMLib Initialization ArgumentsQisMLib Initialization Environment Variables Config File Formattypedef QisMLib_pQisMLib_get_lib_info()QisMLib_initialize_once()QisMLib_close_once()QisMLib Commandslib.load_filelib.load_processed_filelib.load_processed_oasislib.load_processed_hextlib.load_gds_with_mmapslib.unload_fileQisMLib Licensing (API)QisMLib Version Historyqismlib dll/so v3.46 (2026-09)qismlib dll/so v3.45 (2026-07)qismlib dll/so v3.44.1 (2026-06)qismlib dll/so v3.44 (2026-06)qismlib dll/so v3.43.3 (2026-05)qismlib dll/so v3.43.2 (2026-05)qismlib dll/so v3.43.1 (2026-02)qismlib dll/so v3.43 (2026-01)qismlib dll/so v3.42.3 (2026-01)qismlib dll/so v3.42.2 (2025-12)qismlib dll/so v3.42.1 (2025-11)qismlib dll/so v3.42 (2025-11)qismlib dll/so v3.41 (2025-08)qismlib dll/so v3.40 (2025-07)qismlib dll/so v3.39.1 (2025-05)qismlib dll/so v3.39 (2025-05)qismlib dll/so v3.38 (2024-10)qismlib dll/so v3.37 (2024-08)qismlib dll/so v3.36 (2024-04)qismlib dll/so v3.35.2 (2024-01)qismlib dll/so v3.35.1 (2023-11)qismlib dll/so v3.35 (2023-11)qismlib dll/so v3.34.2 (2023-06)qismlib dll/so v3.34.1 (2023-05)qismlib dll/so v3.34 (2023-05)qismlib dll/so v3.33 (2022-08)qismlib dll/so v3.32 (2022-03)qismlib dll/so v3.31 (2022-03)qismlib dll/so v3.30 (2021-08)qismlib dll/so v3.29.1 (2021-02)qismlib dll/so v3.29 (2020-07)qismlib dll/so v3.28 (2020-07)qismlib dll/so v3.27.1 (2020-06)qismlib dll/so v3.27 (2020-02)qismlib dll/so v3.26.3 (2020-01)qismlib dll/so v3.26.2 (2020-01)qismlib dll/so v3.26.1 (2019-12)qismlib dll/so v3.26 (2019-12)qismlib dll/so v3.25.2 (2019-11)qismlib dll/so v3.25.1 (2019-11)qismlib dll/so v3.25 (2019-11)qismlib dll/so v3.24.4 (2019-10)qismlib dll/so v3.24.3 (2019-08)qismlib dll/so v3.24.2 (2019-08)qismlib dll/so v3.24.1 (2019-07)qismlib dll/so v3.24 (2019-07)qismlib dll/so v3.23.1 (2019-06)qismlib dll/so v3.23 (2019-04)qismlib dll/so v3.22.1 (2019-03)qismlib dll/so v3.22 (2018-07)qismlib dll/so v3.21 (2018-07)qismlib dll/so v3.20 (2018-06)qismlib dll/so v3.12, v3.12.1 (2018-04)qismlib dll/so v3.11 (2018-03)qismlib dll/so v3.10 (2018-02)qismlib dll/so v3.9 (2017-11)qismlib dll/so v3.8 (2017-10)qismlib dll/so v3.7 (2017-10)qismlib dll/so v3.6 (2017-07)qismlib dll/so v3.5.1 (2017-05)qismlib dll/so v3.5 (2017-05)qismlib dll/so v3.4 (2017-02)qismlib dll/so v3.3 (2017-01)qismlib dll/so v3.2 (2016-12)qismlib dll/so v3.1 (2016-12)qismlib dll/so v3.0 (2016-10)


QisMLib C++ API (qismlib.h)

Data Structures (qismbase.h)

Logging (qismlog.h)

Extensions (qismextension.h)

QisMFile (qismfile.h)

typedef QisMCriticalFailureCb_fn

Signature of a callback that recieves the critical failure notification

struct CadFile

Codes for recognized file types

class QisMLib

Gateway to the QisMLib API. Allows the client to load a GDSII/OASIS/Dbload file into a QisMFile database and provides access to various QisMLib extensions

Version Control

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

Get_last_error_msg()

Get more information about the last error condition in form of an error string

Get_license_count()

Get the number of licenses reserved for a specific feature (code)

New_loadFile_ctrl()

Create a new instance of the file load settings object to control various aspects of the file load process

Delete_loadFile_ctrl()

Destroy an instance of the file load settings object

Get_file_type()

Check if a file is of a type supported by QisMLib

Get_dbload_version()

Get the version a Dbload file

Load_file()

Load a GDSII/OASIS/Dbload file into the QisMLib database

Unload_file()

Unload the QisMLib database

Get_extension_api()

Get QisMExtension API by name

Get_extension_report()

Get report about various QisMExtension(s) currently loaded

class QisMLibV2

Set_working_dir()

Set the working directory to control where the temporary files generated by QisMLib (acs*.bin e.t.c) are created

class QisMLibV3

Load_gds_with_memory_maps()

Load a GDSII file and use the .load memory maps if available and applicable for faster loading

class QisMLibV4

Set_critical_failure_cb()

Set handler to be notified in the event that the application needs to be terminated because of an unrecoverable error

QisMLib Initialization Arguments

To be used with QisMLib_initialize_once via argC, argT, argV paramters

QisMLib Initialization Environment Variables

Config File Format

typedef QisMLib_p

QisMLib_get_lib_info()

Get library version information

QisMLib_initialize_once()

Initialize the library to get access to the QisMLib API

QisMLib_close_once()

Close the library to free up the resources and unload the extensions

QisMLib Commands

See qismlib.h for the relevant C++ API

lib.load_file

lib.load_processed_file

lib.load_processed_oasis

lib.load_processed_hext

lib.load_gds_with_mmaps

lib.unload_file


QisMLib Licensing (API)

COUNTCODEOPERATIONNOTES
+111003QisMLib_initialize_onceONCE per process
-111003QisMLib_close_onceONCE per process

QisMLib Version History

qismlib dll/so v3.46 (2026-09)

qismlib dll/so v3.45 (2026-07)

qismlib dll/so v3.44.1 (2026-06)

qismlib dll/so v3.44 (2026-06)

qismlib dll/so v3.43.3 (2026-05)

qismlib dll/so v3.43.2 (2026-05)

qismlib dll/so v3.43.1 (2026-02)

qismlib dll/so v3.43 (2026-01)

qismlib dll/so v3.42.3 (2026-01)

qismlib dll/so v3.42.2 (2025-12)

qismlib dll/so v3.42.1 (2025-11)

qismlib dll/so v3.42 (2025-11)

qismlib dll/so v3.41 (2025-08)

qismlib dll/so v3.40 (2025-07)

qismlib dll/so v3.39.1 (2025-05)

qismlib dll/so v3.39 (2025-05)

qismlib dll/so v3.38 (2024-10)

qismlib dll/so v3.37 (2024-08)

qismlib dll/so v3.36 (2024-04)

qismlib dll/so v3.35.2 (2024-01)

qismlib dll/so v3.35.1 (2023-11)

qismlib dll/so v3.35 (2023-11)

qismlib dll/so v3.34.2 (2023-06)

qismlib dll/so v3.34.1 (2023-05)

qismlib dll/so v3.34 (2023-05)

qismlib dll/so v3.33 (2022-08)

qismlib dll/so v3.32 (2022-03)

qismlib dll/so v3.31 (2022-03)

qismlib dll/so v3.30 (2021-08)

qismlib dll/so v3.29.1 (2021-02)

qismlib dll/so v3.29 (2020-07)

qismlib dll/so v3.28 (2020-07)

qismlib dll/so v3.27.1 (2020-06)

qismlib dll/so v3.27 (2020-02)

qismlib dll/so v3.26.3 (2020-01)

qismlib dll/so v3.26.2 (2020-01)

qismlib dll/so v3.26.1 (2019-12)

qismlib dll/so v3.26 (2019-12)

qismlib dll/so v3.25.2 (2019-11)

qismlib dll/so v3.25.1 (2019-11)

qismlib dll/so v3.25 (2019-11)

qismlib dll/so v3.24.4 (2019-10)

qismlib dll/so v3.24.3 (2019-08)

qismlib dll/so v3.24.2 (2019-08)

qismlib dll/so v3.24.1 (2019-07)

qismlib dll/so v3.24 (2019-07)

qismlib dll/so v3.23.1 (2019-06)

qismlib dll/so v3.23 (2019-04)

qismlib dll/so v3.22.1 (2019-03)

qismlib dll/so v3.22 (2018-07)

qismlib dll/so v3.21 (2018-07)

qismlib dll/so v3.20 (2018-06)

qismlib dll/so v3.12, v3.12.1 (2018-04)

qismlib dll/so v3.11 (2018-03)

qismlib dll/so v3.10 (2018-02)

qismlib dll/so v3.9 (2017-11)

qismlib dll/so v3.8 (2017-10)

qismlib dll/so v3.7 (2017-10)

qismlib dll/so v3.6 (2017-07)

qismlib dll/so v3.5.1 (2017-05)

qismlib dll/so v3.5 (2017-05)

qismlib dll/so v3.4 (2017-02)

qismlib dll/so v3.3 (2017-01)

qismlib dll/so v3.2 (2016-12)

qismlib dll/so v3.1 (2016-12)

qismlib dll/so v3.0 (2016-10)


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

Last Updated -- Wed Sep 30 01:26:07 UTC 2026