Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-1) was last changed on 28-Aug-2023 11:26 by UnknownAuthor

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 added 315 lines
%%(display:none)
{{{
WikiUp
}}}
/%
[{TableOfContents }]\\
Le righe processate dal file INV hanno degli headers (TAG) che definiscono il tipo di riga, il formato del testo contenuto e l'eventuale file di overlay.\\
\\
Gli headers hanno il seguente schema:\\
%%quote
....+....1....+....2....+....3....+....4....+....5
TAGattributi............Testo o altri dati (in base al TAG)
/%
----
\\
!!! Dettaglio dei valori da ssegnare ad una riga\\
\\
!!! COORDINATE ASSOLUTE\\
Le coordinate assolute, supportate in alcune specifiche sono espresse in punti tipografici. Di seguito sono riportate le dimensioni dei principali formati PDF generabili:\\
||Nota||Larghezza||Altezza
|il formato A2 verticale ha come dimensioni|1190|1684\\
|il formato A2 orizzontale ha come dimensioni|1684|1190\\
|il formato A3 verticale ha come dimensioni|842|1190\\
|il formato A3 orizzontale ha come dimensioni|1190|842\\
|il formato A4 verticale ha come dimensioni|595|842\\
|il formato A4 orizzontale ha come dimensioni|842|595\\
|il formato A5 verticale ha come dimensioni|421|595\\
|il formato A5 orizzontale ha come dimensioni|595|421\\
|il formato LT verticale ha come dimensioni|612|792\\
|il formato LT orizzontale ha come dimensioni|792|612\\
\\
Per dare un'idea della proporzionalità fra CPI e punti tipografici: 10 CPI corrispondono a 12,545664208490477228218892550631 punti, 12 CPI a 10,467760016547598883248141693027 punti e 15 CPI a 8,3481927710843373493975903614448 punti.\\
Di seguito sono riportati gli elenchi dei valori consentiti per ogni flag di formato:\\
\\
!!! STILE FONT\\
||Cod.||Descr.
|NORMAL|"-"\\
|ITALIC|"A"\\
|BOLD|"B"\\
|BOLDITALIC|"C"\\
|UNDERLINE|"D"\\
|BOLDUNDERLINE|"E"\\
|BOLDITALICUNDERLINE|"F"\\
|ITALICUNDERLINE|"G"\\
|STRYKE|"H"\\
|BOLDSTRYKE|"I"\\
|BOLDITALICSTRYKE|"L"\\
|ITALICSTRYKE|"M"\\
\\
\\
!!! DIMENSIONE FONT\\
La dimensione font segue la seguente scala:\\
%%quote
0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwyz.
/%
----
La scala è operativa dal valore 5 in avanti.\\
Oltre questa scala di valori esistono dei valori aggiuntivi gestiti.\\
Fra questi vengono gestiti dei valori grandi predefiniti ed equivalenti a 70, 90, 110, 130, 150 punti.\\
Tali valori sono rappresentati da:\\
||Cod.||Descr.
|é | equivalente a 70\\
|è | equivalente a 80\\
|à | equivalente a 90\\
|ò | equivalente a 100\\
|ù | equivalente a 110\\
\\
Vengono inoltre gestite quattro unità di misura espresse in CPI che sono espresse attraverso i seguenti simboli:\\
||Cd.||CPI||Alternativa
|L(NUM)\\
| |che rappresenta i 15 CPI| in alternativa usare il caratterer 4\\
|\\
|§ |che rappresenta i 12 CPI| in alternativa usare il caratterer 3\\
|L(PUN)\\
| |che rappresenta i 10 CPI| in alternativa usare il caratterer 2\\
|\\
|& |che rappresente i 6 CPI| in alternativa usare il caratterer 1\\
\\
E' anche possibile esprimere l'unità di misura, utile per l'altezza righe, di 6 LPI attraverso il seguente simbolo:\\
||Cd.||CPI||Alternativa
|% |rappresenta la dimensione di 6 LPI| in alternativa usare il caratterer 0 (zero)\\
\\
\\
!!! TIPO FONT\\
||Descr.||Cod.
|ARIAL|"A"\\
|HELVETICA|"B"\\
|COURIER|"C"\\
|COURIER NEW|"D"\\
|TIMES NEW ROMAN|"F"\\
|VERDANA|"H"\\
\\
E' possibile estendere la categoria dei fonts con dei files (fino a tre) personalizzati. Per far ciò è necessario posizionare i files di font .ttf nella cartella Fonts contenuta in smedg. Tali files dovranno avere un nome che comincia con P1_ , P2_ e P3_ e saranno associati alle categoria fonts "X " , "Y" e "Z" rispettivamente. Per esemplificare: posizionando nella cartella smedg/Fonts il file P1_ lucidabrightregular.ttf esso sarà riferibile come "X". Tali files di font dovranno avere la licenza d'uso.\\
\\
!!! COLORE FONT\\
||Descr.||Cod.
|NERO|"A"\\
|BIANCO|"B"\\
|ROSSO|"C"\\
|VERDE|"D"\\
|BLU|"E"\\
|GIALLO|"F"\\
|VIOLA|"G"\\
|AZZURRO|"H"\\
|GRIGIO|"I"\\
|GRIGIOCHIARO|"J"\\
|VERDEPASTELLO|"L"\\
|ROSAPASTELLO|"M"\\
|SALMONE|"N"\\
|GIALLOCANARINO|"O"\\
|PERVINCA|"P"\\
\\
Oltre a questi è possilbile definire dei colori "custom" come spiegato nella spcifica RGB.\\
\\
!!! ALTEZZA RIGA\\
L'altezza riga, come anche la dimensione font, segue la seguente scala:\\
%%quote
0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwyz.
/%
----
!!! TIPO BARCODE\\
||Valore||Cod.||Descr.
|CODE39| "A"|Alfanumerico lunghezza libero\\
|UPCA| "B"| Solo numerico 12 cifre\\
|UPCAH| "C"|Solo numerico 12 cifre\\
|EAN13| "D"|\\
|EAN13H| "E"|\\
|EAN13B| "E"|Solo numerico 13 cifre\\
|EAN13BH| "F"|Solo numerico 13 cifre\\
|EAN13HH| "G"|Solo numerico 13 cifre\\
|INTERLEAVED25| "H"|Solo numerico 10 cifre\\
|INTERLEAVED25NT| "I"|Solo numerico 10 cifre\\
|CODE128| "J"|\\
|EAN_SUPP| "K"|\\
|PDF417| "L"|\\
|POSTNET| "M"|\\
|PLANET| "N"|\\
|CODE39_EXT| "O"|Alfanumerico lunghezza libero\\
\\
\\
!!! FOR Formato del documento\\
Con la funzione FOR viene definito il formato (A0, A1, A2, A3, A4, Letter) e l'orientamento (Orizzontale o Verticale) del documento da creare\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Formato\\
!! Esempio\\
* TODO\\
!!! BRD Margini del documento\\
Con la funzione BRD viene definita le dimensione dei margini (sinistro, destro, superiore, inferiore) del documento\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Margini\\
I margini del documento hanno la precedenze su qualsiasi altro tag, che si adatta automaticamente alla dimensione stabilita dai margini.\\
!! Esempio\\
* TODO\\
!!! NPG Salto pagina\\
\\
!!! INC Iinclusione di un file di OVERLAY o di schema\\
!! Formato riga\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
Path del file da includere:\\
* PDF - verrà utilizzato come overlay di pagina. Verrà assunto interamente tale file come overlay. Nel caso di un PDF multipagina verranno scandite tutte le pagine ed aggiunte al documento. Se si fa riferimento ad un PDF multipagine è possibile utilizzare una specifica pagina di quest'ultimo indicando alla posizione 11.\\
* TXT - Un file di testo con struttura compatibile, le cui specifiche vengono importate\\
!! Esempio\\
* TODO\\
!!! PAG Importazione di una immagine\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Coordinate\\
Successivamente alle coordinate va inserito il percorso del file immagine da inserire. Se non sono presenti le coordinate l'immagine verrà agganciata a grandezza naturale in alto a sinistra e occuperà spazio in testata nel foglio, quindi il testo gestito con le specifiche ROW comincerà ad essere scritto successivamente allo spazio occupato dall'immagine.\\
Possono essere utilizzate immagini con estensione JPG, GIF, BMP e PNG.\\
!! Esempio\\
* TODO\\
!!! ROW Riga di testo\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Dalla posizione 24 in poi va indicato il testo da inserire nel documento PDF relativamente a quella riga.\\
E' possibile modificare inline le specifiche grafiche della riga, vale a dire modificare il tipo font, il colore, la dimensione, etc ad un certo punto della riga. Si può fare ciò inserendo nella parte racchiusa fra [[ e ]] il testo di cui modificare lo stile separato dalla sezione di definizione dello stile da un punto (.) (es.: ROWC7AA8?JB Testo iniziale riga [[ROWEF-Dd?JB.Testo secondo stile]] ritorno allo stile iniziale [[ROWC5AM6?JB.Testo terzo stile]] ancora stile iniziale [[ROWCeCAf?JD.Testo quarto stile]]) .\\
La Posiz. 8 può servire (assegnandogli il valore F) per omettere lo spaziatore di default di quattro carattere che viene premesso alla riga, rinunciando a questo offset di default, il testo verrà posizionato a partire dal bordo del foglio.\\
!! Esempio\\
* TODO\\
!!! BOX Rettangolo disegnato sulla pagina\\
Con la funzione BOX viene definito un semplice rettangolo dotato di una etichetta\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Coordinate\\
!! Esempio\\
* TODO\\
!!! ROX Come BOX ma con angoli arrotondati\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Coordinate\\
!! Esempio\\
* TODO\\
!!! BTX Definizione di testo racchiuso in un rettangolo\\
Con la funzione BTX viene definito un rettangolo contenente un testo; quest'ultimo rispetta tutte le regole di tabulazione di un normale testo.\\
\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Coordinate\\
Quando una riga di testo raggiunge la fine laterale del box viene mandata automaticamente a capo; se il testo inserito eccede lo spazio del box in cui è inserito viene troncato.\\
L'occupazione della riga varia in base ai pixel di altezza; se il box o l'interlinea sono minori della grandezza del carattere, quest'ultimo viene ridotto per farlo stare nella riga.\\
!! Esempio\\
* TODO\\
!!! RTX Come BTX con angoli arrotondati\\
\\
!!! LIN Definizione di una riga diagonale\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Coordinate\\
identificano i punti di partenza e di arrivo della riga da inserire nel documento PDF\\
!! Esempio\\
* TODO\\
!!! TXT\\
Definizione di un testo libero da inserire ovunque del documento PDF\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
!! Corpo\\
* Coordinate\\
!! Esempio\\
* TODO\\
!!! BCD Barcode da inserire nel PDF\\
!! Formato\\
Vedi Configuratore componente stampa in (MBSCP_CFG-EDT_G53)\\
\\
!! Corpo\\
Coordinate\\
* Es.: Per un barcode semplice:\\
** BCDCC-AC?BA.............130,340,200,420,9780201615883\\
* Per un Barcode ruotato:\\
** BCDCCRACRBA.............230,140,330,320,9780201615883\\
\\
Attenzione: Il valore che viene passato al barcode deve essere compatibile con il tipo di barcode che si vuole visualizzare, quindi per l'EAN13 è prevista una stringa alfanumerica di 13 caratteri, per l'UPCA una stringa alfanumerica di 12 caratteri, etc.. Per maggiori informazioni sulla sintassi dei vari codici barcode, si rimanda a documentazione specializzata.\\
\\
E' inseribile un barcode in una riga di tipo ROW con lo stesso meccanismo con cui si cambia lo stile inline (vedere spiegazione nella sezione relativa alla specifica ROW): quindi con la specifica [[BCDC5AM6?JB.9780201615883]] inserita in un punto di una riga di tipo ROW si ottiene il barcode nella riga di testo e, venendo inserito direttamente nella riga, non vanno espresse le coordinate assolute del foglio per il posizionamento.\\
\\
Nel caso del barcode la posizione che gestisce il Tipo Font (posiz. 3) è utilizzata per identificare la codifica del barcode (CODE39, EAN13, UPC, etc.). Vedere alle sezione TIPO BARCODE i valori da utilizzare per utilizzare per visualizzare i vari tipi di barcode.\\
\\
In posizione 11 è possibile specificare se la rappresentazione leggibile del contenuto del barcode debba essere omessa. Attraverso quindi l'indicazione di X in posizione 11 il valore in formato "Human readable" viene nascosto:\\
* Es.: Per un barcode con rappresentazione human readable:\\
** BCDAC-A8?AB.............50,530,250,630,00000123\\
* Per un Barcode SENZA rappresentazione human readable:\\
** BCDAC-A8?ABX............50,530,250,630,00000123\\
\\
!! Esempio\\
* TODO\\
!!! RGB Colore personalizzato.\\
Permette di specificare dei colori personalizzati da utilizzare nel documento che si vuole generare. I colori saranno utilizzabili dal momento in cui vengono definiti in avavnti nel documento che si vuole generare, quindi è consigliabile definirli ad inizio documento. Se dovessero essere ridefiniti, la modifica avrà luogo dal momento della loro ridefinizione in avanti. La sintassi è la seguente: RGBTR225G067B118 Dal momento della sua definizione sarà disponibile, oltre ai colori standard, il colore utilizzabile con l'indicatore T di valore (nella codifica RGB): 255, 067, 118\\
\\
!!! LBV LinkaBle Value\\
Permette di dichiarare una variable e valorizzarla per poter poi essere riferita nel corso del file .inv nel processo di creazione del PDF. Es.: dichiarazione di una variabile VAR1 con assegnazione del valore VALORE:\\
* LBVBC-BA?BA.............VAR1,VALORE\\
\\
!!! LKV LinKed Value\\
Permette di fare riferimento ad una variabile dichiarata tramite la specifica precedente. Il funzionamento è identico alla specifica TXT con la differenza che, invece di stampare quanto riportato nella specifica, estrarrà il valore della variabile indicata. Le variabili possono essere riferite anche prima della loro dichiarazione.\\
* Es.: utilizzo della variabile VAR1 (come dichiarata nell'esempio della specifica precedente):\\
* LKVCC-AC?BA.............200,300,VAR1\\
\\
In posizione 200,300 verrà stampata la stringa VALORE con lo stile definito dalle specifiche CC-AC?BA.\\
\\
!!! STR.FPA\\
Definisce il formato della pagina PDF su cui avverrà l'elaborazione dei dati. I parametri di scelta sono il formato e l'orientamento.\\
\\
!!! STR.PAG\\
Definisce il nome della pagina del documento PDF.\\
\\
!! Parametri\\
NAM : viene definito il nome della pagina\\
STR : viene indicato il nome della pagina di struttura di secondo livello che verrà poi inserita in un altra pagina.\\
\\
!!! STR.BOX\\
Definisce il box della pagina in cui verranno inserite le righe e le colonne.\\
\\
!! Parametri\\
* Sx : indica le coordinate orizzontali di partenza del box (indicate in percentuale)\\
* Sy : indica le coordinate verticali di inizio del box (indicate in percentuale)\\
* La : indica la larghezza del box in percentuale relativamente alla pagina\\
* Ha : indica l'altezza del box in percentuale relativamente alla pagina\\
* Nam : viene indicato il nome identificativo del box\\
* Typ : viene utilizzato per indicare se il box sarà utilizzato come Header (Typ= HEADER ) o Footer (Typ= FOOTER )\\
\\
!!! STR.RIG\\
Definisce la riga interna al box\\
\\
!! Parametri\\
* Nam : indica il nome della riga\\
* Num : viene indicata la dimensione della riga calcolata in base del numero di righe che possono essere contenute del box. (Es: Altezza del box= 100 Num=5 Altezza della riga=20)\\
\\
!!! STR.COL\\
Definisce la colonna interna alla riga. Nella colonna può essere inserita una stringa la cui lunghezza massima è 256 caratteri.\\
\\
!! Parametri\\
* Nam : indica il nome della colonna\\
* Dim : viene indicata la dimensione della colonna in base alla percentuale di riga che verrà occupata (Es: se Dim=20 la colonna occuperà il 20% della riga)\\
\\
!!! SIM\\
Simulazione della struttura di una pagina. I parametri di entry sono:\\
\\
!! Parametri\\
* Fun : indica la funzione associata al tag SIM; può assumere i valori NEW per definire la creazione di un nuovo elemento o ASS per definire la creazione di una variabile (da utilizzare solamente in combinazione con il metodo VAR)\\
* Met : indica il metodo associato al tag SIM, i valori utilizzabili sono:\\
* PAG Pagina\\
* RIG Riga\\
* VAR Variabile\\
* Nam : Nome della struttura di cui verrà effettuata la simulazione ( il nome deve riprendere il nome della struttura che è stata definita con il tag STR.RIG) o il nome della variabile di assegnazione creata.\\
* Txt : Contenuto della variabile definita.\\
This page has only one version
«