dvisvgm - Интернет в облаке

ПРОГРАММА:

ИМЯ

dvisvgm - конвертирует файлы DVI и EPS в формат SVG на основе XML.

СИНТАКСИС

двисвгм [ кредита ] файл [.dvi]

двисвгм -Э [ кредита ] файл [.eps]

ОПИСАНИЕ

Утилита командной строки двисвгм конвертирует файлы DVI, сгенерированные TeX / LaTeX, в формат
Основанный на XML масштабируемый формат векторной графики SVG. Он поддерживает классический формат DVI 2 как
а также формат 3 (создается pTeX в вертикальном режиме) и формат 5, который также известен как
XDV (создано XeTeX). Помимо основных команд DVI, dvisvgm также оценивает многие
так называемые скидки которые значительно расширяют возможности формата DVI. Для большего
подробный обзор см. в разделе Поддержанный Специальные предложения внизу.

Поскольку текущий стандарт SVG 1.1 не определяет многостраничную графику, dvisvgm создает
отдельные файлы SVG для каждой страницы DVI. Из соображений совместимости только первый
страница конвертируется по умолчанию. Чтобы выбрать другую страницу или произвольную страницу
последовательности, используйте опцию -p который описан ниже.

SVG - это векторный графический формат, поэтому dvisvgm пытается преобразовать глиф
контуры всех используемых шрифтов в масштабируемые описания путей. Самый быстрый способ сделать это -
извлеките информацию о пути из файлов шрифтов в формате PFB, TTF или OTF. Если dvisvgm
способный найти такой файл, он извлекает всю необходимую контурную информацию о глифах
от него.

Однако основным источником описания шрифтов для TeX является Metafont, который производит вывод растровых изображений.
(Файлы GF). Вот почему не все доступные шрифты TeX доступны в масштабируемом формате. В
В этих случаях dvisvgm пытается векторизовать вывод Metafont, отслеживая растровые изображения глифов.
Результаты не так идеальны, как у большинства (оптимизированных вручную) аналогов PFB или OTF, но
тем не менее в большинстве случаев действительно хороши.

При запуске dvisvgm без опции --без шрифтов, шрифт элементы (...) используются
чтобы встроить данные шрифта в файлы SVG. К сожалению, только несколько рендеров SVG поддерживают
этих элементов пока нет. Большинство веб-браузеров и приложений для работы с векторной графикой их не оценивают.
правильно, чтобы текстовые компоненты результирующей графики могли выглядеть странно. В
для создания более совместимых файлов SVG, опция командной строки --без шрифтов может быть отдан
замените элементы шрифта на простые графические контуры.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-a - трассировка-все=[возвращаться]
Эта опция заставляет dvisvgm отслеживать не только действительно необходимые глифы, но и все глифы.
всех растровых шрифтов, используемых в файле DVI. Поскольку результаты трассировки хранятся в
кеш шрифтов, все последующие преобразования DVI (без опции - трассировка-все) где эти
шрифты задействованы, будет намного быстрее. По умолчанию dvisvgm отслеживает только фактически
необходимые глифы и добавляет их в кеш. Логическая опция возвращаться определяет, как
для обработки глифов, уже хранящихся в кеше. По умолчанию эти глифы пропускаются.
Установка аргумента возвращаться в Да or правда заставляет dvisvgm отслеживать соответствующий
снова растровые изображения.

Внимание
Этот параметр действует только в том случае, если активно кэширование шрифтов. Следовательно, - трассировка-все
нельзя комбинировать с опцией --cache = none.

-б, --bbox=FMT
Устанавливает ограничивающую рамку сгенерированной графики в указанный формат. Параметр
FMT принимает либо один из описателей формата, перечисленных ниже, либо последовательность из четырех
значения длины, разделенные запятыми или пробелами x1, y1, x2 и y2. Последние определяют два
диагональные углы ограничивающей рамки. Каждое значение длины состоит из числа с плавающей запятой.
число и необязательная единица измерения длины (pt, bp, cm, mm, in или pc). Если единица
опущено, предполагаются точки TeX (pt).

Также возможно указать только одно значение длины l. В этом случае минимальная граница
поле вычисляется и увеличивается добавлением (-l,-l) в левый верхний и (l,l) к
нижний правый угол.

В качестве альтернативы поддерживаются следующие спецификаторы формата:

Мультиязычность DIN / ISO бумаги Размеры
An, Вn, Cn, Dn, Где n является неотрицательным целым числом, например A4 или a4 для DIN / ISO A4
формат (210мм × 297мм).

север американские бумаги Размеры
счет-фактура, исполнительный, юридический, письмо, бухгалтерская книга

Особый ограничивающая ящик Размеры

дви размер страницы, хранящийся в файле DVI
мин вычисляет минимальный / самый жесткий
Ограничительная рамка
никто ограничивающая рамка не назначена

страница ориентация
Ориентация страницы по умолчанию для форматов бумаги DIN / ISO и американских портрет,
т.е. ширина < высота. Добавление -пейзаж или просто -l в строку формата
переключается на пейзаж Режим (ширина > высота). Из соображений симметрии вы также можете
явно добавить -портрет or -p , чтобы указать портретный формат по умолчанию. Обратите внимание, что
эти суффиксы являются частью строки размера, а не отдельными параметрами. Таким образом, они
должен следовать непосредственно за спецификатором размера без дополнительных пробелов. Более того,
суффиксы ориентации нельзя использовать с дви, минкачества никто.

