[Artwork] / [QisMLib]

QisMGbrPS Extension

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

QisMGbrPS reads a Gerber file and turns it into a database the framework can work with. Gerber, and specifically the extended RS274X form of it, is the standard format for describing the artwork of a printed circuit board. Gerber draws by painting shapes and then scratching away parts of them, and this extension preserves that paint-and-scratch structure in the database it creates. It has three jobs:

  1. Load a Gerber file into a database, with control over how it is interpreted: the units, the smoothness of arcs, the maximum number of vertices per polygon, the number of processing threads, and whether traces are kept as paths or converted to plain outlines. The design can also be rotated, mirrored, scaled, or sized up and down before it is loaded.

  2. Inspect what was loaded. The extension can report whether the file was positive or negative, which layers carry no real data, and, when scanning is switched on, the D-codes it found. A D-code is the numbered aperture, or tool shape, a Gerber file uses to draw pads and traces. You can query which D-codes appear inside a region of interest, list their positions and shape information, and write the results to a CSV file.

  3. Save the database as a GDSII file, one of the standard formats for chip layouts, so that Gerber data can be used wherever GDSII is expected.

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

If you only need to convert a Gerber file or look up its D-codes, the script commands are the quickest route. If you are using Gerber loading into your own software, start with the options object in the C++ programming interface.


QisMGbrPS C++ API (qismgbrps.h)

QisMGbrPSNotify

Represents an interface to recieve notifications from QisMGbrPS

Version control (QisMGbrPSNotify)

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

On_qismgbr_progress

Callback to get progress message while Gbr is being processed

QisMGbrPSOpts

Represents an object to store options for importing Gbr

ParamType

Represents the parameter to be Set or Get

UnitType

Codes for various units supported by QisMGbrPS

Mirror

Codes for types of mirroring

Version control (QisMGbrPSOpts)

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

Set_param

Get_param

Set/Get value for a specific option

Reset (QisMGbrPSOpts)

Reset options to default values

Clone

Create a clone from the current object. MUST be eventually destroyed using QisMGbrPS::Delete_object

Copy

Copy settings from another object

QisMGbrDcodes

Represents the results of a dcode query

Version control (QisMGbrPSFile)

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

Has_dcode

Returns true if at lease one instance of the specified dcode number was found in the query

Dcode_list

Get a list of Dcodes found in the query

Dcode_XY

Returns a list of X,Y co-ordinates (in user units) corresponding to a dcode number

Dcode_info

Returns an information string corresponding to a dcode number

Aperture_units

Returns the aperture units (units associated with various values in the dcode information string) as either "inch" or "mm"

Write_CSV

Write all the collected Dcodes to a CSV file

QisMGbrPSFile

Represents a single database created from Gbr source

MetaInfo

Represents the type of information about the Gerber source to be queried

Version control (QisMGbrPSFile)

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

File_db

Get handle to the underlying QisMFile db so that it can be used with other APIs in the QisM system.

Get_error_msg (QisMGbrPSFile)

Get_error_tag (QisMGbrPSFile)

Get error message and tag (error code as a string) for a recent error

Save_to_gdsii

Export the database to a GDSII file on disk at the specified path gds_output_path (dir + filename + extension)

Get_meta_info

Get select information about the source Gerber file

QisMGbrPSFileV2

Extension (version 2) to QisMGbrPSFile

Query_dcodes

Destroy_dcodes

Run a query to collect instances of Dcodes that match the query options

Query Options

Various parameters for Dcode Query

QisMGbrPS

QisMLib extension to create a db from Gbr data

Version control (QisMGbrPS)

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

Get_error_msg (QisMGbrPS)

Get_error_tag (QisMGbrPS)

Get error message and tag (error code as a string) for a recent error

New_object

Delete_object

Create/Destroy an instance of an object

Load_gbr

Unload_gbr

Create a database from a gbr file

QisMGbrPS commands

QisMScript commands to create a database from a Gerber (RS274X) file

gbrpsfile.print_meta

Print meta-information about the Gerber from which a db was created

gbrpsfile.save_gds

Save a GerberPS db as GDSII

gbrps.unload

gbrps.load

Create a GerberPS (paint & scratch) db from a Gerber file

gbrpsfile.query_dcodes

dcodes.list

dcodes.xy

dcodes.info

dcodes.write_to_file

gbrpsfile.destroy_dcodes

QisMGbrPS Licensing (API)

Product name : QisMGbrPS License code : 11501

QisMGbrPS Licensing (Script)

Product name : QisMGbrPS License code : 11501

QisMGbrPS Version History

qismgbrps dll/so v1.6 11-2025

qismgbrps dll/so v1.5.1 04-2025

qismgbrps dll/so v1.5 04-2025

qismgbrps dll/so v1.4 05-2024

qismgbrps dll/so v1.3 06-2023

qismgbrps dll/so v1.2.1 05-2023

qismgbrps dll/so v1.2 03-2022

qismgbrps dll/so v1.1 12-2021

qismgbrps dll/so v1.0 06-2021


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 18:10:05 UTC 2026