[Artwork] / [QisMLib]

QisMRaster Extension

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

QisMRaster turns chip and board layout data into pictures. The process is called rasterization: the polygons in a layout are painted onto a grid of tiny dots, or pixels, producing a high-resolution black-and-white bitmap that can be saved as a TIFF, BMP, or Artwork's own RAW image file. The extension is built for very large designs, so it can split a job across many processor threads, stream an image to disk when it is too big to fit in memory, and recognize repeated cells so they are drawn only once.

Beyond a plain snapshot, the extension can:

  1. Control the image with settings for pixel size, inverted polarity, dithering, which is a halftone-like pattern that lightens filled areas, drawing direction, and solid versus outline fill.

  2. Combine layers on the fly using a small expression language, so the picture shows the union, difference, or overlap of several layers rather than one layer at a time.

  3. Overlay extra shapes such as polygons, boxes, ellipses, paths, and rings onto an existing image, either adding ink or erasing it.

  4. Post-process a finished image into a grayscale version or a half-size copy.

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

If you want to produce an image without writing code, start with the script commands. If you are using the API into your own software, start with the C++ programming interface, and check the licensing section before planning a multi-threaded job.

QisMRaster ExtensionQisMRaster C++ API (qismraster.h)QisMRasterFlagsImageFormatRasterModeOverlayModeGrayscale_modesQisMRasterImageVersion control (QisMRasterImage)Image_nameImage_bufferImage_size_bytesPolygon_countVertex_countRip_time_secWidth_px Height_pxExtents_llxExtents_llyExtents_urxExtents_uryInvertedGet_ditherGet_pixelsize_xGet_pixelsize_yDPI_xDPI_yGet_right_to_leftReportQisMRasterImageV2Get_bottom_to_topQisMRasterNotifyVersion control (QisMRasterNotify)On_qismraster_imageGet_qismraster_image_proc_error_msgQisMRasterNotifyV2Pre_qismraster_imageQisMRasterNotifyV3Rasterization_refreshQisMRasterSubSamplerVersion control (QisMRasterSubSampler)Get_last_error_msg (QisMRasterSubSampler)Write_to_diskGet_image (QisMRasterSubSampler)Detach_buffer (QisMRasterSubSampler)Destroy_subsampled_bufferQisMGrayscaleImageVersion control (QisMGrayscaleImage)Get_bufferGet_buffer_sizeGet_row_size_pxGet_row_size_bytesGet_row_countGet_sample_rateGet_bits_per_pxGet_dpi_xGet_dpi_yWrite_to_diskDetach_bufferQisMRasterParamsReset (QisMRasterParams)Version control (QisMRasterParams)Set_pixelsizeGet_pixelsize_xGet_pixelsize_ySet_invertGet_invertSet_ditherGet_ditherSet_right_to_leftGet_right_to_leftSet_est_polygon_buffer_countGet_est_polygon_buffer_countSet_pattern_recognitionGet_pattern_recognitionSet_image_formatGet_image_formatSet_num_threadsGet_num_threadsSet_raster_modeGet_raster_modeQisMRasterParamsV2Set_overlayGet_overlayQisMRasterParamsV3Set_bottom_to_topGet_bottom_to_topQisMRasterParamsV4QisMRasterParamsV5Enum CodeSet_paramGet_paramQisMRasterPolygonSetReset (QisMRasterPolygonSet)Version control (QisMRasterPolygonSet)Add_polygonConsolidateCountData_extentsQisMRasterPolygonSetV2Import_bstoreQisMRasterPolygonSetV3Iterator for QisMRasterPolygonSetCount_vGet_first Get_next End_iteratorNum_xy_pairsXY_pairsQisMRasterPolygonSetV4Reset (QisMRasterPolygonSet)Add_polygonAdd_frameQisMRasterizerVersion control (QisMRasterizer)Get_last_error_msg (QisMRasterizer)Get_last_error_code (QisMRasterizer)Rasterize_windowRasterize_window_synthesizedRasterize_polygon_setQisMRasterizerV2Preset_raster_viewRasterize_window_preset_viewOverlay_polygon_setQisMRasterizerV3Rasterize_window_paint_scratchQisMRasterPSInfo_pQisMRasterizerV4 Rasterize_px_windowCreate_paint_scratch_v2_specDestroy_paint_scratch_v2_specRasterize_window_paint_scratch_v2QisMRasterizerV5 Create_grayscaleDestroy_grayscaleDestroy_grayscale_bufferQisMRasterizerV6Subsample_2x2Destroy_subsamplerDestroy_subsampled_bufferQisMRasterizerV7New_imageOverlay_polygonOverlay_polygon_dbuOverlay_box_dbuSet_limit_extentsQisMRasterizerV8Overlay_ellipseOverlay_pathQisMRasterizerV9Set_refresh_notifyQisMRasterizerV10Overlay_box_dbu_offxOverlay_ellipse_dbuQisMRasterizerV11Overlay_ringDPI_to_pixelsizePixelsize_to_DPIFile_dbQisMFormatterVersion control (QisMFormatter)Get_last_error_msg (QisMFormatter)Get_last_error_code (QisMFormatter)Write_tiffWrite_bmpWrite_rawQisMFormatterV2 Write_vbmpQisMFormatterV3 Write_tif8QisMFormatterV4 Format_imageQisMRasterWriterVersion control (QisMRasterWriter)BoundaryBoundary_dbuQisMRasterSharedBufVersion control (QisMRasterSharedBuf)Get_data_extentsWrite_to_diskClear_bufferBytes_per_rowPx_per_rowPx_per_colBytes_totalBuffer_ptrQisMRasterVersion control (QisMRaster)Get_last_error_msg (QisMRaster)Get_last_error_code (QisMRaster)New_objectDelete_objectCreate_rasterizerDestroy_rasterizerCreate_formatterDestroy_formatterQisMRasterV2 Open_file_writerClose_file_writerQisMRasterV3 Rasterize_win_queue_mtQisMRasterV4 Rasterize_win_queue_mt_paint_scratch_v2RasterizeLargeDiskImageOptsRasterize_large_disk_imageRasterize_large_disk_image_paint_scratch_v2QisMRasterV5 WinQueueOpts Rasterize_win_queue_mt_extParentCreate_grayscale (QisMRaster)Destroy_grayscale (QisMRaster)Destroy_grayscale_bufferQisMRasterV6 Subsample_2x2Destroy_subsamplerDestroy_subsampled_bufferQisMRasterV7 Create_shared_bufferCreate_rasterizer_shared_bufferLayer Synthesis Spec. Artwork RAW FormatQisMRaster Commandsraster.create_rasterizerraster.destroy_rasterizerraster.create_paramsraster.destroy_paramsraster.windowraster.px_windowraster.polysraster.overlay_polysraster.synthesizedraster.create_pns_v2_specraster.destroy_pns_v2_specraster.window_pns_v2raster.format_imageraster.queue_mtraster.large_disk_imageraster.get_dpiraster.get_pixelsizeraster.compute_px_szraster.compute_buf_szraster.compute_tile_szraster.get_buffer_infoQisMRaster Licensing (API)QisMRaster Licensing (Script)QisMRaster Version Historyqismraster dl/so v1.25 01-2026qismraster dl/so v1.24 08-2025qismraster dl/so v1.23.6 05-2025qismraster dl/so v1.23.5 03-2025qismraster dl/so v1.23.4 05-2024qismraster dl/so v1.23.3 01-2024qismraster dl/so v1.23.2 01-2024qismraster dl/so v1.23.1 12-2023qismraster dl/so v1.23 10-2023qismraster dl/so v1.22 10-2023qismraster dl/so v1.21 08-2023qismraster dl/so v1.20 04-2023qismraster dl/so v1.18 05-2022qismraster dl/so v1.17 03-2022qismraster dl/so v1.16.1 09-2021qismraster dl/so v1.15 08-2021qismraster dl/so v1.14 03-2021qismraster dl/so v1.13 09-2020qismraster dl/so v1.12 07-2020qismraster dl/so v1.11 06-2020qismraster dl/so v1.10 02-2020qismraster dl/so v1.9 12-2019qismraster dl/so v1.8 12-2019qismraster dl/so v1.7 09-2019qismraster dl/so v1.6 05-2019qismraster dl/so v1.5 02-2019qismraster dl/so v1.4 01-2019qismraster dl/so v1.3 11-2018qismraster dl/so v1.2 10-2018qismraster dl/so v1.1 06-2018