Внимание
Опция -б, --bbox влияет только на ограничивающую рамку и не преобразует
содержимое страницы. Следовательно, если вы выберете альбомный формат, страница не будет
поворачивается.

-С, --кэш[=директория]
Чтобы ускорить процесс преобразования растровых шрифтов, dvisvgm сохраняет промежуточные
информация о преобразовании в файлах кеша. По умолчанию эти файлы хранятся в
$ HOME / .dvisvgm / cache. Если вы предпочитаете другое место, используйте опцию --кэш в
перезаписать по умолчанию. Кроме того, также можно отключить кеширование шрифтов.
механизм полностью с опцией --cache = none. Если аргумент директория опущено, dvisvgm
печатает путь к каталогу кэша по умолчанию вместе с дополнительной информацией о
сохраненные шрифты. Кроме того, удаляются устаревшие и поврежденные файлы кеша.

-дж, --clipjoin
Эта опция указывает dvisvgm самому вычислить пересечение траекторий отсечения, если
необходимо, а не делегировать эту задачу модулю рендеринга SVG. Полученные файлы SVG
более портативны, потому что некоторые рендереры SVG не поддерживают пересечения обрезки
пути, которые определены клиппуть элементы, содержащие клип-путь атрибутов.

--цвет
Позволяет раскрашивать сообщения, печатаемые в процессе преобразования. Цвета могут
быть настроенным с помощью переменной окружения DVISVGM_COLORS. См. Раздел ОКРУЖАЮЩАЯ СРЕДА
ниже для получения дополнительной информации.

-А ТАКЖЕ, --eps
Если задана эта опция, dvisvgm ожидает не DVI, а входной файл EPS, и
пытается преобразовать его в SVG. Для этого один PS-файл специальная команда
создается и передается специальному обработчику PostScript. Эта опция доступна только
если dvisvgm был собран с включенной поддержкой PostScript и требует, чтобы Ghostscript был
доступный. См. Вариант --libgs для дополнительной информации.

-е, --точный
Если задана эта опция, dvisvgm вычисляет точную ограничивающую рамку каждого символа.
По умолчанию значения, хранящиеся в файле TFM шрифта, используются для определения глифа.
степень. Поскольку эти значения предназначены для реализации оптимального размещения символов и
не предназначены для представления точных размеров, они не обязательно соответствуют
границы визуальных глифов. Таким образом, ширина и / или высота некоторых глифов могут быть
больше (или меньше) соответствующих значений TFM. В результате это может привести к
обрезанные символы в границах SVG-графики. С опцией --точный данный,
dvisvgm анализирует фактическую форму каждого символа и выводит обычно точный
Ограничительная рамка.

-м, --fontmap=имена файлов
Загружает и оценивает один или несколько файлов карты шрифтов. Эти файлы необходимы для
разрешать имена и кодировки файлов шрифтов. dvisvgm не предоставляет собственные файлы карт, но
пытается прочитать доступные, поставляемые с dvips или dvipdfm. Если вариант --fontmap is
опущено, dvisvgm ищет файлы карты по умолчанию ps2pk.карта, dvipdfm.mapкачества
psfonts.map (в этом порядке). В противном случае используются перечисленные файлы. Несколько имен файлов
должны быть разделены запятыми без начальных и / или конечных пробелов. Файлы карты
оцениваются в указанном порядке. По умолчанию переопределенные сопоставления не заменяют
предыдущие. Однако перед каждым именем файла может быть указан необязательный спецификатор режима.
(+, -или =), чтобы изменить это поведение:

+ файл карты
Только те записи в данном файле карты, которые не переопределяют отображение шрифтов, являются
применяемый. Это также режим по умолчанию, если не указан спецификатор режима.

-mapfile
Гарантирует, что никакие сопоставления шрифтов, определенные в данном файле карты, не используются,
т.е. ранее определенные сопоставления для указанных шрифтов удаляются.

= mapfile
Применяются все сопоставления, определенные в файле карты. Ранее определенные настройки для
заменяется тот же шрифт.

Если первому имени файла в последовательности файлов предшествует спецификатор режима,
dvisvgm загружает карту шрифтов по умолчанию (см. выше) и применяет другие файлы карты
после. В противном случае ни один из файлов карт по умолчанию не будет загружен автоматически.

Примеры: --fontmap = myfile1.map, + myfile2.map грузы мой файл1.карта последующей
мой файл2.карта где все переопределения мой файл2.карта игнорируются.
--fontmap == myfile1.map, -myfile2.map загружает файл карты по умолчанию, за которым следует
мой файл1.карта и мой файл2.карта где все переопределения мой файл1.карта замещать
предыдущие записи. Впоследствии все определения шрифтов, приведенные в мой файл2.карта
удаляются из дерева карты шрифтов.

Для получения дополнительной информации о форматах файлов карты и спецификаторах режима см.
мануалы на dvips и dvipdfm.

