gpic - Online nel cloud

PROGRAMMA:

NOME

pic - compila immagini per troff o TeX

SINOSSI

bit [ -nvCSU ] [ Nome del file ...]
bit -t [ -cvzCSU ] [ Nome del file ...]

DESCRIZIONE

Questa pagina di manuale descrive la versione GNU di bit, che fa parte del documento groff
sistema di formattazione. bit compila le descrizioni delle immagini incorporate all'interno trof o TeX
inserire file in comandi che sono compresi da TeX o trof. Ogni immagine inizia con a
riga che inizia con . PS e termina con una riga che inizia con .PE. Qualsiasi cosa al di fuori di . PS
e .PE viene attraversato senza modifiche.

È responsabilità dell'utente fornire definizioni appropriate del PS e PE
macro. Quando il pacchetto macro utilizzato non fornisce tali definizioni (ad esempio,
vecchie versioni di -ms), si possono ottenere definizioni appropriate con -mpia: Questi lo faranno
centra ogni immagine.

VERSIONI

Le opzioni che non accettano argomenti possono essere raggruppate dietro un singolo -. L'opzione speciale
-- può essere utilizzato per contrassegnare la fine delle opzioni. Un nome file di - si riferisce alla norma
ingresso.

-C Riconoscere . PS e .PE anche se seguito da un carattere diverso da spazio o
nuova linea.

-S Modalità più sicura; non eseguire sh comandi. Questo può essere utile quando si opera su
input non affidabile (abilitato per impostazione predefinita).

-U Modalità non sicura; ripristina l'opzione predefinita -S.

-n Non utilizzare le estensioni groff per i comandi di disegno troff. Dovresti usare questo
se stai usando un postprocessor che non supporta queste estensioni. Il
le estensioni sono descritte in groff_out(5). Il -n l'opzione causa anche bit non utilizzare
linee di lunghezza zero per disegnare punti in modalità troff.

-t modalità TeX.

-c Sii più compatibile con tipo. Implica -t. Righe che iniziano con \ non sono passati
attraverso in modo trasparente. Righe che iniziano con . sono passati con l'iniziale
. cambiato in \. Una riga che inizia con .ps riceve un trattamento speciale: ci vuole un
argomento intero opzionale che specifica lo spessore della linea (dimensione della penna) in millipollici;
un argomento mancante ripristina lo spessore della linea precedente; lo spessore della linea predefinito
è 8 millipollici. Lo spessore della linea così specificato ha effetto solo quando un
lo spessore della linea negativo non è stato specificato mediante l'uso del spessore attributo o
impostando il linea spessa variabile.

-v Stampa il numero di versione.

-z In modalità TeX disegna punti usando linee di lunghezza zero.

Le seguenti opzioni sono supportate da altre versioni di bit vengono ignorati:

-D Disegna tutte le linee usando la sequenza di escape \D. bit fa sempre questo.

-T dev Genera output per il trof dispositivo dev. Questo non è necessario perché il trof
output generato da bit è indipendente dal dispositivo.

USO

Questa sezione descrive solo le differenze tra GNU bit e la versione originale di
bit. Molte di queste differenze si applicano anche alle versioni più recenti di Unix bit. Un completo
la documentazione è disponibile nel file

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

TeX modo
La modalità TeX è abilitata dal -t opzione. In modalità TeX, bit definirà un vbox chiamato \grafico
per ogni immagine. Utilizzare il nome di fig comando per cambiare il nome del vbox. Devi
stampa tu stesso quel vbox usando, ad esempio, il comando

\centerline{\box\graph}

In realtà, poiché la vbox ha un'altezza pari a zero (è definita con \vtop) questo produrrà
spazio leggermente più verticale sopra l'immagine che sotto;

\centerline{\solleva 1em\scatola\grafico}

eviterebbe questo.

Per fare in modo che il vbox abbia un'altezza positiva e una profondità pari a zero (come usato ad esempio da LaTeX'
grafica.sty), definisci la seguente macro nel tuo documento:

