dvisvgm - Online nel cloud

PROGRAMMA:

NOME

dvisvgm - converte i file DVI ed EPS nel formato SVG basato su XML

SINOSSI

dvisvgm [ Opzioni ] filetto [.dvi]

dvisvgm -E [ Opzioni ] filetto [.eps]

DESCRIZIONE

L'utilità della riga di comando dvisvgm converte i file DVI, come generati da TeX/LaTeX, nel
Formato grafico vettoriale scalabile basato su XML SVG. Supporta il classico formato DVI 2 come
così come il formato 3 (creato da pTeX in modalità verticale) e il formato 5 che è anche noto come
XDV (creato da XeTeX). Oltre ai comandi DVI di base, dvisvgm ne valuta anche molti
cosiddetto speciali che estendono pesantemente le capacità del formato DVI. Per di più
panoramica dettagliata, vedere la sezione supportato Speciali qua sotto.

Poiché l'attuale standard SVG 1.1 non specifica la grafica multipagina, dvisvgm crea
file SVG separati per ogni pagina DVI. Per motivi di compatibilità, solo il primo
la pagina viene convertita per impostazione predefinita. Per selezionare una pagina diversa o una pagina arbitraria
sequenze, usa l'opzione -p che è descritto di seguito.

SVG è un formato di grafica vettoriale e quindi dvisvgm cerca di convertire il glifo
contorni di tutti i caratteri utilizzati a descrizioni di percorso scalabili. Il modo più veloce per farlo è
estrarre le informazioni sul percorso dai file dei caratteri in formato PFB, TTF o OTF. Se dvisvgm è
in grado di trovare un tale file, estrae tutte le informazioni di contorno necessarie sui glifi
da.

Tuttavia, la principale fonte di TeX per le descrizioni dei font è Metafont, che produce output bitmap
(file GF). Ecco perché non tutti i font TeX ottenibili sono disponibili in un formato scalabile. In
in questi casi, dvisvgm cerca di vettorizzare l'output di Metafont ricalcando le bitmap dei glifi.
I risultati non sono perfetti come la maggior parte delle controparti PFB o OTF (ottimizzate manualmente), ma
sono comunque molto carini nella maggior parte dei casi.

Quando si esegue dvisvgm senza opzione --no-font, fonte elementi (...) sono utilizzati
per incorporare i dati del carattere nei file SVG. Sfortunatamente, solo pochi SVG supportano il rendering
questi elementi ancora. La maggior parte dei browser Web e delle applicazioni di grafica vettoriale non li valuta
correttamente in modo che i componenti di testo della grafica risultante possano sembrare strani. In
per creare file SVG più compatibili, opzione della riga di comando --no-font può essere dato a
sostituire gli elementi del carattere con percorsi grafici semplici.

VERSIONI

-un, --traccia tutto=[ripercorrere]
Questa opzione forza dvisvgm a tracciare non solo i glifi effettivamente necessari ma tutti i glifi
di tutti i caratteri bitmap utilizzati nel file DVI. Poiché i risultati del tracciamento sono memorizzati nel
cache dei caratteri, tutte le successive conversioni DVI (senza opzione --traccia tutto) dove questi
i caratteri sono coinvolti, sarà molto più veloce. Per impostazione predefinita, dvisvgm traccia solo l'attuale
glifi necessari e li aggiunge alla cache. L'opzione booleana ripercorrere determina come
per gestire i glifi già memorizzati nella cache. Per impostazione predefinita, questi glifi vengono ignorati.
Impostazione argomento ripercorrere a sì or vero costringe dvisvgm a tracciare il corrispondente
bitmap di nuovo.

Note:
Questa opzione ha effetto solo se la memorizzazione nella cache dei caratteri è attiva. Dunque, --traccia tutto
non può essere combinato con l'opzione --cache=nessuno.

-B, --bbox=FMT
Imposta il riquadro di delimitazione dell'elemento grafico generato sul formato specificato. Il parametro
FMT accetta uno degli identificatori di formato elencati di seguito o una sequenza di quattro
valori di lunghezza separati da virgole o spazi x1, y1, x2 ed y2. Questi ultimi definiscono due
angoli diagonali del riquadro di delimitazione. Ogni valore di lunghezza è costituito da una virgola mobile
numero e un'unità di lunghezza opzionale (pt, bp, cm, mm, in o pc). Se l'unità è
omesso, si assumono i punti TeX (pt).

È anche possibile dare un solo valore di lunghezza l. In questo caso, il limite minimo
box viene calcolato e ingrandito aggiungendo (-l,-l) in alto a sinistra e (l,l) al
angolo inferiore destro.

In alternativa, sono supportati i seguenti identificatori di formato:

Internazionale DIN / ISO carta Dimensioni
An, Bn, Cn, Dn, Dove n è un numero intero non negativo, ad es. A4 o a4 per DIN/ISO A4
formato (210 mm × 297 mm).

Nord americano carta Dimensioni
fattura, esecutivo, legale, lettera, libro mastro

Special delimitazione nella scatola Dimensioni

dvi dimensione della pagina memorizzata nel file DVI
verbale calcola il minimo/più stretto
rettangolo di selezione
nessuna non è assegnato alcun riquadro di delimitazione

Pagina orientamento
L'orientamento della pagina predefinito per i formati carta DIN/ISO e americano è ritratto,
vale a dire larghezza < altezza. In allegato -paesaggio o semplicemente -l alla stringa di formato
passa a paesaggio modalità (larghezza > altezza). Per motivi di simmetria puoi anche
aggiungere esplicitamente -ritratto or -p per indicare il formato verticale predefinito. Notare che
questi suffissi fanno parte della stringa di dimensione e non di opzioni separate. Così, loro
deve seguire direttamente l'identificatore di dimensione senza spazi aggiuntivi. Inoltre,
i suffissi di orientamento non possono essere usati con dvi, verbalee nessuna.

