DEVELOPER DOCUMENTATION

DataMatrix Generator Parameters

Configure the DataMatrix symbol format, encoding, quiet zone, alignment, colors and image dimensions using the BCMaker CGI generator.

Try DataMatrix Official CGI Help ↗

DataMatrix / API

GET /cgi-bin/dmtxcgidHTTP / HTTPS

API OVERVIEW

One request. One barcode image.

Specify the data and optional barcode settings through the BCMaker generator endpoint. The official CGI help confirms GET and POST are both accepted.

GEThttps://www.bcmaker.com/cgi-bin/dmtxcgid

Parameters listed15

Reference valuesCGI help

Barcode typeDataMatrix

01 / BASICS

Image & Data

Set encoded data and pixel sizing.

Image & Data parameters
Parameter	Description	Accepted values	Default
`data`	Information to encode into the DataMatrix symbol.	URL-encoded text or numeric data	`1234567`
`w`	Output image width.	Pixel value	`100`
`h`	Output image height.	Pixel value	`100`
`xdim`	Size of a DataMatrix module; used when image dimensions are not provided.	Pixel size; ignored when w and h are used	`5`

02 / ENCODING

Symbol & Encoding

Control DataMatrix dimensions and data encoding method.

Symbol & Encoding parameters
Parameter	Description	Accepted values	Default
`fmt`	Preferred DataMatrix format / matrix dimensions.	Integer 0–30	`0`
`mode`	DataMatrix encoding mode.	Integer 0–6	`0`

03 / APPEARANCE

Appearance & Colors

Control rotation, quiet zones, alignment and colors.

Appearance & Colors parameters
Parameter	Description	Accepted values	Default
`angle`	Rotation of the DataMatrix code.	0, 90, 180, 270 degrees	`0`
`quiet`	Draw a quiet zone around the symbol.	0 = Hide; 1 = Show	`1`
`qsize`	Quiet zone size.	Nonnegative value (0 and above)	`1`
`alignh`	Position the barcode horizontally in the image.	Integer 0–3	`1`
`alignv`	Position the barcode vertically in the image.	Integer 0–3	`1`
`bcolor`	Background color expressed as an RGB hex value.	000000–ffffff, no # prefix	`ffffff`
`fcolor`	Color of the DataMatrix modules.	000000–ffffff, no # prefix	`000000`

04 / UTILITIES

Help & Debug

Built-in CGI diagnostics.

Help & Debug parameters
Parameter	Description	Accepted values	Default
`help`	Returns documentation for DataMatrix CGI parameters.	help=1	`—`
`debug`	Provides diagnostic details for processing errors.	Example: debug=1	`—`

EXAMPLE REQUEST

Generate a DataMatrix barcode

This example encodes 1234567 and includes the settings from the BCMaker demonstration request.

DataMatrix • GET

https://www.bcmaker.com/cgi-bin/dmtxcgid?data=1234567&fmt=0&mode=0&angle=0&quiet=1&alignh=1&alignv=1&bcolor=ffffff&fcolor=000000&qsize=1&xdim=5&w=&h=&submit=+Generate+DataMatrix+&debug=1

Open Example Request

GOOD TO KNOW

Implementation Notes

Automatic sizing

The help specifies that xdim is meaningful only if w and h are not used. A blank w= and h= appears in the demo URL.

Format and mode

The server lists numeric ranges for fmt and mode but does not define the meaning of each individual value on its help page.

Quiet zone

quiet switches clear margins on or off; qsize controls their size.

Server defaults

Defaults are taken from the DataMatrix CGI help page. They may differ from individual demo form presets.

Reference: Official CGI Help. CGI help defaults.

Ready to generate a barcode?

Open the BCMaker generator and choose DataMatrix.

Go to Generator