dvisvgm - Online in de cloud

PROGRAMMA:

NAAM

dvisvgm - converteert DVI- en EPS-bestanden naar het op XML gebaseerde SVG-formaat

KORTE INHOUD

dvisvgm [ opties ] filet [.dvi]

dvisvgm -E [ opties ] filet [.eps]

PRODUCTBESCHRIJVING

Het opdrachtregelprogramma dvisvgm converteert DVI-bestanden, zoals gegenereerd door TeX/LaTeX, naar de
Op XML gebaseerd schaalbaar vectorafbeeldingsformaat SVG. Het ondersteunt het klassieke DVI-formaat 2 als
evenals formaat 3 (gemaakt door pTeX in verticale modus), en formaat 5 dat ook bekend staat als
XDV (gemaakt door XeTeX). Naast de standaard DVI-commando's evalueert dvisvgm er ook veel
zogenaamd specials & meer die de mogelijkheden van het DVI-formaat aanzienlijk uitbreiden. Voor een meer
gedetailleerd overzicht, zie paragraaf ondersteunde Special hieronder.

Aangezien de huidige SVG-standaard 1.1 geen afbeeldingen met meerdere pagina's specificeert, maakt dvisvgm
afzonderlijke SVG-bestanden voor elke DVI-pagina. Vanwege compatibiliteitsredenen, alleen de eerste
pagina wordt standaard geconverteerd. Om een ​​andere pagina of willekeurige pagina te selecteren
sequenties, gebruik optie -p die hieronder wordt beschreven.

SVG is een op vectoren gebaseerd grafisch formaat en daarom probeert dvisvgm de glyph te converteren
contouren van alle gebruikte lettertypen tot schaalbare padbeschrijvingen. De snelste manier om dat te doen is om
haal de padinformatie uit lettertypebestanden in PFB-, TTF- of OTF-indeling. Als dvisvgm is
in staat is om zo'n bestand te vinden, extraheert het alle benodigde overzichtsinformatie over de glyphs
ervan.

De belangrijkste bron van TeX voor lettertypebeschrijvingen is echter Metafont, dat bitmapuitvoer produceert
(GF-bestanden). Daarom zijn niet alle verkrijgbare TeX-lettertypen beschikbaar in een schaalbaar formaat. In
in deze gevallen probeert dvisvgm de uitvoer van Metafont te vectoriseren door de glyph-bitmaps te volgen.
De resultaten zijn niet zo perfect als de meeste (handmatig geoptimaliseerde) PFB- of OTF-tegenhangers, maar
zijn in de meeste gevallen toch erg leuk.

Bij het uitvoeren van dvisvgm zonder optie --geen-lettertypen, doopvont elementen (...) worden gebruikt
om de lettertypegegevens in de SVG-bestanden in te sluiten. Helaas ondersteunen slechts weinig SVG-weergaven
deze elementen nog niet. De meeste webbrowsers en toepassingen voor vectorafbeeldingen evalueren ze niet
zodat de tekstcomponenten van de resulterende afbeeldingen er vreemd uit kunnen zien. In
opdrachtregeloptie om meer compatibele SVG-bestanden te maken --geen-lettertypen kan worden gegeven aan
vervang de lettertype-elementen door gewone grafische paden.

OPTIES

-een, --alles traceren=[vertelt]
Deze optie dwingt dvisvgm om niet alleen de daadwerkelijk benodigde glyphs te traceren, maar alle glyphs
van alle bitmaplettertypen die in het DVI-bestand worden gebruikt. Aangezien de traceerresultaten worden opgeslagen in de
lettertypecache, alle volgende DVI-conversies (zonder optie --alles traceren) waar deze
lettertypen zijn betrokken, zal veel sneller zijn. Standaard traceert dvisvgm alleen de actual
benodigde glyphs en voegt ze toe aan de cache. De booleaanse optie vertelt bepaalt hoe
om glyphs te verwerken die al in de cache zijn opgeslagen. Standaard worden deze glyphs overgeslagen.
Argument instellen vertelt naar ja or waar dwingt dvisvgm om het overeenkomstige te traceren
weer bitmaps.

Note
Deze optie wordt alleen van kracht als lettertypecaching actief is. Daarom, --alles traceren
niet combineerbaar met optie --cache=geen.

-B, --bbox=fmt
Stelt het begrenzingskader van de gegenereerde afbeelding in op de opgegeven indeling. De parameter
fmt neemt een van de onderstaande indelingsspecificaties of een reeks van vier
door komma's of spaties gescheiden lengtewaarden x1, y1, x2 en y2. De laatste definiëren er twee
diagonale hoeken van het selectiekader. Elke lengtewaarde bestaat uit een drijvende komma
nummer en een optionele lengte-eenheid (pt, bp, cm, mm, in of pc). Als de eenheid is
weggelaten, wordt uitgegaan van TeX-punten (pt).

Het is ook mogelijk om slechts één lengtewaarde op te geven l. In dit geval de minimale begrenzing
box wordt berekend en vergroot door toevoeging van (-l,-l) naar linksboven en (l,l) naar de
rechter onder hoek.

Als alternatief worden de volgende formaatspecificaties ondersteund:

Internationale DIN / ISO papier maten
An, Bn, Cn, Dn, Waar n is een niet-negatief geheel getal, bijv. A4 of a4 voor DIN/ISO A4
formaat (210 mm × 297 mm).

noorden Amerikaans papier maten
factuur, uitvoerend, juridisch, brief, grootboek

special begrenzend doos maten

dvi paginaformaat opgeslagen in het DVI-bestand
Min berekent de minimale/strakke
begrenzend vak
geen er is geen begrenzingskader toegewezen

Pagina oriëntatie
De standaard pagina-oriëntatie voor DIN/ISO en Amerikaanse papierformaten is Portret,
dat wil zeggen Breedte < Hoogte. toevoegen -landschap of gewoon -l naar de formaatreeks
schakelt naar Landschap modus (Breedte > Hoogte). Om symmetrieredenen kan dat ook
nadrukkelijk toevoegen -portret or -p om het standaard staand formaat aan te geven. Let daar op
deze achtervoegsels maken deel uit van de maatreeks en zijn geen afzonderlijke opties. Zo, zij
moet direct de maatspecificatie volgen zonder extra spaties. Verder,
de oriëntatieachtervoegsels kunnen niet worden gebruikt met dvi, Min en geen.