QisMRaster C++ API (qismraster.h)

QisMRasterFlags

All the flags (enumerated constants) associated with the QisMRaster API

ImageFormat

RasterMode

OverlayMode

Grayscale_modes

Grayscale ModeSupported file format
GSM_1x1_1BPPALL formats
GSM_2x2_2BPPBUF, TIF and TIF8 only
GSM_2x2_4BPPBUF, TIF, TIF8, BMP and VBMP
GSM_2x2_8BPPBUF, TIF, TIF8, BMP and VBMP
GSM_4x4_4BPPBUF, TIF, TIF8, BMP and VBMP
GSM_4x4_8BPPBUF, TIF, TIF8, BMP and VBMP
GSM_8x8_8BPPBUF, TIF, TIF8, BMP and VBMP

QisMRasterImage

Interface to retrive information about a raster image

Version control (QisMRasterImage)

Image_name

Image_buffer

Image_size_bytes

Polygon_count

Vertex_count

Rip_time_sec

Width_px

Height_px

Extents_llx

Extents_lly

Extents_urx

Extents_ury

Inverted

Get_dither

Get_pixelsize_x

Get_pixelsize_y

DPI_x

DPI_y

Get_right_to_left

Report

QisMRasterImageV2

Extension for QisMRasterImage (version = 2)

