Admin: Skapade sidan med '{{DISPLAYTITLE:grn(1)}} == 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

Des...'

2026-07-18T13:14:28Z

Skapade sidan med '{{DISPLAYTITLE:grn(1)}} == NAMN == '''grn''' – bädda in Gremlin-bilder i '''groff'''-dokument == SYNOPSIS == <pre> grn [-C] [-T enhet] [-M katalog] [-F katalog] [fil ...] grn -? grn --help grn -v grn --version </pre> == 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: <pre> .GS .GE </pre> Des...'

Ny sida

{{DISPLAYTITLE:grn(1)}}

== NAMN ==

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

== SYNOPSIS ==

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

grn -?

grn --help

grn -v

grn --version
</pre>

== 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:

<pre>
.GS
.GE
</pre>

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:

<pre>
.GF
</pre>

i stället för:

<pre>
.GE
</pre>

lämnas positionen vid bildens överkant.

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

<pre>
.GS
.GE
.GF
</pre>

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

<pre>
\D'F ...'
</pre>

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 ===

<pre>
1 N
2 N
3 N
4 N
</pre>

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

Standardvärdena är:

{| class="wikitable"
! Storlek !! Standard
|-
| 1 || 12 punkter
|-
| 2 || 16 punkter
|-
| 3 || 24 punkter
|-
| 4 || 36 punkter
|}

=== Typsnitt ===

<pre>
roman f
italics f
bold f
special f
</pre>

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

''f'' kan vara ett namn eller nummer.

Standardvärden:

{| class="wikitable"
! Kommando !! Standardfont
|-
| roman || R
|-
| italics || I
|-
| bold || B
|-
| special || S
|}

=== Stipple-font ===

<pre>
l f
stipple f
</pre>

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 ===

<pre>
x N
scale N
</pre>

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

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

Kommandot '''scale''' kan förkortas till:

<pre>
sc
</pre>

=== Linjetjocklek ===

<pre>
narrow N
medium N
thick N
</pre>

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:

{| class="wikitable"
! 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 ===

<pre>
pointscale [off|on]
</pre>

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 ===

<pre>
default
</pre>

Å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 ===

<pre>
width N
</pre>

Tvinga bilden att vara ''N'' tum bred.

Detta åsidosätter skalningsfaktorer i samma bild.

<pre>
width 0
</pre>

ignoreras.

=== height ===

<pre>
height N
</pre>

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 ===

<pre>
file namn
</pre>

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:

<pre>
$$
</pre>

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:

<pre>
g1
g2
g3
g4
g5
g6
g7
g8
g9
</pre>

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:

<pre>
POLYGON
CURVE
</pre>

i stället för nummer.

Exempel på två filer som beskriver samma bild:

<pre>
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
</pre>

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

<pre>
gremlinfile
</pre>

för AED-formatet, eller:

<pre>
sungremlinfile
</pre>

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:

<pre>
1 0.00 0.00
</pre>

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

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

<pre>
-1
</pre>

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.

{| class="wikitable"
! 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:

<pre>
-1.0 -1.0
</pre>

i AED-format, eller med en ensam asterisk:

<pre>
*
</pre>

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:

{| class="wikitable"
! 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:

{| class="wikitable"
! 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:

<pre>
\fI
\d
</pre>

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:

<pre>
(-1, -1)
</pre>

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

'''gremlin''' skriver koordinater med [[printf(3)]]-formatet:

<pre>
%f1.2
</pre>

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 '''dev'''namn, där namn är utdataenhetens namn, för filen '''DESC''' före standardkatalogerna för fonter.

Standardkatalogerna är:

<pre>
/usr/local/share/groff/site-font
/usr/local/share/groff/1.24.1/font
/usr/lib/font
</pre>

'''-M''' ''katalog''

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

Standardsökvägen är, i ordning:

<pre>
.
~
/usr/local/share/groff/site-tmac
/usr/local/share/groff/1.24.1/tmac
</pre>

'''-T''' ''enhet''

: Förbered utdata för utdataenheten ''enhet''.

: Standard är:

<pre>
ps
</pre>

: 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/dev'''namn'''/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:

<pre>
wl@gnu.org
</pre>

== SE ÄVEN ==

* [[gremlin(1)]]
* [[groff(1)]]
* [[pic(1)]]
* [[ideal(1)]]
* [[troff(1)]]
* [[tbl(1)]]
* [[eqn(1)]]
* [[printf(3)]]

== KOLOFON ==

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

Information om projektet finns på:

<pre>
http://www.gnu.org/software/groff/
</pre>

Felrapporter för manualsidan hänvisas till:

<pre>
http://www.gnu.org/software/groff/
</pre>

Sidan hämtades från arkivet:

<pre>
groff-1.24.1.tar.gz
</pre>

Arkivet hämtades från:

<pre>
https://ftp.gnu.org/gnu/groff/
</pre>

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:

<pre>
man-pages@man7.org
</pre>

== KORT SAMMANFATTNING ==

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

En Gremlin-bild placeras normalt mellan:

<pre>
.GS
file bild.g
.GE
</pre>

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

<pre>
.GS C
.GS L
.GS R
</pre>

Kör via groff:

<pre>
groff -Tps -me dokument.me > dokument.ps
</pre>

Kör grn direkt:

<pre>
grn dokument.tr > dokument-med-bilder.tr
</pre>

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

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

Välj utdataenhet:

<pre>
grn -T ps dokument.tr > ut.tr
</pre>

= 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/
<BR><BR>Tack till [https://datorhjalp.se/web/datorhjalp-huddinge/ Datorhjälp Huddinge] som har sponsrat [https://www.linux.se Linux.se] med webbhotell.

[[Kategori:Linuxmanual grupp 1]]
[[Kategori:Linuxmanual]]

grn(1) - Versionshistorik