Manual - Macintosh Dynamic Library Datamatrix (C, Cocoa)

Introduction

The Dynamic Library Code Datamatrix for Mac OS X creates the 2D barcode symbology Datamatrix ECC 200.

Features

Can be used from Objective-C (Cocoa) or from standard C
Supports all square module layouts up to 144 * 144.
Encodes up to 3,000 bytes.
Automatic selection of compaction modes C40, ASCII, Base 256 and Text for smallest outline.
Easy to use - create and display a barcode with only three lines of code
Sample projects in C and Objective-C
Control-internal bitpattern routines are accessible from the client for owner drawn barcodes.
Universal Binary
Small footprint, only 60 kB, only a single file

System requirements

OS X 10.4 ("Tiger") or higher. The provided samples require Xcode 2.x or higher; however, the library as such will also work with older Xcode versions. Non-Cocoa projects that use the library must be linked against the ApplicationServices framework. For use in OS versions before 10.4 we offer the source code of the library for a nominal fee so that you can compile the library against the Jaguar or Panther SDKs. See the online store for more info.

Demo / Purchasing

A demo is available; it puts the text DEMO in the encoded data, see the download area. Please see the online store for licensing options and pricing.

Installation and Setup

1. In the archive locate the file libdatamatrix.x.y.dylib. Copy this file into /usr/local/lib (you may be prompted for your administrator password).

2. In the archive locate the file WSDYx.h. Copy this file into /usr/include (you may be prompted for your administrator password) or any other directory that's in your include path. You can also copy the file into the home directory of the project that uses the library.

For a quick start see the sample projects: We provide a plain C command line tool sample and an Objective-C sample based on the Cocoa document architecture.

Where to go from here

We've provided two ready-to-compile sample projects, one in C (a command line tool), the other one in Objective-C (a Cocoa document-based application). You find the samples in the folders C-Sample and Cocoa-Sample, respectively, in the archive folder.

The command-line tool creates a barcode and saves it to a file in the /tmp directory. This sample is a good starting point if you have to batch create barcodes. The Cocoa sample looks like this:

screenshot dy1

We provide a walkthrough for both samples:

Datamatrix Dynamic Library Sample Projects

Make sure to also see the reference section of the manual.