User guide

SD/CD Series Card Printers OpenCard Data Format Guide 29
Adding Text and Image Layers
Within each personalization operation, you create text and image layers that describe all aspects
of the actual text and image, as described in the following:
• Defining Text ID Layers on page 29
• Using Bar Code-Specific Attributes on page 36
• Defining Image Element Layers on page 39
Defining Text ID Layers
Attributes for height, width, font-families, transformations, and other location and appearance
details of text data to be personalized to a card are set here. In addition, bar code fonts and
other bar code attributes are defined within a text id layer. Begin each text or image layer with
<g>, add the text or graphic elements and their attributes, and then end the definition with </g>.
When used in a GRAPHIC_MONOCHROME or GRAPHIC_COLOR layer, OpenCard renders the text
data using a TrueType font of the specified font-family at the specified font-size at the specified
[x,y] location on the card. Other text attributes may be defined.
When used in a MAGSTRIPE layer, the personalization data is simply be encoded to the magnetic
stripe track corresponding to the “datacard:trackType” defined.
Refer to the “Text Element Layer Example” on page 33 for a practical example of how text id
layers are constructed.
There are two kinds of IDs that are important for use in OpenCard systems: dynamic text IDs and
static text IDs.
Dynamic Text Elements
Dynamic text describes an element whose personalization is to be taken in whole or
in part from an OpenCard data stream. A dynamic text ID must be of the form “LINEn”
where n can be from 1 to 15 (e.g., “LINE1”, “LINE2”, …, “LINE15”). An ID of “LINE1”
uses data supplied in the first personalization data line of an OpenCard data stream.