\def\gpicbox#1{%
\vbox{\unvbox\nomecs #1\nomeendcs\kern 0pt}}

Ora puoi semplicemente dire \gpicbox{grafico} invece di \box\graph.

È necessario utilizzare un driver TeX che supporti il tipo speciali, versione 2.

Righe che iniziano con \ sono passati attraverso in modo trasparente; un % viene aggiunto alla fine del
linea per evitare spazi indesiderati. Puoi tranquillamente usare questa funzione per cambiare i caratteri o per
modificare il valore di \baselinesalta. Qualsiasi altra cosa potrebbe produrre risultati indesiderati;
Utilizzare a proprio rischio. Le righe che iniziano con un punto non ricevono alcun trattamento speciale.

Comandi
da variabile = espr1 a espr2 [by [*]espr3] do X stile di vita X
Impostato variabile a espr1. Mentre il valore di variabile è minore o uguale a espr2,
do stile di vita e incremento variabile by espr3; Se by non è dato, incremento variabile by
1. Se espr3 è preceduto da * poi variabile sarà invece moltiplicato per espr3.
Il valore di espr3 può essere negativo per il caso additivo; variabile viene quindi testato
se è maggiore o uguale a espr2. Per il caso moltiplicativo, espr3
deve essere maggiore di zero. Se i vincoli non vengono rispettati, il ciclo non viene eseguito.
X può essere qualsiasi carattere non presente in stile di vita.

if espr poi X se è vero X [altro Y se-falso Y]
Valutare espr; se è diverso da zero, fallo se è vero, altrimenti fai se-falso. X può essere
qualsiasi carattere non presente in se è vero. Y può essere qualsiasi carattere non presente in
se-falso.

stampare arg...
Concatena gli argomenti e stampa come una riga su stderr. Ogni arg deve essere un file
espressione, una posizione o un testo. Questo è utile per il debug.

command arg...
Concatena gli argomenti e passali come una linea a troff o TeX. Ogni
arg deve essere un'espressione, una posizione o un testo. Questo ha un effetto simile a a
riga che inizia con . or \, ma consente il passaggio dei valori delle variabili
attraverso. Per esempio,

. PS
x = 14
command ".ds stringa x is " x "".
.PE
\*[corda]

stampe

x is 14

sh X command X
Passare command a una conchiglia. X può essere qualsiasi carattere non presente in command.

copia "Nome del file"
Includere Nome del file a questo punto del file.

copia ["Nome del file"] thru X stile di vita X [fino a quando "parola"]
copia ["Nome del file"] thru macro [fino a quando "parola"]
Questo costrutto non stile di vita una volta per ogni riga di Nome del file; la linea è divisa in
parole delimitate da spazi e occorrenze di $i in stile di vita, Per i tra 1 e 9, sono
sostituito dal i-esima parola della riga. Se Nome del file non è dato, le linee sono prese
dall'ingresso corrente fino a .PE. Se uno fino a quando è specificata la clausola, le righe saranno
leggi solo fino a una riga la cui prima parola è parola; quella linea sarà quindi
scartato. X può essere qualsiasi carattere non presente in stile di vita. Per esempio,

. PS
copia thru % cerchio at ($ 1, $ 2) % fino a quando "FINE"
1 2
3 4
5 6
FINE
nella scatola
.PE

è equivalente

. PS
cerchio at (1,2)
cerchio at (3,4)
cerchio at (5,6)
nella scatola
.PE

I comandi da eseguire per ogni riga possono essere presi anche da una macro definita
prima dando il nome della macro come argomento a thru.

azzerare
azzerare variabile1[,] variabile2 ...
Ripristina variabili predefinite variabile1, variabile2 ... ai loro valori predefiniti. Se
non vengono forniti argomenti, reimposta tutte le variabili predefinite ai loro valori predefiniti.
Nota che l'assegnazione di un valore a scala causa anche tutte le variabili predefinite che
controllare le dimensioni da riportare ai valori di default moltiplicato per il nuovo valore di
scala.

trama espr ["testo"]
Questo è un oggetto di testo che viene costruito usando testo come stringa di formato per
sprintf con un argomento di espr. Se testo viene omessa una stringa di formato di "%G" is
Usato. Gli attributi possono essere specificati allo stesso modo di un normale oggetto di testo. Essere
molto attenti a specificare una stringa di formato appropriata; bit fa solo molto
controllo limitato della stringa. Questo è deprecato a favore di sprintf.

variabile := espr
Questo è simile a = con l’esclusione di variabile deve essere già definito, e espr sarà
assegnato a variabile senza creare una variabile locale al blocco corrente. (Di
contrasto, = definisce la variabile nel blocco corrente se non è già definita
lì, quindi cambia il valore solo nel blocco corrente.) Ad esempio, il
seguenti:

. PS
x = 3
y = 3
[
x := 5
y = 5
]
stampare x " " y
.PE

stampe

5 3

Argomenti della forma

X nulla X

possono anche essere della forma

{ nulla }

In questo caso nulla può contenere occorrenze bilanciate di { e }. Le stringhe possono contenere X
o occorrenze sbilanciate di { e }.

Espressioni
La sintassi per le espressioni è stata notevolmente estesa:

x ^ y (esponente)
peccato(x)
cos (x)
atan2 (y, x)
tronco d'albero(x) (base 10)
exp (x) (base 10, cioè 10^x)
sqrt(x)
intero(x)
rand () (restituire un numero casuale compreso tra 0 e 1)
randa(x) (restituire un numero casuale compreso tra 1 e x; deprecato)
randa(x) (imposta il seme del numero casuale)
max (e1, e2)
minimo (e1, e2)
!e
e1 && e2
e1 || e2
e1 == e2
e1 != e2
e1 >= e2
e1 > e2
e1 <= e2
e1 < e2
"str1" == "str2"
"str1" != "str2"

Le espressioni di confronto di stringhe devono essere racchiuse tra parentesi in alcuni contesti per evitare ambiguità.

Altri Modifiche
Una nuda espressione, espr, è accettabile come attributo; è equivalente a dir espr,
where dir è la direzione corrente. Per esempio

linea 2i

significa tracciare una linea lunga 2 pollici nella direzione corrente. Il carattere 'i' (o 'I') è
ignorato; per utilizzare un'altra unità di misura, impostare il scala variabile ad un valore appropriato.

La larghezza e l'altezza massime dell'immagine sono prese dalle variabili maxpswid e
massimo. Inizialmente questi hanno valori 8.5 e 11.

La notazione scientifica è consentita per i numeri. Per esempio

x = 5e-2 mila

Gli attributi di testo possono essere composti. Per esempio,

"foo" sopra giusto

è valido.

Non c'è limite alla profondità alla quale i blocchi possono essere esaminati. Per esempio,

[UN: [B: [C: nella scatola ]]] con .ABCsw at 1,2
cerchio at ultimo [].ABC

è accettabile.

Gli archi ora hanno punti cardinali determinati dal cerchio di cui l'arco fa parte.

Cerchi, ellissi e archi possono essere punteggiati o tratteggiati. In modalità TeX le spline possono essere tratteggiate o
tratteggiato anche.

Le scatole possono avere angoli arrotondati. Il rad attributo specifica il raggio del quarto-
cerchi ad ogni angolo. se no rad or diam l'attributo è dato, un raggio di boxrad viene utilizzato.
Inizialmente, boxrad ha valore 0. Una casella con angoli arrotondati può essere punteggiata o tratteggiata.

Le scatole possono avere i lati inclinati. Questo cambia effettivamente la forma di una scatola da a
rettangolo in un parallelogramma arbitrario. Il xinclinato e islanted gli attributi specificano il
x e y offset dell'angolo in alto a destra della casella dalla sua posizione predefinita.

. . PS la riga può avere un secondo argomento che specifica un'altezza massima per l'immagine. Se
viene specificata la larghezza di zero la larghezza verrà ignorata nel calcolo del fattore di scala
per la foto. Nota che GNU bit scalerà sempre un'immagine della stessa quantità
verticalmente che orizzontalmente. Questo è diverso dal DWB 2.0 bit che può
ridimensionare un'immagine di una quantità diversa verticalmente che orizzontalmente se l'altezza è
specificato.

Ad ogni oggetto di testo è associata una casella invisibile. I punti cardinali di un testo
oggetto sono determinati da questa casella. Anche il movimento implicito associato all'oggetto è
determinato da questa casella. Le dimensioni di questa scatola sono prese dalla larghezza e dall'altezza
attributi; se l'attributo larghezza non viene fornito, la larghezza verrà considerata come
larghezza di testo; se l'attributo dell'altezza non viene fornito, l'altezza verrà considerata come la
numero di stringhe di testo associate all'oggetto volte testo. Inizialmente larghezza di testo e
testo hanno valore 0.

In (quasi tutti) i luoghi in cui è possibile utilizzare una stringa di testo tra virgolette, un'espressione della forma

sprint("formato", arg,...)

può anche essere utilizzato; questo produrrà gli argomenti formattati secondo formato, quale
dovrebbe essere una stringa come descritto in printf(3) appropriato per il numero di argomenti
fornito.

Lo spessore delle linee utilizzate per disegnare gli oggetti è controllato dal linea spessa variabile.
Questo dà lo spessore delle linee in punti. Un valore negativo significa utilizzare il valore predefinito
spessore: in modalità output TeX, questo significa utilizzare uno spessore di 8 milliinches; nell'output di TeX
modalità con -c opzione, questo significa utilizzare lo spessore della linea specificato da .ps Linee; in
modalità di output troff, questo significa utilizzare uno spessore proporzionale alla dimensione dei punti. Un valore zero
significa tracciare la linea più sottile possibile supportata dal dispositivo di output. Inizialmente ha un
valore di -1. C'è anche un grossa[ness] attributo. Per esempio,

cerchio spessore 1.5

disegnerebbe un cerchio usando una linea con uno spessore di 1.5 punti. Lo spessore delle linee
non è influenzato dal valore di scala variabile, né dalla larghezza o altezza data in
, il . PS linea.

Scatole (comprese le scatole con angoli arrotondati o lati obliqui), cerchi ed ellissi possono essere
riempito dando loro un attributo di riempire[ed]. Questo richiede un argomento opzionale di an
espressione con un valore compreso tra 0 e 1; 0 lo riempirà di bianco, 1 di nero, i valori
in mezzo con una sfumatura proporzionalmente grigia. Può essere utilizzato anche un valore maggiore di 1:
questo significa riempire con la sfumatura di grigio attualmente utilizzata per testo e linee.
Normalmente questo sarà nero, ma i dispositivi di output possono fornire un meccanismo per cambiarlo.
Senza un argomento, quindi il valore della variabile valore di riempimento sarà usato. Inizialmente questo
ha un valore di 0.5. L'attributo invisibile non influisce sul riempimento degli oggetti. Qualunque
il testo associato a un oggetto riempito verrà aggiunto dopo che l'oggetto è stato riempito, quindi
che il testo non sarà oscurato dal riempimento.

Sono disponibili tre modificatori aggiuntivi per specificare gli oggetti colorati: contorno[d] imposta il
colore del contorno, ombroso il colore di riempimento e giro[u]r[ed] imposta entrambi. Tutti e tre
le parole chiave prevedono un suffisso che specifichi il colore, ad esempio

cerchio ombroso "Green" contorno "nero"

Attualmente, il supporto del colore non è disponibile in modalità TeX. Nomi di colori predefiniti per groff
sono nei file macro del dispositivo, ad esempio ps.tmac; colori aggiuntivi possono essere definiti con
, il .decolorare richiesta (consultare la pagina di manuale di trof(1) per maggiori dettagli).

Per cambiare il nome del vbox in modalità TeX, imposta la pseudo-variabile nome di fig (che è
in realtà un comando appositamente analizzato) all'interno di un'immagine. Esempio:

. PS
nome di fig = poggiapiedi;
...
.PE

L'immagine è quindi disponibile nella scatola \foobar.

bit presuppone che all'inizio di un'immagine sia il glifo che il colore di riempimento siano impostati su
valore predefinito.

Le punte delle frecce verranno disegnate come triangoli solidi se la variabile punta di freccia è diverso da zero e
o la modalità TeX è abilitata o il -n opzione non è stata data. Inizialmente punta di freccia ha una
valore di 1. Notare che le punte delle frecce piene sono sempre riempite con il colore del contorno corrente.

L'uscita troff di bit è indipendente dal dispositivo. Il -T l'opzione è quindi ridondante. Tutto
i numeri sono presi in pollici; i numeri non vengono mai interpretati come in troff machine
unità.

Gli oggetti possono avere un Allineati attributo. Funzionerà solo se il postprocessore è brancola,
or gropdf. Qualsiasi testo associato a un oggetto avente il Allineati l'attributo sarà
ruotato attorno al centro dell'oggetto in modo che sia allineato nella direzione dal
punto iniziale al punto finale dell'oggetto. Nota che questo attributo non avrà alcun effetto
per oggetti i cui punti iniziale e finale coincidono.

In luoghi dove nth È permesso 'espr'ns è anche consentito. Notare che 'ns è un singolo token:
non è consentito alcuno spazio tra i ' e la th. Per esempio,

da i = 1 a 4 do {
linea da 'io' box.nw a 'i+1'th box.se
}

CONVERSIONE

Per ottenere un'immagine autonoma da a bit file, allega il tuo bit codice con . PS e .PE
richieste; roff i comandi di configurazione possono essere aggiunti all'inizio del file, ma no
roff testo.

È necessario inserire questo file in groff senza aggiungere alcuna informazione sulla pagina, quindi tu
deve controllare quale . PS e .PE le richieste vengono effettivamente chiamate. Ad esempio, la macro mm
pacchetto aggiunge un numero di pagina, il che è molto fastidioso. Al momento, chiamando standard groff
senza alcun pacchetto di macro funziona. In alternativa, puoi definire le tue richieste, ad es
fare niente:

.de PS
..
.de PE
..

groff di per sé non fornisce la conversione diretta in altri formati di file grafici. Ma
ci sono molte possibilità se prima trasformi la tua immagine in PostScript®
formattare usando il groff opzione -Ti prego. Da questo ps-file manca delle informazioni BoundingBox it
non è molto utile da solo, ma può essere inserito in altri programmi di conversione, di solito
detto ps2Altri or pstoAltri o simili. Inoltre, l'interprete PostScript Ghostscript
(gs) ha dispositivi di conversione grafica incorporati che vengono chiamati con l'opzione

gs -sDISPOSITIVO=

Call

gs --Aiuto

per un elenco dei dispositivi disponibili.

Un'alternativa potrebbe essere quella di utilizzare il -Tpdf opzione per convertire direttamente la tua immagine in PDF
formato. Il MediaBox del file prodotto può essere controllato passando a -Pp Misura del foglio
grattare.

Come formato di file PostScript incapsulato EPS sta diventando sempre più importante, e il
la conversione non era considerata banale in passato potresti essere interessato a sapere che c'è
è uno strumento di conversione chiamato ps2eps che fa il lavoro giusto. È molto meglio del
ps2epsi confezionato con gs.

Per i formati grafici bitmap, dovresti usare pstopnm; la risultante (intermedia) PNM
il file può quindi essere convertito praticamente in qualsiasi formato grafico utilizzando gli strumenti del netpbm
pacchetto .

Usa gpic online utilizzando i servizi onworks.net