Содержание
Основные настройки
-d ДИСПЛЕЙ
Дисплей, которым нужно управлять.
-r РАДИУС
Радиус размытия теней в пикселях (по умолчанию 12)
-o НЕПРОЗРАЧНОСТЬ
Непрозрачность теней (0.0 - 1.0, по умолчанию 0.75)
-l СМЕЩЕНИЕ
Смещение тени слева, в пикселях (по умолчанию -15)
-t СМЕЩЕНИЕ
Смещение тени сверху, в пикселях (по умолчанию -15)
-I ШАГ_НЕПРОЗРАЧНОСТИ
Изменение непрозрачности между шагами проявления (0.01 - 1.0, по умолчанию 0.028)
-O ШАГ_НЕПРОЗРАЧНОСТИ
Изменение непрозрачности между шагами затухания (0.01 - 1.0, по умолчанию 0.03)
-D МИЛЛИСЕКУНДЫ
Время между шагами затухания или проявления, в мс (> 0, по умолчанию 10)
-m НЕПРОЗРАЧНОСТЬ
Непрозрачность по умолчанию для выпадающих и всплывающих меню (0.0 - 1.0, по умолчанию 1.0)
-c
Включить тени на окнах. Примечание: окно рабочего стола (окно с параметром _NET_WM_WINDOW_TYPE_DESKTOP) никогда не отбрасывает тень
-C
Исключает отрисовку теней на доках/панелях
-z
Очищает маску тени позади окна. Примечание: это может работать некорректно на ARGB окнах с полностью прозрачными областями.
-f
Плавное проявление/затухание окон при открытии/закрытии и при смене непрозрачности, при условии что –no-fading-openclose не используется.
-F
Приравнивается к -f. Использовать не рекомендуется
-i НЕПРОЗРАЧНОСТЬ
Непрозрачность неактивных окон. (0.1 - 1.0, по умолчанию отключено)
-e НЕПРОЗРАЧНОСТЬ
Непрозрачность строки заголовка и границ окна. (0.1 - 1.0, по умолчанию отключено)
-G
Не отрисовывать тени на перетаскиваемых окнах
-b
Превратить процесс в демон. Склонировать в фоновый режим после инициализации.
-S
Включить синхронные операции Х (для отладки).
--config ПУТЬ
Указать путь файла настроек. См. раздел КОНФИГУРАЦИОННЫЕ ФАЙЛЫ ниже, чтобы узнать где по умолчнию лежат конфиги compton'а
--shadow-red ЗНАЧЕНИЕ
Значение красного цвета тени (0.0 - 1.0, по умолчанию 0).
--shadow-green ЗНАЧЕНИЕ
Значение зеленого цвета тени (0.0 - 1.0, по умолчанию 0).
--shadow-blue ЗНАЧЕНИЕ
Значение синего цвета тени (0.0 - 1.0, по умолчанию 0).
--inactive-opacity-override
Позволяет непрозрачности неактивных окон, заданной параметром -i перекрывать значение окон с параметром _NET_WM_OPACITY.
--inactive-dim value
Затемняет неактивные окна (0.0 - 1.0, по умолчанию 0.0)
--mark-wmwin-focused
Определяет окна оконного менеджера и обозначает их активными
--no-fading-openclose
Отключить плавное проявление/затухание окнон при открытии/закрытии
--shadow-ignore-shaped
Не рисовать тени на фигурных окнах. Примечание: в данном контексте фигурные окна означают окна, форма которых задается при помощи расширения X Shape. Окна, использующие фон в формате ARGB не контролируются этим параметром.
--detect-rounded-corners
Определяет окна со скругленными углами и исключает их из фигурных окон. К сожалению, точность этого параметра не высока
--detect-client-opacity
Определяет параметр _NET_WM_OPACITY окна. Полезно для оконных менеджеров не передающих параметр _NET_WM_OPACITY для обрамления окон
--refresh-rate ЧАСТОТА_ОБНОВЛЕНИЯ
Задает частоту обновления экрана. Если параметр не задан или задан 0, compton будет определять его как расширение X RandR
--vsync МЕТОД_VSYNC
Устанавливает метод VSync. На данный момент доступно 2 метода:
- none: без вертикальной синхронизации
- drm: VSync с параметром DRM_IOCTL_WAIT_VBLANK. Может работать только на некоторых драйверах. Экспериментально
- opengl: Синхронизировать VSync с расширением OpenGL SGI_swap_control. Работает только на некоторых драйверах. Экспериментально
(Примечания: некоторые методы VSync могут не работать во время компиляции)
--alpha-step ЗНАЧЕНИЕ
Шаг для ранее сгенерированных альфа изображений (0.01 - 1.0, по умолчанию 0.03)
--dbe
Включает режим заливки DBE, предполагается использование с VSync для устранения разрывов. Пока что сообщений о работающем эффекте не было
--paint-on-overlay
Отрисовка на оверлейных окнах X Composite вместо окна рута
--sw-opti
Ограничение количества отрисовок: не больше 1(частота обновления) в секунду. Используется для повышения производительности. Экспериментально. Не должно использоваться с –vsync, поскольку –vsync фактически делает то же самое, разве что вы хотите установить частоту обновления ниже текущего значения.
--use-ewmh-active-win
Использовать EWMH_NET_ACTIVE_WINDOW чтобы определить текущее окно в фокусе, вместо прослушивания события FocusIn/FocusOut. Будет более точным, если поддерживается оконным менеджером. Экспериментально.
--unredir-if-possible
Отменяет перенаправление всех окон, если обнаружены непрозрачные окна в полноэкранном режиме, для достижения максимальной производительности для полноэкранного окна. Может вызывать мерцание. –paint-on-overlay может сделать мерцание менее заметным. Экспериментально.
--shadow-exclude УСЛОВИЕ
Указывает перечень состояний окна, при которых окно не должно отбрасывать тень.
--focus-exclude УСЛОВИЕ
Указывает перечень состояний окна, при которых окно должно считаться в фокусе.
--inactive-dim-fixed
Использовать фиксированное значение неактивного затемнения, вместо коррекции в соответствии с прозрачностью окна.
--detect-transient
Использовать WM_TRANSIENT_FOR чтобы сгруппировать окна, и рассматривать группу как одно целое.
--detect-client-leader
Использовать WM_CLIENT_LEADER чтобы сгруппировать окна, и рассматривать группу как одно целое. WM_TRANSIENT_FOR имеет более высокий приоритет при условии, что –detect-transientis включен.
--blur-background
Размытие фона в полупрозрачных/ARGB окнах. В зависимости от драйвера, может ухудшить производительность. Имя переключающего параметра может быть изменено без предварительного уведомления.
--blur-background-frame
Размытие фона окна, когда оконная рама не является прозрачной. Подразумевает –blur-background. В зависимости от драйвера, может ухудшить производительность. Название может измениться.
--blur-background-fixed
Использовать фиксированную силу размытости, а не коррекцию в соответствии с непрозрачностью окна.
Формат условий
--shadow-exclude и --focus-exclude
заносит строку состояния в черный список определенных окон. Формат состояние строки:
condition = TARGET:TYPE[FLAGS]:PATTERN
TARGET может принимать одно из значений: «n» (имя окна), «i» (конкретный класс окна), «g» (общий класс окна), и «r» (функции окна).
TYPE может принимать одно из значений: «e» (точное совпадение), «a» (любое совпадение), «s» (совпадение сначала), «w» (шаблон), и «p» (регулярное выражение PCRE, если скомпилировано с поддержкой).
FLAGS может быть набором параметров. На данный момент единственным установленным параметром является «i» (игнорировать регистр).
PATTERN фактически является строкой шаблона.
Файлы конфигурации
Комптон может брать информацию из файла настроек если скомпилирована поддержка libconfig. Если –config не используется, комптон будет искать конфигурационный файл в $XDG_CONFIG_HOME/compton.conf (обычно ~/.config/compton.conf), затем в ~/.compton.conf, и в последнюю очередь в compton.conf в $XDG_DATA_DIRS (чаще всего в /etc/xdg/compton.conf). Большинство параметров из командной строки могут заменены на опцию в конфигурационном файле и некоторые опции доступны только в кофигурациооных файлах (на данный момент - некоторые настройки окон). Комптон использует общий формат конфигурационных файлов libconfig. Пример конфигурационного файла - compton.sample.conf - доступен в исходниках.
Уведомления
* Комптон реинициализируется после получения SIGUSR1.
Примеры
- Отключение обработки конфигурационного файла:
$ compton --config /dev/null
- Запустить комптон с включенными тенями и плавным затуханием, отключить тени на окнах доков и drag-and-drop окнах:
$ compton -cCGf
- То же самое, что и выше, плюс 80% прозрачности для неактивных окон и рамок окна, отключение плавного затухания/проявления при открытии/закрытии окон, разрешить программную оптимизацию и запустить в фоновом режиме:
$ compton -bcCGf -i 0.8 -e 0.8 --no-fading-openclose --sw-opti
- Белые тени:
$ compton -c --shadow-red 1 --shadow-green 1 --shadow-blue 1
- Разрешить тени на окнах wbar:
$ compton -c --shadow-exclude 'g:e:wbar'
- Не рисовать тени для приложений в полноэкранном режиме (может быть полезно, например, если у вас при работе программ для захвата экрана, таких как xfce4-screenshooter, затеняется весь экран):
$ compton -c --shadow-exclude fullscreen
- Разрешить вертикальную синхронизацию OpenGL:
$ compton --vsync opengl