--grad-перекрытие
Указывает dvisvgm создавать перекрывающиеся сегменты сетки при приближении цветового градиента
заливки (см. также вариант --grad-сегменты ниже). По умолчанию соседние сегменты не
перекрываются, но касаются друг друга только как отдельные плитки. К сожалению, этот расклад
может привести к появлению видимых промежутков между сегментами, потому что фон влияет на
цвет на границе сегментов, если средство визуализации SVG использует сглаживание для создания
плавные контуры. Один из способов избежать этого и создать плавно соприкасающиеся цветовые области.
заключается в увеличении сегментов так, чтобы они доходили до области их правого и нижнего
соседи. Поскольку последние рисуются поверх перекрывающихся частей, видимые
размер всех сегментов остается неизменным. Просто бывшие пробелы исчезают как фон
теперь полностью покрыт правильными цветами. В настоящее время dvisvgm вычисляет
перекрывающиеся сегменты отдельно для каждого фрагмента сетки (сетка фрагмента может состоять
нескольких патчей одного типа). Таким образом, все еще могут быть видимые пробелы на
шов двух соседних заплат.

--grad-сегменты=номер
Определяет максимальное количество сегментов в столбце и строке, используемое для аппроксимации
заливка градиентным цветом. Поскольку SVG 1.1 поддерживает только небольшое подмножество затенения
алгоритмов, доступных в PostScript, dvisvgm аппроксимирует некоторые из них, разделяя
область, которую нужно заполнить на более мелкие монохромные сегменты. Каждый из этих сегментов
получает средний цвет области, которую он покрывает. Таким образом, увеличивая количество
сегменты приводят к уменьшению монохроматических областей и, следовательно, к лучшему
аппроксимация фактического цветового градиента. Как недостаток, чем больше сегментов, тем больше
Файлы SVG, потому что каждый сегмент представлен отдельным элементом пути.

В настоящее время dvisvgm поддерживает треугольные патч-сетки свободной и решетчатой ​​формы, а также
Патч-меши кунов и тензорных произведений. Они аппроксимируются путем подразделения области
каждого патча в n×n сетка из более мелких сегментов. Максимальное количество сегментов на
столбец и строку можно изменить с помощью опции --grad-сегменты.

--grad-упрощать=дельта
Если размер сегментов, созданных для приблизительной заливки градиентным цветом, меньше
при заданном значении дельты dvisvgm снижает уровень детализации. Например, Безье
кривые заменяются прямыми, а треугольные сегменты объединяются в
тетрагоны. Для небольшой дельты эти упрощения обычно не заметны, но
уменьшить размер сгенерированных файлов SVG.

-час, --Помогите[=Режим]
Печатает краткую сводку всех доступных параметров командной строки. Необязательный Режим
параметр представляет собой целое число от 0 до 2. Он выбирает вариант отображения
текст справки. В режиме 0 перечислены все параметры, разделенные на категории с заголовками разделов. Этот
также используется по умолчанию, если dvisvgm вызывается без параметров. В режиме 1 перечислены все варианты.
упорядочены по коротким именам опций, в то время как в режиме 2 строки сортируются по длинным опциям
имена.

--хранить
Отключает удаление временных файлов, созданных Metafont (обычно .gf, .tfm и
.лог-файлы).

--libgs=имя файла
Этот параметр доступен только в том случае, если библиотека Ghostscript не связана напрямую с
dvisvgm, и если поддержка PostScript не была полностью отключена во время компиляции. В
В этом случае dvisvgm пытается динамически загрузить общую библиотеку GS во время выполнения. От
по умолчанию он ожидает, что имя библиотеки будет libgs.so.X (в Unix-подобных системах, где X
является версией библиотеки ABI) или gsdll32.dll / gsdll64.dll (Windows). Вариант
--libgs можно использовать, чтобы дать другое имя. В качестве альтернативы также можно установить
имя библиотеки GS по переменной среды ЛИБГС. Последний имеет меньший приоритет
чем параметр командной строки, т.е. dvisvgm игнорирует переменную ЛИБГС if --libgs дано.

