dpic - Online en la nube

PROGRAMA:

NOMBRE

dpic: convierte la entrada de lenguaje de imagen a formatos compatibles con LaTeX y a otros formatos

SINOPSIS

dpic [ -efghmprstvxz ] [ en archivo ] [> archivar ]

Típicamente en archivo es de la forma nombre[.foto] y archivar es de la forma
nombre[.tex | .eps | .fig | .mp | .svg]

CAMPUS

(Ninguno) Salida de dibujo LaTeX (capacidad de dibujo basada en fuentes muy limitada)
-e salida pict2e
-f Salida postscript, cadenas en formato psfrag
-g Salida TikZ ‐ pgf
-h escribir un mensaje de ayuda y salir
-m Salida mfpic (consulte la documentación de mfpic)
-p Salida PSTricks
-r Salida PostScript sin formato, sin formato automático de cadenas
-s Salida de MetaPost
-t Salida de eepicemu (un poco menos limitada que la salida de dibujo de LaTeX)
-v salida svg
-x salida xfig 3.2
-z modo seguro (acceso a archivos externos desactivado)

DESCRIPCIÓN

Dpic acepta un subconjunto ajustado del lenguaje de dibujo de imágenes aceptado por GNU pic (a veces
llamado gpic) o AT&T pic, y emite comandos de dibujo de nivel inferior para insertarlos en LaTeX
documentos, para procesar con las herramientas de dibujo xfig o Inkscape, o para mostrarlos directamente como
Postscript encapsulado o SVG. Se puede insertar texto arbitrario en la salida para más tarde
formato y comandos arbitrarios para el postprocesador (PSTricks, Tikz ‐ pgf, etc.) pueden
ser incluido. Dpic devuelve EXIT_SUCCESS (normalmente 0) si los mensajes no son más graves que
Se generaron advertencias, de lo contrario EXIT_FAILURE (normalmente 1).

Algunas extensiones de idioma exclusivas de dpic se implementan para propósitos específicos.

IDIOMA RESUMEN

La entrada consta de una secuencia de líneas. La primera línea de una imagen es .ps y el ultimo es
.EDUCACIÓN FÍSICA, con lneas entre estos dos convertidos en comandos de dibujo de bajo nivel para el
postprocesador elegido por la opción. Líneas fuera de .ps ... .EDUCACIÓN FÍSICA pasar por dpic
sin alterar.

Coordenadas
Los ejes de coordenadas en el lenguaje de imágenes apuntan hacia la derecha y hacia arriba. Las unidades de dibujo son
pulgadas por defecto, pero la declaración

escala = 25.4

al principio del diagrama tiene el efecto de cambiar las unidades a milímetros.

Dibujado objetos
Los objetos dibujados primitivos consisten en los objetos planos caja, círculo, elipse; el lineal
objetos línea, flecha, movimiento, ranura; y arco, que tiene características de planar y
objetos lineales. A bloquear es un par de corchetes que encierran otros objetos: [ cualquier cosa
] y es un objeto plano. El diagrama completo está contenido implícitamente en un bloque.

A cadena es un objeto plano similar a una caja, pero el lenguaje de imágenes también permite que las cadenas
adjuntarse a otros objetos como superposiciones, en cuyo caso son parte del objeto.

La posición de dibujo actual Aquí siempre está definido. Inicialmente y al comienzo de un
bloquear, Aquí es 0,0. Del mismo modo, la dirección actual, que puede ser cualquiera de arriba, abajo, a la izquierda,
derecho, se establece como Derecho inicialmente.

Cada objeto dibujado tiene un punto de entrada y un punto de salida, que dependen de la corriente
dirección. El punto de entrada se coloca de forma predeterminada en la posición actual. Los objetos pueden
también se colocará explícitamente con respecto a las coordenadas absolutas o en relación con otros
objetos. El punto de salida se convierte en la nueva posición actual.