Note:
Opzione -B, --bbox colpisce solo il riquadro di delimitazione e non trasforma il
contenuto della pagina. Quindi, se scegli un formato orizzontale, la pagina non sarà
ruotato.

-C, --cache[=dir]
Per accelerare il processo di conversione dei caratteri bitmap, dvisvgm salva intermedi
informazioni di conversione nei file di cache. Per impostazione predefinita, questi file sono archiviati in
$HOME/.dvisvgm/cache. Se preferisci una posizione diversa, usa l'opzione --cache a
sovrascrivere il valore predefinito. Inoltre, è anche possibile disabilitare la memorizzazione nella cache dei caratteri
meccanismo completamente con optional --cache=nessuno. Se argomento dir è omesso, dvisvgm
stampa il percorso della directory cache predefinita insieme a ulteriori informazioni su
i caratteri memorizzati. Inoltre, i file della cache obsoleti e danneggiati vengono rimossi.

-J, --clipjoin
Questa opzione dice a dvisvgm di calcolare l'intersezione dei tracciati di ritaglio stesso se
necessario e non delegare questo compito al renderer SVG. I file SVG risultanti
sono più portabili perché alcuni renderer SVG non supportano le intersezioni di ritaglio
percorsi che sono definiti da clipPath elementi che contengono a percorso di clip attributo.

--colore
Consente la colorazione dei messaggi stampati durante il processo di conversione. I colori possono
essere personalizzato tramite la variabile d'ambiente DVISVGM_COLORS. Vedi la sezione AMBIENTE
di seguito per ulteriori informazioni.

- Ehi, --eps
Se viene data questa opzione, dvisvgm non si aspetta un DVI ma un file di input EPS e
prova a convertirlo in SVG. Per fare ciò, un singolo psfile comando speciale è
creato e inoltrato al gestore speciale PostScript. Questa opzione è disponibile solo
se dvisvgm è stato compilato con il supporto PostScript abilitato e richiede che Ghostscript sia
a disposizione. Vedi opzione --libgs per maggiori informazioni.

-e, --esatto
Se viene data questa opzione, dvisvgm calcola il riquadro di delimitazione preciso di ogni carattere.
Per impostazione predefinita, i valori memorizzati nel file TFM di un font vengono utilizzati per determinare i glifi
estensione. Poiché questi valori hanno lo scopo di implementare posizionamenti ottimali dei caratteri e sono
non progettati per rappresentare le dimensioni esatte, non corrispondono necessariamente con
i limiti dei glifi visivi. Pertanto, la larghezza e/o l'altezza di alcuni glifi potrebbero essere
maggiore (o minore) dei rispettivi valori TFM. Di conseguenza, questo può portare a
caratteri ritagliati ai limiti della grafica SVG. Con opzione --esatto dato,
dvisvgm analizza la forma effettiva di ogni carattere e ne ricava un solitamente stretto
rettangolo di selezione.

-M, --fontmap=i nomi dei file
Carica e valuta uno o più file di mappa dei caratteri. Questi file sono necessari per
risolvere i nomi dei file di font e le codifiche. dvisvgm non fornisce i propri file di mappa ma
prova a leggere quelli disponibili in arrivo con dvips o dvipdfm. Se opzione --fontmap is
omesso, dvisvgm cerca i file di mappa predefiniti ps2pk.map, dvipdfm.mape
psfonts.map (in questo ordine). In caso contrario, vengono utilizzati i file elencati. Più nomi di file
devono essere separati da virgole senza spazi bianchi iniziali e/o finali. I file della mappa
vengono valutati nell'ordine indicato. Per impostazione predefinita, le mappature ridefinite non sostituiscono
precedenti. Tuttavia, ogni nome di file può essere preceduto da un identificatore di modalità opzionale
(+, -, o =) per modificare questo comportamento:

+filemappa
Solo quelle voci nel file mappa dato che non ridefiniscono una mappatura dei caratteri sono
applicato. Questa è anche la modalità predefinita se non viene fornito alcun identificatore di modalità.

-file di mappa
Garantisce che non venga utilizzata nessuna delle mappature dei caratteri definite nel file mappa specificato,
cioè le mappature precedentemente definite per i caratteri specificati vengono rimosse.

=filemappa
Vengono applicate tutte le mappature definite nel file mappa. Impostazioni precedentemente definite per
lo stesso carattere viene sostituito.

Se il primo nome file nella sequenza del nome file è preceduto da un identificatore di modalità,
dvisvgm carica la mappa dei caratteri predefinita (vedi sopra) e applica gli altri file di mappa
dopo. In caso contrario, nessuno dei file mappa predefiniti verrà caricato automaticamente.

Consigli d'uso: --fontmap=miofile1.mappa,+miofile2.mappa carichi miofile1.mappa seguito da
miofile2.mappa dove tutte le ridefinizioni di miofile2.mappa sono ignorati
--fontmap==miofile1.mappa,-miofile2.mappa carica il file di mappa predefinito seguito da
miofile1.mappa ed miofile2.mappa dove tutte le ridefinizioni di miofile1.mappa sostituire
voci precedenti. Successivamente, tutte le definizioni per i caratteri fornite in miofile2.mappa
vengono rimossi dall'albero della mappa dei caratteri.

Per ulteriori informazioni sui formati dei file di mappa e sugli identificatori di modalità, vedere
i manuali di dvips e dvipdfm.

