NAMN

grn – bädda in Gremlin-bilder i groff-dokument

SYNOPSIS

grn [-C] [-T enhet] [-M katalog] [-F katalog] [fil ...]

grn -?

grn --help

grn -v

grn --version

BESKRIVNING

grn är en förprocessor för att inkludera gremlin-bilder i troff(1)-indata.

grn skriver till standardutdata och behandlar endast indatarader mellan två rader som börjar med:

.GS
.GE

Dessa rader måste innehålla grn-kommandon.

Makrona begär en gremlin-fil. Bilden i den filen konverteras och placeras i troff-indataströmmen.

.GS kan anropas med argumentet:

C

Centrera hela gremlin-bilden.

L

Vänsterjustera bilden.

R

Högerjustera bilden.

Standard är centrering.

Om ingen fil anges läses standardindata.

Vid bildens slut är positionen på sidan vid nederkanten av gremlin-bilden.

Om grn-posten avslutas med:

.GF

i stället för:

.GE

lämnas positionen vid bildens överkant.

För närvarande är det endast makropaketet me som har stöd för:

.GS
.GE
.GF

grn skapar rit-escape-sekvenser som använder groffs färgschemautökning:

\D'F ...'

Detta kan därför sakna stöd i andra troff-implementationer.

GRN-KOMMANDON

Varje indatarad mellan .GS och .GE kan innehålla ett grn-kommando.

Kommandon består av en eller två strängar separerade med blanktecken.

Den första strängen är kommandot och den andra är dess operand.

Kommandon kan skrivas med stora eller små bokstäver och kan förkortas ned till ett tecken.

Kommandon som påverkar bildmiljön gäller endast för aktuell bild. Miljön återställs till standardvärden vid början av nästa bild.

Textstorlek

1 N
2 N
3 N
4 N

Sätt Gremlins textstorlek nummer 1, 2, 3 eller 4 till N punkter.

Standardvärdena är:

Storlek	Standard
1	12 punkter
2	16 punkter
3	24 punkter
4	36 punkter

Typsnitt

roman f
italics f
bold f
special f

Sätt roman, kursiv, fet respektive specialfont till troffs font f.

f kan vara ett namn eller nummer.

Standardvärden:

Kommando	Standardfont
roman	R
italics	I
bold	B
special	S

Stipple-font

l f
stipple f

Sätt stipple-fonten till troffs stipple-font f, angiven som namn eller nummer.

Kommandot stipple kan förkortas till st, för att undvika förväxling med special.

Det finns inget standardvärde för stipples om det inte sätts med kommandot default.

Det är ogiltigt att inkludera en gremlin-bild med polygoner utan att ange en stipple-font.

Skalning

x N
scale N

Förstora bilden, utöver eventuell standardskalning, med N.

N är ett flyttal större än noll.

Kommandot scale kan förkortas till:

sc

Linjetjocklek

narrow N
medium N
thick N

Sätt tjockleken på Gremlins smala, medeltjocka respektive tjocka linjer till N gånger 0,15 punkter.

Detta värde kan ändras vid kompilering.

Standardvärden:

Kommando	Standardfaktor	Motsvarande tjocklek
narrow	1.0	0,15 pt
medium	3.0	0,45 pt
thick	5.0	0,75 pt

Ett tjockleksvärde på noll väljer den minsta tillgängliga linjetjockleken.

Negativa värden gör linjetjockleken proportionell mot aktuell textstorlek.

pointscale

pointscale [off|on]

Skala texten så att den följer bildens skalning.

Gremlin-text skrivs normalt med den punktstorlek som anges med kommandona 1, 2, 3 eller 4, oberoende av bildens skalningsfaktorer.

När pointscale är aktiverat skalas punktstorlekarna med bilden, inom troffs begränsningar.

Alla operander utom off aktiverar textskalning.

default

default

Återställ standardvärdena för bildmiljön till de inställningar som gäller i aktuell bild.

Detta är avsett som en global mekanism för parameterinställning i början av troff-indatan, men kan användas när som helst.

width

width N

Tvinga bilden att vara N tum bred.

Detta åsidosätter skalningsfaktorer i samma bild.

width 0

ignoreras.

height

height N

Tvinga bilden att vara N tum hög och åsidosätt andra skalningsfaktorer.

Om både width och height anges avgör den snävare begränsningen bildens skala.

height och width sparas inte med kommandot default.

De påverkar däremot punktstorleksskalning om denna är aktiverad.

file

file namn

Hämta bilden från Gremlin-filen namn i aktuell katalog eller i bibliotekskatalogen.

Se optionen -M.

Om flera file-kommandon anges gäller det sista.

Om filen inte finns rapporteras ett felmeddelande och behandlingen fortsätter från .GE-raden.

ANVÄNDNING MED GROFF

Eftersom grn är en förprocessor har den ingen åtkomst till formaterarens tillstånd, såsom:

indrag
radlängd
textstorlek
registervärden