-Л, --linkmark=стиль
Выбирает способ пометки гиперссылок. В стиль аргумент может принимать одно из
ценности никто, ящиккачества линия, Где ящик по умолчанию, т.е. рисуется прямоугольник
вокруг связанной области, если опция --linkmark опущено. Аргумент стиля линия всего
рисует нижний край ограничивающего прямоугольника, а никто говорит dvisvgm не добавлять
видимые объекты в гиперссылки. Линии и поля приобретают текущий цвет текста.
выбрано. Чтобы применить другой, постоянный цвет, следует двоеточие, за которым следует цвет.
спецификатор может быть добавлен к строке стиля. А цвет спецификатор это либо
шестнадцатеричное значение RGB формы #RRGGBB, или название цвета dvips
(http://en.wikibooks.org/wiki/LaTeX/Colors# The_68_standard_colors_known_to_dvips).

Более того, аргумент стиль может принимать один спецификатор цвета, чтобы выделить связанный
область безрамной рамкой, залитой этим цветом. Необязательный второй спецификатор цвета
через двоеточие выбирает цвет рамки.

Примеры: коробка: красный or коробка: # ff0000 рисует красные рамки вокруг связанных областей. желтый: синий
создает прямоугольники с желтой заливкой и синими рамками.

-л, --list-специальные
Печатает список зарегистрированных специальных обработчиков и выходов. Каждый обработчик обрабатывает набор
специальных утверждений, относящихся к той же категории. В большинстве случаев категории
обозначаются префиксом специальных операторов. Обычно это ведущее слово
отделены от остальной части оператора двоеточием или пробелом, например цвет or ps.

-М, --маг=фактор
Устанавливает коэффициент увеличения, применяемый вместе с Metafont вызывает предыдущую трассировку
глифы. Чем больше это значение, тем лучше результаты трассировки. Тем не менее, большие
Значения увеличения могут вызвать арифметические ошибки Metafont из-за переполнения числа. Так,
используйте эту опцию осторожно. Настройка по умолчанию обычно дает хорошие результаты.

--без слияния
Помещает каждого персонажа в отдельный текст элемент с соответствующим x и y
атрибуты. По умолчанию новый текст or чайная ложка элементы создаются только в том случае, если строка начинается
в месте, которое отличается от обычного положения, определенного персонажами
предварительные значения.

--no-mktexmf
Подавляет создание отсутствующих файлов шрифтов. Если dvisvgm не может найти файл шрифта
через механизм поиска kpathsea он вызывает внешние инструменты mktextfm или mktexmf
от. Эта опция отключает эти вызовы.

-н, --без шрифтов[=вариант]
Если указана эта опция, dvisvgm не создает SVG. шрифт элементы, но использует пути
вместо. Получающиеся в результате файлы SVG, как правило, больше, но одновременно они больше
совместим с большинством приложений, которые еще не поддерживают шрифты SVG. Необязательный
аргумент вариант выбирает способ замены шрифтов путями. Вариант 0
создает путь и использование элементы. Вариант 1 создает путь только элементы. Вариант --без шрифтов
подразумевает --без стилей.

-с, --шкала=sx[,sy]
Масштабирует содержимое страницы по горизонтали на sx и по вертикали sy. Этот вариант
что эквивалентно -ТСsx,sy.

-С, --без специальных предложений[=имена]
Отключить обработку специальных команд, встроенных в файл DVI. Если не дальше
задан, все спец игнорируются. Чтобы выборочно отключить наборы специальных предложений,
к этому параметру можно добавить необязательный список имен, разделенных запятыми. А имя is
уникальный идентификатор, указывающий на предполагаемый специальный обработчик. Вариант --list-специальные
перечисляет все доступные в настоящее время обработчики и их имена. Все неподдерживаемые специальные
заявления молча игнорируются.

--без стилей
По умолчанию dvisvgm создает стили CSS и атрибуты классов для ссылки на шрифты, потому что
это более компактно, чем многократно устанавливать полную информацию о шрифте в каждом тексте
элемент. Однако, если вы предпочитаете прямые ссылки на шрифты, поведение по умолчанию может быть
отключен с опцией --без стилей.

-о, --выход=описания
Устанавливает шаблон имени выходного файла. Параметр описания это строка, которая может
содержат переменные %f, %pкачества %P. %f расширяется до базового имени файла DVI,
т.е. имя файла без суффикса, %p это номер текущей страницы, и %P Общая
количество страниц в файле DVI. Необязательное число (0–9) после знака процента.
указывает минимальное количество цифр для записи. Если конкретное значение
короче номер дополняется ведущими нулями. Пример: % 3p вводит 3 цифры для
номер текущей страницы (001, 002 и т. д.). Без явного спецификатора ширины, %p получает
такое же количество цифр, как %P.

Если вам нужен больший контроль над нумерацией, вы можете использовать арифметические выражения как
часть выкройки. Синтаксис: % (выражение) в котором выраж может содержать дополнения,
вычитания, умножения и целочисленные деления с общим приоритетом. В
переменные p и P содержат номер текущей страницы и общее количество страниц,
соответственно. Например, --output = "% f -% (p-1)" создает имена файлов, в которых нумерация
начинается с 0, а не с 1.

Шаблон по умолчанию % f-% p.svg если файл DVI состоит из более чем одной страницы, и
% f.svg в противном случае. Это означает, что файл DVI foo.dvi преобразуется в foo.svg if foo.dvi is
одностраничный документ. В противном случае несколько файлов SVG foo-01.svg, foo-02.svgи т. д.
произведен. В средах Windows знак процента указывает на разыменованную среду.
переменные, и поэтому должны быть защищены вторым знаком процента, например
--output = %% f - %% p.

-п, --страница=диапазоны
Эта опция устанавливает страницы для обработки. Параметр диапазоны состоит из
Список номеров отдельных страниц и / или диапазонов страниц, разделенных запятыми. Диапазон страниц - это пара
чисел, разделенных дефисом, например 5–12. Таким образом, последовательность страниц может выглядеть как
это: 2-4,6,9-12,15. Не имеет значения, дается ли страница более одного раза или страница
диапазоны перекрываются. dvisvgm всегда извлекает номера страниц в порядке возрастания и
конвертирует их только один раз. Чтобы оставаться совместимым с предыдущими версиями,
последовательность страниц по умолчанию - 1. Поэтому dvisvgm преобразует только первую страницу, а не
весь документ в случае варианта --страница опущено. Обычно диапазоны страниц состоят из двух
числа, обозначающие первую и последнюю страницу, которую нужно преобразовать. Если преобразование должно быть
начался со страницы 1, или, если он должен продолжаться до последней страницы DVI, первой или
второй номер диапазона соответственно можно не указывать. Пример: --page = -10 преобразовывает все
страницы до 10 страницы, --page = 10- конвертирует все страницы, начиная со страницы 10. Пожалуйста
Учтите, что значения страниц не относятся к номерам страниц, напечатанным на странице.
Вместо этого ожидается физическое количество страниц, где первая страница всегда получает номер
1.

-д, --точность=цифры
Задает максимальное количество десятичных знаков, применяемых к атрибуту с плавающей запятой.
ценности. Все значения атрибутов, записанные в сгенерированный файл (ы) SVG, округляются.
соответственно. Параметр цифры допускает целочисленные значения от 0 до 6, где 0 включает
автоматический выбор значащих десятичных знаков. Это также значение по умолчанию
если dvisvgm вызывается без опции --точность.

-П, --прогресс[=задерживать]
Включает простой индикатор выполнения, отображаемый при выполнении таких трудоемких операций, как
Обработаны специальные сообщения PostScript. Индикатор не появляется до указанной задержки
(в секундах) истекло. Значение задержки по умолчанию составляет 0.5 секунды.

-р, --вращать=угол
Поворачивает содержимое страницы по часовой стрелке на угол градусов по центру страницы. Этот
вариант эквивалентен -ТРугол.

-Р, --родственник
SVG позволяет определять графические пути последовательностью абсолютных и / или относительных
команды, т.е. каждая команда ожидает либо абсолютные координаты, либо координаты
относительно текущей позиции чертежа. По умолчанию dvisvgm создает пути, состоящие из
абсолютные команды. Если вариант --родственник задано, создаются относительные команды
вместо этого, что в большинстве случаев немного уменьшает размер файлов SVG.

-с, --stdout
Не записывайте вывод SVG в файл, а перенаправляйте его в стандартный вывод.

-Т, - преобразовать=команды
Применяет последовательность преобразований к содержимому SVG. Каждое преобразование
описанный команду начиная с заглавной буквы, за которой следует список
Параметры, разделенные запятыми. Поддерживаются следующие команды преобразования:

T tx[,ty]
Переводит (перемещает) страницу в направлении вектора (tx,ty). если ty опущен, ty=0
предполагается. Ожидаемая длина единицы tx и ty являются точками TeX (1pt =
1 / 72.27 дюйма). Однако есть несколько констант, определенных для упрощения единицы измерения.
преобразование (см. ниже).

S sx[,sy]
Масштабирует страницу по горизонтали на sx и по вертикали sy. Если sy опущен, sy=sx
предполагается.

R угол[,x,y]
Поворачивает страницу по часовой стрелке на угол градусов вокруг точки (x,y). Если необязательный
Аргументы x и y опущены, страница будет повернута вокруг своего центра
в зависимости от выбранного формата страницы. Когда вариант -bнет дано вращение
центр - начало координат (0,0).

KX угол
Перекошивает страницу по x- ось угол градусов. Аргумент угол может взять любой
значение кроме 90 + 180k, Где k является целым числом

KY угол
Перекошивает страницу по y- ось угол градусов. Аргумент угол может взять любой
значение кроме 90 + 180k, Где k является целым числом

FH [y]
Отражает (переворачивает) страницу по горизонтальной линии через точку (0,y). Опуская
необязательный аргумент приводит к y=h/ 2, где h обозначает высоту страницы (см. предопределенный
постоянная ниже).

FV [x]
Отражает (переворачивает) страницу по вертикальной линии через точку (x, 0). Опуская
необязательный аргумент приводит к x=w/ 2, где w обозначает ширину страницы (см. предопределенный
постоянная ниже).

M m1, ...,m6
Применяет преобразование, описываемое матрицей 3 × 3
((m1,m2,m3), (m4,m5,m6), (0,0,1)), где внутренние тройки обозначают строки.

Внимание
Все команды трансформации опции -Т, - преобразовать применяются в порядке
их внешнего вида. При желании несколько команд можно разделить пробелами.
В этом случае вся строка преобразования должна быть заключена в двойные
цитаты. Все параметры являются выражениями типа с плавающей запятой. Вы также можете
давать простые числа или арифметические термины, объединенные операторами + (Сложение),
- (вычитание), * (Умножение), / (деление) или % (по модулю) с общим
правила ассоциативности и приоритета. Также можно использовать круглые скобки.

Кроме того, предоставляются некоторые предопределенные константы:

ux горизонтальное положение верхнего
левый угол страницы в точке TeX
единиц
uy вертикальное положение верхнего левого угла
угол страницы в единицах TeX point
h высота страницы в единицах TeX point
(0 в случае -bнет)
w ширина страницы в единицах TeX point (0
в случае -bнет)

Кроме того, вы можете использовать константы длины pt, mm, cm и in, например 2см or
1.6in. Таким образом, вариант -TT1in, 0R45 перемещает содержимое страницы на 1 дюйм вправо и
после этого поворачивает его на 45 градусов вокруг центра страницы.

Для единичных преобразований вы также можете использовать параметры -c, -t и -r, Обратите внимание, что
порядок, в котором указаны эти параметры, не имеет значения, т. е. вы не можете
используйте их для описания последовательностей преобразований. Они просто независимы
сокращенные варианты общих преобразований.

-т, --перевести=tx[,ty]
Переводит (перемещает) содержимое страницы в направлении вектора (tx,ty). Этот вариант
что эквивалентно -TTtx,ty.

-в, - многословие=уровень
Управляет типом сообщений, выводимых при запуске dvisvgm:

0 нет вывода сообщений
1 только сообщения об ошибках
2 только предупреждающие сообщения
4 только информационные сообщения

Внимание
Добавляя эти значения, вы можете комбинировать категории. Уровень по умолчанию - 7,
т.е. печатаются все сообщения.

-В, --версия[=расширенная]
Печатает версию dvisvgm и завершает работу. Если для необязательного аргумента установлено значение Да,
Также печатаются номера версий связанных библиотек.

-з, --zip[=уровень]
Создает сжатый файл SVG с расширением .svgz. Необязательный аргумент указывает
уровень сжатия. Допустимые значения находятся в диапазоне от 1 до 9 (значение по умолчанию 9).
Большие значения приводят к лучшим результатам сжатия, но требуют больше времени вычислений.

Предупреждение
Этот вариант нельзя комбинировать с -с, --stdout.

-З, - масштаб[=фактор]
Умножает ширина и высота атрибуты корневого элемента SVG по аргументу фактор
при этом система координат изображения сохраняется. В результате большинство зрителей SVG
соответственно увеличьте графику. Если указан отрицательный коэффициент масштабирования, ширина и
высота атрибуты опускаются.

ПОДДЕРЖКА СПЕЦПРЕДЛОЖЕНИЯ

dvisvgm поддерживает несколько наборов особый команды который можно использовать для обогащения файлов DVI
с дополнительными функциями, такими как цвет, графика и гиперссылки. Оценка специальных
Команды делегируются выделенным обработчикам. Каждый обработчик несет ответственность за все специальные
операторы одного и того же набора команд, т. е. команды, начинающиеся с одного и того же префикса. Чтобы получить
список фактически предоставленных специальных обработчиков, используйте опцию --list-специальные (см. выше). Этот
В разделе представлен обзор поддерживаемых в настоящее время специальных команд.

BGCOLOR
Специальная инструкция для изменения цвета фона / страницы. Поскольку SVG 1.1 не
поддержка цветов фона, dvisvgm вставляет прямоугольник выбранного цвета в
сгенерированный документ SVG. Этот прямоугольник всегда имеет тот же размер, что и выбранный или
вычисляемая ограничивающая рамка. Эта команда цвета фона является частью специального набора цветов
но обрабатывается отдельно, чтобы пользователь мог его выключить. Для обзора
синтаксис команд, см., например, документацию по dvips.

цвет
Операторы этого набора команд предоставляют инструкции по изменению цвета текста / краски.
Для обзора точного синтаксиса, например, смотрите документацию dvips.

двисвгм
dvisvgm предлагает свой небольшой набор специальных возможностей. Следующий список дает краткое
Обзор.

dvisvgm: raw текст
Добавляет произвольную последовательность символов в раздел страницы документа SVG.
dvisvgm здесь не выполняет никаких проверок, поэтому пользователь должен убедиться, что
полученный SVG все еще действителен. Параметр текст может содержать выражения {?Икс},
{? y}качества {?цвет} которые расширяются до текущего x or y координата и текущий
цвет соответственно. Более того, {? nl} расширяется до символа новой строки.

dvisvgm: rawdef текст
Эта команда похожа на dvisvgm: raw, но помещает необработанный текст в
раздел документа SVG, который в настоящее время создается.

dvisvgm: rawset имя ... dvisvgm: endrawset
Эта пара специальных символов отмечает начало и конец определения именованного необработанного SVG.
фрагмент. Все dvisvgm: raw и dvisvgm: rawdef специальные предложения прилагаются dvisvgm: rawset
и dvisvgm: endrawset не оцениваются сразу, а совместно хранятся в
данный имя для дальнейшего использования. После определения на именованный фрагмент можно ссылаться
во всем файле DVI dvisvgm: rawput (увидеть ниже). Две команды
dvisvgm: rawset и dvisvgm: endrawset не должны быть вложенными, т.е. каждый вызов
dvisvgm: rawset должен сопровождаться соответствующим вызовом dvisvgm: endrawset
перед другим dvisvgm: rawset может возникнуть. Также идентификатор имя Должно быть уникальным
во всем файле DVI. С использованием dvisvgm: rawset несколько раз вместе с
то же имя приводит к предупреждающему сообщению.

dvisvgm: rawput имя
Вставляет необработанные фрагменты SVG, ранее сохраненные в заданном имя. двисвгм
различает фрагменты, указанные с помощью dvisvgm: raw or
dvisvgm: rawdef, и обрабатывает их по-разному: вставляет все dvisvgm: raw части
каждый раз dvisvgm: rawput называется, тогда как dvisvgm: rawdef порции идут в
раздел текущего документа SVG только один раз.

dvisvgm: img ширина высота файл
Создает элемент изображения в текущей графической позиции, ссылаясь на данную
файл. Здесь можно использовать изображения JPEG, PNG и SVG. Однако dvisvgm не проверяет
формат файла или суффикс имени файла. Длина ширина и высота должен быть
даны как простые числа с плавающей запятой в единицах TeX point (1in = 72.27pt).

dvisvgm: bbox новый] имя
Определяет или сбрасывает локальную ограничивающую рамку с именем имя. Имя может состоять из
буквы и цифры. При обработке страницы DVI dvisvgm постоянно обновляет
(глобальный) ограничивающий прямоугольник текущей страницы для определения минимального
прямоугольник, содержащий все видимые компоненты страницы (символы, изображения, рисунок
элементы и т. д.) В дополнение к глобальной ограничивающей рамке пользователь может запросить
произвольное количество именованных локальных ограничивающих рамок. После определения эти поля становятся
обновляется вместе с глобальной ограничивающей рамкой, начиная с первого символа
что следует определению. Таким образом, локальные боксы могут использоваться для вычисления
размер частей страницы. Это полезно для сценариев, в которых сгенерированный SVG
файл проходит постобработку. В сочетании со специальным файлом dvisvgm: raw макрос {? bbox
имя} расширяется до четырех значений x, y, wкачества h (разделены пробелами) с указанием
координаты левого верхнего угла, ширина и высота локального бокса имя.
Если коробка имя ранее не было определено, все четыре значения равны нулю.