--grad-sovrapposizione
Dice a dvisvgm di creare segmenti di griglia sovrapposti quando si approssima il gradiente di colore
riempimenti (vedi anche opzione --grad-segmenti qui di seguito). Per impostazione predefinita, i segmenti adiacenti non lo fanno
si sovrappongono ma si toccano solo come tessere separate. Sfortunatamente, questo allineamento
può portare a spazi visibili tra i segmenti perché lo sfondo influenza il
colore al confine dei segmenti se il renderer SVG utilizza l'anti-aliasing per creare
contorni lisci. Un modo per evitarlo e per creare regioni di colore perfettamente toccanti
consiste nell'allargare i segmenti in modo che si estendano nell'area del loro lato destro e inferiore
vicinato. Poiché questi ultimi sono disegnati sopra le parti sovrapposte, il visibile
la dimensione di tutti i segmenti rimane invariata. Solo le precedenti lacune scompaiono come sfondo
ora è completamente coperto dai colori corretti. Attualmente, dvisvgm calcola il
segmenti sovrapposti separatamente per ogni patch della mesh (una mesh patch può consistere
di più patch dello stesso tipo). Pertanto, potrebbero esserci ancora lacune visibili a
la cucitura di due toppe adiacenti.

--grad-segmenti=numero
Determina il numero massimo di segmenti per colonna e riga utilizzati per approssimare
riempimenti di colore sfumato. Poiché SVG 1.1 supporta solo un piccolo sottoinsieme dell'ombreggiatura
algoritmi disponibili in PostScript, dvisvgm ne approssima alcuni suddividendoli
l'area da riempire in segmenti più piccoli e monocromatici. Ciascuno di questi segmenti
ottiene il colore medio della regione che copre. Quindi, aumentando il numero di
segmenti porta ad aree monocromatiche più piccole e quindi si traduce in una migliore
approssimazione del gradiente di colore effettivo. Come inconveniente, più segmenti implicano più grandi
File SVG perché ogni segmento è rappresentato da un elemento di percorso separato.

Attualmente, dvisvgm supporta mesh di patch triangolari a forma libera e reticolare, nonché
Procione e mesh patch prodotto tensore. Si approssimano suddividendo l'area
di ogni patch in a n×n griglia di segmenti più piccoli. Il numero massimo di segmenti per
colonna e riga possono essere modificate con l'opzione --grad-segmenti.

--grad-semplificare=delta
Se la dimensione dei segmenti creati per approssimare i riempimenti di colore sfumato scende al di sotto
il valore delta dato, dvisvgm riduce il loro livello di dettaglio. Ad esempio, Bézier
le curve sono sostituite da linee rette e i segmenti triangolari sono combinati per
tetragoni. Per un piccolo delta queste semplificazioni di solito non sono evidenti ma
ridurre la dimensione dei file SVG generati.

-H, --Aiuto[=modo]
Stampa un breve riepilogo di tutte le opzioni della riga di comando disponibili. L'opzionale modo
parametro è un valore intero compreso tra 0 e 2. Seleziona la variante di visualizzazione del
Testo guida. La modalità 0 elenca tutte le opzioni suddivise in categorie con intestazioni di sezione. Questo
è anche l'impostazione predefinita se dvisvgm viene chiamato senza parametri. La modalità 1 elenca tutte le opzioni
ordinato in base ai nomi delle opzioni brevi, mentre la modalità 2 ordina le righe in base all'opzione lunga
nomi.

--mantenere
Disabilita la rimozione dei file temporanei creati da Metafont (di solito .gf, .tfm e
.log files).

--libgs=Nome del file
Questa opzione è disponibile solo se la libreria Ghostscript non è direttamente collegata a
dvisvgm e se il supporto PostScript non è stato completamente disabilitato durante la compilazione. In
in questo caso, dvisvgm prova a caricare dinamicamente la libreria GS condivisa durante il runtime. Di
predefinito, si aspetta che il nome della libreria sia libgs.so.X (su sistemi simili a Unix, dove X
è la versione ABI della libreria) o gsdll32.dll/gsdll64.dll (Windows). Opzione
--libgs può essere usato per dare un nome diverso. In alternativa, è anche possibile impostare
il nome della libreria GS dalla variabile d'ambiente BIANCHE. Quest'ultimo ha meno precedenza
rispetto all'opzione della riga di comando, ovvero dvisvgm ignora la variabile BIANCHE if --libgs viene data.

