ZPLToolkit

^GC

Graphic CirclePreview: partial

Draws a circle with a diameter, border thickness and colour at the current field origin.

Syntax

^GCd,t,c

Parameters

ParameterDescription and accepted valuesIf omitted
dCircle diameter in dots.Thickness to 32000 dots — diameterValue of t
tBorder thickness in dots.1 to 32000 dots — border thickness1 dot
cB draws black; W draws white.B black or W whiteB

How it works

^GC creates a circular graphic field. Its diameter and border are measured in dots, so the same source has a different physical size at another print resolution.

A zero or omitted diameter falls back to the border thickness. Write both values explicitly when a template needs a predictable mark.

The circle is a graphic field closed by ^FS. Place it with ^FO or ^FT and combine it with ^FR when it must reverse against existing label content.

Example

ZPL
^XA
^FO80,50^GC120,4,B^FS
^XZ

Rendering…

A 120-dot outlined circle at the field origin.
Open in the viewer

How the preview on this site handles it

The preview draws the circle and its ^FO/^FT and ^FR placement. ^GC has no orientation parameter, so ^FW does not rotate it.

Common mistakes

  • Treating the diameter as millimetres.
  • Forgetting ^FS.
  • Expecting ^FW to turn the circle.

See also