dvisvgm: bbox ширина высота [глубина]
Обновляет ограничивающую рамку текущей страницы, встраивая виртуальный прямоугольник (x,
y, ширина, высота), где левый нижний угол расположен в текущем DVI
позиция рисования (x,y). Если необязательный параметр глубина указан, dvisvgm
вставляет второй прямоугольник (x, y, ширина, -глубина). Длина ширина, высота и
глубина должны быть заданы как простые числа с плавающей запятой в единицах TeX point (1in =
72.27pt). В зависимости от размера и положения виртуального прямоугольника эта команда
либо увеличивает общую ограничивающую рамку, либо оставляет ее как есть. Невозможно
уменьшить его степень. Это специальное предложение следует использовать вместе с dvisvgm: raw in
чтобы правильно обновить область просмотра страницы.

dvisvgm: bbox a [bs] x1 y1 x2 y2
Этот вариант специального bbox обновляет ограничивающую рамку, встраивая виртуальную
прямоугольник (x1,y1,x2,y2). Точки (x1,y1) И (x2,y2) обозначают две диагональные
углы прямоугольника даны в единицах TeX point.

dvisvgm: bbox исправить] x1 y1 x2 y2
Этот вариант специальной функции bbox назначает абсолютную (окончательную) ограничивающую рамку объекту
результирующий SVG. После выполнения этой команды dvisvgm больше не изменяет
координаты ограничивающего прямоугольника, за исключением того, что этот специальный вызов снова вызывается позже. Точки
(x1,y1) И (x2,y2) обозначают два диагональных угла прямоугольника, заданного в TeX
точечные единицы.