Note
Keuze -B, --bbox heeft alleen invloed op het begrenzingsvak en transformeert niet de
pagina inhoud. Als u dus een liggend formaat kiest, is de pagina dat niet
gedraaid.

-C, --cache[=dir]
Om het conversieproces van bitmaplettertypen te versnellen, slaat dvisvgm intermediate
conversie-informatie in cachebestanden. Standaard worden deze bestanden opgeslagen in
$HOME/.dvisvgm/cache. Als u een andere locatie verkiest, gebruik dan optie --cache naar
de standaard overschrijven. Verder is het ook mogelijk om de font caching uit te schakelen
mechaniek geheel met optie --cache=geen. Als argument dir is weggelaten, dvisvgm
drukt het pad af van de standaard cachemap samen met verdere informatie over
de opgeslagen lettertypen. Bovendien worden verouderde en beschadigde cachebestanden verwijderd.

-J, --clipjoin
Deze optie vertelt dvisvgm om het snijpunt van uitknippaden zelf te berekenen als
nodig is, en deze taak niet te delegeren aan de SVG-renderer. De resulterende SVG-bestanden
zijn draagbaarder omdat sommige SVG-renderers geen intersecties van knippen ondersteunen
paden die worden bepaald door clipPath elementen die een bevatten clip-pad attribuut.

--kleur
Maakt inkleuring mogelijk van berichten die tijdens het conversieproces worden afgedrukt. De kleuren kunnen
worden aangepast via de omgevingsvariabele DVISVGM_COLORS. Zie het onderdeel MILIEU
hieronder voor meer informatie.

-IS, --eps
Als deze optie wordt gegeven, verwacht dvisvgm geen DVI maar een EPS-invoerbestand, en
probeert het naar SVG te converteren. Om dit te doen, een single psbestand speciale opdracht is
gemaakt en doorgestuurd naar de speciale PostScript-handler. Deze optie is alleen beschikbaar
als dvisvgm is gebouwd met PostScript-ondersteuning ingeschakeld en vereist dat Ghostscript is
beschikbaar. Zie optie --libgs te bezoeken voor meer informatie.

-e, --Exact
Als deze optie wordt gegeven, berekent dvisvgm de precieze begrenzingsbox van elk teken.
Standaard worden de waarden die zijn opgeslagen in het TFM-bestand van een lettertype gebruikt om een ​​glyph te bepalen
omvang. Omdat deze waarden bedoeld zijn om optimale karakterplaatsingen te implementeren en zijn
niet ontworpen om de exacte afmetingen weer te geven, ze komen niet noodzakelijkerwijs overeen met
de grenzen van de visuele glyphs. Zo kunnen de breedte en/of hoogte van sommige glyphs zijn
groter (of kleiner) dan de respectievelijke TFM-waarden. Hierdoor kan dit leiden tot
afgekapte tekens aan de randen van de SVG-afbeeldingen. Met optie --Exact gegeven,
dvisvgm analyseert de daadwerkelijke vorm van elk karakter en leidt een meestal strak af
begrenzende doos.

-M, --lettertypekaart=bestandsnamen
Laadt en evalueert een enkele of meerdere lettertypemapbestanden. Deze bestanden zijn nodig om
lettertypebestandsnamen en -coderingen oplossen. dvisvgm levert geen eigen kaartbestanden maar
probeert de beschikbare bestanden te lezen die met dvips of dvipdfm worden geleverd. Indien optie --lettertypekaart is
weggelaten, zoekt dvisvgm naar de standaard mapbestanden ps2pk.map, dvipdfm.map en
psfonts.map (in deze volgorde). Anders worden de weergegeven bestanden gebruikt. Meerdere bestandsnamen
moeten worden gescheiden door komma's zonder witruimte aan het begin en/of het einde. De kaartbestanden
worden in de gegeven volgorde beoordeeld. Standaard worden geherdefinieerde toewijzingen niet vervangen
vorige. Elke bestandsnaam kan echter worden voorafgegaan door een optionele modusspecificatie
(+, -of =) om dit gedrag te wijzigen:

+kaartbestand
Alleen die vermeldingen in het gegeven toewijzingsbestand die een lettertypetoewijzing niet opnieuw definiëren, zijn dat wel
toegepast. Dat is ook de standaardmodus als er geen modusspecificatie is opgegeven.

-mapbestand
Zorgt ervoor dat geen van de lettertypetoewijzingen die in het gegeven toewijzingsbestand zijn gedefinieerd, wordt gebruikt,
dwz eerder gedefinieerde toewijzingen voor de opgegeven lettertypen worden verwijderd.

=mapbestand
Alle toewijzingen die in het kaartbestand zijn gedefinieerd, worden toegepast. Eerder gedefinieerde instellingen voor
hetzelfde lettertype worden vervangen.

Als de eerste bestandsnaam in de bestandsnaamreeks wordt voorafgegaan door een modusspecificatie,
dvisvgm laadt de standaard lettertypemap (zie hierboven) en past de andere mapbestanden toe
daarna. Anders wordt geen van de standaard mapbestanden automatisch geladen.

Voorbeelden: --fontmap=mijnbestand1.map,+mijnbestand2.map ladingen mijnbestand1.map gevolgd door
mijnbestand2.map waar alle herdefinities van mijnbestand2.map worden genegeerd.
--fontmap==mijnbestand1.map,-mijnbestand2.map laadt het standaard mapbestand gevolgd door
mijnbestand1.map en mijnbestand2.map waar alle herdefinities van mijnbestand1.map vervangen
eerdere vermeldingen. Daarna worden alle definities voor de lettertypen gegeven in mijnbestand2.map
worden verwijderd uit de font map tree.

Zie voor meer informatie over de mapbestandsindelingen en de modusspecificaties
de handleidingen van dvips en dvipdfm.

