[Artwork] / [QisMLib]

QisMLib Data Structures

Welcome to the reference page for QisMLib Data Structures, a core API of QisMLib, Artwork Conversion's CAD processing framework.

This page documents the basic building blocks that every other part of the framework shares. A chip layout is made of cells, and each cell contains shapes such as closed polygons, paths with a width, text labels, and references that place one cell inside another, either singly or in a repeating array. The framework needs a common way to describe each of these items, to describe rectangular windows within the layout, to send progress and data notifications back to the calling program, and to report errors. Those shared descriptions are what this page defines. It is aimed at developers writing software against the framework, but even non-programmers may find it useful for understanding the vocabulary used throughout the rest of the documentation.

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

If you are new to the framework, skim the layout element records to learn the vocabulary. Developers building on the framework should read the notification handler section closely before writing any traversal code.


C++ API (qismbase.h)

struct QisMWindow

A data structure to hold rectangular window information

class QisMBoxSet

Interface that represents a container of boxes (rectangular windows)

Version Control

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

Add_box()

Add a box to the set

Get_count()

Get number of boxes in the set

Get_box()

Get a box from the set

Reset()

Reset the contents

Copy()

Copy from another set (assign, not append)

class QisMBoxSetV2

Add_spec()

Add boxes based on a spec. string.

struct QisMVector

Flags that indicate the type of vector

struct QisMBoundary

A data structure to store information for QisMVector::BOUNDARY

struct QisMPath

A data structure to store information for QisMVector::PATH

struct QisMText

A data structure to store information for QisMVector::TEXT

struct QisMSref

A data structure to store information for QisMVector::SREF

struct QisMAref

A data structure to store information for QisMVector::AREF

struct QisMArrayElement

A data structure to store information for QisMVector::AREF_ELEMENT

class QisMNotify

API for the various QisMLib notifications to be handled by the client software

Notification handler return codes

Version Control

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

On_qismt_warning()

Notifications containing warning messages

On_qismt_progress()

Notifications containing progress updates

On_qismt_vector_data_begin()

Notification that database traversal (Get_vector_data) is about to begin

On_qismt_vector()

Notification for each data vector encoutered during database traversal (Get_vector_data)

On_qismt_vector_data_end()

Notification that database traversal (Get_vector_data) is about to end

class QisMNotifyRefresh

Extends QisMNotify to support refresh callbacks during drawing

On_qismt_refresh()

A refresh notification while the drawing is in progress

typedef QisMNotifyV2

class QisMThreadLock

Interface that represents a Mutex

Version Control

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

Lock()

Unlock()

Begin (Lock)/End (Unlock) critical section

struct QisMError

Tags for various error conditions


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:08:50 UTC 2026