gpic - Online in de cloud

PROGRAMMA:

NAAM

pic - compileer foto's voor troff of TeX

KORTE INHOUD

bit [ -nvCSU ] [ bestandsnaam ...]
bit -t [ -cvzCSU ] [ bestandsnaam ...]

PRODUCTBESCHRIJVING

Deze handleiding beschrijft de GNU-versie van bit, dat deel uitmaakt van het groff-document
formatteersysteem. bit compileert beschrijvingen van afbeeldingen die erin zijn ingebed troff of TeX
invoerbestanden in opdrachten die door TeX worden begrepen of troff. Elke foto begint met een
regel die begint met .ps en eindigt met een regel die begint met .PE. Alles daarbuiten .ps
en .PE ongewijzigd wordt doorgegeven.

Het is de verantwoordelijkheid van de gebruiker om de juiste definities van de term te geven PS en PE
macro's. Wanneer het gebruikte macropakket dergelijke definities niet biedt (bijvoorbeeld
oude versies van -ms), kunnen geschikte definities worden verkregen met -mpisch: Deze zullen
centreer elke foto.

OPTIES

Opties waarvoor geen argumenten nodig zijn, kunnen achter één optie worden gegroepeerd -. De speciale optie
-- kan worden gebruikt om het einde van de opties te markeren. Een bestandsnaam van - verwijst naar de standaard
invoer.

-C Herkennen .ps en .PE zelfs als dit wordt gevolgd door een ander teken dan een spatie of
nieuwe lijn.

-S Veiligere modus; niet uitvoeren sh opdrachten. Dit kan handig zijn bij het opereren
onbetrouwbare invoer (standaard ingeschakeld).

-U Onveilige modus; de standaardoptie terugzetten -S.

-n Gebruik niet de groff-extensies voor de troff-tekenopdrachten. Je zou dit moeten gebruiken
als u een postprocessor gebruikt die deze extensies niet ondersteunt. De
uitbreidingen worden beschreven in groff_uit(5). De -n optie veroorzaakt ook bit niet te gebruiken
lijnen met een lengte van nul om punten te tekenen in de troff-modus.

-t TeX-modus.

-c Wees meer compatibel met tip. Impliceert -t. Regels beginnend met \ zijn niet doorgegeven
transparant door. Regels beginnend met . worden doorgegeven met de initiaal
. veranderd naar \. Een regel die begint met .ps krijgt een speciale behandeling: er is een
optioneel geheel getalargument dat de lijndikte (pengrootte) in milliinch specificeert;
een ontbrekend argument herstelt de vorige lijndikte; de standaard lijndikte
is 8 milliinch. De aldus gespecificeerde lijndikte heeft alleen effect als een niet-
negatieve lijndikte is niet gespecificeerd bij gebruik van de dikte attribuut of
door het instellen van de lijn dik variabel.

-v Druk het versienummer af.

-z Teken in de TeX-modus punten met lijnen met lengte nul.

De volgende opties worden ondersteund door andere versies van bit worden genegeerd:

-D Teken alle lijnen met behulp van de escape-reeks \D. bit doet dit altijd.

-T dev Genereer uitvoer voor de troff apparaat dev. Dit is niet nodig omdat de troff
output gegenereerd door bit is apparaatonafhankelijk.

GEBRUIK

In deze sectie worden alleen de verschillen tussen GNU beschreven bit en de originele versie van
bit. Veel van deze verschillen zijn ook van toepassing op nieuwere versies van Unix bit. Een volledige
documentatie is beschikbaar in het bestand

/usr/share/doc/groff-base/pic.ms.gz

TeX mode
De TeX-modus wordt ingeschakeld door de -t keuze. In de TeX-modus, bit zal een vbox definiëren genaamd \grafiek
voor elke foto. Gebruik de vijgennaam opdracht om de naam van de vbox te wijzigen. Je moet
print zelf die vbox met behulp van bijvoorbeeld de opdracht

\middellijn{\doos\grafiek}

Omdat de vbox een hoogte van nul heeft (deze is gedefinieerd met \vtop), zal dit in feite resulteren
iets meer verticale ruimte boven de foto dan eronder;

\middellijn{\verhoging 1em\doos\grafiek}

zou dit vermijden.

Om ervoor te zorgen dat de vbox een positieve hoogte en een diepte van nul heeft (zoals bijvoorbeeld gebruikt door LaTeX's
grafische.stal), definieer de volgende macro in uw document:

\def\gpicbox#1{%
\vbox{\unvbox\csnaam #1\endcsnaam\kern 0pt}}

Nu kun je het gewoon zeggen \gpicbox{grafiek} in plaats van \box\grafiek.

U moet een TeX-stuurprogramma gebruiken dat de tip speciaal, versie 2.

Regels beginnend met \ worden transparant doorgegeven; A % wordt toegevoegd aan het einde van de
lijn om ongewenste spaties te vermijden. U kunt deze functie veilig gebruiken om lettertypen te wijzigen of om
verander de waarde van \basislijnoverslaan. Al het andere kan ongewenste resultaten opleveren;
gebruik op eigen risico. Lijnen die met een punt beginnen, krijgen geen speciale behandeling.

commando's
voor variabele = uitdr1 naar uitdr2 [by [*]uitdr3] do X lichaam X
Zet de variabele naar uitdr1. Terwijl de waarde van variabele is kleiner dan of gelijk aan uitdr2,
do lichaam en verhogen variabele by uitdr3; als by niet wordt gegeven, verhoging variabele by
1. Als uitdr3 wordt voorafgegaan door * harte variabele wordt in plaats daarvan vermenigvuldigd met uitdr3.
De waarde van uitdr3 kan negatief zijn voor het additieve geval; variabele wordt vervolgens getest
of deze groter is dan of gelijk is aan uitdr2. Voor het vermenigvuldigingsgeval geldt uitdr3
moet groter zijn dan nul. Als niet aan de beperkingen wordt voldaan, wordt de lus niet uitgevoerd.
X kan elk karakter zijn dat niet voorkomt lichaam.

if uitdrukken harte X als het klopt X [anders Y als-false Y]
Schatten uitdrukken; als het niet nul is, doe dat dan als het klopt, anders doen als-false. X kan zijn
elk personage dat niet voorkomt als het klopt. Y kan elk karakter zijn dat niet voorkomt
als-false.

print arg...
Voeg de argumenten samen en druk ze af als een regel op stderr. Elk arg moet een
expressie, een positie of tekst. Dit is handig bij het debuggen.

commando arg...
Voeg de argumenten samen en geef ze door als een regel naar troff of TeX. Elk
arg moet een uitdrukking, een positie of tekst zijn. Dit heeft een soortgelijk effect als a
regel die begint met . or \, maar staat toe dat de waarden van variabelen worden doorgegeven
door. Bijvoorbeeld,

.ps
x = 14
commando ".ds snaar x is " x ""
.PE
\*[snaar]

prints

x is 14.

sh X commando X
Passeren commando naar een schelp. X kan elk karakter zijn dat niet voorkomt commando.

kopiëren "bestandsnaam"
omvatten bestandsnaam op dit punt in het bestand.

kopiëren ["bestandsnaam"] door X lichaam X [tot "woord"]
kopiëren ["bestandsnaam"] door macro [tot "woord"]
Deze constructie wel lichaam één keer voor elke regel bestandsnaam; de lijn is opgesplitst in
door spatie gescheiden woorden en het voorkomen van $i in lichaamvoor i tussen 1 en 9, zijn
vervangen door de i-de woord van de regel. Als bestandsnaam wordt niet gegeven, er worden lijnen genomen
vanaf de huidige ingang tot .PE. Als een tot clausule is opgegeven, zullen de regels zijn
alleen lezen tot een regel waarvan het eerste woord is woord; die lijn zal dan zijn
weggegooid. X kan elk karakter zijn dat niet voorkomt lichaam. Bijvoorbeeld,

.ps
kopiëren door % cirkel at ($1,$2) % tot "EINDE"
1 2
3 4
5 6
EINDE
doos
.PE

is gelijk aan

.ps
cirkel at (1,2)
cirkel at (3,4)
cirkel at (5,6)
doos
.PE

De voor elke regel uit te voeren opdrachten kunnen ook uit een gedefinieerde macro worden gehaald
eerder door de naam van de macro als argument op te geven door.

opnieuw in te stellen
opnieuw in te stellen variabele1[,] variabele2 ...
Vooraf gedefinieerde variabelen opnieuw instellen variabele1, variabele2 ... naar hun standaardwaarden. Als
er zijn geen argumenten opgegeven, reset alle vooraf gedefinieerde variabelen naar hun standaardwaarden.
Houd er rekening mee dat het toekennen van een waarde aan schaal zorgt er ook voor dat alle vooraf gedefinieerde variabelen dat doen
controledimensies die moeten worden gereset naar hun standaardwaarden maal de nieuwe waarde van
schaal.

perceel uitdrukken ["tekst"]
Dit is een tekstobject dat is opgebouwd met behulp van tekst als een formatstring voor
sprintf met een argument van uitdrukken. Indien tekst wordt een formatstring van weggelaten "%G" is
gebruikt. Attributen kunnen op dezelfde manier worden opgegeven als voor een normaal tekstobject. Zijn
let er goed op dat u een geschikte opmaaktekenreeks opgeeft; bit doet het maar heel erg
beperkte controle van de string. Dit wordt afgekeurd ten gunste van sprint.

variabele := uitdrukken
Dit is vergelijkbaar met = behalve variabele moet al gedefinieerd zijn, en uitdrukken zal zijn
toegewezen aan variabele zonder een variabele te creëren die lokaal is voor het huidige blok. (Door
contrast, = definieert de variabele in het huidige blok als deze nog niet is gedefinieerd
daar en verandert vervolgens alleen de waarde in het huidige blok.) Bijvoorbeeld: de
volgende:

.ps
x = 3
y = 3
[
x := 5
y = 5
]
print x " " y
.PE

prints

5 3

Argumenten van het formulier

X iets X

mogen ook van de vorm zijn

{ iets }

In dit geval iets kan evenwichtige voorkomens bevatten van { en }. Tekenreeksen kunnen bevatten X
of onevenwichtige gebeurtenissen van { en }.

Uitdrukkingen
De syntaxis voor expressies is aanzienlijk uitgebreid:

x ^ y (exponentiatie)
zonde(x)
cos (x)
atan2(y, x)
logboek(x) (basis 10)
exp (x) (grondtal 10, dat wil zeggen 10^x)
kwark(x)
int(x)
rand() (retourneert een willekeurig getal tussen 0 en 1)
rand(x) (retourneer een willekeurig getal tussen 1 en x; verouderd)
srand (x) (stel het willekeurige nummerzaad in)
maximaal(e1, e2)
min(e1, e2)
!e
e1 && e2
e1 || e2
e1 == e2
e1 != e2
e1 >= e2
e1 > e2
e1 <= e2
e1 < e2
"str1" == "str2"
"str1" != "str2"

Tekenreeksvergelijkingsexpressies moeten in sommige contexten tussen haakjes worden geplaatst om dubbelzinnigheid te voorkomen.

Overige Wijzigingen
Een kale uitdrukking, uitdrukken, is acceptabel als attribuut; het is gelijkwaardig aan dir uitdrukken,
met de meeste dir is de huidige richting. Bijvoorbeeld

lijn 2i

betekent dat u een lijn van 2 inch lang in de huidige richting tekent. Het 'i'-teken (of 'ik') is
buiten beschouwing gelaten; Als u een andere meeteenheid wilt gebruiken, stelt u de in schaal variabele naar een geschikte waarde.

De maximale breedte en hoogte van de afbeelding worden uit de variabelen gehaald maxpswid en
maxpsht. Aanvankelijk hebben deze waarden 8.5 en 11.

Voor getallen is wetenschappelijke notatie toegestaan. Bijvoorbeeld

x = 5e-2

Tekstkenmerken kunnen worden samengesteld. Bijvoorbeeld,

"foe" boven gewoon

is geldig.

Er is geen limiet aan de diepte waarop blokken kunnen worden onderzocht. Bijvoorbeeld,

[A: [B: [C: doos ]]] with .ABCsw at 1,2
cirkel at laatste [].ABC

is acceptabel.

Bogen hebben nu kompaspunten die worden bepaald door de cirkel waarvan de boog deel uitmaakt.

Cirkels, ellipsen en bogen kunnen gestippeld of gestippeld zijn. In de TeX-modus kunnen splines gestippeld of gestippeld zijn
ook gestormd.

Dozen kunnen afgeronde hoeken hebben. De rad attribuut specificeert de straal van het kwart-
cirkels op elke hoek. Als Nee rad or diam attribuut is gegeven, een straal van boxrad is gebruikt.
Aanvankelijk boxrad heeft de waarde 0. Een kader met afgeronde hoeken kan gestippeld of gestippeld zijn.

Dozen kunnen schuine zijden hebben. Dit verandert effectief de vorm van een doos van a
rechthoek naar een willekeurig parallellogram. De xschuin en schuin attributen specificeren de
x- en y-verschuiving van de rechterbovenhoek van het vak ten opzichte van de standaardpositie.

De .ps regel kan een tweede argument hebben dat een maximale hoogte voor de afbeelding specificeert. Als
de breedte van nul is gespecificeerd. De breedte wordt genegeerd bij het berekenen van de schaalfactor
voor de foto. Merk op dat GNU bit zal een afbeelding altijd met dezelfde hoeveelheid schalen
zowel verticaal als horizontaal. Dit is anders dan de DWB 2.0 bit wat kan
schaal een afbeelding verticaal met een andere hoeveelheid dan horizontaal als er sprake is van een hoogte
gespecificeerd.

Aan elk tekstobject is een onzichtbaar vak gekoppeld. De kompaspunten van een tekst
object worden bepaald door dit vak. De impliciete beweging die bij het object hoort, is dat ook
bepaald door dit vakje. De afmetingen van deze doos zijn afgeleid van de breedte en hoogte
attributen; als het breedte-attribuut niet wordt opgegeven, wordt aangenomen dat de breedte is
tekstbreedte; als het hoogte-attribuut niet wordt opgegeven, wordt aangenomen dat de hoogte de
aantal tekstreeksen dat aan de objecttijden is gekoppeld tekst. aanvankelijk tekstbreedte en
tekst een waarde van 0 hebben.

Op (bijna alle) plaatsen waar een tekstreeks tussen aanhalingstekens kan worden gebruikt, een uitdrukking van de vorm

sprintf("formaat", arg,...)

kan ook gebruikt worden; dit zal de argumenten opleveren die zijn opgemaakt volgens formaat, welke
moet een string zijn zoals beschreven in printf(3) geschikt voor het aantal argumenten
geleverde.

De dikte van de lijnen die worden gebruikt om objecten te tekenen, wordt bepaald door de lijn dik variabel.
Dit geeft de dikte van lijnen in punten. Een negatieve waarde betekent dat u de standaardwaarde gebruikt
dikte: in de TeX-uitvoermodus betekent dit dat u een dikte van 8 milliinch gebruikt; in TeX-uitvoer
modus met de -c optie, dit betekent dat u de lijndikte gebruikt die is opgegeven bij .ps lijnen; in
troff-uitvoermodus, dit betekent dat u een dikte gebruikt die evenredig is met de puntgrootte. Een nulwaarde
betekent dat u de dunst mogelijke lijn tekent die door het uitvoerapparaat wordt ondersteund. Aanvankelijk heeft het een
waarde van -1. Er is ook een dik[ness] attribuut. Bijvoorbeeld,

cirkel dikte 1.5

zou een cirkel tekenen met een lijn met een dikte van 1.5 punt. De dikte van lijnen
wordt niet beïnvloed door de waarde van de schaal variabel, noch door de opgegeven breedte of hoogte
the .ps lijn.

Dozen (inclusief dozen met afgeronde hoeken of schuine zijden), cirkels en ellipsen kunnen dat zijn
gevuld door ze een attribuut te geven van vullen[ed]. Hiervoor is een optioneel argument van an nodig
expressie met een waarde tussen 0 en 1; 0 vult het met wit, 1 met zwart, waarden
daartussen met een proportionele grijze tint. Een waarde groter dan 1 kan ook worden gebruikt:
dit betekent vullen met de grijstint die momenteel wordt gebruikt voor tekst en lijnen.
Normaal gesproken is dit zwart, maar uitvoerapparaten kunnen een mechanisme bieden om dit te veranderen.
Zonder argument, dan de waarde van de variabele vulval zal gebruikt worden. In eerste instantie dit
heeft een waarde van 0.5. Het onzichtbare attribuut heeft geen invloed op de vulling van objecten. Elk
tekst die bij een gevuld object hoort, wordt toegevoegd nadat het object is gevuld, dus
dat de tekst niet door de vulling wordt verduisterd.

Er zijn drie extra modifiers beschikbaar om gekleurde objecten te specificeren: schets[d] stelt de
kleur van de omtrek, schaduwrijk de vulkleur, en colo[u]r[ed] stelt beide in. Alle drie
trefwoorden verwachten bijvoorbeeld een achtervoegsel dat de kleur specificeert

cirkel schaduwrijk "Groen" schets "zwart"

Momenteel is kleurondersteuning niet beschikbaar in de TeX-modus. Voorgedefinieerde kleurnamen voor groff
staan ​​bijvoorbeeld in de macrobestanden van het apparaat ps.tmac; Met kunnen extra kleuren worden gedefinieerd
the .defcolor aanvraag (zie de handleiding van troff(1) voor meer details).

Om de naam van de vbox in TeX-modus te wijzigen, stelt u de pseudo-variabele in vijgennaam (dat is
eigenlijk een speciaal ontleed commando) binnen een afbeelding. Voorbeeld:

.ps
vijgennaam = foebar;
...
.PE

De afbeelding is dan beschikbaar in de doos \foobar.

bit gaat ervan uit dat aan het begin van een afbeelding zowel de glyph als de vulkleur zijn ingesteld op de
standaardwaarde.

Pijlpunten worden getekend als dichte driehoeken als de variabele pijlpunt is niet nul en
de TeX-modus is ingeschakeld of de -n optie is niet gegeven. Aanvankelijk pijlpunt een
waarde 1. Merk op dat ononderbroken pijlpunten altijd gevuld zijn met de huidige omtrekkleur.

De troff-uitvoer van bit is apparaatonafhankelijk. De -T optie is daarom overbodig. Alle
getallen worden geacht in inches te zijn; getallen worden nooit geïnterpreteerd als een troffmachine
units.

Objecten kunnen een uitgelijnd attribuut. Dit werkt alleen als de postprocessor dat is betast,
or grootpdf. Elke tekst die is gekoppeld aan een object met de extensie uitgelijnd attribuut zal zijn
geroteerd rond het midden van het object, zodat het is uitgelijnd in de richting van het object
beginpunt tot het eindpunt van het object. Houd er rekening mee dat dit kenmerk geen effect heeft
voor objecten waarvan het begin- en eindpunt samenvallen.

Op plaatsen waar nth is toegestaan 'uitdrukken'e is ook toegestaan. Let daar op 'e is een enkel token:
er mag geen ruimte tussen staan ' en th. Bijvoorbeeld,

voor i = 1 naar 4 do {
lijn vanaf 'ik' doos.nw naar 'i+1'de box.se
}

CONVERSIE

Om een ​​zelfstandig beeld te verkrijgen van a bit bestand, sluit uw bit coderen met .ps en .PE
verzoeken; rof configuratieopdrachten kunnen aan het begin van het bestand worden toegevoegd, maar nee
rof tekst.

Het is noodzakelijk om dit bestand in te voeren groff zonder enige pagina-informatie toe te voegen, zodat u
moet controleren welke .ps en .PE verzoeken worden daadwerkelijk gebeld. Bijvoorbeeld de mm-macro
pakket voegt een paginanummer toe, wat erg vervelend is. Op dit moment belt standaard groff
zonder enig macropakket werkt. Als alternatief kunt u uw eigen verzoeken definiëren, bijvoorbeeld naar
niets doen:

.de PS
..
.de PE
..

groff zelf biedt geen directe conversie naar andere grafische bestandsformaten. Maar
er zijn veel mogelijkheden als u uw afbeelding eerst omzet in PostScript®
formaat met behulp van de groff optie -Tps. Sinds dit ps-bestand mist BoundingBox-informatie
is op zichzelf niet erg nuttig, maar kan doorgaans in andere conversieprogramma's worden ingevoerd
genoemd ps2Overige or pstoOverige of iets dergelijks. Bovendien is er de PostScript-interpreter spookscript
(gs) heeft ingebouwde grafische conversieapparaten die met de optie worden aangeroepen

gs -sAPPARAAT=

Bel

gs --help

voor een lijst met beschikbare apparaten.

Een alternatief kan zijn om gebruik te maken van de -Tpdf optie om uw foto direct naar te converteren PDF
formaat. De MediaBox van het geproduceerde bestand kan worden bestuurd door een -Pp papiergrootte
naar groff.

Als het ingekapselde PostScript-bestandsformaat EPS wordt steeds belangrijker en de
conversie werd in het verleden niet als triviaal beschouwd, misschien wil je dat weten
is een conversietool genaamd ps2eps die het juiste werk doet. Het is veel beter dan de
tools ps2epsi verpakt met gs.

Voor bitmap-grafische formaten moet u pstopnm; de resulterende (tussenliggende) PNM
-bestand kan vervolgens worden geconverteerd naar vrijwel elk grafisch formaat met behulp van de tools van het netpbm
pakket .

Gebruik gpic online met behulp van onworks.net-services