--grad-overlap
Vertelt dvisvgm om overlappende rastersegmenten te maken bij het benaderen van kleurverloop
vullingen (zie ook optie --grad-segmenten onderstaand). Standaard doen aangrenzende segmenten dat niet
overlappen maar raken elkaar alleen als afzonderlijke tegels. Helaas, deze uitlijning
kan leiden tot zichtbare openingen tussen de segmenten omdat de achtergrond de achtergrond beïnvloedt
kleur aan de grens van de segmenten als de SVG-renderer anti-aliasing gebruikt om te maken
gladde contouren. Een manier om dit te voorkomen en om naadloos aan elkaar grenzende kleurgebieden te creëren
is om de segmenten te vergroten zodat ze zich uitstrekken tot in het gebied van hun rechter- en billen
buren. Omdat deze laatste bovenop de overlappende delen zijn getekend, is het zichtbare
grootte van alle segmenten blijft ongewijzigd. Alleen de voormalige hiaten verdwijnen als achtergrond
is nu helemaal bedekt met de juiste kleuren. Momenteel berekent dvisvgm de
overlappende segmenten afzonderlijk voor elke patch van de mesh (een patch mesh kan bestaan ​​uit
van meerdere patches van hetzelfde type). Daarom kunnen er nog steeds zichtbare hiaten zijn
de naad van twee aangrenzende patches.

--grad-segmenten=aantal
Bepaalt het maximale aantal segmenten per kolom en rij dat wordt gebruikt om te benaderen
kleurverloopvullingen. Aangezien SVG 1.1 slechts een kleine subset van de arcering ondersteunt
algoritmen die beschikbaar zijn in PostScript, benadert dvisvgm sommige ervan door ze onder te verdelen
het gebied dat moet worden gevuld in kleinere, monochromatische segmenten. Elk van deze segmenten
krijgt de gemiddelde kleur van de regio die het bestrijkt. Dus het verhogen van het aantal
segmenten leidt tot kleinere monochromatische gebieden en resulteert daarom in een betere
benadering van het werkelijke kleurverloop. Als nadeel betekenen meer segmenten groter
SVG-bestanden omdat elk segment wordt vertegenwoordigd door een afzonderlijk padelement.

Op dit moment ondersteunt dvisvgm vrije- en roostervormige driehoekige patch-meshes evenals
Coons en tensor-product patch meshes. Ze worden benaderd door het gebied onder te verdelen
van elke patch in een n×n raster van kleinere segmenten. Het maximale aantal segmenten per
kolom en rij kunnen worden gewijzigd met optie --grad-segmenten.

--grad-vereenvoudigen=delta
Als de grootte van de segmenten die zijn gemaakt om gradiëntkleurvullingen te benaderen hieronder valt
de gegeven deltawaarde, vermindert dvisvgm hun detailniveau. Bézier bijvoorbeeld
krommen worden vervangen door rechte lijnen en driehoekige segmenten worden gecombineerd tot
tetragons. Voor een kleine delta zijn deze vereenvoudigingen meestal niet merkbaar maar
verklein de grootte van de gegenereerde SVG-bestanden.

-H, --help[=mode]
Drukt een korte samenvatting af van alle beschikbare opdrachtregelopties. De optionele mode
parameter is een geheel getal tussen 0 en 2. Het selecteert de weergavevariant van de
hulp tekst. Modus 0 somt alle opties op, onderverdeeld in categorieën met sectiekoppen. Dit
is ook de standaard als dvisvgm wordt aangeroepen zonder parameters. Modus 1 somt alle opties op
gesorteerd op de korte optienamen, terwijl modus 2 de regels sorteert op de lange optie
namen.

--houden
Schakelt het verwijderen uit van tijdelijke bestanden zoals gemaakt door Metafont (meestal .gf, .tfm en
.logboek bestanden).

--libgs=bestandsnaam
Deze optie is alleen beschikbaar als er niet direct naar de Ghostscript-bibliotheek is gelinkt
dvisvgm en als PostScript-ondersteuning niet volledig is uitgeschakeld tijdens het compileren. In
in dit geval probeert dvisvgm de gedeelde GS-bibliotheek dynamisch te laden tijdens runtime. Door
standaard verwacht het dat de naam van de bibliotheek libgs.so.X is (op Unix-achtige systemen, waar X
is de ABI-versie van de bibliotheek) of gsdll32.dll/gsdll64.dll (Windows). Keuze
--libgs kan worden gebruikt om een ​​andere naam te geven. Als alternatief is het ook mogelijk om in te stellen
de GS-bibliotheeknaam door de omgevingsvariabele LIBGS. De laatste heeft minder voorrang
dan de opdrachtregeloptie, dwz dvisvgm negeert variabele LIBGS if --libgs is gegeven.