Därför kan ingen troff-indata placeras mellan makrona .GS och .GE.

Gremlin-textelement behandlas däremot senare av troff. Allt som är giltigt på en enda rad troff-indata är därför giltigt i en rad Gremlin-text, med undantag för punkt som styrtecken i början av raden.

Det är därmed möjligt att ha ekvationer i en Gremlin-figur genom att lägga in eqn(1)-uttryck i Gremlin-filen, omgivna av tidigare definierade avgränsare, till exempel:

$$

När grn används tillsammans med andra förprocessorer ska tbl(1) köras före grn, pic(1) och/eller ideal.

Om eqn(1) behövs ska det köras som sista förprocessor.

groff(1) kör automatiskt förprocessorer i rätt ordning.

En bild betraktas som en enhet, men detta hindrar inte troff från att försöka bryta upp den om den hamnar vid sidans slut.

Om bilden placeras mellan “keeps” i me-makrona säkerställs korrekt placering.

grn använder troffs register:

g1
g2
g3
g4
g5
g6
g7
g8
g9

och sätter g1 och g2 till Gremlin-figurens bredd och höjd i enhetsmått innan .GS-makrot anropas.

Detta är användbart för den som vill skriva om dessa makron.

GREMLIN-FILFORMAT

Det finns två olika Gremlin-filformat:

det ursprungliga formatet för AED-grafikterminaler
Sun/X11-versionen

En utökning i Sun/X11-formatet tillåter referenspunkter med negativa koordinater. Detta är inte kompatibelt med AED-versionen.

Så länge en Gremlin-fil inte innehåller negativa koordinater kan båda formaten läsas korrekt av båda versionerna av gremlin eller grn.

En annan skillnad är att Sun/X11-formatet använder namn på bildobjekt, exempelvis:

POLYGON
CURVE

i stället för nummer.

Exempel på två filer som beskriver samma bild:

sungremlinfile        gremlinfile
0 240.00 128.00       0 240.00 128.00
CENTCENT              2
240.00 128.00         240.00 128.00
185.00 120.00         185.00 120.00
240.00 120.00         240.00 120.00
296.00 120.00         296.00 120.00
*                     -1.00 -1.00
2 3                   2 3
10 A Triangle         10 A Triangle
POLYGON               6
224.00 416.00         224.00 416.00
96.00 160.00          96.00 160.00
384.00 160.00         384.00 160.00
*                     -1.00 -1.00
5 1                   5 1
0                     0
-1                    -1

Den första raden i varje Gremlin-fil innehåller antingen:

gremlinfile

för AED-formatet, eller:

sungremlinfile

för Sun/X11-formatet.

Den andra raden innehåller en orientering samt x- och y-värden för en placeringspunkt, separerade med mellanslag.

Orienteringen är antingen 0 eller 1 och ignoreras av Sun/X11-versionen.

0

Gremlin visar bilden i horisontellt format, med ritområdet bredare än högt och en meny överst.

1

Gremlin visar bilden i vertikalt format, med ritområdet högre än brett och en meny till vänster.

x och y är flyttalsvärden som anger en placeringspunkt när filen läses in i en annan fil.

Denna rad är normalt inte särskilt viktig. Ett föreslaget värde är:

1 0.00 0.00

Resten av filen består av noll eller flera elementspecifikationer.

Efter den sista elementspecifikationen kommer en rad med strängen:

-1

Rader längre än 127 tecken kapas till denna längd.

ELEMENTSPECIFIKATIONER

Den första raden i varje element innehåller ett decimaltal som anger elementets typ i AED-formatet, eller dess namn i Sun/X11-formatet.

AED-nummer	Sun/X11-namn	Beskrivning
0	BOTLEFT	text justerad nedtill vänster
1	BOTRIGHT	text justerad nedtill höger
2	CENTCENT	centrerat objekt
3	VECTOR	vektor
4	ARC	båge
5	CURVE	kurva
6	POLYGON	polygon
7	BSPLINE	b-spline
8	BEZIER	Bézier
10	TOPLEFT	text justerad upptill vänster
11	TOPCENT	text justerad upptill centrerat
12	TOPRIGHT	text justerad upptill höger
13	CENTLEFT	text justerad centrerat vänster
14	CENTRIGHT	text justerad centrerat höger
15	BOTCENT	text justerad nedtill centrerat

Varje rad efter objekttypen anger en punkt som används för att visa elementet.

Raden innehåller en x- och en y-koordinat i flyttalsformat, separerade med mellanslag.

Listan med punkter avslutas med:

-1.0 -1.0

i AED-format, eller med en ensam asterisk:

i Sun/X11-format.

Efter punkterna kommer en rad med två decimaltal som anger pensel och storlek för elementet.

Penseln bestämmer hur objekt ritas.

För vektorer, bågar och kurvor finns sex giltiga penselvärden:

Värde	Betydelse
1	tunna prickade linjer
2	tunna punkt-streckade linjer
3	tjocka heldragna linjer
4	tunna streckade linjer
5	tunna heldragna linjer
6	medeltjocka heldragna linjer

