User Commands

ИМЯ

icewmbg - управляет изображениями фона рабочего стола IceWM.

СИНОПСИС

icewmbg [OPTIONS] [ARGUMENTS]

ОПИСАНИЕ

icewmbg назначает цвет или изображение фону рабочего стола X11. Поддерживаются распространённые форматы изображений. Каждое рабочее место icewm может иметь своё фоновое изображение.

Когда фоновое изображение изменяется, icewmbg может быть уведомлено об обновлении изображения фона. Когда происходит переключение рабочих мест, оно проверяет время изменения файла изображения. Если время изменилось, оно перезагружает изображение.

icewmbg поддерживает полупрозрачность. Полупрозрачное фоновое изображение и цвета могут быть настроены.

Оно использует RandR или Xinerama для поддержки фоновых изображений на всех подключенных мониторах. Когда мониторы появляются/исчезают, или меняют свои разрешения, icewm это отрегулирует. Оно поддерживает параметры для одного большого фонового изображения на всех мониторах.

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

icewmbg автоматически запускается из icewm-session(1). Если там просто единственный фон для всех рабочих мест, icewmbg может сделать вывод, что оно может безопасно завершиться после настройки фона рабочего стола для освобождения его системной памяти. Если размер экрана изменится, тогда icewm попытается перезапустить icewmbg, предпочтительно через icewm-session.

ПАРАМЕТРЫ И АРГУМЕНТЫ

СПЕЦИФИЧЕСКИЕ ПАРАМЕТРЫ

Когда множество значений задано для изображений или цветов, они разделяются двоеточиями. Каждое действительное значение может быть заключено в двойные кавычки. Если FILE является каталогом, все изображения из этого каталога будут использованы в порядке сортировки. Если значение начинается с восклицательного знака, как в !FILE, изображения из каталога FILE перемешиваются случайным образом. Имена файлов изображений или имена каталогов могут иметь символы шаблонов glob(7), или они могут начинаться с тильды или переменной окружения.

-f, --fork

Передаёт параметры фону и отсоединяет процесс от терминала.

-p, --replace

Замещает существующее icewmbg. Если в данный момент работает icewmbg, оно завершается. Новое icewmbg поднимается заново.

-q, --quit

Приказывает работающему icewmbg прекратить работу. Этот параметр использует icewm-session при остановке icewm(1).

-r, --restart

Приказывает работающему icewmbg самостоятельно перезапуститься. Это полезно при изменении настроек. Если нет активного icewmbg, оно стартует.

-u, --shuffle

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

-c, --config=FILE

Загрузить предустановки из FILE.

-t, --theme=THEME

Использовать тему под названием THEME.

-i, --image=FILE[,FILE]*

Загрузить фоновые изображения из каждого FILE. Это отменяет настойку DesktopBackgroundImage. Когда задано более одного изображения, они назначаются каждому рабочему месту в заданном порядке.

-k, --color=COLOR[,COLOR]*

Использовать цвета фона из каждого COLOR. Это отменяет настройку DesktopBackgroundColor.

-s, --semis=FILE[,FILE]*

Загрузить прозрачные изображения из каждого FILE. Это отменяет настройку DesktopTransparencyImage.

-x, --trans=NAME[,NAME]

Использовать прозрачные цвета из каждого NAME. Это отменяет настройку DesktopTransparencyColor.

-e, --center={0|1}

Выключить/Включить центрирование фонового изображения. Это отменяет настройку DesktopBackgroundCenter.

-a, --scaled={0|1}

Выключить/Включить масштабирование фонового изображения. Это отменяет настройку DesktopBackgroundScaled.

-m, --multi={0|1}

Выключить или включить единственное фоновое изображение на все мониторы. Это отменяет настройку DesktopBackgroundMultihead.

-y, --cycle=SECONDS

Циклически показывает список фоновых изображений через SECONDS. Это отменяет настройку CycleBackgroundsPeriod.

-o, --output=FILE

Перенаправить весь вывод в FILE. Начальная тильда или переменная окружения раскрываются.

--postpreferences

Напечатать список всех значений предпочтений, которые будет использовать icewmbg.

--verbose

Напечатать журнал действий и некоторых событий.

ОБЩИЕ ПАРАМЕТРЫ

-d, --display=DISPLAY

Использовать DISPLAY для соединения с X сервером. Иначе использовать DISPLAY из окружения.

-h, --help

Кратко напечатать используемые выражения в stdout и выйти.

-V, --version

Напечатать версию программы в stdout и выйти.

-C, --copying

Напечатать права на копирование для программы в stdout и выйти.