Etiquetas
A Label in pic es una secuencia alfanumérica que comienza con una letra mayúscula. Dpic
permite el subíndice de variables y etiquetas; por lo tanto T y T [5] son etiquetas distintas. los
El valor entre paréntesis puede ser cualquier expresión, pero se redondea al valor entero más cercano. A
etiqueta da un nombre simbólico a una posición u objeto dibujado; por ejemplo,

Enviar: Aquí + (1,2)
Autobús [23]: línea Derecho 4

Definido puntos
Una vez dibujado, un objeto lineal tiene puntos definidos .comienzo, .centrar, y .fin, que puede ser
referenciados como posiciones conocidas, por ejemplo,

L: línea; línea up 0.5 en Lc

donde .centrar ha sido abreviado como .c

Los puntos definidos para un objeto plano son los puntos de la brújula en su periferia dados por
.norte, .s, .mi, .W, .noroeste, .nordeste, .se, .sudoeste, Junto con .centrar, .cima, .fondo, .Derecha, .izquierda.
Para un arco, estos puntos corresponden al círculo del cual el arco es parte, con el
Además de .comienzo y .final.

A bloquear Tiene puntos definidos similares a una caja, pero también puede tener otros en su interior.
Usando el ejemplo

A: [ circulo; Q: [ línea; círculo ]; T: Qn ]

los puntos definidos son los siguientes:

Los puntos del bloque exterior como si fuera una caja, por
ejemplo, ane

Una posición definida en el bloque, por ejemplo, ATI

Los puntos definidos de los objetos etiquetados dentro del bloque,
precedido por un punto, por ejemplo, AQ (el centro de
bloquear P), or AQne (la esquina noreste de P).

Los puntos definidos de los objetos enumerados dentro del
bloque, precedido por un punto (pero asegúrese de que haya un espacio
después del punto si va seguido de un número en lugar de
una expresión entre llaves), por ejemplo, AQ 1 círculo.n
o mejor) AQ {1} st círculo.n