Следующий фрагмент TeX добавляет к выходным данным два необработанных элемента SVG и обновляет
ограничивающая рамка соответственно:

\ special {dvisvgm: raw }
\ special {dvisvgm: bbox 20 10 10}

\ special {dvisvgm: raw }
\ special {dvisvgm: bbox abs 10 200 100 250}

em
Эти специальные предложения были представлены в дистрибутиве emTeX Эберхардом Маттесом. Они
предоставить инструкции по рисованию линий, инструкции по встраиванию изображений MSP, PCX и BMP
файлы, а также две команды PCL. dvisvgm поддерживает только операторы рисования линий
и молча игнорирует все остальные специальные предложения. Описание синтаксиса команды может быть
можно найти в документации по драйверу DVI, поставляемой с emTeX (см. CTAN).

HTML
Спецификация гиперссылки определяет несколько вариантов того, как отмечать области с гиперссылками.
в файле DVI. dvisvgm поддерживает простые специальные конструкции HyperTeX, созданные с помощью
опция пакета hyperref гипертекс. По умолчанию все связанные области документа являются
отмечен прямоугольником. Вариант --linkmark позволяет изменить это поведение. См. Выше для
дальнейшие подробности. Информация о синтаксисе и семантике специальных функций HyperTeX может быть
найдено в руководстве по гиперссылке.