--sync

Использовать медленный синхронный режим для связи с сервером X11.

--verbose

Сообщать о некоторых действиях.

ФАЙЛЫ

Дополнительные аргументы, которые или являются путями, или имеют расширения изображений, предполагается, что они являются файлами изображений фона, или каталогами, содержащими их.

ПРЕДПОЧТЕНИЯ

По умолчанию icewmbg загружает настройки из файла preferences icewm(1). См. icewm-prefences(5) для подробностей. Читаются настройки:

  DesktopBackgroundCenter    - Отцентрировать фон рабочего стола
  DesktopBackgroundScaled    - Масштабировать фон рабочего стола
  DesktopBackgroundColor     - Цвет(а) фона рабочего стола
  DesktopBackgroundImage     - Изображение(я) фона рабочего стола
  ShuffleBackgroundImages    - Перемешать список фоновых изображений
  SupportSemitransparency    - Поддержка полупрозрачных терминалов
  DesktopTransparencyColor   - Полупрозрачное(ые) цвет(а) фона рабочего стола
  DesktopTransparencyImage   - Полупрозрачное(ые) изображение(я) фона рабочего
стола
  DesktopBackgroundMultihead - Одно фоновое изображение на все мониторы
  CycleBackgroundsPeriod     - Период смены изображений рабочего стола в
секундах

Если эти настройки установлены в файле preferences, они могут быть перекрыты темой в файле default.theme. Чтобы принудительно выполнить определённые настройки, поставьте их вместо этого в файл prefoverride. См. icewm-prefoverride(5).

РАБОЧИЕ МЕСТА

Каждое рабочее место может иметь уникальное изображение. Определите множество изображений в DesktopBackgroundImage, разделяя запятыми. Или задайте хотя бы один каталог с изображениями. Изображения назначаются каждому рабочему месту в заданном порядке. Когда icewm меняет рабочее место, работающее icewmbg адаптирует фон рабочего стола к назначенному изображению.

Если вы определили больше изображений, чем есть рабочих мест, то CycleBackgroundsPeriod поможет установить период. Когда период истекает, icewmbg переключит на следующий набор изображений. Если вы задали меньше изображений, чем есть рабочих мест, то icewmbg снова использует предыдущие изображения для заполнения рабочих мест.

МАСШТАБИРОВАНИЕ ИЗОБРАЖЕНИЙ

Часто фоновое изображение отличается по ширине или высоте от экрана. Изображение может быть размножено (уложено плиткой), центрировано или масштабировано. Этим управляют DesktopBackgroundCenter и DesktopBackgroundScaled. Что произойдёт при их комбинациях, задано в следующей таблице:

center:0 scaled:0 = Фоновое изображение размножится в двух измерениях.
center:1 scaled:0 = Фоновое изображение центрируется, но не масштабируется.
center:1 scaled:1 = Заполнит одно измерение и сохранит соотношение сторон.
center:0 scaled:1 = Заполнит оба измерения и сохранит соотношение сторон.

ПРИМЕРЫ

# Для четырёх уникальных фоновых изображений рабочего стола
# для четырёх рабочих мест выполните:

icewmbg -f -p -i image0,image1,image2,image3

# Или создайте каталог с четырьмя изображениями и выполните:

icewmbg -f -p -i /path/to/directory

# Изображения должны иметь правильные расширения имён файлов изображений

СИГНАЛЫ

icewmbg поддерживает следующие сигналы:

SIGHUP

icewmbg будет перезапущен.

SIGINT, SIGTERM

icewmbg будет завершён.

SIGUSR1

icewmbg перемешает список фоновых изображений и обновит фоновые изображения на всех рабочих местах.

СМ. ТАКЖЕ

icewm(1), icewm-preferences(5), icewm-prefoverride(5), wmsetbg(1), xsetbg(1), xwallpaper(1).

ОШИБКИ

Пожалуйста, сообщайте об ошибках на https://github.com/bbidulock/icewm/issues.

АВТОР

Brian Bidulock <bidulock@openss7.org>.

См. --copying для получения полной информации об авторских правах и правах на копирование.

ПЕРЕВОД

Перевод данного текста на русский язык, а также поддержка пакета программного обеспечения icewm в ALTLinux Dmitriy Khanzhin <jinn@altlinux.org>.

ЛИЦЕНЗИЯ

IceWM лицензирован под GNU Library General Public License. См. файл COPYING в комплекте поставки или используйте флаг --copying для показа прав на копирование.

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 174:

You forgot a '=back' before '=head2'

Around line 180:

=back without =over

 User Commands