-L, --linkmark=style
Seleziona il metodo per contrassegnare le aree con collegamenti ipertestuali. Il style argomento può prendere uno di
i valori nessuna, nella scatolae linea, Dove nella scatola è l'impostazione predefinita, ovvero viene disegnato un rettangolo
intorno alla regione collegata se opzione --linkmark è omesso. Argomento di stile linea ad appena
disegna il bordo inferiore del rettangolo di delimitazione e nessuna dice a dvisvgm di non aggiungere nulla
oggetti visibili ai collegamenti ipertestuali. Le linee e le caselle assumono il colore del testo corrente
selezionato. Per applicare un colore diverso e costante, due punti seguiti da un colore
L'identificatore può essere aggiunto alla stringa di stile. UN colore specificatore è a
valore RGB esadecimale della forma #RRGGBB, o un nome di colore dvips
(http://en.wikibooks.org/wiki/LaTeX/Colors#The_68_standard_colors_known_to_dvips).

Inoltre, argomento style può prendere un singolo identificatore di colore per evidenziare il collegato
regione da una casella senza cornice riempita con quel colore. Un secondo identificatore di colore opzionale
separato da due punti seleziona il colore della cornice.

Consigli d'uso: scatola: rossa or casella:#ff0000 disegna riquadri rossi attorno alle aree collegate. giallo:blu
crea rettangoli pieni di giallo con cornici blu.

-l, --list-speciali
Stampa un elenco di gestori speciali registrati ed uscite. Ogni gestore elabora un set
di dichiarazioni speciali appartenenti alla stessa categoria. Nella maggior parte dei casi, le categorie
sono identificati dal prefisso delle dichiarazioni speciali. Di solito è una parola chiave
separato dal resto dell'istruzione da due punti o uno spazio, ad es colore or ps.

-M, --mag=fattore
Imposta il fattore di ingrandimento applicato in combinazione con le chiamate Metafont prima del tracciamento
i glifi. Maggiore è questo valore, migliori saranno i risultati della traccia. Tuttavia, grande
i valori di ingrandimento possono causare errori aritmetici di Metafont a causa di overflow di numeri. Così,
usa questa opzione con cautela. L'impostazione predefinita di solito produce buoni risultati.

--nessuna fusione
Mette ogni singolo carattere in un separato testo elemento con corrispondente x ed y
attributi. Per impostazione predefinita, nuovo testo or tspan gli elementi vengono creati solo se inizia una stringa
in una posizione diversa dalla posizione normale definita dai personaggi
valori anticipati.

--no-mktexmf
Sopprime la generazione di file di font mancanti. Se dvisvgm non riesce a trovare un file di font
attraverso il meccanismo di ricerca di kpathsea, chiama gli strumenti esterni mktextfm o mktexmf
di. Questa opzione disabilita queste chiamate.

-N, --no-font[=variante]
Se viene data questa opzione, dvisvgm non crea SVG fonte elementi ma usa percorsi
invece. I file SVG risultanti tendono ad essere più grandi ma contemporaneamente lo sono di più
compatibile con la maggior parte delle applicazioni che non supportano ancora i caratteri SVG. L'opzionale
argomento variante seleziona il metodo per sostituire i caratteri con i percorsi. Variante 0
crea sentiero ed uso elementi. La variante 1 crea sentiero solo elementi. Opzione --no-font
implica --no-stili.

-C, --scala=sx[,sy]
Ridimensiona il contenuto della pagina orizzontalmente di sx e verticalmente da sy. Questa opzione è
equivalente -STsx,sy.

-S, --no-speciali[=nomi]
Disabilita l'elaborazione di comandi speciali incorporati nel file DVI. Se non oltre
viene dato il parametro, tutte le offerte speciali vengono ignorate. Per disabilitare in modo selettivo le serie di offerte speciali,
a questa opzione può essere aggiunto un elenco di nomi separato da virgole. UN Nome is
l'identificatore univoco che fa riferimento al gestore speciale previsto. Opzione --list-speciali
elenca tutti i gestori attualmente disponibili e i loro nomi. Tutto speciale non supportato
le dichiarazioni vengono ignorate in silenzio.

--no-stili
Per impostazione predefinita, dvisvgm crea stili CSS e attributi di classe per fare riferimento ai caratteri perché
è più compatto che impostare ripetutamente le informazioni complete sui caratteri in ogni testo
elemento. Tuttavia, se preferisci i riferimenti diretti ai caratteri, il comportamento predefinito può essere
disabilitato con opzione --no-stili.

-oh, --produzione=modello
Imposta il modello del nome del file di output. Parametro modello è una stringa che può
contenere le variabili %f, %pe %P. %f si espande al nome di base del file DVI,
cioè il nome del file senza suffisso, %p è il numero di pagina corrente, e %P il totale
numero di pagine nel file DVI. Un numero opzionale (0-9) dato dopo il segno di percentuale
specifica il numero minimo di cifre da scrivere. Se un valore particolare è
più breve, il numero viene riempito con zeri iniziali. Esempio: %3p applica 3 cifre per
il numero di pagina corrente (001, 002, ecc.). Senza uno specificatore di larghezza esplicito, %p si
lo stesso numero di cifre di %P.

Se hai bisogno di un maggiore controllo sulla numerazione, puoi usare espressioni aritmetiche come
parte di un modello. La sintassi è %(espr) where espr può contenere aggiunte,
sottrazioni, moltiplicazioni e divisioni intere con precedenza comune. Il
variabili p ed P contenere il numero di pagina corrente e il numero totale di pagine,
rispettivamente. Per esempio, --output="%f-%(p-1)" crea nomi di file in cui la numerazione
inizia con 0 anziché 1.

Il modello predefinito è %f-%p.svg se il file DVI è composto da più di una pagina, e
%f.svg altrimenti. Ciò significa che un file DVI foo.dvi è convertito foo.svg if foo.dvi is
un documento di una sola pagina. Altrimenti, più file SVG foo-01.svg, foo-02.svg, ecc
prodotto. Negli ambienti Windows, il segno di percentuale indica l'ambiente dereferenziato
variabili, e deve quindi essere protetto da un secondo segno di percentuale, ad es
--output=%%f-%%p.

-P, --pagina=gamme
Questa opzione imposta le pagine da elaborare. Parametro gamme consiste in un
elenco separato da virgole di singoli numeri di pagina e/o intervalli di pagine. Un intervallo di pagine è una coppia
di numeri separati da un trattino, ad es. 5-12. Quindi, una sequenza di pagine potrebbe assomigliare a
questo: 2-4,6,9-12,15. Non importa se una pagina viene data più di una volta o se pagina
gli intervalli si sovrappongono. dvisvgm estrae sempre i numeri di pagina in ordine crescente e
li converte solo una volta. Per rimanere compatibile con le versioni precedenti, il
la sequenza di pagina predefinita è 1. dvisvgm quindi converte solo la prima pagina e non la
intero documento in caso di opzione --pagina è omesso. Di solito, gli intervalli di pagine sono composti da due
numeri che indicano la prima e l'ultima pagina da convertire. Se la conversione deve essere
iniziato a pagina 1, o se dovesse continuare fino all'ultima pagina DVI, la prima o
il secondo numero di intervallo può essere omesso, rispettivamente. Esempio: --pagina=-10 converte tutto
pagine fino a pagina 10, --pagina=10- converte tutte le pagine che iniziano con pagina 10. Per favore
considerare che i valori di pagina non si riferiscono ai numeri di pagina stampati sulla pagina.
Invece, è previsto il conteggio delle pagine fisiche, dove la prima pagina ottiene sempre il numero
1.

-D, --precisione=cifre
Specifica il numero massimo di posizioni decimali applicate all'attributo a virgola mobile
i valori. Tutti i valori degli attributi scritti nei file SVG generati sono arrotondati
di conseguenza. Il parametro cifre consente valori interi da 0 a 6, dove 0 abilita
la selezione automatica delle cifre decimali significative. Questo è anche il valore predefinito
se dvisvgm viene chiamato senza opzione --precisione.

-P, --progresso[=ritardo]
Consente un semplice indicatore di avanzamento mostrato quando operazioni che richiedono tempo come
Gli speciali PostScript vengono elaborati. L'indicatore non appare prima del ritardo indicato
(in secondi) è trascorso. Il valore di ritardo predefinito è 0.5 secondi.

-R, --ruotare=angolo
Ruota il contenuto della pagina in senso orario di angolo gradi intorno al centro della pagina. Questo
opzione è equivalente a -TRangolo.

-R, --parente
SVG permette di definire percorsi grafici mediante una sequenza di assoluti e/o relativi
comandi, cioè ogni comando si aspetta coordinate assolute o coordinate
rispetto alla posizione di disegno corrente. Per impostazione predefinita, dvisvgm crea percorsi composti da
comandi assoluti. Se opzione --parente viene dato, vengono creati i relativi comandi
invece che riduce leggermente la dimensione dei file SVG nella maggior parte dei casi.

-S, --stdout
Non scrivere l'output SVG in un file ma reindirizzarlo a stdout.

-T, --trasformare=comandi
Applica una sequenza di trasformazioni al contenuto SVG. Ogni trasformazione è
descritto da a command inizia con una lettera maiuscola seguita da un elenco di
parametri separati da virgole. Sono supportati i seguenti comandi di trasformazione:

T tx[,ty]
Trasla (sposta) la pagina nella direzione del vettore (tx,ty). Se ty è omesso, ty=0
è assunto. La lunghezza unitaria prevista di tx ed ty sono punti TeX (1pt =
1/72.27 pollici). Tuttavia, ci sono diverse costanti definite per semplificare l'unità
conversione (vedi sotto).

S sx[,sy]
Ridimensiona la pagina orizzontalmente di sx e verticalmente da sy. Se sy è omesso, sy=sx
è assunto.

R angolo[,x,y]
Ruota la pagina in senso orario di angolo gradi intorno al punto (x,y). Se l'opzionale
argomenti x ed y sono omessi, la pagina verrà ruotata attorno al suo centro
a seconda del formato di pagina scelto. Quando opzione -Bnone è data, la rotazione
il centro è l'origine (0,0).

KX angolo
Inclina la pagina lungo il x-asse per angolo gradi. Discussione angolo può prendere qualsiasi
valore tranne 90+180k, Dove k è un numero intero.

KY angolo
Inclina la pagina lungo il y-asse per angolo gradi. Discussione angolo può prendere qualsiasi
valore tranne 90+180k, Dove k è un numero intero.

FH [y]
Specchia (capovolge) la pagina in corrispondenza della linea orizzontale attraverso il punto (0,y). Omettendo il
argomento facoltativo porta a y=h/2, dove h denota l'altezza della pagina (vedi predefinito
costante sotto).

