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