-L, --linkteken=stijl
Selecteert de methode om gehyperlinkte gebieden te markeren. De stijl argument kan een van nemen
de waarden geen, doos en lijn, Waar doos is de standaard, dwz er wordt een rechthoek getekend
rond de gekoppelde regio indien optie --linkteken wordt weggelaten. Stijlargument lijn voor slechts
tekent de onderrand van de begrenzende rechthoek, en geen vertelt dvisvgm om er geen toe te voegen
zichtbare objecten naar hyperlinks. De lijnen en vakken krijgen de huidige tekstkleur
geselecteerd. Om een ​​andere, constante kleur toe te passen, een dubbele punt gevolgd door een kleur
specifier kan worden toegevoegd aan de stijltekenreeks. A kleur specificeerder is ofwel een
hexadecimale RGB-waarde van het formulier #RRGGBB, of een dvips-kleurnaam
(http://en.wikibooks.org/wiki/LaTeX/Colors#The_68_standard_colors_known_to_dvips).

Bovendien argumenteren stijl kan een enkele kleurspecificatie gebruiken om de gekoppelde te markeren
regio door een kaderloze doos gevuld met die kleur. Een optionele tweede kleurspecificatie
gescheiden door een dubbele punt selecteert de kaderkleur.

Voorbeelden: doos: rood or doos:#ff0000 tekent rode vakken rond de gekoppelde gebieden. geel blauw
creëert geel gevulde rechthoeken met blauwe kaders.

-ik, --lijst-specials
Drukt een lijst af met geregistreerde speciale handlers en uitgangen. Elke handler verwerkt een set
van bijzondere verklaringen die tot dezelfde categorie behoren. In de meeste gevallen de categorieën
worden geïdentificeerd door het voorvoegsel van de speciale verklaringen. Het is meestal een leidend woord
gescheiden van de rest van de verklaring door een dubbele punt of een spatie, bijv kleur or ps.

-M, --mag=factor
Stelt de vergrotingsfactor in die wordt toegepast in combinatie met Metafont-oproepen voorafgaande tracering
de tekens. Hoe groter deze waarde, hoe beter de traceerresultaten. Desalniettemin groot
vergrotingswaarden kunnen Metafont-rekenkundige fouten veroorzaken als gevolg van nummeroverlopen. Dus,
gebruik deze optie met zorg. De standaardinstelling levert meestal mooie resultaten op.

--niet-samenvoegen
Zet elk karakter apart tekst element met bijbehorende x en y
attributen. Standaard nieuw tekst or theelepel elementen worden alleen gemaakt als een string begint
op een locatie die afwijkt van de reguliere positie bepaald door de karakters
voorschot waarden.

--no-mktexmf
Onderdrukt het genereren van ontbrekende lettertypebestanden. Als dvisvgm geen lettertypebestand kan vinden
via het opzoekmechanisme van kpathsea roept het de externe tools mktextfm of mktexmf aan
door. Deze optie schakelt deze oproepen uit.

-N, --geen-lettertypen[=variant]
Als deze optie wordt gegeven, maakt dvisvgm geen SVG doopvont elementen maar gebruiken paden
in plaats van. De resulterende SVG-bestanden zijn meestal groter, maar ze zijn tegelijkertijd meer
compatibel met de meeste toepassingen die nog geen SVG-lettertypen ondersteunen. De optionele
argument variant selecteert de methode om lettertypen te vervangen door paden. Variant 0
creëert pad en . elementen. Variant 1 creëert pad alleen elementen. Keuze --geen-lettertypen
impliceert --geen-stijlen.

-C, --schaal=sx[,sy]
Schaalt de pagina-inhoud horizontaal met sx en verticaal door sy. Deze optie is
gelijkwaardig -TSsx,sy.

-S, --geen-specials[=namen]
Schakel verwerking van speciale opdrachten in het DVI-bestand uit. Als niet verder
parameter wordt gegeven, worden alle specials genegeerd. Om sets speciale aanbiedingen selectief uit te schakelen,
een optionele door komma's gescheiden lijst met namen kan aan deze optie worden toegevoegd. A naam is
de unieke identificator die verwijst naar de beoogde speciale handler. Keuze --lijst-specials
somt alle momenteel beschikbare handlers en hun namen op. Allemaal niet-ondersteunde speciale
verklaringen worden stilzwijgend genegeerd.

--geen-stijlen
Standaard maakt dvisvgm CSS-stijlen en klassekenmerken om naar lettertypen te verwijzen omdat
het is compacter dan herhaaldelijk de volledige lettertype-informatie in elke tekst in te stellen
element. Als u echter de voorkeur geeft aan directe lettertypeverwijzingen, kan het standaardgedrag zijn
uitgeschakeld met optie --geen-stijlen.

-O, --uitvoer=patroon
Stelt het naampatroon van het uitvoerbestand in. Parameter patroon is een tekenreeks die mag
bevatten de variabelen %f, %p en %P. %f breidt uit naar de basisnaam van het DVI-bestand,
dwz de bestandsnaam zonder achtervoegsel, %p is het huidige paginanummer, en %P het totaal
aantal pagina's in het DVI-bestand. Een optioneel getal (0-9) achter het procentteken
specificeert het minimale aantal cijfers dat geschreven moet worden. Als een bepaalde waarde is
korter, het nummer wordt opgevuld met voorloopnullen. Voorbeeld: %3 p dwingt 3 cijfers af voor
het huidige paginanummer (001, 002, enz.). Zonder een expliciete breedtespecificatie, %p krijgt
hetzelfde aantal cijfers als %P.

Als u meer controle over de nummering nodig heeft, kunt u rekenkundige uitdrukkingen gebruiken als
onderdeel van een patroon. De syntaxis is %(uitdr) WAAR uitdrukken kan toevoegingen bevatten,
aftrekkingen, vermenigvuldigingen en delingen van gehele getallen met gemeenschappelijke prioriteit. De
variabelen p en P bevatten het huidige paginanummer en het totale aantal pagina's,
respectievelijk. Bijvoorbeeld, --output="%f-%(p-1)" maakt bestandsnamen waar de nummering
begint met 0 in plaats van 1.

Het standaardpatroon is %f-%p.svg als het DVI-bestand uit meer dan één pagina bestaat, en
%f.svg anders. Dat betekent een DVI-bestand foo.dvi wordt omgezet in foo.svg if foo.dvi is
een document van één pagina. Anders meerdere SVG-bestanden foo-01.svg, foo-02.svg, enz. zijn
geproduceerd. In Windows-omgevingen geeft het procentteken een gederefereerde omgeving aan
variabelen, en moet daarom worden beschermd door een tweede procentteken, bijv
--uitvoer=%%f-%%p.

-P, --bladzijde=ranges
Met deze optie stelt u de te verwerken pagina's in. Parameter ranges bestaat uit een
door komma's gescheiden lijst van afzonderlijke paginanummers en/of paginabereiken. Een paginabereik is een paar
getallen gescheiden door een koppelteken, bijvoorbeeld 5-12. Zo zou een paginavolgorde eruit kunnen zien
dit: 2-4,6,9-12,15. Het maakt niet uit of een pagina meer dan eens wordt gegeven of pagina
bereiken elkaar overlappen. dvisvgm extraheert de paginanummers altijd in oplopende volgorde en
converteert ze slechts één keer. Om compatibel te blijven met eerdere versies, is de
standaard paginavolgorde is 1. dvisvgm converteert daarom alleen de eerste pagina en niet de
hele document in geval optie --bladzijde wordt weggelaten. Gewoonlijk bestaan ​​paginabereiken uit twee
getallen die de eerste en laatste pagina aangeven die moet worden geconverteerd. Als de conversie moet zijn
beginnen op pagina 1, of als het moet doorgaan tot de laatste DVI-pagina, de eerste of
tweede bereiknummer kan respectievelijk worden weggelaten. Voorbeeld: --pagina=-10 converteert alles
pagina's tot pagina 10, --pagina=10- converteert alle pagina's beginnend met pagina 10. Please
Houd er rekening mee dat de paginawaarden niet verwijzen naar de paginanummers die op de pagina zijn afgedrukt.
In plaats daarvan wordt het fysieke aantal pagina's verwacht, waarbij de eerste pagina altijd een nummer krijgt
1.

-NS, --precisie=cijfers
Specificeert het maximale aantal decimalen dat wordt toegepast op het drijvende-kommakenmerk
waarden. Alle attribuutwaarden die naar het/de gegenereerde SVG-bestand(en) worden geschreven, zijn afgerond
overeenkomstig. De parameter cijfers staat gehele getallen toe van 0 tot 6, waarbij 0 inschakelt
de automatische selectie van significante decimalen. Dit is ook de standaardwaarde
als dvisvgm wordt aangeroepen zonder optie --precisie.

-P, --voortgang[=vertraging]
Schakelt een eenvoudige voortgangsindicator in die wordt weergegeven bij tijdrovende bewerkingen zoals
PostScript-specials worden verwerkt. De indicator verschijnt niet vóór de opgegeven vertraging
(in seconden) is verstreken. De standaard vertragingswaarde is 0.5 seconden.

-R, --draaien=hoek
Draait de pagina-inhoud met de klok mee hoek graden rond het midden van de pagina. Dit
optie is gelijk aan -TRhoek.

-R, --familielid
SVG maakt het mogelijk om grafische paden te definiëren in een reeks van absoluut en/of relatief
commando's, dwz elk commando verwacht absolute coördinaten of coördinaten
ten opzichte van de huidige tekenpositie. Standaard maakt dvisvgm paden die bestaan ​​uit
absolute commando's. Indien optie --familielid wordt gegeven, worden relatieve commando's gemaakt
in plaats daarvan, waardoor de grootte van de SVG-bestanden in de meeste gevallen enigszins wordt verkleind.

-Ja, --stdout
Schrijf de SVG-uitvoer niet naar een bestand, maar leid het ernaar om stdout.

-T, --transformeren=commando's
Past een reeks transformaties toe op de SVG-inhoud. Elke transformatie is
beschreven door a commando beginnend met een hoofdletter gevolgd door een lijst van
door komma's gescheiden parameters. De volgende transformatieopdrachten worden ondersteund:

T tx[,ty]
Vertaalt (verplaatst) de pagina in de richting van vector (tx,ty). Als ty wordt weggelaten, ty=0
wordt verondersteld. De verwachte eenheidslengte van tx en ty zijn TeX punten (1pt =
1/72.27 inch). Er zijn echter verschillende constanten gedefinieerd om de eenheid te vereenvoudigen
conversie (zie hieronder).

S sx[,sy]
Schaalt de pagina horizontaal met sx en verticaal door sy. Indien sy wordt weggelaten, sy=sx
wordt verondersteld.

R hoek[,x,y]
Draait de pagina met de klok mee hoek graden rond punt (x,y). Als de optionele
argumenten x en y worden weggelaten, wordt de pagina rond het midden gedraaid
afhankelijk van het gekozen paginaformaat. Wanneer optie - geen wordt gegeven, de rotatie
centrum is oorsprong (0,0).

KX hoek
Schuift de pagina scheef langs de x-as door hoek graden. Argument hoek kan elke
waarde behalve 90+180k, Waar k is een geheel getal.

KY hoek
Schuift de pagina scheef langs de y-as door hoek graden. Argument hoek kan elke
waarde behalve 90+180k, Waar k is een geheel getal.

FH [y]
Spiegelt (draait) de pagina op de horizontale lijn door punt (0,y). Het weglaten van de
optioneel argument leidt tot y=h/2, waar h geeft de paginahoogte aan (zie voorgedefinieerd
constante hieronder).

FV [x]
Spiegelt (draait) de pagina op de verticale lijn door punt (x,0). Het weglaten van de
optioneel argument leidt tot x=w/2, waar w geeft de paginabreedte aan (zie voorgedefinieerd
constante hieronder).

M m1, ...,m6
Past een transformatie toe die wordt beschreven door de 3×3-matrix
((m1,m2,m3) (m4,m5,m6),(0,0,1)), waarbij de binnenste drietallen de rijen aangeven.

Note
Alle transformatiecommando's van optie -T, --transformeren worden toegepast in de volgorde
van hun uiterlijk. Meerdere commando's kunnen optioneel worden gescheiden door spaties.
In dit geval moet de hele transformatiereeks dubbel worden ingesloten
citaten. Alle parameters zijn uitdrukkingen van het drijvende-kommatype. Je kan of
geef gewone getallen of rekenkundige termen gecombineerd door de operatoren + (toevoeging),
- (aftrekken), * (vermenigvuldiging), / (divisie) of % (modulo) met gemeenschappelijk
associatieve en voorrangsregels. Haakjes kunnen ook worden gebruikt.

Daarnaast zijn er enkele vooraf gedefinieerde constanten:

ux horizontale positie van de bovenkant
linkerpaginahoek in TeX-punt
eenheden
uy verticale positie van linksboven
paginahoek in TeX punteenheden
h paginahoogte in TeX punteenheden
(0 in het geval van - geen)
w paginabreedte in TeX punteenheden (0
bij - geen)

Verder kun je de lengteconstanten gebruiken pt, mm, cm en in, bijv 2cm or
1.6in. Optie dus -TT1in,0R45 verplaatst de pagina-inhoud 1 inch naar rechts en
draait het daarna 45 graden rond het midden van de pagina.

Voor enkele transformaties kunt u ook opties gebruiken -c, -t en -r. Merk op dat
de volgorde waarin deze opties worden gegeven is niet significant, dat wil zeggen dat u dat niet kunt
gebruik ze om transformatiesequenties te beschrijven. Ze zijn gewoon onafhankelijk
verkorte opties voor algemene transformaties.

-T, --vertalen=tx[,ty]
Vertaalt (verplaatst) de pagina-inhoud in de richting van vector (tx,ty). Deze optie is
gelijkwaardig -TTtx,ty.

-in, --breedsprakigheid=niveau
Bepaalt het type berichten dat wordt afgedrukt tijdens een dvisvgm-run:

0 geen berichtuitvoer
1 alleen foutmeldingen
2 alleen waarschuwingsberichten
4 alleen informatieve berichten

Note
Door deze waarden toe te voegen kun je de categorieën combineren. Het standaardniveau is 7,
dwz alle berichten worden afgedrukt.

-V, --versie[=uitgebreid]
Drukt de versie van dvisvgm af en sluit af. Als het optionele argument is ingesteld op ja
versienummers van de gekoppelde bibliotheken worden ook afgedrukt.

-z, --zip[=niveau]
Maakt een gecomprimeerd SVG-bestand met achtervoegsel .svgz. Het optionele argument specificeert de
compressie niveau. Geldige waarden liggen tussen 1 en 9 (standaardwaarde is 9).
Grotere waarden zorgen voor betere compressieresultaten, maar nemen meer rekentijd in beslag.

Voorzichtigheid
Deze optie is niet te combineren met -Ja, --stdout.

-Z, --zoom[=factor]
Vermenigvuldigt de Breedte en Hoogte kenmerken van het SVG-hoofdelement per argument factor
terwijl het coördinatensysteem van de afbeelding behouden blijft. Als gevolg hiervan zijn de meeste SVG-viewers
zoom de afbeeldingen dienovereenkomstig in. Als een negatieve zoomfactor wordt gegeven, wordt de Breedte en
Hoogte attributen zijn weggelaten.

ONDERSTEUNDE SPECIALS

dvisvgm ondersteunt verschillende sets van special commando's die kan worden gebruikt om DVI-bestanden te verrijken
met extra functies, zoals kleur, afbeeldingen en hyperlinks. De evaluatie van speciaal
commando's wordt gedelegeerd aan toegewijde handlers. Elke handler is verantwoordelijk voor alle specials
statements van dezelfde commandoset, dwz commando's die beginnen met hetzelfde voorvoegsel. Om een
lijst met daadwerkelijk verstrekte speciale handlers, gebruik optie --lijst-specials (zie hierboven). Dit
sectie geeft een overzicht van de speciale commando's die momenteel worden ondersteund.

bgcolor
Speciale verklaring voor het wijzigen van de achtergrond-/paginakleur. Aangezien SVG 1.1 dat niet doet
ondersteunt achtergrondkleuren, dvisvgm voegt een rechthoek van de gekozen kleur in het
gegenereerd SVG-document. Deze rechthoek krijgt altijd dezelfde grootte als de geselecteerde of
berekend begrenzingsvak. Dit achtergrondkleurcommando maakt deel uit van de speciale kleurenset
maar wordt afzonderlijk behandeld zodat de gebruiker het kan uitschakelen. Voor een overzicht van de
opdrachtsyntaxis, zie bijvoorbeeld de documentatie van dvips.

kleur
Verklaringen van deze opdrachtenset bevatten instructies om de tekst-/verfkleur te wijzigen.
Voor een overzicht van de exacte syntax, zie bijvoorbeeld de documentatie van dvips.

dvisvgm
dvisvgm biedt zijn eigen kleine set specials aan. De volgende lijst geeft een korte samenvatting
Overzicht.

dvisvgm:rauw tekst
Voegt een willekeurige reeks tekens toe aan het paginagedeelte van het SVG-document.
dvisvgm voert hier geen validatie uit, dus de gebruiker moet ervoor zorgen dat het
resulterende SVG is nog steeds geldig. Parameter tekst kan de uitdrukkingen bevatten {?X},
{?y} en {?kleur} die zich uitbreiden naar de stroom x or y coördinaat en de stroom
kleur, respectievelijk. Verder, {?nl} breidt zich uit tot een teken voor een nieuwe regel.

dvisvgm: rawdef tekst
Deze opdracht is vergelijkbaar met: dvisvgm:rauw, maar plaatst de onbewerkte tekst in het
gedeelte van het SVG-document dat momenteel wordt gegenereerd.

dvisvgm: rawset naam ... dvisvgm:endrawset
Dit paar specials markeert het begin en einde van een definitie van een benoemde onbewerkte SVG
fragment. Alle dvisvgm:rauw en dvisvgm: rawdef specials ingesloten door dvisvgm: rawset
en dvisvgm:endrawset worden niet direct geëvalueerd maar gezamenlijk opgeslagen onder de
gegeven naam voor later gebruik. Eenmaal gedefinieerd, kan naar het genoemde fragment worden verwezen
door het hele DVI-bestand door dvisvgm:rawput (zie hieronder). De twee commando's
dvisvgm: rawset en dvisvgm:endrawset mag niet genest zijn, dwz elke aanroep van
dvisvgm: rawset moet worden gevolgd door een overeenkomstige oproep van dvisvgm:endrawset
voor een ander dvisvgm: rawset kan gebeuren. Ook de identificatie naam moet uniek zijn
in het hele DVI-bestand. Gebruik makend van dvisvgm: rawset meerdere keren samen met de
dezelfde naam leidt tot een waarschuwingsbericht.

dvisvgm:rawput naam
Voegt onbewerkte SVG-fragmenten in die eerder zijn opgeslagen onder het gegeven naam. dvisvgm
maakt onderscheid tussen fragmenten die zijn opgegeven met dvisvgm:rauw or
dvisvgm: rawdef, en behandelt ze anders: het voegt all dvisvgm:rauw onderdelen
telkens dvisvgm:rawput wordt genoemd, terwijl de dvisvgm: rawdef delen gaan naar de
gedeelte van het huidige SVG-document slechts één keer.

dvisvgm:img Breedte Hoogte filet
Creëert een afbeeldingselement op de huidige grafische positie die verwijst naar het gegeven
bestand. JPEG-, PNG- en SVG-afbeeldingen kunnen hier worden gebruikt. dvisvgm controleert echter niet
het bestandsformaat of het achtervoegsel van de bestandsnaam. De lengtes Breedte en Hoogte moet
gegeven als gewone getallen met drijvende komma in TeX-punteenheden (1in = 72.27pt).

dvisvgm:bbox nieuw] naam
Definieert of reset een lokaal begrenzingsvak genaamd naam. De naam kan bestaan ​​uit
letters en cijfers. Tijdens het verwerken van een DVI-pagina werkt dvisvgm continu de
(algemeen) begrenzingskader van de huidige pagina om het minimum te bepalen
rechthoek die alle zichtbare paginacomponenten bevat (karakters, afbeeldingen, tekening
elementen enz.) Naast het globale begrenzingsvak kan de gebruiker een
willekeurig aantal benoemde lokale begrenzingsvakken. Eenmaal gedefinieerd, zijn deze vakken
bijgewerkt samen met het globale begrenzingsvak beginnend met het eerste teken
dat volgt de definitie. De lokale dozen kunnen dus worden gebruikt om de
omvang van delen van de pagina. Dit is handig voor scenario's waarin de gegenereerde SVG
bestand wordt nabewerkt. In combinatie met speciale dvisvgm:raw, de macro {?bbox
naam} uitgebreid naar de vier waarden x, y, w en h (gescheiden door spaties) specificeren
de coördinaten van de linkerbovenhoek, breedte en hoogte van de lokale box naam.
Als doos naam niet eerder was gedefinieerd, zijn alle vier de waarden gelijk aan nul.

