 |
|||
 |
 |
 |
|
|
 |
 |
|
|
 |
 |
|
|
 |
 |
|
|
 |
 |
|
 |
|||
Todos os detalhes e parâmetros sobre a forma física do código de barras a ser
gerado, são obtidos dos arquivos de configuração. Trata-se de arquivos tipo texto,
presentes no mesmo diretório do CGI WEBCODE. Estes aqruivos possuem o seguinte formato:
;linhas de comentário (iniciadas por ponto-e-virgula);
[barcode]
var1=val1
var2=val2
.
.
[ hosts]
1=host1.name.com
2=host2.mane.com.uk
3=IP#1
4=IP#2
5=wild card format for IPs*.*
.
.
Pode-se ter até 999 diferentes arquivos de configuração. O file name de todos eles deve
seguir o formato WEBCnnn.INI com nnn variando de 001 a 999. Quando o CGI WEBCODE é
chamado, o número do arquivo de configuração a ser utilizado é informado como
parâmetro: G=nnn. Se este parâmetro não for informado, 001 é assumido.
Os arquivos de configuração possuem uma estrutura bastante simples: Duas seções
distintas denominadas [barcode] e [hosts].
A seção [barcode] é usada para informar os parâmetros e variáveis que definem todos
os detalhes dos códigos de barras a serem gerados. A seção [hosts] informa os nomes
e/ou IPs dos hosts autorizados a chamar o CGI WEBCODE.
Os parâmetros e variáveis possíveis nos arquivos de configuração são as seguintes:
Parâmetro |
Descrição |
| Z=xxxxxxxx | Informa a unidade métrica a ser usada, podendo ser igual a "Centímetros" ou "Polegadas". Se omitido, "Centímetros" é assumido. As medidas serão sempre informadas em milésimos de centímetros ou polegadas. Na descrição dos parâmetros que segue, supõe-se que tenha sido adotado o padrão "Centímetros". Pode-se também utilizar a unidade métrica “Pontos” através do parâmetro R=2540 (não importando neste caso o valor do parâmetro Z) |
| F=xxxxxxxx | Se informado, gera o arquivo xxxxxx.GIF contendo a imagem do código de barras gerado, no mesmo diretório em que se encontra o CGI WEBCODE |
| R=nnn | Resolução do código a ser gerado, em DPI. Os seguintes valores podem ser utilizados: 75, 150, 300, 360, 600 ou 720. Se omitido, 75 é assumido. A resolução especial 2540 tambem poderá ser utilizada, para indicar que a unidade métrica a ser utilizada será “pontos” e não centímetros ou polegadas |
| T=xxxxxxxx | Padrão do código de barras a ser gerado. A presente versão aceita os seguintes valores para esta esta variável: int2of5 (para o padrão 2 de 5 intercalado), codabar, code39, code128, ean-8, ean-13, upc-a e upc-e. Se omitido, int2of5 é assumido |
| L=xxxxxxx | Nome do arquivo do fonte a ser utilizado na geração da legenda dos códigos. Os arquivos possíveis (somente tipo TTF) deverão estar presentes no mesmo diretório em que se encontra o CGI WEBCODE. Se omitido, ARIAL.TTF é assumido |
| B=nnnnn | Largura das barras estreitas (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| E=nnnnn | Largura dos espaços estreitos (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| A=nnnnn | Altura das barras (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| M=nnnnn | Altura do prolongamento UPC/EAN (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| D=nnnnn | Altura dos caracteres na legenda (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| U=nnnnn | Largura dos caracteres da legenda (em 0,01 mm). Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| P=nn | Proporção largo / estreito x 10 dos elementos do código. Pode-se utilizar 20, 25 ou 30, correspondendo a proporções 2.0 : 1, 2,5 : 1 ou 3,0 : 1. Pode-se utilizar ainda o valor 0 para os padrões cuja proporção seja automática. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| K=0 ou 1 | Se = 1, gera o digit-check explícito do código. Se = 0, não gera. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| H=0 ou 1 | Se = 1, gera barras horizontais de proteção do código. Se = 0, não gera. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| N=0 ou 1 | Se = 1, gera as legendas do código. Se = 0, não gera. Se omitido, será assumido um valor particular para o padrão do código de barras a ser gerado (vide tabela adiante) |
| S=xy | Caracteres de start/stop para o Codabar (x=start, y=stop) ou start do Code 128 (x=start). Para o padrão Codabar pode-se utilizar os caracteres de start/stop: a, b, c, d, A, B, C, D. Para o padrão Code 128 pode-se utilizar os seguintes caracters de start: A, B ou C. Se omitido, será assumido S=ab para o Codabar e S=B para o Code 128 |
| I=xyz | Caracteres de shift A, B e C para o Code 128. Se omitido, serão asumidos os caracteres ( [ { para shift A, B e C respectivamente |
| C=xxxxx.. | Código a ser gerado. O comprimento e o tipo de dado permitido na seqüência xxxxx... dependerá do padrão do código de barras a ser gerado (vide tabela adiante) |
Todos estes parâmetros poderão ser informados também durante a chamada do CGI
WEBCODE, sendo que nestes casos, o parâmetro informado terá prioridade sobre o seu
correspondente contido no arquivo de configuração.
Assím, a ordem de prioridade para obtenção de cada um dos parâmetros será a seguinte:
| 1) | Informado na chamada. Se não for informado, o CGI WEBCODE tentará encontrá-lo no |
| 2) | Arquivo de configuração. Se não for encontrado, o CGI WEBCODE utilizará o |
| 3) | Valor default |
Quando qualquer parâmetro for informado durante a chamada do CGI WEBCODE, este deverá
seguir a mesma sintaxe descrita para o arquivo de configuração, usando o caracter &
como separador. Exemplos:
<IMG
SRC="http://www.seudomínio.com.br/cgi-bin/webcode.exe?C=982&P=30&H=1">
<IMG
SRC="http://www.seudomínio.com.br/cgi-bin/webcode.exe?C=9378&G=003">
As tabelas a seguir mostram para cada um dos padrões suportados pelo CGI WEBCODE, os
valores mínimos, máximos, opções e default de cada uma dos parâmetros:
PARÂMETROS |
Valores possíveis para os parâmetros |
|||
| 2 de 5 intercalado |
Code 39 | Code 128 | CODABAR | |
B = Largura das barras estreitas |
1 (0,01 mm) 500 (5 mm) 48 (0,48 mm) |
1 (0,01 mm) 500 (5 mm) 48 (0,48 mm) |
1 (0,01 mm) 500 (5 mm) 48 (0,48 mm) |
1 (0,01 mm) 500 (5 mm) 48 (0,48 mm) |
E = Largura dos
espaços estreitos |
B B + 20 B + 2 |
B B + 20 B + 2 |
B B + 20 B + 2 |
B B + 20 B + 2 |
| A = Altura das barras mínimo: máximo: default: |
10 (0,1 mm) 15000 (150 mm) 1600 (16 mm) |
10 (0,1 mm) 15000 (150 mm) 1600 (16 mm) |
10 (0,1 mm) 15000 (150 mm) 1600 (16 mm) |
10 (0,1 mm) 15000 (150 mm) 1600 (16 mm) |
| M= Altura do prolong. UPC/EAN | não considerado | não considerado | não considerado | não considerado |
| D = Altura dos carac. da legenda mínimo: máximo: default: |
A / 12 A / 3 A / 5 |
A / 12 A / 3 A / 5 |
A / 12 A / 3 A / 5 |
A / 12 A / 3 A / 5 |
| U = Largura dos carac. da legenda mínimo: máximo: default: |
D / 4 D * 4 2 / 3 * D |
D / 4 D * 4 2 / 3 * D |
D / 4 D * 4 2 / 3 * D |
D / 4 D * 4 2 / 3 * D |
| P = Proporção largo/estreito opções: default: |
20, 25 ou 30 20 |
20, 25 ou 30 20 |
automática --- |
20, 25 ou 30 20 |
| H = Barras horizontais opções: default: |
0 (não), 1 (sim) 0 (não) |
0 (não), 1 (sim) 0 (não) |
0 (não), 1 (sim) 0 (não) |
0 (não), 1 (sim) 0 (não) |
| N = Geração de legenda opções: default: |
0 (não), 1 (sim) 1 (sim) |
0 (não), 1 (sim) 1 (sim) |
0 (não), 1 (sim) 1 (sim) |
0 (não), 1 (sim) 1 (sim) |
| K = Check-digit explícito opções: default: |
0 (não), 1 (sim) 0 (não) |
0 (não), 1 (sim) 0 (não) |
automático --- |
0 (não), 1 (sim) 0 (não) |
| S = Caracteres de start/stop opções: default: |
não considerado --- |
não considerado --- |
A, B ou C B |
a b c d A B C D a b |
| I = Caracteres de Shift ABC opções: default: |
não considerado --- |
não considerado --- |
quaisquer ( [ { |
não considerado --- |
| C = Código a ser gerado mínimo: máximo: tipo: |
1 dígito + dck 63 dígitos + dck numéricos 0-9 |
1 dígito + dck 63 dígitos + dck 0-9 A-Z $/+-:. |
1 caracter + dck 63 caracteres + dck quaisquer |
1 dígito + dck 63 dígitos + dck 0-9 $:/.+- |
PARÂMETROS |
Valores possíveis para os parâmetros |
|||
| UPC-E | UPC-A | EAN-8 | EAN-13 | |
B = Largura das barras estreitas |
1 (0,01 mm) 500 (5 mm) 29 (0,29 mm) |
1 (0,01 mm) 500 (5 mm) 39 (0,39 mm) |
1 (0,01 mm) 500 (5 mm) 29 (0,29 mm) |
1 (0,01 mm) 500 (5 mm) 39 (0,39 mm) |
E = Largura dos
espaços estreitos |
B B + 20 B + 1 |
B B + 20 B + 1 |
B B + 20 B + 1 |
B B + 20 B + 1 |
| A = Altura das barras mínimo: máximo: default: |
10 (0,1 mm) 15000 (150 mm) 800 (8 mm) |
10 (0,1 mm) 15000 (150 mm) 2100 (21 mm) |
10 (0,1 mm) 15000 (150 mm) 800 (8 mm) |
10 (0,1 mm) 15000 (150 mm) 2100 (21 mm) |
| M= Altura do prolong. UPC/EAN mínimo: máximo: default: |
A / 16 A / 4 A / 14 |
A / 16 A / 4 A / 8 |
A / 16 A / 4 A / 14 |
A / 16 A / 4 A / 8 |
| D = Altura dos carac. da legenda mínimo: máximo: default: |
A / 12 A / 3 A / 7 |
A / 12 A / 3 A / 4 |
A / 12 A / 3 A / 7 |
A / 12 A / 3 A / 4 |
| U = Largura dos carac. da legenda mínimo: máximo: default: |
D / 4 D * 4 2 / 3 * D |
D / 4 D * 4 2 / 3 * D |
D / 4 D * 4 2 / 3 * D |
D / 4 D * 4 2 / 3 * D |
| P = Proporção largo/estreito | automática | automática | automática | automática |
| H = Barras horizontais | nunca gera | nunca gera | nunca gera | nunca gera |
| N = Geração de legenda | sempre gera | sempre gera | sempre gera | sempre gera |
| K = Check-digit explícito | automático | automático | automático | automático |
| S = Caracteres de start/stop | não considerado | não considerado | não considerado | não considerado |
| I = Caracteres de Shift ABC | não considerado | não considerado | não considerado | não considerado |
| C = Código a ser gerado mínimo: máximo: tipo: |
5 dígitos + dck 5 dígitos + dck numéricos 0-9 |
11 dígitos + dck 11 dígitos + dck numéricos 0-9 |
7 dígitos + dck 7 dígitos + dck numéricos 0-9 |
12 dígitos + dck 12 dígitos + dck numéricos 0-9 |
Observações sobre as tabelas acima:
| 1) | O código a ser gerado deve ser sempre informado SEM o digit-check. Quando for o caso, o CGI WEBCODE irá gerá-lo automáticamente |
| 2) | Se houver inconsistência dos dados informados, o CGI WEBCODE irá gerar uma mensagem
de erro que será enviada ao browser cliente em substituição ao código de barras
solicitado |
Todas as informações desta página e ainda alguns detalhes adicionais constam do módulo WEBCODE.DOC integrante do download (cópia de demonstração e testes).