ds-measurer.yaml

Версия:1.6.1
Интерфейс:
Язык:YAML
Зависимости:
Автор:Дмитрий Соколов
Лицензия:GNU GPL v3

Идущий вместе с ds-measurer поумолчательный конфигурационный файл в формате YAML, в котором можно настроить цвета отрисовки, сочетания клавиш для разных функций, набор соотношений сторон фиксации выделения, формат и маску файла скриншота и др.

При своём запуске ds-measurer ищет этот файл сначала в каталоге $HOME/.config текущего пользователя, а уже потом, если не находит, в одном каталоге с собой. При обновлении ds-utils (например, через git pull), в числе прочего обновляется и этот конфигурационный файл в одном каталоге с ds-measurer. Так что, если вы хотите иметь свои собственные настройки Замерщика, необходимо скопировать этот файл в каталог $HOME/.config и менять его уже там.

Секция common: общие настройки

selection mode: inner Соглашение о том, как учитывать при выделении толщину линий самого курсора и прямоугольника выделения (см. подробнее). При значении inner все линии находятся внутри выделения. При значении outer все линии находятся снаружи выделения. При значении two pixels все линии имеют толщину 2 пикселя, что в принципе снимает проблему, но, имхо, неудобно.

Секция guides: настройки направляющих

snap distance: 10 Расстояние в пикселях до направляющей(-их), ближе которого выделение прилипает к ним. При значении 0 прилипание выключено.

Секция screenshot: создание скриншотов

target: both Куда писать скриншоты: только в буфер обмена (clipboard), только на диск (file), или и туда, и туда (both).
format: png Формат скриншота, записываемого на диск. Возможные значения: png, jpeg.
file: ~/screenshot_%Y_%m_%d_%H_%M_%S.png Путь и strftime-маска имён записываемых на диск скриншотов. По умолчанию скриншоты пишутся в домашний каталог $HOME с локальным временем в имени файла.

Секция shortcuts: горячие клавиши

quit: Escape Выход из программы.
fixed ratio: Shift_L При удерживании выделять с текущим из заданых фиксированных соотношений сторон.
from center: Control_L При удерживании выделять из центра.
freeze: f Сохранить в процессе выделения его текущее состояние.
guide horizontal: bracketleft ([) Добавить на месте курсора горизонтальную направляющую.
guide vertical: bracketright (]) Добавить на месте курсора вертикальную направляющую.
snap to guides: backslash (\) Прилипать к направляющим при выделении (Ctrl+Shift+\). Также, скрыть / показать вновь направляющие (Shift+\). Также, удалить все направляющие (Ctrl+Alt+Shift+\).
clear: Delete Удалить с экрана текущее выбранное (подсвеченное) выделение (направляющую).
clear last: BackSpace Удалить с экрана последнее сделанное выделение (или направляющую).
clear all: j Удалить с экрана все сохранённые выделения (или направляющие).
copy values: space (пробел) Копировать геометрические значения выделения или направляющей в буфер обмена.
screenshot: s Сделать скриншот выделенной области (текущего выделения мышью, либо, если нет, активного подсвеченного, сделанного ранее).
segment line: z Показать / скрыть отрезок между началом и концом выделения и угол между этим отрезком и горизонталью.
only mask: question (/, слева от правого шифта) Показать / скрыть все числа и вспомогательные линии выделения при маскировке.

Секция aspect ratio shortcuts: набор фиксированных соотношений сторон выделения и горячие клавиши переключения между ними

Можно добавлять, удалять и менять строки соотношений.

1: q Равные стороны (квадрат).
4/3: w Стандартное соотношение старых мониторов (800 × 600, 1024 × 768, 1280 × 960…).
1/0.618: e Соотношение золотого сечения.
3/2: r Стандартное соотношение фотографий.
16/9: t Стандартное соотношение более современных мониторов (1280 × 720, 1366 × 768, 1920 × 1080…).
297/210: y Соотношение бумажного формата ISO 216 (A4, A3 и т.д.).

Секция selection guides: наборы вспомогательных линий

Можно добавлять, удалять и менять наборы вспомогательных линий. Ключами наборов являются горячие клавиши, по которым данный набор показывается / скрывается. Значениями — объекты: x — массив координат вертикальных линий, y — массив координат горизонтальных линий, show — булево значение: показывать или нет при старте.

x: {x: [0.5], y: [0.5], show: 1} Линии по центру.
c: {x: [0.38197, 0.61803], y: [0.38197, 0.61803], show: 0} Золотое сечение.
v: {x: [0.33333, 0.66667], y: [0.33333, 0.66667], show: 0} Правило третей.
b: {x: [0.2, 0.4, 0.6, 0.8], y: [0.2, 0.4, 0.6, 0.8], show: 0} Правило пятых долей.

Секция colors shortcuts: горячие клавши переключения между заданными цветовыми схемами

Можно добавлять, удалять и менять строки схем, но они должны также присутствовать в секции colors под соответствующими именами.

default: 1 Стандартная полупрозрачная серо-синеватая схема.
dark: 2 Абсолютно чёрная схема.
light: 3 Абсолютно белая схема.

Секция colors: цветовые схемы

В принципе, в конфигурационном файле по умолчанию всё очевидно. Секция colors содержит произвольное количество подсекций цветовых схем. Но чтобы они включались по горячим клавишам, их имена должны в точности совпадать с соответствующими в секции colors shortcuts. Обязательно должны присутствовать схемы default (схема по умолчанию при запуске) и highlight (цвета активного подсвеченного выделения в режиме сохранения выделений; в секции colors shortcuts для неё нет назначенной горячей клавиши, поскольку это бессмысленно, но при желании можете и добавить). Остальные можно добавлять и удалять по желанию. Каждая подсекция цветовой схемы в свою очередь должна содержать следующие подсекции:

main: Цвет отрезка между началом и концом выделения.
basic: Основной цвет: курсора, прямоугольника выделения, вспомогательных линий.
guide: Цвет направляющих.
text main: Цвет текста значений длины отрезка и конечных (текущих) координат.
text basic: Цвет текста значений ширины и высоты выделения и угла между отрезком, соединяющим начало и конец выделения, и горизонталью.
text faded: Цвет текста значения начальных координат выделения.

Эти цвета определяются, в свою очередь, четырьмя значениями RGBA в виде десятичных дробей (от 0 до 1): r (красная составляющая), g (зелёная составляющая), b (синяя составляющая), a (прозрачность цвета).

Значения горячих клавиш представляют собой X11 keysyms (без префикса XK_). Список можно посмотреть у себя в /usr/include/X11/keysymdef.h или, например, здесь. Может быть, позже реализую более дружественный синтаксис.

Не применяйте для отступов табуляции! Формат YAML описывает структуру данных проблами.