dvisvgm:bbox Breedte Hoogte [diepte]
Werkt het selectiekader van de huidige pagina bij door een virtuele rechthoek in te sluiten (x,
y, Breedte, Hoogte) waar de linker benedenhoek zich bevindt op de huidige DVI
tekenpositie (x,y). Als de optionele parameter diepte is gespecificeerd, dvisvgm
sluit een tweede rechthoek in (x, y, Breedte, -diepte). De lengtes Breedte, Hoogte en
diepte moet worden gegeven als gewone getallen met drijvende komma in TeX-punteenheden (1in =
72.27pt). Afhankelijk van de grootte en positie van de virtuele rechthoek, kan dit commando
vergroot het algemene begrenzingskader of laat het zoals het is. Het is niet mogelijk
de omvang verminderen. Deze special moet worden gebruikt in combinatie met dvisvgm:rauw in
om de viewport van de pagina correct bij te werken.

dvisvgm:bbox buikspieren] x1 y1 x2 y2
Deze variant van de speciale bbox werkt het begrenzingskader bij door een virtueel
rechthoek (x1,y1,x2,y2). De punten (x1,y1) en (x2,y2) duiden twee diagonaal aan
hoeken van de rechthoek gegeven in TeX punteenheden.

dvisvgm:bbox repareren] x1 y1 x2 y2
Deze variant van de speciale bbox wijst een absoluut (laatste) begrenzingskader toe aan het
resulterende SVG. Na het uitvoeren van deze opdracht verandert dvisvgm het
begrenzingskadercoördinaten, behalve dat deze special later opnieuw wordt aangeroepen. De punten
(x1,y1) en (x2,y2) geven twee diagonale hoeken aan van de rechthoek gegeven in TeX
punt eenheden.