Idioma elementos
Las líneas que definen una imagen están separadas por caracteres de nueva línea o punto y coma. Newlines
son significativas excepto después de entonces, ;, :, {, más, o nueva línea.

Una línea continúa hasta la siguiente si el carácter situado más a la derecha es una barra invertida.

Las líneas de no continuación que comienzan con un punto se ignoran, excepto para .ps y .EDUCACIÓN FÍSICA líneas.

La fuente de la imagen se puede comentar colocando cada comentario a la derecha de un # personaje
(a menos que el # está en una cadena).

Los elementos del lenguaje incluyen lo siguiente:

Un comando de dibujo con etiqueta opcional, por ejemplo, box or A: box

Una definición de etiqueta de posición, por ejemplo A: posición

Una asignación a una variable, por ejemplo x = 5

A dirección (para cambiar el valor predeterminado), por ejemplo, up

La ramificación se realiza mediante

if expr luego { verdad } más { falso }.

La función de bucle es

para variable = expr a expr [por [*] aumentar ] do { cualquier cosa }.

La variable de bucle se incrementa en 1 de forma predeterminada; de lo contrario, en aumentar (que puede ser un
expresión negativa) a menos que esté precedida por un asterisco, en cuyo caso el bucle
la variable se multiplica por aumentar La variable de ciclo puede ser cambiada por las declaraciones en el
loop, controlando así el número de repeticiones de loop.

Los frenillos ocurren en varios contextos. Cuando se usa independientemente de otros elementos del lenguaje, como

{ cualquier cosa }

la riostra izquierda guarda la posición y dirección actuales, y la riostra derecha las restaura
a los valores guardados después de que se hayan procesado las líneas adjuntas.

Los comandos arbitrarios del postprocesador se pueden generar usando

comando cuerda,

que inserta el contenido de cadena en la salida. los cadena el contenido debe ser
compatible con el postprocesador elegido. De manera similar, cualquier línea que comience con un
La barra invertida se copia literalmente en la salida.

La línea

ejecutivo cadena

ejecuta el contenido de cadena como si fuera una línea de entrada normal.

Para ejecutar comandos de shell del sistema operativo, use

sh cadena

y para leer líneas de un archivo externo, use

copia cadena

Estos comandos están deshabilitados por la opción dpic -z o mediante un conmutador en tiempo de compilación.

El comando

Imprimir expr | posición | cadena [ > cadena | >> cadena ]

imprime o agrega su argumento al archivo nombrado en la cadena de la derecha, o por defecto
al error estándar. La opción -z inhabilita la impresión en un archivo.

Macros
El lenguaje de imágenes incluye definición y expansión de macros, utilizando

definir nombre { cualquier cosa },

para que, cuando nombre aparece solo o con argumentos como nombre ( argumento, ... ) entonces es
reemplazado por el contenido entre llaves en la definición. Una coma en un argumento
La lista se ignora dentro de una cadena o paréntesis. En esta sustitución, las apariciones de $1
se reemplazan por el primer argumento, y así sucesivamente para otros argumentos. El valor $+ en un parche de
macro es el número de argumentos dados a la macro. dpic ignora los espacios en blanco (espacios,
nuevas líneas y caracteres de tabulación) que preceden directamente a un argumento en una invocación de macro. A
La definición de macro se puede eliminar mediante

indefinir nombre

Las definiciones de macros son globales, lo que puede requerir una indefinición juiciosa de macros si hay
es un riesgo de conflictos de nombres.

Dibujo comandos
Un objeto se dibuja utilizando el siguiente formato general:

[ Label :] objeto [ atributos ] [ colocación ] [ instrumentos de cuerda ]

Los siguientes elementos objeto puede ocurrir en cualquier orden, pero el orden puede marcar la diferencia para
el resultado dibujado, ya que las líneas se leen e interpretan de izquierda a derecha. Los valores predeterminados son
asumido para todos los parámetros del dibujo según sea necesario. Por ejemplo, la secuencia

círculo "Masticar"; flecha; box "Tragar"
línea; arco cw ->; Elipse "Digerir"

dibuja un diagrama de flujo simple usando tamaños predeterminados para todos los objetos, con palabras centradas en
el círculo, el cuadro y la elipse.

Atributos
El tamaño y otros parámetros controlan la apariencia de los objetos. Un atributo es un
palabra clave o palabras clave con expresiones apropiadas.

Los atributos de dimensión son los siguientes, que muestran abreviaturas válidas:

altura | ht | ancho | wid | radio | rad | diámetro | diam | escalado expr

Cuando se agrega a objetos lineales, altura y anchura se aplican a las dimensiones de la punta de flecha. los
escamoso atributo escala el objeto por exp.

El tamaño posprocesado de una cadena se desconoce de antemano para el procesador de imágenes, pero una vez
conocidas, las dimensiones del cuadro delimitador se pueden especificar explícitamente como para otros objetos dibujados,
como se muestra:

cadena wid expr ht expr

El grosor de las líneas que definen un objeto se modifica mediante la variable de entorno
grosor de línea o el atributo

espesor | grueso expr

expresado en puntos. El grosor de la línea es independiente de cualquier escala.

Las líneas continuas se dibujan por defecto; esto se puede modificar con

sólido | invisible | invis

o con

punteado | punteado [ expr ]

la expresión opcional en el último que establece la longitud y la distancia entre guiones o
puntos

Los siguientes atributos son para poner puntas de flecha al principio, al final o en ambos extremos de una
objeto lineal:

<- | -> | <-> [ expr ]

El parámetro de forma expr puede omitirse, en cuyo caso el valor del medio ambiente
variable punta de flecha se utiliza. El predeterminado para flecha is ->.

La dirección de dibujo de un arco es cambiada por el atributo

ccw | cw

ccw el valor por defecto.

Para rellenar un objeto o ruta con un tono de gris, use el atributo

llenar [ expr ]

donde un valor de 1 significa blanco y 0 significa negro. Los caminos se pueden llenar donde el
posprocesador lo permite.

El color de la línea se puede configurar usando

contorno | delineado cadena

donde el contenido de la cadena depende del postprocesador. Los colores predefinidos de
Se pueden especificar paquetes LaTeX o Tikz ‐ pdf. El lenguaje de la imagen no conoce detalles sobre
color; el contenido de la cadena debe ser compatible con el postprocesador. Los colores personalizados tienen
para ser definido usando el

comando cadena

instalación para que el postprocesador los conozca.

El relleno por color es similar, usando el atributo

sombreado cadena

y, cuando los colores de relleno y contorno son iguales, los dos atributos se pueden
combinado como

color | color | coloreado | coloreado cadena

en el que las cuatro grafías son equivalentes.

Finalmente, el atributo

mismo

duplica las propiedades del objeto previamente dibujado del mismo tipo, pero con la
ubicación predeterminada actual.

Además de los cambios de escala efectuados por el escala variable, el tamaño de la completa
La imagen se puede configurar agregando uno o dos términos al .ps línea como se muestra:

.ps [x[y]]

donde xey se evalúan a valores constantes. Al encontrarme con el .EDUCACIÓN FÍSICA línea, la imagen
se calculan el ancho w y la altura h. Si x> 0, la imagen se escala de modo que w = x.
Si h> y> 0 o si x = 0 e y> 0, entonces la imagen se escala de modo que h = y. Horizontal
y la escala vertical no son independientes. El tamaño del texto, el grosor de la línea y las puntas de flecha son
no escalado. Las unidades son pulgadas, por ejemplo,

.ps 100/25.4

establece el ancho de la imagen final en 100 mm. El texto de la cadena impresa puede extenderse más allá del
límites rectangulares definidos por w y h a menos que las dimensiones del texto hayan sido explícitamente
conjunto.

Si el ancho del diagrama final excede maxpswid o la altura excede maxpsht luego el diagrama
se escala como para xey anteriores.

Colocación provisional of dibujado objetos
Un objeto se coloca de forma predeterminada para que su entrada esté en el punto actual.

La colocación explícita se obtiene con

objeto at posición

que centra el objeto en posición, or

objeto se define punto at posición

por ejemplo,

arco cw en posición a posición .c at posición

Un bloque también se puede colocar por referencia a un desplazamiento desde su esquina inferior izquierda,
por ejemplo,

A: [ contenido ] (0.5,0.2) at larga.

Los objetos lineales se colocan por defecto con el .comienzo punto colocado en el dibujo actual
posición; de lo contrario, los objetos lineales se definen mediante un especificación de línea, que es de la forma

especificación de línea = en posición | a posición | dirección [ expr ]
| especificación de línea especificación de línea
| especificación de línea luego especificación de línea

donde la segunda línea significa que especificaciones lineales puede concatenarse, y el tercero que
Los objetos lineales de varios segmentos se dibujan utilizando múltiples especificaciones lineales separado por a continuación.

Como ejemplo, lo siguiente dibuja un triángulo con el vértice más a la izquierda en la corriente
punto:

línea up 2 Derecho 1.5 luego DE INSCRIPCIÓN 3 luego a Aquí

Excepcionalmente, el especificación de línea

a posición a posición a ...

es múltiple y no requiere la luego palabra clave.

Un único expr también es aceptable especificación de línea inmediatamente después de un objeto lineal y significa
que el objeto se dibuja a la longitud expr en la dirección actual. La excepción a esto
is

ranura [ expr ] especificación de línea

para lo cual el expr es un parámetro de tensión de spline. Si expr se omite, una línea recta es
dibujado al punto medio de los dos primeros puntos de control de spline y desde el punto medio del
los dos últimos hasta el último punto; la spline es tangente a todos los puntos medios entre los puntos de control.
If expr está presente, la spline es tangente en el primer y último punto de control y en todo
otros puntos medios, y la tensión de la ranura se puede ajustar. Valores de tensión entre 0 y 1
son tipicos

En los casos en los que no se conocen de antemano todos los puntos de un objeto lineal de varios segmentos
o inconveniente de calcular, el comando de dibujo

continue especificación de línea

agregará un segmento al objeto lineal previamente dibujado como si continue tuvieron entonces,
dos diferencias. Se pueden realizar cálculos arbitrarios entre el objeto anterior y el
continue declaración, y el punto actual es el punto de salida del objeto anterior.

La construcción

línea en posición a posición cortar expr

trunca la línea en cada extremo por el valor de expr o si expr se omite, por la corriente
radio del círculo. De lo contrario

línea en posición a posición cortar Expr1 cortar Expr2

trunca la línea por las dos distancias especificadas en los extremos. Los valores de truncamiento pueden ser
negativo.

El atributo

by posición

es para posicionar, por ejemplo,

movimiento by (5,6)

Variables y expresiones
Los nombres de las variables son secuencias alfanuméricas que comienzan con una letra minúscula, opcionalmente
con subíndice como etiquetas, y se definen por asignación. Por ejemplo, la siguiente línea
define la variable x si aún no existe en el alcance actual:

x = expr

El alcance de las variables de imagen es el bloque actual en el que se definen, incluido
bloques definidos posteriormente dentro del bloque actual. La asignación

x := expr

requiere x haber sido definido previamente en el bloque actual o un bloque adjunto.

Las expresiones consisten en valores de coma flotante combinados usando el operador unario "!" por
negación lógica y los usuales paréntesis y operadores binarios en orden decreciente de
precedencia:

^
* / %
+ -
== != >= <= < >
&&
||

En las pruebas lógicas, el valor 0 es equivalente a falso y un valor distinto de cero a verdadero, con
valor verdadero resultante de 1.

Un valor de coma flotante se obtiene como un número entero, un número con e sintaxis, una función
valor, un valor de tamaño de un objeto dibujado, por ejemplo,

pasado caja.ht,

o la coordenada horizontal o vertical de un posición, obtenido respectivamente como

posición .x | .y

Las funciones de un argumento son abs, acos, como en, cos Exp, experiencia, En t, Iniciar sesión, logia, firmar, pecado,
cuadrado, bronceado, suelo. Las funciones exp y log son base 10. La función rand () entrega un
número aleatorio entre 0 y 1, y rand (expr.) inicializa el generador de números aleatorios.

Las funciones de dos argumentos son atan2, máx, min mod donde mod es la función módulo
entregando un valor positivo.

predefinida entorno las variables
Un conjunto de variables predefinidas establece los valores predeterminados de los parámetros de dibujo. Su
los valores se heredan del bloque superior, pero se pueden cambiar por asignación. Ellos pueden
ser utilizado en expresiones como otras variables. Las variables, sus valores predeterminados y
los usos predeterminados se dan a continuación

arcrad Radio de arco de 0.25
flecha 0.1 longitud de punta de flecha
ancho de flecha 0.05 ancho de punta de flecha
caja 0.5 altura de la caja
radio de caja 0 radio de esquinas de caja redondeadas
ancho de caja 0.75 ancho de caja
círculorad 0.25 radio del círculo
ancho de tablero 0.05 trazos de longitud para líneas discontinuas
elipseht 0.5 altura de elipse
elipsewid 0.75 ancho de elipse
línea 0.5 altura de líneas verticales
ancho de línea 0.5 longitud de líneas horizontales
ancho de movimiento 0.5 longitud de movimientos horizontales
ancho de movimiento 0.5 longitud de movimientos horizontales
texto 0 altura asumida del texto
desplazamiento de texto 2.5 / 72 espacio de justificación de texto
ancho de texto 0 ancho asumido del texto

Cuando se asigna un valor a la variable escala, todos los valores anteriores se multiplican por
el nuevo valor de escala. De este modo, las unidades de dibujo se cambian, pero la configuración física predeterminada.
Los tamaños de los objetos dibujados permanecen sin cambios ya que, en la salida final, las dimensiones se dividen por
las escala valor. Además, los siguientes no se modifican por escala:

punta de flecha 1 forma de punta de flecha
llenarval 0.5 densidad de relleno
grosor de línea 0.8 grosor de línea en puntos
maxpsht 11.5 altura máxima permitida del diagrama
maxpswid 8.5 ancho máximo permitido del diagrama
escala 1 factor de escala de unidad de dibujo

Las variables maxpswid y maxpsht puede tener que redefinirse para diagramas grandes o
figuras de paisajes, por ejemplo.

posiciones
A posición es equivalente a un par de coordenadas definido en las unidades de dibujo actuales, y se puede
expresado en las siguientes formas:

Aquí
La posición de dibujo actual.

expr, expr
Un par de expresiones separadas por una coma.

( posición )
Una posición entre paréntesis para agrupar.

( posición , posición )
Toma el valor horizontal de la primera posición y
el valor vertical del segundo.

posición + | - posición
Suma de vectores.

posición * | / expr
Postmultiplicación escalar.

Label
La etiqueta de una posición u objeto definido. La posición
es el centro del objeto.

expr [de las camino] entre posición y posición

El ejemplo x entre A y B es igual a A * (1-x) + B * x.
Cualquier valor de expr esta permitido.

expr < posición, posición >
Un equivalente abreviado de la forma anterior.

número st | rd | nd | th [último] objeto
Un objeto enumerado dentro del bloque actual.

El objeto es uno de los

línea, movimiento, flecha, arco, caja, elipse, círculo, ranura, [], "" .

El número puede ser
reemplazado por { expr }. Por ejemplo, pasado "" significa el
última cadena, y {2 ^ 2} nd [] significa el cuarto bloque en el
alcance actual. La posición es el centro del objeto.

Es posible que se requieran paréntesis cuando se utilicen posiciones o expresiones compuestas en el
formas.

Finalmente, una posición se puede expresar como

objeto . se define punto

Tangas
A cadena es una secuencia de caracteres entre comillas dobles. Para incluir una comilla doble
en una cadena, preceda con una barra invertida. Las cadenas se pueden concatenar usando el +
operador. La función similar a C

sprintf ( formato cuerda, expr, ... )

es equivalente a una cadena. Las expresiones son valores de punto flotante, por lo que los únicos
los formatos numéricos son e, f, y g.

Varias cadenas como "Texto 1" "Texto 2" están apilados y centrados verticalmente.

Una cuerda unida a un objeto se superpone al objeto en el centro, y cualquier altura or anchura
los atributos se aplican al objeto, no a la cadena. Sin embargo, los atributos de justificación
solo y justo se puede aplicar a las cadenas individuales de una pila que se superpone a un objeto.

Una cadena independiente se coloca con su centro en el punto actual de forma predeterminada, o por
especificando la posición de uno de sus puntos definidos como para cualquier objeto, por ejemplo,

"Crujiente galletas " wid 82.3/72 ht 9.7/72 .sudoeste at Q

Los calificadores de ubicación arriba, abajo, solo, justo coloque la cuerda arriba, abajo o
justificado con respecto al punto de colocación. Por ejemplo,

"Crujiente galletas " at Q solo arriba

coloca la cuerda arriba y desplazamiento de texto unidades a la derecha de Q.

EJEMPLOS

Archivo fuente example.pic:

\ documentclass {artículo}
\ usepackage {tikz}
\ Begin {document}
.ps
box discontinua "Hola" "Mundo"
.EDUCACIÓN FÍSICA
\ End {document}

El comando

dpic -g ejemplo.pic > ejemplo.tex; pdflatex ejemplo

produce example.pdf que contiene un cuadro punteado con Hello y World apilados en su interior.

Para producir un archivo .tex que contenga comandos de dibujo PSTricks para su inserción en un LaTeX
documento usando el comando \ input, elimine las primeras tres y últimas líneas en el anterior
fuente y proceso usando el -p opción de dpic.

Del mismo modo, la fuente de la imagen

.ps
\ definecolor {puce} {rgb} {0.8,0.53,0.6}%
box sombreado "pardo rojizo"
.EDUCACIÓN FÍSICA

produce una caja llena de un color similar a una pulga cuando se procesa con dpic -g or dpic -p y
el archivo resultante se inserta en un archivo fuente de látex que invoca, respectivamente, el tikz
o paquete pstricks.

Use dpic en línea usando los servicios de onworks.net