¿Quieres probar estos comandos en un editor real? Abre
EditorZPL y copia el ejemplo.
~DG
~DG – Descargar Gráfico
Carga imágenes en formato hexadecimal para usar en etiquetas.
Sintaxis
~DG{d}:{o}.x,{t},{w},{data}
Parámetros
- D (dispositivo): Ubicación de memoria para el gráfico. (R: (DRAM), E: (Flash), B:, A: (por defecto: R:))
- O (nombre): Nombre del archivo gráfico. (1–8 caracteres (por defecto: UNKNOWN))
- X (extensión): Extensión del archivo (se añade .GRF automáticamente si no se especifica). (.GRF)
- T (bytes totales): Número total de bytes del gráfico. Fórmula: (ancho_mm × dpi / 8) × (alto_mm × dpi) (Valor calculado según dimensiones)
- W (bytes por fila): Número de bytes por cada fila del gráfico. Fórmula: ancho_mm × dpi / 8 (Valor calculado según ancho)
- DATA (datos): Cadena hexadecimal que representa el gráfico. Cada carácter hex representa 4 píxeles horizontales. (Cadena hexadecimal ASCII)
Ejemplo
~DGR:LOGO.GRF,00128,016,
FFFFFFFFFFFFFFFF
F000000000000000F
F000000000000000F
FFFFFFFFFFFFFFFF
^XA
^FO100,100^XGR:LOGO.GRF,1,1^FS
^XZ
Nota: No uses espacios ni puntos en los nombres de gráficos. Si envías dos gráficos con el mismo nombre, el primero se sobrescribe. Para más opciones de descarga, considera usar ~DY.
~EG
~EG – Borrar Todos los Gráficos
Elimina todos los gráficos descargados de la memoria de la impresora.
Parámetros
- - (sin parámetros): Este comando no requiere ningún parámetro. Se ejecuta directamente y borra todos los gráficos almacenados. (Ninguno)
Ejemplo
~EG
^XA
^FO50,50^A0N,40,40^FDGráficos borrados correctamente^FS
^XZ
Nota: Atención: Este comando es irreversible. Una vez ejecutado, todos los gráficos almacenados se perderán permanentemente y deberán ser redescargados si se necesitan. Se recomienda hacer una copia de seguridad de los gráficos importantes antes de ejecutar ~EG. El comando ^EG es equivalente y se puede usar indistintamente.
^GB
^GB – Caja Gráfica
Dibuja cajas rectangulares y líneas en la etiqueta con opciones de grosor, color y esquinas redondeadas.
Sintaxis
^GB{w},{h},{t},{c},{r}
Parámetros
- W (ancho de caja): Ancho de la caja en puntos (dots). (Valor de t a 32000. Por defecto: valor de grosor (t) o 1)
- H (alto de caja): Alto de la caja en puntos (dots). (Valor de t a 32000. Por defecto: valor de grosor (t) o 1)
- T (grosor del borde): Grosor del borde en puntos. (1 a 32000. Por defecto: 1)
- C (color de línea): Color de la línea del borde. (B = negro, W = blanco. Por defecto: B)
- R (redondeo de esquinas): Grado de redondeo de las esquinas. (0 (sin redondeo) a 8 (máximo redondeo). Por defecto: 0)
Ejemplo
^XA
^FO50,50^GB300,200,10^FS
^FO50,300^GB300,200,10,,5^FS
^FO400,50^GB0,200,20^FS
^FO400,300^GB200,0,30^FS
^XZ
Nota: Si ancho y alto no se especifican, se obtiene una caja sólida con dimensiones según el valor t. La fórmula del redondeo es: radio = (índice/8) * (lado menor/2). Para impresoras de 203 dpi, multiplique milímetros por 8 para obtener puntos.
^GC
^GC – Círculo Gráfico
Dibuja un círculo en la etiqueta con diámetro, grosor y color configurables.
Parámetros
- D (diámetro del círculo): Diámetro del círculo en puntos. (3 a 4095 (valores mayores se reemplazan por 4095). Por defecto: 3)
- T (grosor del borde): Grosor del contorno en puntos. (2 a 4095. Por defecto: 1)
- C (color de línea): Color del contorno del círculo. (B = negro, W = blanco. Por defecto: B)
Ejemplo
^XA
^FO50,50^GC150,10,B^FS
^FO250,50^GC150,50,B^FS
^XZ
Nota: El grosor del borde se extiende hacia el interior del círculo. Para crear un círculo sólido, establezca el grosor igual al radio (diámetro/2).
^GD
^GD – Línea Diagonal Gráfica
Dibuja una línea diagonal dentro de un área rectangular especificada.
Sintaxis
^GD{w},{h},{t},{c},{o}
Parámetros
- W (ancho del área): Ancho del área que contiene la diagonal en puntos. (3 a 32000. Por defecto: valor de t o 3)
- H (alto del área): Alto del área que contiene la diagonal en puntos. (3 a 32000. Por defecto: valor de t o 3)
- T (grosor de línea): Grosor de la línea diagonal en puntos. (1 a 32000. Por defecto: 1)
- C (color de línea): Color de la línea diagonal. (B = negro, W = blanco. Por defecto: B)
- O (orientación): Dirección de la diagonal. (R (o /) = diagonal hacia la derecha, L (o \) = diagonal hacia la izquierda. Por defecto: R)
Ejemplo
^XA
^FO150,100^GB350,200,10^FS
^FO155,110^GD330,180,10,,R^FS
^XZ
Nota: La diagonal conecta una esquina con la esquina opuesta del rectángulo definido por ancho y alto. Use R para diagonal de arriba-izquierda a abajo-derecha, L para la dirección opuesta.
^GE
^GE – Elipse Gráfica
Dibuja una elipse (óvalo) en la etiqueta con dimensiones y grosor configurables.
Sintaxis
^GE{w},{h},{t},{c}
Parámetros
- W (ancho de elipse): Ancho de la elipse en puntos. (3 a 4095 (valores mayores se reemplazan por 4095). Por defecto: valor de t o 1)
- H (alto de elipse): Alto de la elipse en puntos. (3 a 4095. Por defecto: valor de t o 1)
- T (grosor del borde): Grosor del contorno de la elipse en puntos. (2 a 4095. Por defecto: 1)
- C (color de línea): Color del contorno de la elipse. (B = negro, W = blanco. Por defecto: B)
Ejemplo
^XA
^FO100,100^GE300,150,10,B^FS
^XZ
Nota: Si el ancho y alto son iguales, se obtiene un círculo. Para crear una elipse sólida, establezca el grosor igual a la mitad de la dimensión menor.
^GF
^GF – Campo Gráfico
Descarga e imprime datos gráficos directamente en la etiqueta sin guardarlos en memoria.
Sintaxis
^GF{a},{b},{c},{d},{data}
Parámetros
- A (tipo de compresión): Formato de los datos gráficos enviados. (A = hexadecimal ASCII, B = binario, C = binario comprimido. Por defecto: A)
- B (bytes binarios): Número total de bytes a transmitir para la imagen. (1 a 99999. Obligatorio)
- C (bytes del gráfico): Número total de bytes que componen el formato gráfico (ancho x alto). (1 a 99999. Obligatorio)
- D (bytes por fila): Número de bytes que componen una fila de la imagen. (1 a 99999. Obligatorio)
- DATA (datos): Datos del gráfico en el formato especificado. (Hexadecimal ASCII (00-FF), binario o binario comprimido)
Ejemplo
^XA
^FO100,100
^GFA,128,128,16,
FFFFFFFFFFFFFFFF
F000000000000000F
F000000000000000F
F000000000000000F
FFFFFFFFFFFFFFFF
^FS
^XZ
Nota: Para ASCII, use dos dígitos hex por byte de imagen. Una coma en los datos rellena la línea actual con 00 (blanco). ~DN o cualquier ^ o ~ aborta la descarga. Para imágenes grandes, considere usar ~DG para almacenar el gráfico.
^GS
^GS – Símbolo Gráfico
Imprime símbolos especiales como ®, ©, ™ y marcas de certificación.
Parámetros
- O (orientación): Orientación del símbolo. (N = normal, R = rotado 90°, I = invertido 180°, B = 270°. Por defecto: N o último valor ^FW)
- H (altura del carácter): Altura del símbolo proporcional al ancho (en puntos). (0 a 32000. Por defecto: último valor ^CF)
- W (ancho del carácter): Ancho del símbolo proporcional a la altura (en puntos). (0 a 32000. Por defecto: último valor ^CF)
Ejemplo
^XA
^FO50,50^CF0,30
^FDZEBRA PROGRAMMING^FS
^FO50,100
^FDLANGUAGE II (ZPL II^FS
^FO280,100^GS^FDC^FS
^FO295,100^FD)^FS
^XZ
Nota: Símbolos disponibles: A = ® (Marca Registrada), B = © (Copyright), C = ™ (Trademark), D = (UL) Underwriters Laboratories, E = (CSA) Canadian Standards Association. Use ^GS seguido de ^FD con la letra correspondiente.
^ID
Eliminar Objeto
El comando ^ID elimina objetos, gráficos, fuentes y formatos almacenados de las áreas de memoria de la impresora. Los objetos pueden eliminarse selectivamente o en grupos usando comodines (*). Puede usarse dentro de un formato de impresión para eliminar objetos antes de guardar nuevos.
Parámetros
- D (Dispositivo): Ubicación del objeto almacenado (R:, E:, B:, A: (por defecto R:))
- O (Nombre del objeto): Nombre del objeto a eliminar. Soporta comodín (*) (1 a 8 caracteres (por defecto UNKNOWN))
- X (Extensión): Extensión del archivo. Soporta comodín (*) (Cualquier extensión Zebra válida (por defecto .GRF))
Ejemplo
^XA
^IDR:*.ZPL^FS
^XZ
// Eliminar todos los .GRF de RAM:
^XA
^IDR:*.GRF^FS
^XZ
// Eliminar un archivo específico:
^XA
^IDR:LOGO.GRF^FS
^XZ
Nota: Al eliminar de R: la memoria queda disponible inmediatamente. En A:, B:, E: el espacio se recupera tras desfragmentación automática. El comodín *.ZOB elimina todas las fuentes de códigos de barras descargadas.
^IL
Cargar Imagen
El comando ^IL se usa al inicio de un formato de etiqueta para cargar una imagen almacenada de un formato y fusionarla con datos adicionales. La imagen siempre se posiciona en ^FO0,0. Esta técnica de superponer información constante con datos variables aumenta significativamente el rendimiento del formato.
Parámetros
- D (Dispositivo): Ubicación del objeto almacenado (R:, E:, B:, A: (por defecto R:))
- O (Nombre del objeto): Nombre de la imagen a cargar (1 a 8 caracteres alfanuméricos (por defecto UNKNOWN))
- X (Extensión): Extensión del archivo gráfico (.GRF, .PNG (fijo))
Ejemplo
^XA
^ILR:PLANTILLA.GRF^FS
^CFD,36,20
^FO15,210
^FD900123^FS
^FO218,210
^FDLINEA 12^FS
^XZ
Nota: Usar junto con ^IS para guardar la imagen base. La imagen se carga en posición 0,0 y los datos variables se superponen con ^FO y ^FD normalmente.
^IM
Mover Imagen
El comando ^IM realiza un movimiento directo de una imagen desde el área de almacenamiento hacia el bitmap de impresión. Es idéntico al comando ^XG (Recall Graphic) pero sin parámetros de escalado, lo que puede resultar en menor tiempo de formateo.
Parámetros
- D (Dispositivo): Ubicación del objeto almacenado (R:, E:, B:, A: (por defecto prioridad de búsqueda))
- O (Nombre del objeto): Nombre de la imagen a mover (1 a 8 caracteres alfanuméricos (por defecto UNKNOWN))
- X (Extensión): Extensión del archivo gráfico (.GRF, .PNG (fijo))
Ejemplo
^XA
^FO100,100^IMR:LOGO.GRF^FS
^FO100,300^IMR:LOGO.GRF^FS
^FO100,500^IMR:LOGO.GRF^FS
^XZ
Nota: A diferencia de ^XG, ^IM no tiene magnificación y puede requerir menos tiempo de formateo. Para aprovechar esto, la imagen debe estar en límite de 8, 16 o 32 bits. Use ^FO para posicionar el gráfico en cualquier lugar.
^IS
Guardar Imagen
El comando ^IS guarda un formato de etiqueta como imagen gráfica en lugar de como script ZPL. Se usa típicamente al final de un script. La imagen guardada puede recuperarse posteriormente con prácticamente ningún tiempo de formateo y superponerse con datos variables para formar una etiqueta completa.
Parámetros
- D (Dispositivo): Ubicación donde guardar el objeto (R:, E:, B:, A: (por defecto R:))
- O (Nombre del objeto): Nombre para guardar la imagen (1 a 8 caracteres alfanuméricos (por defecto UNKNOWN))
- X (Extensión): Formato de la imagen (.GRF, .PNG (por defecto .GRF))
- P (Imprimir después): Imprimir la imagen después de guardarla (Y=sí, N=no (por defecto Y))
Ejemplo
^XA
^LH10,15^FWN^BY3,3,85^CFD,36
^GB430,750,4^FS
^FO135,20^A0,70,60
^FDZEBRA^FS
^FO80,100^A0,40,30
^FDTECHNOLOGIES CORP^FS
^ISR:PLANTILLA.GRF,N
^XZ
Nota: Usar junto con ^IL para cargar la imagen. Esta técnica aumenta drásticamente el rendimiento al separar la información constante (guardada como imagen) de los datos variables.
^XG
Recuperar Gráfico
El comando ^XG se usa para recuperar una o más imágenes gráficas para imprimir. Se usa en un formato de etiqueta para combinar gráficos, como logos de empresa y piezas, con datos de texto para formar una etiqueta completa.
Parámetros
- D (Dispositivo): Dispositivo de origen de la imagen (R:, E:, B:, A: (por defecto: prioridad R:, E:, B:, A:))
- O (Nombre): Nombre de la imagen almacenada (1 a 8 caracteres alfanuméricos (por defecto: UNKNOWN))
- X (Extensión): Extensión del archivo (.GRF (fijo))
- MX (Magnificación X): Factor de magnificación en el eje X (1 a 10 (por defecto: 1))
- MY (Magnificación Y): Factor de magnificación en el eje Y (1 a 10 (por defecto: 1))
Ejemplo
^XA
^FO100,100^XGR:LOGO.GRF,1,1^FS
^FO100,300^XGR:LOGO.GRF,2,2^FS
^XZ
Nota: Una imagen puede recuperarse y redimensionarse tantas veces como sea necesario en cada formato. Se pueden añadir otras imágenes y datos al formato.