FV [x]
Specchia (capovolge) la pagina in corrispondenza della linea verticale attraverso il punto (x,0). Omettendo il
argomento facoltativo porta a x=w/2, dove w denota la larghezza della pagina (vedi predefinito
costante sotto).

M m1,...,m6
Applica una trasformazione descritta dalla matrice 3×3
((m1,m2,m3), (m4,m5,m6),(0,0,1)), dove le triple interne denotano le righe.

Note:
Tutti i comandi di trasformazione di option -T, --trasformare sono applicati nell'ordine
del loro aspetto. Più comandi possono essere facoltativamente separati da spazi.
In questo caso l'intera stringa di trasformazione deve essere racchiusa tra double
citazioni. Tutti i parametri sono espressioni di tipo a virgola mobile. Puoi anche
fornire numeri semplici o termini aritmetici combinati dagli operatori + (aggiunta),
- (sottrazione), * (moltiplicazione), / (divisione) o % (modulo) con comune
associatività e regole di precedenza. Si possono usare anche le parentesi.

Inoltre, vengono fornite alcune costanti predefinite:

ux posizione orizzontale della parte superiore
angolo sinistro della pagina in TeX point
unità
uy posizione verticale in alto a sinistra
angolo della pagina in unità TeX point
h altezza della pagina in unità TeX point
(0 in caso di -Bnone)
w larghezza della pagina in unità punto TeX (0
in caso di -Bnone)

Inoltre, puoi usare le costanti di lunghezza pt, mm, cm ed in, per esempio 2cm or
1.6in. Quindi, opzione -TT1in,0R45 sposta il contenuto della pagina di 1 pollice a destra e
successivamente lo ruota di 45 gradi attorno al centro della pagina.