Het volgende TeX-fragment voegt twee onbewerkte SVG-elementen toe aan de uitvoer en werkt het
selectiekader dienovereenkomstig:

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

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

em
Deze specials zijn geïntroduceerd met de emTeX-distributie door Eberhard Mattes. Zij
bieden lijntekeningverklaringen, instructies voor het insluiten van MSP-, PCX- en BMP-afbeeldingen
bestanden, evenals twee PCL-opdrachten. dvisvgm ondersteunt alleen de instructies voor het tekenen van lijnen
en negeert stilzwijgend alle andere em-specials. Een beschrijving van de opdrachtsyntaxis kan zijn
gevonden in de documentatie van het DVI-stuurprogramma die bij emTeX wordt geleverd (zie CTAN).

html
De hyperref-specificatie definieert verschillende varianten voor het markeren van gehyperlinkte gebieden
in een DVI-bestand. dvisvgm ondersteunt de eenvoudige speciale HyperTeX-constructies zoals gemaakt met
hyperref-pakketoptie hypertex. Standaard zijn alle gekoppelde gebieden van het document
gemarkeerd door een rechthoek. Keuze --linkteken maakt het mogelijk om dit gedrag te veranderen. Zie hierboven voor
verdere details. Informatie over syntaxis en semantiek van de HyperTeX-specials kan zijn
gevonden in de hyperref-handleiding.

