^FD - Field Data

^FD carries the content of a field. The rest of the field decides what that content becomes: the same ^FDHELLO prints as text after ^A0N,40,40, and becomes bars after ^BCN,80. The data must not contain a literal caret or tilde, because those start the next command. ^FH and ^CC/^CT are the ways around it.

Syntax

^FDa

Support

Supportedparsed: full · state: full · rendered: full

Every documented parameter renders the same output Labelary produces.

Labelary renders this command.

Parameters

aField dataoptional · text

The content to print. A caret or tilde would start the next command, so neither can appear literally without ^FH hex escapes, or new prefixes from ^CC and ^CT.

Default: empty, which prints nothing
Accepted range: 0 to 3072 bytes
Invalid value: not possible — any value is accepted. The renderer truncates data beyond 3072 bytes. What counts as printable depends on the field: a barcode field rejects characters its symbology cannot encode, and reports RENDER_ERROR.
Test coverage: No test at the minimum, maximum or one step outside the range.

Behavior

The data runs from ^FD to the next command prefix, and ^FS closes the field. A field can carry only one ^FD: a second one replaces the first.

\& inside the data forces a line break, which makes a multi-line address block out of one field. It works with ^FB: the renderer splits the text at every \& first, then wraps each line to the block width.

Two routes put a caret or tilde on the label. ^FH writes the byte as a hexadecimal escape (_5E for ^), applies to one field, and is the usual choice. ^CC and ^CT change the prefixes for everything that follows, which frees the old characters for data, but also persists past ^XZ into the next label. The current prefix never prints. A backslash needs ^CI13.

^FD is also what makes a field draw at all. The renderer draws a field with no bar code, box or image element as a text run, so data attached to an unimplemented command still prints.

Tested behavior

Example

One plain field and one split into lines by \&:

^XA
^FO40,30^A0N,30,30^FDone field, one line^FS
^FO40,90^A0N,30,30^FB600,3
^FDsplit here\&and here^FS
^XZ

Open in viewer

^FS Field SeparatorEnds the current field.
^FH Field Hexadecimal IndicatorLets the following `^FD` carry bytes as hexadecimal escapes.
^FV Field VariableSupplies field data the printer clears after the label prints, unlike `^FD`.
^FO Field OriginSets the top-left corner of the next field.
^FB Field BlockWord-wraps the field's text into a block of a given width.