Per le singole trasformazioni puoi anche usare le opzioni -c, -t ed -r. Nota che
l'ordine in cui vengono fornite queste opzioni non è significativo, ovvero non è possibile
usarli per descrivere sequenze di trasformazione. Sono semplicemente indipendenti
opzioni abbreviate per trasformazioni comuni.

-T, --tradurre=tx[,ty]
Trasla (sposta) il contenuto della pagina nella direzione del vettore (tx,ty). Questa opzione è
equivalente -TTtx,ty.

-in, --verbosità=livello
Controlla il tipo di messaggi stampati durante l'esecuzione di dvisvgm:

0 nessun messaggio in uscita
1 solo messaggi di errore
2 solo messaggi di avviso
4 solo messaggi informativi

Note:
Aggiungendo questi valori puoi combinare le categorie. Il livello predefinito è 7,
cioè tutti i messaggi vengono stampati.

-V, --versione[= ]
Stampa la versione di dvisvgm ed esce. Se l'argomento facoltativo è impostato su sì, le
vengono stampati anche i numeri di versione delle librerie collegate.

-z, --cerniera lampo[=livello]
Crea un file SVG compresso con suffisso .svgz. L'argomento facoltativo specifica il
livello di compressione. I valori validi sono nell'intervallo da 1 a 9 (il valore predefinito è 9).
Valori più grandi producono risultati di compressione migliori ma richiedono più tempo di calcolo.

Attenzione
Questa opzione non può essere combinata con -S, --stdout.

-Z, --Ingrandisci[=fattore]
Moltiplica il larghezza ed altezza attributi dell'elemento radice SVG per argomento fattore
mentre viene mantenuto il sistema di coordinate del grafico. Di conseguenza, la maggior parte dei visualizzatori SVG
ingrandire la grafica di conseguenza. Se viene fornito un fattore di zoom negativo, il larghezza ed
altezza gli attributi vengono omessi.

SUPPORTATI SPECIALI

dvisvgm supporta diversi set di la nostra speciale comandi che può essere utilizzato per arricchire i file DVI
con funzionalità aggiuntive, come colore, grafica e collegamenti ipertestuali. La valutazione di speciale
comandi è delegato a gestori dedicati. Ogni conduttore è responsabile di tutte le speciali
istruzioni dello stesso set di comandi, cioè comandi che iniziano con lo stesso prefisso. Prendere un
elenco dei gestori speciali effettivamente forniti, utilizzare l'opzione --list-speciali (vedi sopra). Questo
La sezione fornisce una panoramica dei comandi speciali attualmente supportati.

bgcolor
Dichiarazione speciale per la modifica del colore di sfondo/pagina. Dal momento che SVG 1.1 non lo fa
supporta i colori di sfondo, dvisvgm inserisce un rettangolo del colore scelto nel
documento SVG generato. Questo rettangolo ha sempre le stesse dimensioni dell'o selezionato
riquadro di delimitazione calcolato. Questo comando del colore di sfondo fa parte del set speciale del colore
ma viene gestito separatamente per consentire all'utente di disattivarlo. Per una panoramica del
sintassi del comando, vedere la documentazione di dvips, per esempio.

colore
Le istruzioni di questo set di comandi forniscono istruzioni per modificare il colore del testo/dipingere.
Per una panoramica dell'esatta sintassi, vedere la documentazione di dvips, ad esempio.

dvisvgm
dvisvgm offre una propria piccola serie di offerte speciali. Il seguente elenco fornisce una breve
Panoramica.

dvisvgm: grezzo testo
Aggiunge una sequenza arbitraria di caratteri alla sezione della pagina del documento SVG.
dvisvgm non esegue alcuna convalida qui, quindi l'utente deve assicurarsi che il
SVG risultante è ancora valido. Parametro testo può contenere le espressioni {?X},
{?y}e {?colore} che si espandono alla corrente x or y coordinata e la corrente
colore, rispettivamente. Inoltre, {?nl} si espande in un carattere di nuova riga.

dvisvgm:rawdef testo
Questo comando è simile a dvisvgm: grezzo, ma inserisce il testo non elaborato in
sezione del documento SVG attualmente in fase di generazione.

dvisvgm:rawset Nome ... dvisvgm:endrawset
Questa coppia di speciali segna l'inizio e la fine di una definizione di un SVG grezzo con nome
frammento. Tutto dvisvgm: grezzo ed dvisvgm:rawdef offerte speciali racchiuse da dvisvgm:rawset
ed dvisvgm:endrawset non vengono valutati immediatamente ma archiviati congiuntamente sotto il
dato Nome per un uso successivo. Una volta definito, è possibile fare riferimento al frammento nominato
in tutto il file DVI di dvisvgm: rawput (vedi sotto). I due comandi
dvisvgm:rawset ed dvisvgm:endrawset non deve essere annidato, cioè ogni chiamata di
dvisvgm:rawset deve essere seguito da una corrispondente chiamata di dvisvgm:endrawset
prima di un altro dvisvgm:rawset può capitare. Inoltre, l'identificatore Nome deve essere unico
in tutto il file DVI. Usando dvisvgm:rawset più volte insieme al
stesso Nome porta a un messaggio di avviso.

dvisvgm: rawput Nome
Inserisce frammenti SVG non elaborati precedentemente archiviati sotto il dato Nome. dvisvgm
distingue tra frammenti che sono stati specificati con dvisvgm: grezzo or
dvisvgm:rawdef, e li gestisce in modo diverso: inserisce tutti dvisvgm: grezzo Ricambi
ogni volta dvisvgm: rawput è chiamato, mentre il dvisvgm:rawdef le porzioni vanno al
sezione del documento SVG corrente solo una volta.

