~DG

Baixar GráficoPreview: parcial

Guarda um bitmap em hexadecimal ASCII na memória da impressora para que etiquetas posteriores o recuperem com ^XG sem carregar a imagem inteira.

Sintaxe

~DGd:o.x,t,w,data

Parâmetros

Parâmetro	Descrição e valores aceitos	Se omitido
d:o.x	Dispositivo, nome e extensão .GRF do gráfico. Omita partes apenas quando o padrão da impressora for intencional.Device, name and .GRF extension	R:UNKNOWN.GRF
t	Total de bytes do bitmap.Total bytes in the graphic	Required
w	Bytes em cada linha do bitmap. A largura desenhada é oito vezes este valor.Bytes per row	Required
data	Bytes do bitmap em hexadecimal ASCII, na ordem das linhas.ASCII hexadecimal graphic data	Required

Como funciona

~DG baixa um gráfico monocromático para um dispositivo da impressora, como a memória volátil R: ou a memória persistente E:. Os dados são hexadecimal ASCII: cada par de caracteres descreve um byte, isto é, oito pontos horizontais.

O total de bytes e os bytes por linha descrevem a mesma geometria de ^GF: divida o total pelos bytes por linha para obter a altura e multiplique os bytes da linha por oito para obter a largura preenchida. Se não baterem, a imagem armazenada é corrompida ou rejeitada.

Baixar não é desenhar. Um ^XG posterior chama o objeto pelo nome e o posiciona na etiqueta; isso economiza tráfego para um logo repetido, mas também exige que a memória da impressora contenha o ativo esperado.

Exemplo

ZPL

~DGR:SQUARE.GRF,32,2,FFFFC003A0059009881184218241818181818241842188119009A005C003FFFF
^XA
^FO40,40^XGR:SQUARE.GRF,2,2^FS
^XZ

Renderizando…

O bitmap é baixado antes do formato e ^XG o recupera com o dobro do tamanho.

Abrir no visualizador

O que o preview deste site faz com ele

A prévia registra um ~DG do mesmo texto e permite que ^XG o recupere. ~DG é reconhecido, mas não desenha nada; gráficos guardados apenas na impressora real não estão disponíveis aqui.

Erros comuns

Usar R: para um logo que precisa sobreviver ao reinício. R: é volátil; use o dispositivo persistente previsto e administre sua capacidade.
Alterar o nome em ~DG e não em ^XG. O campo passa a resolver para uma imagem vazia, sem um erro visível da impressora.
Enviar total de bytes que não corresponde ao hexadecimal ou aos bytes por linha. Confira as dimensões antes de colocar o bitmap no template.