ZPLToolkit

^FW

Orientação de CampoPreview: parcial

Gira um quarto, meia ou três quartos de volta todos os campos seguintes, permitindo rotacionar o template sem mexer em cada comando.

Sintaxe

^FWa,b

Parâmetros

ParâmetroDescrição e valores aceitosSe omitido
aRotação aplicada aos campos que não declaram a própria.N normal, R 90°, I 180°, B 270°N
bJustificação padrão, no firmware V60.14.x ou posterior.0 left, 1 right, 2 autoLast justification

Como funciona

^FW define a orientação que o ^A e todos os comandos de código de barras usam quando o próprio parâmetro `o` deles é omitido. É assim que uma etiqueta pensada para bobina em retrato é impressa em paisagem, e como um bloco de endereço na lateral é escrito sem repetir a rotação em cada linha.

O campo que declara a própria orientação vence: com ^FWR em vigor, um ^A0N ainda sai na horizontal. Isso faz do ^FW um padrão, não uma imposição — e é o que permite girar tudo e abrir exceção para um campo.

Comandos sem parâmetro de orientação não são afetados. ^GB e ^GF continuam exatamente onde e como estavam, então um template girado ainda precisa que as caixas e os gráficos sejam reposicionados na mão.

A rotação é no sentido horário, e nunca joga o campo para o outro lado da origem: o ^FO continua segurando o canto superior esquerdo do campo, medido depois do giro.

Exemplo

ZPL
^XA
^FWR
^FO60,40^A0,35,35^FDTurned^FS
^FO220,40^A0N,35,35^FDNormal^FS
^XZ

Renderizando…

O ^FWR gira o primeiro campo; o segundo declara N e sai na horizontal mesmo assim.
Abrir no visualizador

O que o preview deste site faz com ele

A orientação é aplicada, assim como a regra de que o parâmetro do próprio campo tem precedência. Já o parâmetro de justificação b não é, nem o hábito da impressora de manter o ^FW valendo entre etiquetas — aqui todo formato começa em N.

Erros comuns

  • Esperar que o ^FW gire a etiqueta inteira. Ele gira cada campo em torno da própria origem; as coordenadas continuam onde estavam, então um layout girado quase sempre precisa de novos ^FO.
  • Esperar que o ^GB acompanhe. Caixas e gráficos não têm parâmetro de orientação e continuam em pé.
  • Achar que um campo com orientação explícita ainda herda do ^FW. Um ^A0N sob ^FWR sai na horizontal, o que é fácil de ler como se o ^FW tivesse sido ignorado.

Veja também