För polygoner är även 0 giltigt. Det anger en osynlig kant.

För text väljer penseln font:

Värde	Font
1	roman, R-font i troff
2	kursiv, I-font i troff
3	fet, B-font i troff
4	special, S-font i troff

När grn används med groff är fonten egentligen bara en startfont.

Textsträngen kan innehålla formateringssekvenser som:

\fI
\d

som kan ändra font eller utföra andra formatteringar.

För text är storleksfältet ett decimaltal mellan 1 och 4.

Det väljer den textstorlek som texten ska ritas med.

För polygoner tolkas storleksfältet som ett stipple-nummer som används för att fylla polygonen.

Numret används som index i en stipple-font vid utskrift.

Den sista raden i varje element innehåller ett decimaltal och en textsträng, separerade med ett mellanslag.

Talet anger antalet tecken i strängen.

Informationen används endast för textelement och innehåller textsträngen.

Det kan finnas mellanslag i texten.

För bågar, kurvor och vektorer är teckenantalet 0, följt av exakt ett mellanslag före radslutet.

KOORDINATER

gremlin konstruerades för AED-terminaler, och koordinaterna avspeglar AED:s koordinatsystem.

För vertikala bilder gäller normalt:

x-värden: 116 till 511
y-värden: 0 till 483

För horisontella bilder gäller normalt:

x-värden: 0 till 511
y-värden: 0 till 367

Man måste inte strikt hålla sig inom detta område, men resultatet blir bättre om man håller sig nära det.

Punktlistor avslutas med punkten:

(-1, -1)

Använd därför aldrig negativa koordinater i AED-formatet.

gremlin skriver koordinater med printf(3)-formatet:

%f1.2

Det är lämpligt att använda samma format om du vill ändra grn-koden.

SUN/X11-KOORDINATER

Det finns ingen begränsning för koordinatområdet i Sun/X11-versionen av gremlin.

Filer med negativa koordinater orsakar däremot problem om de visas på AED.

OPTIONER

-?

Visa användningsmeddelande och avsluta.

--help

Visa användningsmeddelande och avsluta.

-v

Visa versionsinformation och avsluta.

--version

Visa versionsinformation och avsluta.

-C

Känn igen .GS, .GE och .GF även när de följs av ett annat tecken än mellanslag eller radslut.

-F katalog

Sök i katalog efter underkataloger med formen devnamn, där namn är utdataenhetens namn, för filen DESC före standardkatalogerna för fonter.

Standardkatalogerna är:

/usr/local/share/groff/site-font
/usr/local/share/groff/1.24.1/font
/usr/lib/font

-M katalog

Lägg katalog först i sökvägen för Gremlin-filer.

Standardsökvägen är, i ordning:

.
~
/usr/local/share/groff/site-tmac
/usr/local/share/groff/1.24.1/tmac

-T enhet

Förbered utdata för utdataenheten enhet.

Standard är:

ps

Se groff(1) för giltiga enheter.

AVSLUTNINGSSTATUS

grn avslutas med status:

0

Körningen lyckades.

2

Programmet kunde inte tolka kommandoradsargumenten.

1

Ett fel uppstod under körningen.

FILER

/usr/local/share/groff/1.24.1/font/devnamn/DESC

Beskriver utdataenheten namn.

FÖRFATTARE

Den ursprungliga Berkeley-versionen av grn skrevs av:

David Slattengren
Barry Roitblat

Den modifierades för groff av:

Daniel Senderowicz
Werner Lemberg

Werner Lembergs e-postadress:

wl@gnu.org

SE ÄVEN

KOLOFON

Denna sida är en del av projektet groff, GNU troff.

Information om projektet finns på:

http://www.gnu.org/software/groff/

Felrapporter för manualsidan hänvisas till:

http://www.gnu.org/software/groff/

Sidan hämtades från arkivet:

groff-1.24.1.tar.gz

Arkivet hämtades från:

https://ftp.gnu.org/gnu/groff/

den 24 maj 2026.

Om du upptäcker renderingsproblem i HTML-versionen av sidan, eller anser att det finns en bättre eller mer aktuell källa, kan du skicka e-post till:

man-pages@man7.org

KORT SAMMANFATTNING

grn används för att bädda in Gremlin-bilder i groff/troff-dokument.

En Gremlin-bild placeras normalt mellan:

.GS
file bild.g
.GE

Centrering, vänster- eller högerjustering anges på .GS-raden:

.GS C
.GS L
.GS R

Kör via groff:

groff -Tps -me dokument.me > dokument.ps

Kör grn direkt:

grn dokument.tr > dokument-med-bilder.tr

Lägg till sökväg för Gremlin-filer:

grn -M ./bilder dokument.tr > ut.tr

Välj utdataenhet:

grn -T ps dokument.tr > ut.tr

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/grn.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp Huddinge som har sponsrat Linux.se med webbhotell.

grn(1)

Innehåll