[Artwork] / [QisMLib]

QisMDraw

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

QisMDraw turns a layout database that the framework has loaded into a picture. It can paint directly into a window of your own application, produce an image in memory or on disk in GIF, bitmap or XPM form, or hand back the drawn shapes as vector data for you to render yourself. Because chip layouts can hold enormous numbers of shapes, the extension also lets you decide how much detail to draw: anything smaller than a chosen number of pixels can be skipped or shown as a solid box, which makes drawing very large views much faster.

Beyond that, a long list of settings controls the look of the picture: fill or outline only, black or white background, colors and fill patterns for each layer, markers for cell references, texts and geometry, a scale bar in any corner, and labels or outline boxes for referenced cells at chosen nesting levels.

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

If you just want a picture of a file, the script command is the quickest route. If you are adding a layout viewer to your own application, start with the C++ programming interface and note the rules for refreshing the screen while a long draw is in progress.

QisMDraw QisMDraw C++ API (qismdraw.h)struct QisMDrawFlagtypedef WindowHandle_tstruct QisMColorclass QisMDrawObjectSet_display_filter_size()Get_display_filter_size()Set_cell_display_filter_size()Get_cell_display_filter_size()Set_draw_filtered_areas()Get_draw_filtered_areas()Set_cell_display_filter_outline_color()Get_cell_display_filter_outline_color()Set_cell_display_filter_fill_color()Get_cell_display_filter_fill_color()Set_cell_display_filter_color()Get_cell_display_filter_color()Set_cell_display_filter_pattern()Get_cell_display_filter_pattern()Set_outline_filter()Get_outline_filter()Set_fill()Get_fill()Set_background_color()Get_background_color()Set_reference_marker()Get_reference_marker()Set_sref_marker()Get_sref_marker()Set_text_marker()Get_text_marker()Set_geometry_marker()Get_geometry_marker()Set_marker_shape()Get_marker_shape()Set_scale_bar()Get_scale_bar()Set_cell_labels()Get_cell_labels()Set_cell_label_position()Get_cell_label_position()Set_cell_label_height()Get_cell_label_height()Set_cell_outline()Get_cell_outline()Set_cell_outline_label_sref()Get_cell_outline_label_sref()Set_cell_outline_label_aref()Get_cell_outline_label_aref()Set_layers_outline_color()Get_layers_outline_color()Set_layers_fill_color()Get_layers_fill_color()Set_layers_fill()Get_layers_fill()Set_layers_outline_type()Get_layers_outline_type()Set_window()Set_image_size()Redraw_direct()Redraw_image()Get_partial_image()Get_display_vector_data()Stop_draw()class QisMDrawVersion ControlGet_last_error_msg()Open_draw()Close_draw()QisMDraw commandsdraw.imagedraw.vectorsQisMDraw Licensing


QisMDraw C++ API (qismdraw.h)

struct QisMDrawFlag

Flags used by QisMDraw API

typedef WindowHandle_t

Window identifier for direct draw

struct QisMColor

RGB Color specification

class QisMDrawObject

QisMLib drawing API

Set_display_filter_size()

Get_display_filter_size()

Set/Get a threshold to filter (not process) items that are smaller than a certain size in pixels in the current view

Set_cell_display_filter_size()

Get_cell_display_filter_size()

Set/Get a threshold to filter (not process) references that are smaller than a certain size in pixels in the current view

Set_draw_filtered_areas()

Get_draw_filtered_areas()

Controls how filtered areas are drawn

Set_cell_display_filter_outline_color()

Get_cell_display_filter_outline_color()

Set/Get the outline color for filtered areas

Set_cell_display_filter_fill_color()

Get_cell_display_filter_fill_color()

Set/Get the fill color for filtered areas

Set_cell_display_filter_color()

Get_cell_display_filter_color()

Set/Get the fill & outline color for filtered areas

Set_cell_display_filter_pattern()

Get_cell_display_filter_pattern()

Set/Get the fill pattern for filtered areas

Set_outline_filter()

Get_outline_filter()

Control if a polygon outline is drawn or not if ALL of the following conditions are true:

Set_fill()

Get_fill()

Set/Get the fill/outline setting for drawing data

Set_background_color()

Get_background_color()

Set/Get background color (Black/White)

Set_reference_marker()

Get_reference_marker()

Show/Hide markers for cell references (default: false)

Set_sref_marker()

Get_sref_marker()

Show/Hide single reference markers (default: false)

Set_text_marker()

Get_text_marker()

Show/Hide array reference markers (default: false)

Set_geometry_marker()

Get_geometry_marker()

Show/Hide geometry markers for one or more layers

Set_marker_shape()

Get_marker_shape()

Set/Get the shape for reference/text/geometry markers (default: MSF_DIAMOND)

Set_scale_bar()

Get_scale_bar()

Show/Hide scale bar at any one corner of the screen (default: SBF_OFF)

Set_cell_labels()

Get_cell_labels()

Display cell-name labels for cell references at select nesting levels

Set_cell_label_position()

Get_cell_label_position()

Set/Get the label position for cell references when displayed at a given nesting level (default: LPF_CENTER)

Set_cell_label_height()

Get_cell_label_height()

Set/Get the height of cell reference labels in pixels when displayed at a given nesting level (default: 10 pixels)

Set_cell_outline()

Get_cell_outline()

Display an outline for cell reference extents box at select nesting levels

Set_cell_outline_label_sref()

Get_cell_outline_label_sref()

Show/Hide labels and outlines for single references at the specified nesting level

Set_cell_outline_label_aref()

Get_cell_outline_label_aref()

Show/Hide labels and outlines for array references at the specified nesting level

Set_layers_outline_color()

Get_layers_outline_color()

Set the outline color for the specified layers if outline is visible

Set_layers_fill_color()

Get_layers_fill_color()

Set the fill color for the specified layers

Set_layers_fill()

Get_layers_fill()

Set the fill pattern for the specified layers

Set_layers_outline_type()

Get_layers_outline_type()

Show/Hide outline for the specified layers

Set_window()

Set the current view window adjusted to match the aspect ratio of the drawing area (unlike Set_exact_window)

Set_image_size()

Set the image size in pixels for drawing with Redraw_direct and Redraw_image

Redraw_direct()

Perform a redraw directly to the client window

Redraw_image()

Generate an image for the current view

Get_partial_image()

Get partial image while Redraw_image is in progress

Get_display_vector_data()

Get display information in form of vector data

Stop_draw()

Stop Redraw_direct, Redraw_image and Get_display_vector_data operations

class QisMDraw

QisMLib draw extension manager

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

Open_draw()

Create an instance of the QisMLib drawing object

Close_draw()

Get more information about the last error condition

QisMDraw commands

See qismdraw.h for the corresponding C++ API

draw.image

draw.vectors

QisMDraw Licensing

COUNTCODEOPERATIONNOTES
+111057C++ QisMDraw::Open_draw()ONCE per call
-111057C++ QisMDraw::Close_draw()ONCE per call
+/-111057Script draw.imageONCE per call

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

Last Updated -- Wed Sep 30 18:58:21 UTC 2026