Get_bottom_to_top

QisMRasterNotify

Interface to recieve raster images via a callback for certain multi-window rasterization operations

Version control (QisMRasterNotify)

On_qismraster_image

Get_qismraster_image_proc_error_msg

QisMRasterNotifyV2

Extension to QisMRasterNotify (version = 2)

Pre_qismraster_image

QisMRasterNotifyV3

Extension to QisMRasterNotify (version = 3)

Rasterization_refresh

QisMRasterSubSampler

Interface to a 2x2 down-sampled raster image

Version control (QisMRasterSubSampler)

Get_last_error_msg (QisMRasterSubSampler)

Write_to_disk

Get_image (QisMRasterSubSampler)

Detach_buffer (QisMRasterSubSampler)

Destroy_subsampled_buffer

QisMGrayscaleImage

Interface to work with a newly generated gray scale image

Version control (QisMGrayscaleImage)

Get_buffer

Get_buffer_size

Get_row_size_px

Get_row_size_bytes

Get_row_count

Get_sample_rate

Get_bits_per_px

Get_dpi_x

Get_dpi_y

Write_to_disk

Detach_buffer

QisMRasterParams

A data structure to specify various rasterization options

Reset (QisMRasterParams)

Version control (QisMRasterParams)

Set_pixelsize

Get_pixelsize_x

Get_pixelsize_y

Set_invert

Get_invert

Set_dither

Get_dither

Set_right_to_left

Get_right_to_left

Set_est_polygon_buffer_count

Get_est_polygon_buffer_count

Set_pattern_recognition

Get_pattern_recognition

Set_image_format

Get_image_format

Set_num_threads

Get_num_threads

Set_raster_mode

Get_raster_mode

QisMRasterParamsV2

Extension for QisMRasterParams (version = 2)

Set_overlay

Get_overlay

QisMRasterParamsV3

Extension for QisMRasterParams (version = 3)

Set_bottom_to_top