PDF
pdfTeX и dvipdfmx представили несколько специальных команд, связанных с генерацией
PDF-файлы. В настоящее время их всего двое, pdf: mapfile и pdf: mapline поддерживаются
dvisvgm. Эти специальные возможности позволяют изменять дерево карты шрифтов во время обработки DVI.
файлы. Например, они используются CTeX. dvisvgm поддерживает как dvips, так и
Формат карты шрифтов dvipdfm. Для получения дополнительной информации о синтаксисе и семантике команд см.
см. документацию \ pdfmapfile в руководстве пользователя pdfTeX.

ps
Знаменитый DVI-драйвер dvips представил собственный набор специальных функций для встраивания
Код PostScript в файлы DVI, что значительно улучшает возможности DVI
документы. Одна из целей dvisvgm - полностью оценить все фрагменты PostScript и
конвертировать как можно больше из них в SVG. В отличие от dvips, dvisvgm использует
арифметика с плавающей запятой для вычисления точного положения каждого графического элемента,
т.е. не округляет координаты. Следовательно, относительное расположение
графические элементы могут незначительно отличаться от рассчитанных dvips.

Поскольку PostScript - довольно сложный язык, dvisvgm не пытается реализовать его
собственный интерпретатор PostScript, но полагается на Ghostscript (http://ghostscript.com) вместо
Если библиотека Ghostscript не была связана с двоичным файлом dvisvgm, выполняется поиск и
загружается динамически во время выполнения. В этом случае dvisvgm ищет libgs.so.X on
Unix-подобные системы (поддерживаемые версии ABI: 7,8,9), а также для gsdll32.dll or gsdll64.dll
в Windows. Вы можете переопределить имена файлов по умолчанию с помощью переменной среды ЛИБГС or
параметр командной строки --libgs. Библиотека должна быть доступна через поиск ld
путь (* nix) или переменная среды PATH (Windows). В качестве альтернативы абсолютное
можно указать путь к файлу. Если библиотека не может быть найдена, dvisvgm отключает
обработка специальных сообщений PostScript и печать предупреждающего сообщения. Вариант использования
--list-специальные чтобы проверить, доступна ли поддержка PostScript, т. е. запись ps is
настоящее время.

Обработчик PostScript также распознает и оценивает данные ограничивающей рамки, сгенерированные
домен предварительный просмотр пакет с опцией плотная страница. Если данные присутствуют в файле DVI,
dvisvgm соответствующим образом адаптирует ограничивающую рамку сгенерированного файла SVG и печатает
сообщение, показывающее ширину, высоту и глубину поля в единицах TeX-точек.
В частности, значение глубины можно использовать для вертикального выравнивания графики SVG с
базовая линия окружающего текста, например, в документах HTML или XSL-FO.

TPIC
В специальный набор TPIC входят инструкции по рисованию простых геометрических объектов. Немного
Пакеты LaTeX, такие как eepic и tplot, используют эти специальные возможности для описания графики.

ПРИМЕРЫ

файл dvisvgm

Конвертирует первую страницу файл .dvi в файл.svg.

dvisvgm -z файл

Конвертирует первую страницу файл .dvi в файл.svgz со степенью сжатия по умолчанию 9.

dvisvgm -p5 -z3 -ba4-l -onewfile файл

Конвертирует пятую страницу файл .dvi в новый файл.svgz со степенью сжатия 3. Ограничивающая
коробка настроена на DIN / ISO A4 в альбомном формате.

dvisvgm --transform = "R20, w / 3,2h / 5 T1cm, 1cm S2,3" файл

Конвертирует первую страницу файл .dvi в файл.svg где применены три преобразования.

ОКРУЖАЮЩАЯ СРЕДА

dvisvgm использует Кпатси библиотека для поиска файлов, которые она открывает. Следовательно
переменные окружения, описанные в документации библиотеки, влияют на преобразователь.

Если dvisvgm был связан без библиотеки Ghostscript, и если поддержка PostScript отсутствует
был отключен, общая библиотека Ghostscript просматривается во время выполнения через dlopen ().
Переменная окружения ЛИБГС можно использовать для указания пути и имени файла библиотеки.

Предварительно скомпилированные версии dvisvgm для Windows требуют рабочей установки MiKTeX 2.9.
или выше. dvisvgm не работает вместе с портативной версией MiKTeX, потому что он
полагается на COM-интерфейс MiKTeX, доступный только при локальной установке. Чтобы включить
оценка специальных возможностей PostScript, оригинальная DLL Ghostscript gsdll32.dll должен быть
присутствуют и доступны через путь поиска. Для 64-разрядных сборок Windows требуется 64-разрядная версия.
Библиотека Ghostscript gsdll64.dll. Обе библиотеки DLL поставляются с соответствующими установщиками Ghostscript.
доступно на www.ghostscript.com.

Переменная окружения DVISVGM_COLORS определяет цвета, используемые для выделения различных
части вывода сообщения dvisvgm. Он оценивается только в том случае, если опция --цвет дано. В
Значение DVISVGM_COLORS список разделенных двоеточиями записей в форме gg=BF, Где gg
обозначает один из индикаторов цветовой группы, перечисленных ниже, и BF две шестнадцатеричные цифры
указание фона (первая цифра) и цвета переднего плана / текста (вторая цифра). В
значения цвета определяются следующим образом: 0 = черный, 1 = красный, 2 = зеленый, 3 = желтый, 4 = синий, 5 = пурпурный,
6 = голубой, 7 = серый, 8 = ярко-красный, 9 = ярко-зеленый, A = ярко-желтый, B = ярко-синий, C = яркий
пурпурный, D = ярко-голубой, E = ярко-серый, F = белый. В зависимости от терминала цвета могут
различаются. Вместо изменения цвета текста и фона также можно
измените только один из них: звездочка (*) вместо шестнадцатеричной цифры указывает
текст по умолчанию или цвет фона терминала.

Все неправильно сформированные записи в списке игнорируются.

er Сообщения об ошибках

wn предупреждающие сообщения

pn сообщения о номерах страниц

ps сообщения о размере страницы

fw информация о файлах
письменный

sm государственные сообщения

tr сообщения трассировщика глифов

pi индикатор прогресса

Пример: эр = 01: пи = * 5 устанавливает цвета сообщений об ошибках (er) в красный (1) на черном (0), а также расширение
индикаторы прогресса (pi) на голубой (5) на фоне по умолчанию (*).

Используйте dvisvgm онлайн с помощью сервисов onworks.net