Это старая версия документа.


Основные настройки

-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'

*Разрешить вертикальную синхронизацию OpenGL:

$ compton --vsync opengl