gpic - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

pic - компіляція зображень для troff або TeX

СИНТАКСИС

біт [ -nvCSU ] [ ім'я файлу ...]
біт -t [ -cvzCSU ] [ ім'я файлу ...]

ОПИС

Ця сторінка посібника описує версію GNU біт, який є частиною документа groff
система форматування. біт збирає описи зображень, вбудованих усередину троф або TeX
введіть файли в команди, які зрозумілі TeX або троф. Кожне зображення починається з а
рядок, що починається з . PS і закінчується рядком, що починається з .PE. Що завгодно . PS
та .PE проходить без змін.

Відповідальність користувача за надання відповідних визначень PS та PE
макроси. Якщо пакет макросів, що використовується, не надає таких визначень (наприклад,
старі версії -ms), відповідні визначення можна отримати за допомогою -mpic: Ці будуть
центрувати кожну картинку.

ВАРІАНТИ

Параметри, які не беруть аргументів, можуть бути згруповані за одним -. Спеціальний варіант
-- можна використовувати для позначення кінця параметрів. Ім'я файлу - відноситься до стандарту
Вхід

-C Визнайте . PS та .PE навіть якщо за ним слідує символ, відмінний від пробілу або
новий рядок.

-S Безпечний режим; не виконувати sh команди. Це може бути корисно під час роботи
ненадійне введення (увімкнено за замовчуванням).

-U Небезпечний режим; повернути параметр за замовчуванням -S.

-n Не використовуйте розширення groff до команд малювання troff. Ви повинні скористатися цим
якщо ви використовуєте постпроцесор, який не підтримує ці розширення. The
розширення описані в groff_out(5 р.). The -n варіант також викликає біт не використовувати
лінії нульової довжини для малювання точок у режимі troff.

-t Режим TeX.

-c Будьте більш сумісними з tpic. Має на увазі -t. Рядки, які починаються з \ не проходять
наскрізь прозоро. Рядки, які починаються з . передаються через початкову
. змінено на \. Рядок, що починається з .ps надається особливе ставлення: це вимагає an
необов'язковий цілочисельний аргумент, що вказує товщину лінії (розмір пера) в мілідюймах;
відсутній аргумент відновлює попередню товщину рядка; товщина лінії за замовчуванням
становить 8 мілідюймов. Вказана товщина лінії вступає в силу лише тоді, коли не
від’ємна товщина лінії не була визначена за допомогою товщина атрибут або
встановивши товщина лінії змінна.

-v Надрукуйте номер версії.

-z У режимі TeX малюйте точки, використовуючи лінії нульової довжини.

Наступні параметри підтримуються іншими версіями біт ігноруються:

-D Намалюйте всі лінії, використовуючи керуючу послідовність \D. біт завжди робить це.

-T DEV Згенерувати вихідні дані для троф пристрій DEV. Це непотрібно, оскільки троф
вихід, згенерований біт є незалежним від пристрою.

ВИКОРИСТАННЯ

Цей розділ описує лише відмінності між GNU біт та оригінальну версію
біт. Багато з цих відмінностей також стосуються новіших версій Unix біт. Повний
документація доступна у файлі

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

TeX режим
Режим TeX увімкнено -t варіант. У режимі TeX, біт визначить vbox з назвою \граф
для кожної картинки. Використовувати фіг команда, щоб змінити назву vbox. Ти повинен
самі роздрукуйте цей vbox за допомогою, наприклад, команди

\центральна лінія{\box\graph}

Насправді, оскільки vbox має висоту нуль (вона визначається за допомогою \vtop), це призведе до появи
трохи більше вертикального простору над картинкою, ніж під ним;

\центральна лінія{\підняти 1em\box\graph}

уникнути цього.

Щоб зробити vbox додатною висотою та нульовою глибиною (як використовується, наприклад, LaTeX
графіка.сти), визначте такий макрос у своєму документі:

\def\gpicbox#1{%
\vbox{\unvbox\csname #1\endcsname\kern 0pt}}

Тепер можна просто сказати \gpicbox{график} замість \box\graph.

Ви повинні використовувати драйвер TeX, який підтримує tpic спеціальні пропозиції, версія 2.

Рядки, які починаються з \ пропускаються прозоро; а % додається в кінці
рядок, щоб уникнути небажаних пробілів. Ви можете безпечно використовувати цю функцію для зміни шрифтів або до
змінити значення \baselineskip. Все інше цілком може призвести до небажаних результатів;
використовуйте на свій страх і ризик. Рядки, що починаються з крапки, не піддаються ніякому спеціальному обробці.

Команди
та цінності змінна = вираз 1 до вираз 2 [by [*]вираз 3] do X тіло X
Установка змінна до вираз 1. У той час як значення змінна менше або дорівнює вираз 2,
do тіло і приріст змінна by вираз 3; якщо by не дається, приріст змінна by
1 Якщо вираз 3 має префікс * потім змінна замість цього буде помножено на вираз 3.
Значення вираз 3 може бути негативним для адитивного випадку; змінна потім тестується
чи воно більше чи дорівнює вираз 2. Для мультиплікативного випадку, вираз 3
має бути більше нуля. Якщо обмеження не виконуються, цикл не виконується.
X може бути будь-який символ, який не зустрічається в тіло.

if експр потім X якщо-вірно X [ще Y якщо-неправда Y]
Оцінювати експр; якщо воно відмінне від нуля, то зробіть якщо-вірно, інакше зробіть якщо-неправда. X може бути
будь-який символ, який не зустрічається в якщо-вірно. Y може бути будь-який символ, який не зустрічається в
якщо-неправда.

друк аргумент...
Об’єднайте аргументи та виведіть у вигляді рядка на stderr. Кожен аргумент має бути
вираз, позицію або текст. Це корисно для налагодження.

команда аргумент...
Об’єднайте аргументи та передайте їх як рядок до troff або TeX. Кожен
аргумент має бути виразом, позицією або текстом. Це має подібний ефект до а
рядок, що починається з . or \, але дозволяє передавати значення змінних
через. Наприклад,

. PS
x = 14
команда ".ds рядок x is " x "."
.PE
\*[рядок]

друк

x is 14.

sh X команда X
Проходити команда до оболонки. X може бути будь-який символ, який не зустрічається в команда.

скопіювати "ім'я файлу"
Include ім'я файлу на цьому місці у файлі.

скопіювати ["ім'я файлу"] через X тіло X [до "слово"]
скопіювати ["ім'я файлу"] через макрос [до "слово"]
Ця конструкція робить тіло один раз для кожного рядка ім'я файлу; рядок розбивається на
слова, розділені пробілами, і входження $i in тіло, Для i від 1 до 9, є
замінено на i--е слово рядка. Якщо ім'я файлу не дається, рядки беруться
від поточного входу до .PE. Якщо an до речення вказано, рядки будуть
читати лише до рядка, першим словом якого є слово; тоді ця лінія буде
відкинути. X може бути будь-який символ, який не зустрічається в тіло, Наприклад,

. PS
скопіювати через % коло at ($1, $2) % до "КІНЕЦЬ"
1 2
3 4
5 6
END
ящик
.PE

еквівалентна

. PS
коло at (1,2)
коло at (3,4)
коло at (5,6)
ящик
.PE

Команди, які потрібно виконати для кожного рядка, також можна взяти з визначеного макросу
раніше, давши ім’я макросу як аргумент через.

скидання
скидання змінна1[,] змінна2 ...
Скидання попередньо визначених змінних змінна1, змінна2 ... до значень за замовчуванням. Якщо
аргументи не надаються, скиньте всі попередньо визначені змінні до значень за замовчуванням.
Зауважте, що присвоєння значення масштаб також викликає всі попередньо визначені змінні, які
контрольні виміри, які потрібно скинути до значень за замовчуванням, помножених на нове значення
масштабу.

ділянку експр ["текст"]
Це текстовий об’єкт, який створюється за допомогою використання текст як рядок форматування для
sprintf з аргументом експр. Якщо текст опущено рядок форматування "%g" is
використаний. Атрибути можна вказати так само, як і для звичайного текстового об’єкта. Будьте
дуже обережно вказати відповідний рядок формату; біт робить тільки дуже
обмежена перевірка рядка. Це застаріло на користь спринт.

змінна := експр
Це схоже на = крім змінна вже має бути визначено, і експр буде
присвоєно змінна без створення локальної змінної для поточного блоку. (За
контраст, = визначає змінну в поточному блоці, якщо вона ще не визначена
там, а потім змінює значення лише в поточному блоці.) Наприклад, the
наступні:

. PS
x = 3
y = 3
[
x := 5
y = 5
]
друк x " " y
.PE

друк

5 3

Аргументи форми

X все X

також дозволяється мати форму

{ все }

В цьому випадку все може містити збалансовані випадки { та }. Рядки можуть містити X
або незбалансовані випадки { та }.

Вирази
Синтаксис виразів значно розширено:

x ^ y (зведення в ступінь)
гріх (x)
cos (x)
atan2(y, x)
журнал (x) (основа 10)
досвід (x) (основа 10, тобто 10^x)
sqrt(x)
int(x)
ранд() (повернути випадкове число від 0 до 1)
ранд(x) (повернути випадкове число від 1 до x; не рекомендується)
Сранд(x) (встановити початкове число випадкових чисел)
макс(e1, e2)
хв(e1, e2)
!e
e1 && e2
e1 || e2
e1 == e2
e1 != e2
e1 >= e2
e1 > e2
e1 <= e2
e1 < e2
"str1" == "str2"
"str1" != "str2"

У деяких контекстах вирази порівняння рядків мають бути в дужках, щоб уникнути неоднозначності.

Інше Зміни
Голий вираз, експр, прийнятний як атрибут; це еквівалентно реж експр,
де реж - поточний напрямок. Наприклад

лінія 2i

означає провести лінію довжиною 2 дюйми в поточному напрямку. Символ "i" (або "I").
ігнорується; щоб використовувати іншу одиницю вимірювання, встановіть масштаб змінної до відповідного значення.

Максимальна ширина та висота зображення беруться зі змінних maxpswid та
макспшт. Спочатку вони мають значення 8.5 і 11.

Для чисел допускається наукове позначення. Наприклад

x = 5е-2

Текстові атрибути можна поєднувати. Наприклад,

"foo" вище просто

є дійсним.

Глибина, на яку можна досліджувати блоки, не обмежена. Наприклад,

[А: [B: [C: ящик ]]] з .ABCsw at 1,2
коло at останній [].ABC

є прийнятним.

Дуги тепер мають точки компаса, що визначаються колом, частиною якого є дуга.

Кола, еліпси та дуги можуть бути пунктирними або пунктирними. У режимі TeX сплайни можуть мати пунктир або
штрих також.

Ящики можуть мати закруглені кути. The радий атрибут визначає радіус чверті
кола в кожному кутку. Якщо ні радий or діам дано атрибут, радіус boxrad використовується.
Спочатку boxrad має значення 0. Поле із закругленими кутами може бути пунктирним або пунктирним.

Ящики можуть мати похилі боки. Це ефективно змінює форму коробки з a
прямокутник до довільного паралелограма. The x похилий та похилий атрибути вказують на
x і y зміщення верхнього правого кута поля від його положення за замовчуванням.

Команда . PS рядок може мати другий аргумент, що визначає максимальну висоту зображення. Якщо
вказано ширину нуля, ширина буде ігноруватися при обчисленні коефіцієнта масштабування
для картини. Зверніть увагу, що GNU біт завжди буде масштабувати зображення на однакову величину
як по вертикалі, так і по горизонталі. Це відрізняється від DWB 2.0 біт що може
масштабувати зображення по вертикалі на різну величину, ніж по горизонталі, якщо висота є
вказано.

Кожен текстовий об’єкт має невидиме поле, пов’язане з ним. Точки компаса тексту
об'єкт визначаються цим полем. Неявний рух, пов’язаний з об’єктом, також
визначається цією коробкою. Розміри цієї коробки беруться з ширини і висоти
атрибути; якщо атрибут ширини не вказано, тоді буде прийнято значення ширини
textwid; якщо атрибут висоти не вказано, то висота буде вважатися
кількість текстових рядків, пов'язаних з часом об'єкта текст. Спочатку textwid та
текст мають значення 0.

У (майже у всіх) місцях, де можна використовувати текстовий рядок у лапках, вираз форми

sprintf("формат", аргумент,...)

також можна використовувати; це створить аргументи, відформатовані відповідно до формат, Яка
має бути рядком, як описано в printf(3) відповідає кількості аргументів
постачається.

Товщина ліній, які використовуються для малювання об’єктів, контролюється за допомогою параметра товщина лінії змінна.
Це дає товщину ліній у точках. Від’ємне значення означає використання за замовчуванням
товщина: у режимі виведення TeX це означає використання товщини 8 мілідюймов; у виводі TeX
режим з -c опція, це означає використання товщини лінії, зазначеної в .ps лінії; в
troff вихідний режим, це означає використання товщини, пропорційної розміру точки. Нульове значення
означає провести якнайтоншу лінію, яку підтримує вихідний пристрій. Спочатку він має a
значення -1. Існує також a товстий[мис] атрибут. Наприклад,

коло товщина 1.5

намалював би коло, використовуючи лінію товщиною 1.5 точки. Товщина ліній
не впливає на значення масштаб змінної, ані шириною чи висотою, вказаними в
. PS лінія.

Коробки (включаючи коробки із заокругленими кутами або похилими сторонами), кола та еліпси можуть бути
заповнюється, надаючи їм атрибут заповнювати[ed]. Це приймає необов’язковий аргумент an
вираз зі значенням від 0 до 1; 0 заповнить його білими, 1 чорними значеннями
між ними з пропорційно сірим відтінком. Також можна використовувати значення більше 1:
це означає заливку відтінком сірого, який зараз використовується для тексту та рядків.
Зазвичай він буде чорним, але пристрої виведення можуть забезпечити механізм для зміни цього.
Без аргументу значення змінної fillval буде використано. Спочатку це
має значення 0.5. Атрибут invisible не впливає на заповнення об’єктів. Будь-який
текст, пов’язаний із заповненим об’єктом, буде додано після того, як об’єкт буде заповнений, тому
щоб текст не був затьмарений заповненням.

Для визначення кольорових об’єктів доступні три додаткові модифікатори: план[d] встановлює
колір контуру, заштрихований колір заливки та colo[u]r[ed] встановлює обидва. Усі три
наприклад, ключові слова очікують суфікс, що визначає колір

коло заштрихований "зелений" план "чорний"

Наразі підтримка кольору недоступна в режимі TeX. Попередньо визначені назви кольорів для groff
є, наприклад, у файлах макросів пристрою ps.tmac; додаткові кольори можна визначити за допомогою
.defcolor запит (див. сторінку посібника з троф(1) для більш детальної інформації).

Щоб змінити назву vbox у режимі TeX, встановіть псевдозмінну фіг (який
насправді спеціально проаналізована команда) всередині зображення. приклад:

. PS
фіг = foobar;
...
.PE

Тоді зображення буде доступне в коробці \foobar.

біт передбачає, що на початку зображення і гліф, і колір заливки встановлені на
значення за замовчуванням.

Наконечники стрілок будуть намальовані як суцільні трикутники, якщо змінна наконечник стріли відмінний від нуля і
або режим TeX увімкнено, або -n варіант не надано. Спочатку наконечник стріли має
значення 1. Зверніть увагу, що суцільні наконечники стрілок завжди заповнюються поточним кольором контуру.

Вихід троф біт незалежний від пристрою. The -T Тому варіант є зайвим. всі
числа приймаються в дюймах; цифри ніколи не інтерпретуються як в машині трофів
одиниць.

Об’єкти можуть мати вирівняні атрибут. Це працюватиме лише за наявності постпроцесора намацки,
or gropdf. Будь-який текст, пов’язаний з об’єктом, що має вирівняні атрибут буде
повернути навколо центру об’єкта так, щоб він був вирівняний у напрямку від
початкова точка до кінцевої точки об'єкта. Зауважте, що цей атрибут не матиме жодного ефекту
для об'єктів, початкова і кінцева точки яких збігаються.

У місцях, де nth дозволено "експр'th також дозволено. Зауважте, що 'th є одним маркером:
не допускається простір між " і th, Наприклад,

та цінності i = 1 до 4 do {
лінія від 'i'th box.nw до 'i+1' box.se
}

КОНВЕРСІЯ

Щоб отримати окреме зображення з a біт файл, додайте свій біт код з . PS та .PE
запити; roff команди налаштування можуть бути додані на початку файлу, але ні
roff тексту.

Необхідно передати цей файл groff без додавання інформації про сторінку, тому ви
треба перевірити який . PS та .PE запити насправді викликаються. Наприклад, макрос мм
пакет додає номер сторінки, що дуже дратує. На даний момент дзвінок стандартний groff
без жодного пакету макросів працює. Крім того, ви можете визначити власні запити, наприклад, до
нічого не робити:

. De PS
..
. De PE
..

groff сам по собі не забезпечує прямого перетворення в інші формати графічних файлів. Але
є багато можливостей, якщо ви спочатку перетворите своє зображення на PostScript®
форматувати за допомогою groff варіант -Тпс. З цього ps-файлу не вистачає інформації BoundingBox
не дуже корисний сам по собі, але зазвичай його можна використовувати в інших програмах перетворення
названий ps2Інше or pstoІнше або тому подібне. Крім того, інтерпретатор PostScript ghostscript
(gs) має вбудовані пристрої перетворення графіки, які викликаються з опцією

gs -sПРИСТІЙ=

виклик

gs --допомога

для списку доступних пристроїв.

Альтернативою може бути використання -Tpdf можливість безпосередньо конвертувати зображення PDF
формат. MediaBox створеного файлу можна керувати, передаючи a -Сп розмір паперу
groff.

Як формат файлу Encapsulated PostScript EPS стає все більш важливим, і
Перетворення не вважалося тривіальним у минулому, вам може бути цікаво дізнатися про це
це інструмент перетворення під назвою ps2eps яка виконує правильну роботу. Це набагато краще, ніж
інструмент ps2epsi упакований з gs.

Для растрових графічних форматів слід використовувати pstopnm; отриманий (проміжний) PNM
потім файл можна перетворити практично в будь-який графічний формат за допомогою інструментів netpbm
пакет.

Використовуйте gpic онлайн за допомогою служб onworks.net