pdf
pdfTeX en dvipdfmx introduceerden verschillende speciale commando's met betrekking tot het genereren van
PDF-bestanden. Momenteel zijn er slechts twee pdf: mapfile en pdf:maplijn worden ondersteund door
dvisvgm. Deze specials maken het mogelijk om de mapstructuur van het lettertype te wijzigen tijdens de verwerking van DVI
bestanden. Ze worden bijvoorbeeld gebruikt door CTeX. dvisvgm ondersteunt beide, de dvips en
dvipdfm font map-formaat. Voor meer informatie over de opdrachtsyntaxis en semantiek,
zie de documentatie van \pdfkaartbestand in de pdfTeX-gebruikershandleiding.

ps
De beroemde DVI-driver dvips introduceerde zijn eigen set specials om in te bedden
PostScript-code in DVI-bestanden, wat de mogelijkheden van DVI aanzienlijk verbetert
documenten. Een doel van dvisvgm is om alle PostScript-fragmenten volledig te evalueren en om
converteer er zoveel mogelijk naar SVG. In tegenstelling tot dvips gebruikt dvisvgm
drijvende-kommaberekeningen om de precieze positie van elk grafisch element te berekenen,
dwz het rondt de coördinaten niet af. Daarom zijn de relatieve locaties van de
grafische elementen kunnen enigszins afwijken van die berekend door dvips.