Get_bottom_to_top

QisMRasterParamsV4

Extension for QisMRasterParams (version = 4)

QisMRasterParamsV5

Extension for QisMRasterParams (version = 5)

Enum Code

Set_param

Get_param

QisMRasterPolygonSet

A data structure to store a set of polygons

Reset (QisMRasterPolygonSet)

Version control (QisMRasterPolygonSet)

Add_polygon

Consolidate

Count

Data_extents

QisMRasterPolygonSetV2

Extension for QisMRasterPolygonSet (version = 2)

Import_bstore

QisMRasterPolygonSetV3

Extension for QisMRasterPolygonSet (version = 3)

Iterator for QisMRasterPolygonSet

Count_v

Get_first

Get_next

End_iterator

Num_xy_pairs

XY_pairs

QisMRasterPolygonSetV4

Extension for QisMRasterPolygonSet (version = 4)

Reset (QisMRasterPolygonSet)

Add_polygon

Add_frame

QisMRasterizer

Interface to an instance of the rasterizer

Version control (QisMRasterizer)

Get_last_error_msg (QisMRasterizer)

Get_last_error_code (QisMRasterizer)

Rasterize_window

Rasterize_window_synthesized

Rasterize_polygon_set

QisMRasterizerV2

Extension for QisMRasterizer (version = 2)

Preset_raster_view

Rasterize_window_preset_view

Overlay_polygon_set

QisMRasterizerV3

Extension for QisMRasterizer (version = 3)

Rasterize_window_paint_scratch

QisMRasterPSInfo_p

Opaque handle that represents an instance of the paint & scratch (v2) spec.

QisMRasterizerV4

Extension for QisMRasterizer (version = 4)

Rasterize_px_window

Create_paint_scratch_v2_spec

Destroy_paint_scratch_v2_spec

Rasterize_window_paint_scratch_v2

QisMRasterizerV5

Extension for QisMRasterizer (version = 5)

Create_grayscale

Destroy_grayscale

Destroy_grayscale_buffer

QisMRasterizerV6

Extension #6 to QisMRasterizer (version = 6)

Subsample_2x2

Destroy_subsampler

Destroy_subsampled_buffer

QisMRasterizerV7

Extension #7 to QisMRasterizer (version = 7)

New_image

Overlay_polygon

Overlay_polygon_dbu

Overlay_box_dbu

Set_limit_extents

QisMRasterizerV8

Extension #8 to QisMRasterizer (version = 8)

Overlay_ellipse

Overlay_path

QisMRasterizerV9

Extension #9 to QisMRasterizer (version = 9)

Set_refresh_notify

QisMRasterizerV10

Extension #10 to QisMRasterizer (version = 10)

Overlay_box_dbu_offx

Overlay_ellipse_dbu

QisMRasterizerV11

Extension #11 to QisMRasterizer (version = 11)

Overlay_ring

DPI_to_pixelsize

Pixelsize_to_DPI

File_db

QisMFormatter

Interface to an instance of the image formatter

Version control (QisMFormatter)

Get_last_error_msg (QisMFormatter)

Get_last_error_code (QisMFormatter)

Write_tiff

Write_bmp

Write_raw

QisMFormatterV2

Extension for QisMFormatterV2 (version = 2)

Write_vbmp

QisMFormatterV3

Extension for QisMFormatter (version = 3)

Write_tif8

QisMFormatterV4

Extension for QisMFormatter (version = 4)

Format_image

QisMRasterWriter

Interface to a TIFF/BMP/RAW file writer.

Version control (QisMRasterWriter)

Boundary

Boundary_dbu

QisMRasterSharedBuf

Represents an image buffer shared between multiple rasterizers

Version control (QisMRasterSharedBuf)

Get_data_extents

Write_to_disk

Clear_buffer

Bytes_per_row

Px_per_row

Px_per_col

Bytes_total

Buffer_ptr

QisMRaster

Interface to the QisMRaster Extension for QisMLib