dvisvgm:img larghezza altezza filetto
Crea un elemento immagine nella posizione grafica corrente facendo riferimento al dato
file. Le immagini JPEG, PNG e SVG possono essere utilizzate qui. Tuttavia, dvisvgm non verifica
il formato del file o il suffisso del nome del file. le lunghezze larghezza ed altezza deve essere
dati come semplici numeri in virgola mobile in unità TeX point (1in = 72.27pt).

dvisvgm:bbox nuovo] Nome
Definisce o ripristina un riquadro di delimitazione locale chiamato Nome. Il nome può essere composto da
lettere e cifre. Durante l'elaborazione di una pagina DVI, dvisvgm aggiorna continuamente il
riquadro di delimitazione (globale) della pagina corrente per determinare il minimo
rettangolo contenente tutti i componenti visibili della pagina (personaggi, immagini, disegno
elementi ecc.) Oltre al riquadro di delimitazione globale, l'utente può richiedere un
numero arbitrario di riquadri di delimitazione locali denominati. Una volta definite, queste caselle sono
aggiornato insieme al riquadro di delimitazione globale che inizia con il primo carattere
che segue la definizione. Quindi, le caselle locali possono essere utilizzate per calcolare il
estensione di parti della pagina. Questo è utile per gli scenari in cui l'SVG generato
il file è post-elaborato. In combinazione con lo speciale dvisvgm:raw, la macro {?box
Nome} si espande ai quattro valori x, y, we h (separato da spazi) specificando
le coordinate dell'angolo in alto a sinistra, larghezza e altezza della casella locale Nome.
Se scatola Nome non era stato precedentemente definito, tutti e quattro i valori sono uguali a zero.

dvisvgm:bbox larghezza altezza [profondità]
Aggiorna il riquadro di delimitazione della pagina corrente incorporando un rettangolo virtuale (x,
y, larghezza, altezza) dove si trova l'angolo in basso a sinistra al DVI . corrente
posizione di disegno (x,y). Se il parametro opzionale profondità è specificato, dvisvgm
incorpora un secondo rettangolo (x, y, larghezza-profondità). le lunghezze larghezza, altezza ed
profondità devono essere dati come semplici numeri in virgola mobile in unità TeX point (1in =
72.27pt). A seconda delle dimensioni e della posizione del rettangolo virtuale, questo comando
ingrandisce il riquadro di delimitazione generale o lo lascia così com'è. Non è possibile
ridurne l'estensione. Questo speciale dovrebbe essere usato insieme a dvisvgm: grezzo in
per aggiornare correttamente il viewport della pagina.

dvisvgm:bbox addominali] x1 y1 x2 y2
Questa variante dello speciale bbox aggiorna il riquadro di delimitazione incorporando un virtuale
rettangolo (x1,y1,x2,y2). I punti (x1,y1) e (x2,y2) denotano due diagonali
angoli del rettangolo dati in unità di punti TeX.

dvisvgm:bbox aggiustare] x1 y1 x2 y2
Questa variante dello speciale bbox assegna un riquadro di delimitazione assoluto (finale) al
SVG risultante. Dopo aver eseguito questo comando, dvisvgm non altera ulteriormente il
coordinate del riquadro di delimitazione, tranne che questo speciale viene chiamato di nuovo in seguito. i punti
(x1,y1) e (x2,y2) denotano due angoli diagonali del rettangolo dato in TeX
unità puntiformi.

Il seguente frammento di TeX aggiunge due elementi SVG non elaborati all'output e aggiorna il
riquadro di delimitazione di conseguenza:

\special{dvisvgm:raw }
\special{dvisvgm:bbox 20 10 10}

\special{dvisvgm:raw }
\special{dvisvgm:bbox abs 10 200 100 250}

em
Queste offerte speciali sono state introdotte con la distribuzione emTeX da Eberhard Mattes. Essi
fornire dichiarazioni di disegno al tratto, istruzioni per incorporare immagini MSP, PCX e BMP
file, oltre a due comandi PCL. dvisvgm supporta solo le istruzioni di disegno al tratto
e ignora silenziosamente tutte le altre specialità em. Una descrizione della sintassi del comando può essere
trovato nella documentazione del driver DVI fornita con emTeX (vedi CTAN).

html
La specifica hyperref definisce diverse varianti su come contrassegnare le aree con collegamenti ipertestuali
in un file DVI. dvisvgm supporta i semplici costrutti speciali HyperTeX creati con
opzione pacchetto hyperref ipertesto. Per impostazione predefinita, tutte le aree collegate del documento sono
contrassegnato da un rettangolo. Opzione --linkmark permette di modificare questo comportamento. Vedi sopra per
maggiori dettagli. Le informazioni sulla sintassi e la semantica degli speciali HyperTeX possono essere
trovato nel manuale hyperref.

pdf
pdfTeX e dvipdfmx hanno introdotto diversi comandi speciali relativi alla generazione di
File PDF. Attualmente, solo due di loro, pdf:filemappa ed pdf:mappa sono supportati da
dvisvgm. Queste speciali consentono di modificare l'albero della mappa dei caratteri durante l'elaborazione di DVI
File. Sono usati da CTeX, per esempio. dvisvgm supporta entrambi, dvips e
formato mappa dei caratteri dvipdfm. Per ulteriori informazioni sulla sintassi e sulla semantica del comando,
vedere la documentazione di \pdfmapfile nel manuale utente di pdfTeX.

ps
Il famoso driver DVI dvips ha introdotto il proprio set di speciali per incorporare
Codice PostScript in file DVI, che migliora notevolmente le capacità di DVI
documenti. Uno degli obiettivi di dvisvgm è valutare completamente tutti i frammenti PostScript e
convertirne il maggior numero possibile in SVG. A differenza di dvips, dvisvgm usa
aritmetica in virgola mobile per calcolare la posizione precisa di ogni elemento grafico,
cioè non arrotonda le coordinate. Pertanto, le posizioni relative del
gli elementi grafici possono differire leggermente da quelli calcolati da dvips.