Aangezien PostScript een vrij complexe taal is, probeert dvisvgm dit niet te implementeren
eigen PostScript-interpreter maar vertrouwt op Ghostscript (http://ghostscript.com) in plaats daarvan.
Als de Ghostscript-bibliotheek niet was gekoppeld aan het binaire bestand dvisvgm, wordt het opgezocht en
dynamisch geladen tijdens runtime. In dit geval zoekt dvisvgm naar libgs.so.X on
Unix-achtige systemen (ondersteunde ABI-versies: 7,8,9), en voor gsdll32.dll or gsdll64.dll
op Windows. U kunt de standaard bestandsnamen overschrijven met de omgevingsvariabele LIBGS or
de opdrachtregeloptie --libgs. De bibliotheek moet bereikbaar zijn via de ld search
pad (*nix) of de omgevingsvariabele PATH (Windows). Alternatief, het absolute
bestandspad kan worden opgegeven. Als de bibliotheek niet kan worden gevonden, schakelt dvisvgm het
verwerking van PostScript-specials en drukt een waarschuwingsbericht af. Optie gebruiken
--lijst-specials om te controleren of PostScript-ondersteuning beschikbaar is, dwz invoer ps is
aanwezig is.

De PostScript-handler herkent en evalueert ook gegevens van begrenzingskaders die zijn gegenereerd door
de Preview pakket met optie strak. Als de gegevens aanwezig zijn in een DVI-bestand,
dvisvgm past het begrenzingskader van het gegenereerde SVG-bestand dienovereenkomstig aan en drukt een
bericht met de breedte, hoogte en diepte van het vak in TeX-punteenheden.
Vooral de dieptewaarde kan worden gebruikt om de SVG-afbeeldingen verticaal uit te lijnen met de
basislijn van omringende tekst in bijvoorbeeld HTML- of XSL-FO-documenten.

tip
De speciale set TPIC definieert instructies voor het tekenen van eenvoudige geometrische objecten. Sommige
LaTeX-pakketten, zoals eepic en tplot, gebruiken deze specials om afbeeldingen te beschrijven.

Voorbeelden

dvisvgm-bestand

Converteert de eerste pagina van bestand.dvi naar bestand.svg.

dvisvgm -z-bestand

Converteert de eerste pagina van bestand.dvi naar bestand.svgz met standaard compressieniveau 9.

dvisvgm -p5 -z3 -ba4-l -onewfile-bestand

Converteert de vijfde pagina van bestand.dvi naar nieuwbestand.svgz met compressieniveau 3. De begrenzing
doos is ingesteld op DIN/ISO A4 in liggend formaat.

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

Converteert de eerste pagina van bestand.dvi naar bestand.svg waar drie transformaties worden toegepast.

MILIEU

dvisvgm gebruikt de kpadzee bibliotheek voor het lokaliseren van de bestanden die het opent. Vandaar de
omgevingsvariabelen beschreven in de documentatie van de bibliotheek beïnvloeden de converter.

Als dvisvgm was gekoppeld zonder de Ghostscript-bibliotheek en als PostScript-ondersteuning dat niet heeft
uitgeschakeld, wordt de gedeelde Ghostscript-bibliotheek tijdens runtime opgezocht via dlopen().
De omgevingsvariabele LIBGS kan worden gebruikt om het pad en de bestandsnaam van de bibliotheek op te geven.

De voorgecompileerde Windows-versies van dvisvgm vereisen een werkende installatie van MiKTeX 2.9
of daarboven. dvisvgm werkt niet samen met de draagbare editie van MiKTeX omdat het
vertrouwt op de COM-interface van MiKTeX die alleen toegankelijk is in een lokale installatie. Om de
evaluatie van PostScript-specials, de originele Ghostscript-DLL gsdll32.dll moet
aanwezig en bereikbaar via het zoekpad. 64-bit Windows-builds vereisen de 64-bit
Ghostscript-DLL gsdll64.dll. Beide DLL's worden geleverd met de bijbehorende Ghostscript-installatieprogramma's
verkrijgbaar via www.ghostscript.com.

De omgevingsvariabele DVISVGM_COLORS specificeert de kleuren die worden gebruikt om verschillende te markeren
delen van de berichtuitvoer van dvisvgm. Het wordt alleen geëvalueerd als optie --kleur is gegeven. De
waarde van DVISVGM_COLORS is een lijst met door dubbele punten gescheiden ingangen van het formulier gg=BF, Waar gg
staat voor een van de onderstaande kleurgroepindicatoren, en BF zijn twee hexadecimale cijfers
specificeren van de achtergrond (eerste cijfer) en voorgrond/tekstkleur (tweede cijfer). De
kleurwaarden worden als volgt gedefinieerd: 0=zwart, 1=rood, 2=groen, 3=geel, 4=blauw, 5=magenta,
6=cyaan, 7=grijs, 8=felrood, 9=felgroen, A=felgeel, B=felblauw, C=fel
magenta, D=helder cyaan, E=helder grijs, F=wit. Afhankelijk van de terminal kunnen de kleuren
verschillen. In plaats van zowel de tekst- als de achtergrondkleur te wijzigen, is het ook mogelijk om dit te doen
verander slechts één ervan: Een asterisk (*) in plaats van een hexadecimaal cijfer geeft de
standaard tekst- of achtergrondkleur van de terminal.

Alle verkeerd opgemaakte vermeldingen in de lijst worden stilzwijgend genegeerd.

er foutmeldingen

wn waarschuwingsberichten

pn berichten over paginanummers

ps berichten van paginaformaat

fw informatie over de bestanden
geschreven

sm staat berichten

tr berichten van de glyph tracer

pi voortgangsindicator

Voorbeeld: er=01:pi=*5 stelt de kleuren van foutmeldingen in (er) naar rood (1) op zwart (0), En
die van voortgangsindicatoren (pi) naar cyaan (5) op standaard achtergrond (*).

Gebruik dvisvgm online met behulp van onworks.net-services