Version control (QisMRaster)

Get_last_error_msg (QisMRaster)

Get_last_error_code (QisMRaster)

New_object

Delete_object

Create_rasterizer

Destroy_rasterizer

Create_formatter

Destroy_formatter

QisMRasterV2

Extension for QisMRaster (version = 2)

Open_file_writer

Close_file_writer

QisMRasterV3

Extension for QisMRaster (version = 3)

Rasterize_win_queue_mt

QisMRasterV4

Extension for QisMRasterV4 (version = 4)

Rasterize_win_queue_mt_paint_scratch_v2

RasterizeLargeDiskImageOpts

Rasterize_large_disk_image

Rasterize_large_disk_image_paint_scratch_v2

QisMRasterV5

Extension for QisMRasterV5 (version = 5)

WinQueueOpts

Rasterize_win_queue_mt_ext

Parent

Create_grayscale (QisMRaster)

Destroy_grayscale (QisMRaster)

Destroy_grayscale_buffer

QisMRasterV6

Extension for QisMRaster (version = 6)

Subsample_2x2

Destroy_subsampler

Destroy_subsampled_buffer

QisMRasterV7

Extension for QisMRaster (version = 7)

Create_shared_buffer

Create_rasterizer_shared_buffer


Layer Synthesis Spec.


Artwork RAW Format

QisMRaster Commands

raster.create_rasterizer

raster.destroy_rasterizer

raster.destroy_rasterizer $rstr={rstr_id}

raster.create_params

raster.destroy_params

raster.destroy_params $params={params_id}

raster.window

raster.px_window

raster.polys

raster.overlay_polys

raster.overlay_polys $rstr={rstr_id} $bin={bin_id} [mode={PAINT | SCRATCH | DITHER}]

raster.synthesized

raster.create_pns_v2_spec

raster.destroy_pns_v2_spec

raster.window_pns_v2

raster.format_image

raster.queue_mt

raster.large_disk_image

raster.get_dpi

raster.get_pixelsize

raster.get_dpi pixelsize={x}[,{y}] [units_m={units_in_meter}] [&var={var_id}] raster.get_pixelsize dpi={x}[,{y}] [units_m={units_in_meter}] [&var={var_id}]

raster.compute_px_sz

raster.compute_buf_sz

raster.compute_tile_sz

raster.get_buffer_info

QisMRaster Licensing (API)

Product name : QisMRaster License code : 14827

QisMRaster Licensing (Script)

Product name : QisMRaster License code : 14827

QisMRaster Version History

qismraster dl/so v1.25 01-2026

qismraster dl/so v1.24 08-2025

qismraster dl/so v1.23.6 05-2025

qismraster dl/so v1.23.5 03-2025

qismraster dl/so v1.23.4 05-2024

qismraster dl/so v1.23.3 01-2024

qismraster dl/so v1.23.2 01-2024

qismraster dl/so v1.23.1 12-2023

qismraster dl/so v1.23 10-2023

qismraster dl/so v1.22 10-2023

qismraster dl/so v1.21 08-2023

qismraster dl/so v1.20 04-2023

qismraster dl/so v1.18 05-2022

qismraster dl/so v1.17 03-2022

qismraster dl/so v1.16.1 09-2021

qismraster dl/so v1.15 08-2021

qismraster dl/so v1.14 03-2021

qismraster dl/so v1.13 09-2020

qismraster dl/so v1.12 07-2020

qismraster dl/so v1.11 06-2020

qismraster dl/so v1.10 02-2020

qismraster dl/so v1.9 12-2019

qismraster dl/so v1.8 12-2019

qismraster dl/so v1.7 09-2019

qismraster dl/so v1.6 05-2019

qismraster dl/so v1.5 02-2019

qismraster dl/so v1.4 01-2019

qismraster dl/so v1.3 11-2018

qismraster dl/so v1.2 10-2018

qismraster dl/so v1.1 06-2018


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 20:20:55 UTC 2026