Poiché PostScript è un linguaggio piuttosto complesso, dvisvgm non tenta di implementarlo
proprio interprete PostScript ma si basa su Ghostscript (http://ghostscript.com) anziché.
Se la libreria Ghostscript non è stata collegata al binario dvisvgm, viene cercata e
caricato dinamicamente durante il runtime. In questo caso, dvisvgm cerca libgs.so.X on
Sistemi simili a Unix (versioni ABI supportate: 7,8,9) e per gsdll32.dll or gsdll64.dll
Su Windows. Puoi sovrascrivere i nomi dei file predefiniti con la variabile d'ambiente BIANCHE or
l'opzione della riga di comando --libgs. La biblioteca deve essere raggiungibile tramite la ricerca ld
percorso (*nix) o la variabile di ambiente PATH (Windows). In alternativa, l'assoluto
è possibile specificare il percorso del file. Se la libreria non può essere trovata, dvisvgm disabilita il
elaborazione di speciali PostScript e stampa un messaggio di avviso. Usa opzione
--list-speciali per verificare se è disponibile il supporto PostScript, ad esempio la voce ps is
presente.

Il gestore PostScript riconosce e valuta anche i dati del riquadro di delimitazione generati da
, il anteprima pacchetto con opzione pagina stretta. Se i dati sono presenti in un file DVI,
dvisvgm adatta di conseguenza il riquadro di delimitazione del file SVG generato e stampa a
messaggio che mostra la larghezza, l'altezza e la profondità del riquadro in unità di punti TeX.
In particolare, il valore della profondità può essere utilizzato per allineare verticalmente la grafica SVG con il
linea di base del testo circostante nei documenti HTML o XSL-FO, ad esempio.

tipo
Il set speciale TPIC definisce le istruzioni per disegnare oggetti geometrici semplici. Alcuni
I pacchetti LaTeX, come eepic e tplot, usano questi speciali per descrivere la grafica.

ESEMPI

file dvisvgm

Converte la prima pagina di file.dvi a file.svg.

file dvisvgm -z

Converte la prima pagina di file.dvi a file.svgz con livello di compressione predefinito 9.

dvisvgm -p5 -z3 -ba4-l -onewfile

Converte la quinta pagina di file.dvi a nuovofile.svgz con livello di compressione 3. Il limite
box è impostato su DIN/ISO A4 in formato orizzontale.

dvisvgm --transform="R20,l/3,2h/5 T1cm,1cm S2,3" file

Converte la prima pagina di file.dvi a file.svg dove vengono applicate tre trasformazioni.

AMBIENTE

dvisvgm usa il kpathsea libreria per individuare i file che apre. Quindi il
le variabili d'ambiente descritte nella documentazione della libreria influenzano il convertitore.

Se dvisvgm è stato collegato senza la libreria Ghostscript e se il supporto PostScript no
stato disabilitato, la libreria Ghostscript condivisa viene cercata durante il runtime tramite dlopen().
La variabile d'ambiente BIANCHE può essere utilizzato per specificare il percorso e il nome del file della libreria.

Le versioni Windows precompilate di dvisvgm richiedono un'installazione funzionante di MiKTeX 2.9
o sopra. dvisvgm non funziona insieme all'edizione portatile di MiKTeX perché
si basa sull'interfaccia COM di MiKTeX accessibile solo in un'installazione locale. Per abilitare il
valutazione degli speciali PostScript, la DLL Ghostscript originale gsdll32.dll deve essere
presente e raggiungibile attraverso il percorso di ricerca. Le build di Windows a 64 bit richiedono il 64 bit
DLL Ghostscript gsdll64.dll. Entrambe le DLL vengono fornite con i corrispondenti programmi di installazione di Ghostscript
disponibile su www.ghostscript.com.

La variabile d'ambiente DVISVGM_COLORS specifica i colori usati per evidenziare vari
parti dell'output del messaggio di dvisvgm. Viene valutato solo se opzione --colore viene data. Il
valore di DVISVGM_COLORS è un elenco di voci separate da due punti del modulo gg=BF, Dove gg
denota uno degli indicatori del gruppo di colori elencati di seguito e BF sono due cifre esadecimali
specificando lo sfondo (prima cifra) e il colore di primo piano/testo (seconda cifra). Il
i valori del colore sono definiti come segue: 0=nero, 1=rosso, 2=verde, 3=giallo, 4=blu, 5=magenta,
6=ciano, 7=grigio, 8=rosso brillante, 9=verde brillante, A=giallo brillante, B=blu brillante, C=brillante
magenta, D=ciano brillante, E=grigio brillante, F=bianco. A seconda del terminale, i colori possono
differire. Invece di cambiare sia il testo che il colore di sfondo, è anche possibile
cambiarne solo uno: Un asterisco (*) al posto di una cifra esadecimale indica il
testo predefinito o colore di sfondo del terminale.

Tutte le voci non corrette nell'elenco vengono ignorate silenziosamente.

er messaggio di errore

wn messaggi di avvertimento

pn messaggi sui numeri di pagina

ps messaggi sulla dimensione della pagina

fw informazioni sui file
scritto

sm messaggi di stato

tr messaggi del tracciante glifo

pi indicatore di progresso

Esempio: er=01:pi=*5 imposta i colori dei messaggi di errore (er) al rosso (1) su nero (0), E
quelli degli indicatori di progresso (pi) al ciano (5) su sfondo predefinito (*).

Usa dvisvgm online utilizzando i servizi onworks.net