^XG

Recuperar GráficoPreview: parcial

Desenha um bitmap que foi baixado uma vez para a impressora, em vez de reenviá-lo a cada etiqueta.

Sintaxe

^XGd:o.x,mx,my

Parâmetros

Parâmetro	Descrição e valores aceitos	Se omitido
d:o.x	Dispositivo, nome e extensão do gráfico armazenado, como em R:LOGO.GRF.Device, name and extension of the stored graphic	R:, .GRF
mx	Ampliação horizontal, de 1 a 10.1 to 10 — horizontal magnification	1
my	Ampliação vertical, de 1 a 10.1 to 10 — vertical magnification	1

Como funciona

Um logotipo não muda de uma etiqueta para outra, então mandá-lo dentro de cada uma desperdiça o link. O ~DG guarda o bitmap na impressora com um nome, e o ^XG o desenha — o formato seguinte carrega algumas dezenas de bytes onde antes carregava centenas de kilobytes.

O nome é composto por dispositivo, arquivo e extensão, como em R:LOGO.GRF. O dispositivo e a extensão podem ser omitidos; a impressora assume R: e .GRF.

Os dois parâmetros de ampliação repetem pontos em vez de reamostrar, então a imagem dobra de tamanho sem ganhar detalhe. Guarde o gráfico no tamanho em que pretende imprimi-lo e use a ampliação só quando quiser mesmo o efeito quadriculado.

Exemplo

ZPL

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

Renderizando…

Um bitmap de 16 × 16 pontos baixado uma vez e recuperado com o dobro do tamanho.

Abrir no visualizador

O que o preview deste site faz com ele

A prévia guarda os gráficos que um ~DG do mesmo texto baixou e os desenha com a ampliação pedida. Um nome para o qual esta prévia nunca viu um ~DG não desenha nada, porque a imagem vive na impressora e não no formato.

Erros comuns

Recuperar um nome que nunca foi baixado. A impressora não desenha nada e não reclama, e é por isso que um logotipo ausente é tão difícil de perceber.
Supor que o armazenamento sobrevive a um desligamento. R: é memória volátil; use E: para um gráfico que precise durar mais que o reinício.
Ampliar um gráfico pequeno para preencher um espaço. Os pontos são repetidos, então as bordas ficam quadriculadas — guarde-o já no tamanho necessário.