Plataforma de Comunicação Elgin versão 3.13.9
Documentação das bibliotecas de integração com hardware Elgin
Nível de Sistema

Comandos de Nível de Sistema (System Level Commands) fornecem funções para configurar as propriedades relacionadas à impressão e ao ambiente das etiquetas. Mais...

Funções

int SetMedidas (int medida)
 Define o sistema de unidades adotado para a configuração dos campos da etiqueta e de algumas propriedades. Mais...
 
int SetBackfeed (int backfeed)
 Define a distância em que a etiqueta será deslocada da impressora após a impressão; isso faz com que a etiqueta fique a uma distância conveniente para o usuário "rasgá-lo" do restante do papel. Mais...
 
int SetPrintStPos (int printStPos)
 Define a posição inicial de impressão. Mais...
 
int SetSensor (int sensor)
 Define se o sensor a ser usado na impressão será o transmissivo ou o reflexivo. Mais...
 
int SetModoContinuo (int modoContinuo)
 Ativa (ou desativa) o modo de impressão contínuo e configura a distância de papel a ser impresso. Mais...
 
int SetLength (int length)
 Define o comprimento (altura) máximo da etiqueta. Mais...
 

Descrição detalhada

Comandos de Nível de Sistema (System Level Commands) fornecem funções para configurar as propriedades relacionadas à impressão e ao ambiente das etiquetas.

Estes parâmetros não são gravados na EPROM, logo, serão perdidos sempre que a impressora for desligada ou reiniciada.

Convenções usadas nas chamadas das funções da biblioteca:
Windows

‍__stdcall

Linux

‍__cdecl

Funções

◆ SetMedidas()

int SetMedidas ( int  medida)

Define o sistema de unidades adotado para a configuração dos campos da etiqueta e de algumas propriedades.

Parâmetros
medida- Parâmetro do tipo numérico que define se o sistema de unidades utilizado será o métrico (cm/100) ou o imperial (pol/100); cm = centímetro, pol = polegada.

Se o sistema escolhido for o métrico, os valores passados aos parâmetros relacionados ao posicionamento e às dimensões dos campos da etiqueta (coordenadas, altura e comprimento, por exemplo) estarão em centésimos de centímetro.

Se o sistema escolhido for o imperial, os valores passados àqueles parâmetros estarão em centésimos de polegada. O sistema de unidades determinado aqui também afetará outras propriedades da impressão, como o back-feed, o offset de coluna e o offset de linha.

Valores válidos:
Valor Sistema de Unidades
0 Métrico
1 Imperial

  • Se esta função não for usada, assume-se o valor 0.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetBackfeed()

int SetBackfeed ( int  backfeed)

Define a distância em que a etiqueta será deslocada da impressora após a impressão; isso faz com que a etiqueta fique a uma distância conveniente para o usuário "rasgá-lo" do restante do papel.

  • OBS: A impressora L42PRO não suporta esta função.
Parâmetros
backfeed- Parâmetro do tipo numérico que define o back-feed de impressão.

Valores válidos:

‍Números entre 220 e 999 (220, 221, 222, ..., 999).


Exemplos:
Valor Back-feed (métrico) Back-feed (imperial)
220 (Valor padrão) (Valor padrão)
250 +3 milímetros +3 décimos de polegada
320 +1 centímetro +1 polegada

  • Se esta função não for usada, assume-se o valor 250.
  • OBS: Atente-se ao valor configurado na função SetMedidas.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetPrintStPos()

int SetPrintStPos ( int  printStPos)

Define a posição inicial de impressão.

  • OBS: A impressora L42PRO não suporta esta função.
Parâmetros
printStPos- Parâmetro do tipo numérico que define a posição inicial de impressão. O valor padrão 220 configura a posição incial exatamente abaixo da linha TPH (cabeça de impressão).

Valores válidos:

‍Números entre 0 e 9999 (0, 1, 2, ..., 9999).


  • Se esta função não for usada, assume-se o valor 220.
  • OBS: Use esta função somente se realmente necessário.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetSensor()

int SetSensor ( int  sensor)

Define se o sensor a ser usado na impressão será o transmissivo ou o reflexivo.

Parâmetros
sensor- Parâmetro do tipo numérico que define o sensor a ser utilizado na impressão.

Valores válidos:
Valor Sensor
0 Transmissivo
1 Reflexivo

  • Se esta função não for usada, assume-se o valor 0.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetModoContinuo()

int SetModoContinuo ( int  modoContinuo)

Ativa (ou desativa) o modo de impressão contínuo e configura a distância de papel a ser impresso.

Parâmetros
modoContinuo- Parâmetro do tipo numérico que ativa e define a distância de impressão do modo contínuo, isto é, a quantidade de papel que será impresso entre o início e o final da impressão, em centésimos de centímetro (ou de polegada).

Se o modo contínuo for usado, as configurações feitas nas funções SetSensor e SetPrintStPos serão ignoradas.

Valores válidos:

‍Números entre 0 e 9999 (0, 1, 2, ..., 9999).


Exemplos:
Valor Distância (métrico) Distância (imperial)
5 Meio milímetro 5 centésimos de polegada
10 1 milímetro 1 décimo de polegada
200 2 centímetros 2 polegadas
4500 45 centímetros 45 polegadas

  • Se esta função não for usada, assume-se o valor 0.
  • OBS: Atente-se ao valor configurado na função SetMedidas.
  • OBS: Para desativar/não usar o modo contínuo, use o valor 0.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.

◆ SetLength()

int SetLength ( int  length)

Define o comprimento (altura) máximo da etiqueta.

Parâmetros
length- Parâmetro do tipo numérico que define o comprimento (altura) máximo da etiqueta.

Valores válidos:

‍Números entre 0 e 9999 (0, 1, 2, ..., 9999).


Exemplos:
Valor Length (métrico) Length (imperial)
300 3 centímetros 3 polegadas
1200 12 centímetros 12 polegadas

  • Se esta função não for usada, assume-se o valor 0.
  • OBS: Atente-se ao valor configurado na função SetMedidas.
  • OBS: Os valores suportados variam de 1" a 12".
  • OBS: O valor 0 ignora esta função.

Retorna
O retorno da função é do tipo numérico.
A função bem-sucedida deve retornar 0.