From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- .../docs/tdemultimedia/artsbuilder/tools.docbook | 845 +++++---------------- 1 file changed, 169 insertions(+), 676 deletions(-) (limited to 'tde-i18n-ru/docs/tdemultimedia/artsbuilder/tools.docbook') diff --git a/tde-i18n-ru/docs/tdemultimedia/artsbuilder/tools.docbook b/tde-i18n-ru/docs/tdemultimedia/artsbuilder/tools.docbook index 2cdda978057..51639f6e0ff 100644 --- a/tde-i18n-ru/docs/tdemultimedia/artsbuilder/tools.docbook +++ b/tde-i18n-ru/docs/tdemultimedia/artsbuilder/tools.docbook @@ -6,531 +6,245 @@ To validate or process this file as a standalone document, uncomment this prolog. Be sure to comment it out again when you are done --> -Инструменты &arts; +Инструменты &arts; -Это набор управляющих &arts; модулей. Чтобы пользоваться &arts; эффективно, нужно уметь ими пользоваться. В этом разделе описывается каждый из модулей и параметры их команд. +Это набор управляющих &arts; модулей. Чтобы пользоваться &arts; эффективно, нужно уметь ими пользоваться. В этом разделе описывается каждый из модулей и параметры их команд. -&kcontrol; - -Если &arts; запущен в &kde;, &kcontrolcenter; размещает его настройками в категории Звук. Вы можете связать звуки с различными событиями менеджера окон и &kde; в категории ЗвукСистемные оповещения. О настройках панели управления читайте в справочнике по &kcontrol;. +&kcontrol; + +Если &arts; запущен в &kde;, &kcontrolcenter; размещает его настройками в категории Звук. Вы можете связать звуки с различными событиями менеджера окон и &kde; в категории ЗвукСистемные оповещения. О настройках панели управления читайте в справочнике по &kcontrol;. -&artsd; +&artsd; -&artsd; управляет доступом к звуковому оборудованию, это один из сервисов &arts;. Он позволяет разным приложениям одновременно посылать запросы серверу, где они будут накладываться друг на друга и воспроизводиться. Без единого звукового сервера одно приложение, использующее звуковое устройство, будет блокировать запросы остальных. +&artsd; управляет доступом к звуковому оборудованию, это один из сервисов &arts;. Он позволяет разным приложениям одновременно посылать запросы серверу, где они будут накладываться друг на друга и воспроизводиться. Без единого звукового сервера одно приложение, использующее звуковое устройство, будет блокировать запросы остальных. -Для работы &arts; нужно, чтобы была запущена только одна копия модуля &artsd;. Если это указано в панели &kcontrol; Звуковая подсистема, &artsd; будет запускаться автоматически при входе в систему. +Для работы &arts; нужно, чтобы была запущена только одна копия модуля &artsd;. Если это указано в панели &kcontrol; Звуковая подсистема, &artsd; будет запускаться автоматически при входе в систему. -Аргументами программы могут быть: +Аргументами программы могут быть: -artsd - - - - -Задайте используемую частоту дискретизации. - - - - - - -Справка по использованию команды. - - - - - - -Использовать работу в сети. - - - - - +artsd + + + + +Задайте используемую частоту дискретизации. + + + + + + +Справка по использованию команды. + + + + + + +Использовать работу в сети. + + + + + -Задать TCP порт (подразумевает указание и ). +Задать TCP порт (подразумевает указание и ). - + -Открытый доступ без аутентификации (опасно). +Открытый доступ без аутентификации (опасно). - + -Включить режим двустороннего ввода-вывода. +Включить режим двустороннего ввода-вывода. - + -Укажите аудиоустройство (обычно /dev/dsp). +Укажите аудиоустройство (обычно /dev/dsp). - + -Установите количество блоков. +Установите количество блоков. - + -Установите размер блока в байтах. +Установите размер блока в байтах. - + -Установите время отключения сервера при бездействии в секундах. Значение ноль отменяет автоматическое отключение. +Установите время отключения сервера при бездействии в секундах. Значение ноль отменяет автоматическое отключение. - + -Укажите имя приложения, которое будет использоваться для сообщений об ошибках, предостережениях и отображения информации. Если вы используете KDE, это может делать artsmessage. +Укажите имя приложения, которое будет использоваться для сообщений об ошибках, предостережениях и отображения информации. Если вы используете KDE, это может делать artsmessage. - + -Увеличивает размер сетевого буфера до значения, подходящего при использовании локальной сети 10 мбит/. То же самое, что и параметр -w 5 (смотрите ниже). +Увеличивает размер сетевого буфера до значения, подходящего при использовании локальной сети 10 мбит/. То же самое, что и параметр -w 5 (смотрите ниже). - + -При использовании artsd в сети обычно стоит использовать сетевой буфер большего размера, чтобы избежать пропадания звука. ARts предоставляет минимальный буфер для приложений. Без указания данного параметра за минимальный размер буфера берется размер блока, умноженный на число блоков (см. выше). Данный же параметр позволяет увеличить стандартный размер с коэффициентом число. +При использовании artsd в сети обычно стоит использовать сетевой буфер большего размера, чтобы избежать пропадания звука. ARts предоставляет минимальный буфер для приложений. Без указания данного параметра за минимальный размер буфера берется размер блока, умноженный на число блоков (см. выше). Данный же параметр позволяет увеличить стандартный размер с коэффициентом число. - + -Установите уровень вывода служебной информации: - 3 (нет), 2 (предупреждения), 1 (информация), 0 (отладка). +Установите уровень вывода служебной информации: - 3 (нет), 2 (предупреждения), 1 (информация), 0 (отладка). - + -Показать версию. +Показать версию. -В большинстве случаев достаточно просто запустить &artsd;. +В большинстве случаев достаточно просто запустить &artsd;. -&artswrapper; - -Чтобы добиться хорошего времени отклика, &artsd; запускается как процесс реального времени (на тех платформах, где это возможно). Для этого требуются права пользователя root, поэтому, чтобы снизить риски, связанные с безопасностью, &artsd; можно запускать с помощью небольшой программы &artswrapper;, которая, будучи запущенной от root, получает приоритет выполнения в реальном времени и запускает &artsd; от непривелигированного пользователя (не root). - -Если для этой небольшой программы вы сделаете UID root, вероятнее всего, качество воспроизведения будет улучшено, так как должны исчезнуть задержки при воспроизведении. Однако при этом увеличивается риск того, что ошибка в программе или недобросовестный пользователь могут нарушить работу всей системы или как-то иначе повредить ее работе. Кроме того, на машине, которой пользуются несколько человек одновременно, приоритет реального времени для сервера может помещать пользователям, которые занимаются какой-то серьезной работой. +&artswrapper; + +Чтобы добиться хорошего времени отклика, &artsd; запускается как процесс реального времени (на тех платформах, где это возможно). Для этого требуются права пользователя root, поэтому, чтобы снизить риски, связанные с безопасностью, &artsd; можно запускать с помощью небольшой программы &artswrapper;, которая, будучи запущенной от root, получает приоритет выполнения в реальном времени и запускает &artsd; от непривелигированного пользователя (не root). + +Если для этой небольшой программы вы сделаете UID root, вероятнее всего, качество воспроизведения будет улучшено, так как должны исчезнуть задержки при воспроизведении. Однако при этом увеличивается риск того, что ошибка в программе или недобросовестный пользователь могут нарушить работу всей системы или как-то иначе повредить ее работе. Кроме того, на машине, которой пользуются несколько человек одновременно, приоритет реального времени для сервера может помещать пользователям, которые занимаются какой-то серьезной работой. -&artsshell; +&artsshell; -&artsshell; выполняет различные функции, связанные со звуковым сервером. Мы предполагаем дополнить модуль новыми командами в будущем (об этом смотрите в комментариях кода). +&artsshell; выполняет различные функции, связанные со звуковым сервером. Мы предполагаем дополнить модуль новыми командами в будущем (об этом смотрите в комментариях кода). -Формат команды: +Формат команды: -artsshell suspendstatus terminate autosuspend secs networkbuffers n volume [volume] stereoeffect options - -artsshell [параметры] команда [параметры команды] - -Поддерживаются следущие параметры: +artsshell suspendstatus terminate autosuspend secs networkbuffers n volume [volume] stereoeffect options + +artsshell [параметры] команда [параметры команды] + +Поддерживаются следущие параметры: - + -Подавлять весь вывод. +Подавлять весь вывод. - + -Справка по использованию команды. +Справка по использованию команды. -Поддерживаются следущие команды: +Поддерживаются следущие команды: - + -Отключить звуковой сервер. +Отключить звуковой сервер. - + -Показать информацию о состоянии сервера. +Показать информацию о состоянии сервера. - + -Отключить звуковой сервер. Если какие-то приложения его используют, они сообщат об ошибках. +Отключить звуковой сервер. Если какие-то приложения его используют, они сообщат об ошибках. - секунды + секунды -Установите время ожидания в секундах. Если звуковой сервер будет бездействовать это количество времени, он отключится. Значение ноль отменяет автоотключение. +Установите время ожидания в секундах. Если звуковой сервер будет бездействовать это количество времени, он отключится. Значение ноль отменяет автоотключение. - число + число -Размер сетевых буферов вычисляется как стандартный размер буфера по умолчанию, умноженный на число. +Размер сетевых буферов вычисляется как стандартный размер буфера по умолчанию, умноженный на число. - [громкость] + [громкость] -Установите громкость аудио вывода звуковым сервером. Аргумент громкость - это число с плавающей точкой. Если команда будет без парамеров, отобразится текущий уровень громкости. +Установите громкость аудио вывода звуковым сервером. Аргумент громкость - это число с плавающей точкой. Если команда будет без парамеров, отобразится текущий уровень громкости. - + -Список всех модулей стереоэффектов. +Список всех модулей стереоэффектов. - название + название -Помещает стререоэффект в стек и возвращает идентификатор, с помощью которого можно будет извлечь этот эффект. Эффект может быть помещён в начало или конец стека. +Помещает стререоэффект в стек и возвращает идентификатор, с помощью которого можно будет извлечь этот эффект. Эффект может быть помещён в начало или конец стека. - идентификатор + идентификатор -Извлекает стереоэффект с указанным идентификатором из стека. +Извлекает стереоэффект с указанным идентификатором из стека. @@ -539,210 +253,105 @@ this prolog. Be sure to comment it out again when you are done --> -<application ->artsplay</application -> - -artsplay проигрывает звуковые файлы. У команды может быть только один аргумент - имя файла, который посылается звуковому серверу. Типом этого файла может быть wav, au или другой распространённый. Этот модуль полезен для тестирования активности звукового сервера. Запустив две команды параллельно или через малый промежуток времени, вы увидите, как звуковой сервер накладывает несколько сигналов друг на друга. +<application>artsplay</application> + +artsplay проигрывает звуковые файлы. У команды может быть только один аргумент - имя файла, который посылается звуковому серверу. Типом этого файла может быть wav, au или другой распространённый. Этот модуль полезен для тестирования активности звукового сервера. Запустив две команды параллельно или через малый промежуток времени, вы увидите, как звуковой сервер накладывает несколько сигналов друг на друга. -<application ->artsdsp</application -> +<application>artsdsp</application> -Звуковой сервер поддерживает только совместимые с &arts; приложения. Многие приложения пытаются обратиться к звуковой карте напрямую, тогда команда &artsdsp; позволяет, не внося в них исправления, работать с &arts;. +Звуковой сервер поддерживает только совместимые с &arts; приложения. Многие приложения пытаются обратиться к звуковой карте напрямую, тогда команда &artsdsp; позволяет, не внося в них исправления, работать с &arts;. -Если приложение запущено под &artsdsp;, все его попытки обратиться к устройству /dev/dsp перехватываются и преобразовываются в вызовы &arts; API. Поскольку эмуляция устройства несовершенна, большинство приложений работает, хотя и замечается увеличение задержки и снижается быстродействие. +Если приложение запущено под &artsdsp;, все его попытки обратиться к устройству /dev/dsp перехватываются и преобразовываются в вызовы &arts; API. Поскольку эмуляция устройства несовершенна, большинство приложений работает, хотя и замечается увеличение задержки и снижается быстродействие. -Формат команды &artsdsp;: +Формат команды &artsdsp;: -artsdsp [параметры] аргументы приложения +artsdsp [параметры] аргументы приложения -Возможны следущие параметры: +Возможны следущие параметры: -, +, -Вызов краткой справки. +Вызов краткой справки. - = имя + = имя -Испульзуйте имя для определения проигрывателя artsd. +Испульзуйте имя для определения проигрывателя artsd. - + -Эмулировать отображение в память (например, для Quake). +Эмулировать отображение в память (например, для Quake). - + -Вывести параметры. +Вывести параметры. -Пример вызова: +Пример вызова: -artsdsp realplay song.mp3 +artsdsp realplay song.mp3 -Некоторые приложения работают лучше, если задан параметр . Конечно, эмулируются не все характеристики устройства, но большинство работает. Если вы обнаружили неработающее приложение, отправьте подробный отчёт об ошибке, чтобы разработчики смогли это исправить. Не забывайте о встроенной поддержке &arts;. Если ваше любимое приложение не поддерживается, попросите разработчиков его добавить. +Некоторые приложения работают лучше, если задан параметр . Конечно, эмулируются не все характеристики устройства, но большинство работает. Если вы обнаружили неработающее приложение, отправьте подробный отчёт об ошибке, чтобы разработчики смогли это исправить. Не забывайте о встроенной поддержке &arts;. Если ваше любимое приложение не поддерживается, попросите разработчиков его добавить. -<application ->artscat</application -> +<application>artscat</application> -Это простой модуль, отправляющий необработанные данные звуковому серверу. Вам необходимо только указать формат данных (частоту дискретизации, размер сэмплов и количество каналов). Вы, скорее всего, не будете его часто использовать, но он удобен для тестирования. Синтаксис команды: +Это простой модуль, отправляющий необработанные данные звуковому серверу. Вам необходимо только указать формат данных (частоту дискретизации, размер сэмплов и количество каналов). Вы, скорее всего, не будете его часто использовать, но он удобен для тестирования. Синтаксис команды: -artscat [ параметры ] [ имя файла ] +artscat [ параметры ] [ имя файла ] -Если имя файла не указано, чтение идёт из потока стандартного ввода. Поддерживаются следущие параметры: +Если имя файла не указано, чтение идёт из потока стандартного ввода. Поддерживаются следущие параметры: - частота дискретизации + частота дискретизации -Установите частоту дискретизации. +Установите частоту дискретизации. - биты + биты -Установите размер сэмпла (8 или 16). +Установите размер сэмпла (8 или 16). - каналы + каналы -Установите количество каналов (1 или 2). +Установите количество каналов (1 или 2). - + -Показать использование команды и выйти. +Показать использование команды и выйти. @@ -750,79 +359,51 @@ this prolog. Be sure to comment it out again when you are done --> -&artscontrol; +&artscontrol; -Графический модуль для выполнения задач, связанных со звуковым сервером. По умолчанию отображаются два индикатора уровня громкости и ползунок для регулировки громкости. В меню Вид вы можете выбрать и другие функции: +Графический модуль для выполнения задач, связанных со звуковым сервером. По умолчанию отображаются два индикатора уровня громкости и ползунок для регулировки громкости. В меню Вид вы можете выбрать и другие функции: -Показать область БПФ +Показать область БПФ -Открывает окно с анализатором спектра в реальном времени. +Открывает окно с анализатором спектра в реальном времени. -Показать менеджера аудио +Показать менеджера аудио -Показывает активные источники звука и позволяет подключить их к любой доступной шине. +Показывает активные источники звука и позволяет подключить их к любой доступной шине. -Показать состояние aRts +Показать состояние aRts -С помощью этого модуля вы будете знать, активен ли сервер и обладает ли он приоритетом работы в реальном времени. Он также показывает, сколько времени осталось для автоматического отключения сервера, и позволяет вам немедленно его отключить вручную. +С помощью этого модуля вы будете знать, активен ли сервер и обладает ли он приоритетом работы в реальном времени. Он также показывает, сколько времени осталось для автоматического отключения сервера, и позволяет вам немедленно его отключить вручную. -Показать midi-менеджера +Показать midi-менеджера -Отображает активные входы и выходы &MIDI; и позволяет их подключать друг к другу. +Отображает активные входы и выходы &MIDI; и позволяет их подключать друг к другу. -FreeVerb +FreeVerb -Подключает эффект эха к стеку &arts; и позволяет вам графически изменять параметры эффекта. +Подключает эффект эха к стеку &arts; и позволяет вам графически изменять параметры эффекта. -Указатель громкости в цифровом виде +Указатель громкости в цифровом виде -Показывает индикаторы громкости в главном окне в форме цветных индикаторов вместо строк состояния. +Показывает индикаторы громкости в главном окне в форме цветных индикаторов вместо строк состояния. @@ -831,172 +412,84 @@ this prolog. Be sure to comment it out again when you are done --> -<application ->artsc-config</application -> +<application>artsc-config</application> -Этот модуль поможет разработчикам в использовании &arts; C API. Он выбирает подходящие параметры компилятора и компоновщика при компиляции и компоновке кода с помощью &arts;. Желательно его использовать в сборочных файлах для обеспечения переносимости. Допустимы три параметра: +Этот модуль поможет разработчикам в использовании &arts; C API. Он выбирает подходящие параметры компилятора и компоновщика при компиляции и компоновке кода с помощью &arts;. Желательно его использовать в сборочных файлах для обеспечения переносимости. Допустимы три параметра: - + -Показывает необходимые компилятору флаги при использовании &arts; C API. +Показывает необходимые компилятору флаги при использовании &arts; C API. - + -Показывает необходимые компоновщику флаги при компоновке с использованием &arts; C API. +Показывает необходимые компоновщику флаги при компоновке с использованием &arts; C API. ---version +--version -Показывает версию artsc-config. +Показывает версию artsc-config. -Пример вывода команды: - -% artsc-config --I/usr/local/kde2/include/artsc -% artsc-config --L/usr/local/kde2/lib -ldl -lartsc -DPIC -fPIC -lpthread -% artsc-config -0.9.5 +Пример вывода команды: + +% artsc-config +-I/usr/local/kde2/include/artsc +% artsc-config +-L/usr/local/kde2/lib -ldl -lartsc -DPIC -fPIC -lpthread +% artsc-config +0.9.5 -Вы можете использовать этот модуль в сборочном файле по такому правилу: +Вы можете использовать этот модуль в сборочном файле по такому правилу: -artsc: artsc.c +artsc: artsc.c gcc `artsc-config --cflags` -o artsc artsc.c `artsc-config --libs` -&mcopidl; +&mcopidl; -&mcopidl; - это компилятор &IDL;-файлов для &MCOP;, (Multimedia Communication Protocol, протокол связи мультимедиа-модулей), использующийся в &arts;. Интерфейсы &arts; описаны в &IDL; (Interface Definition Language, язык определения интерфейса). Модуль &mcopidl; считает файл &IDL; входом и генерирует заголовочный и исходный файлы C++ для создания класса интерфейса. Синтаксис команды: +&mcopidl; - это компилятор &IDL;-файлов для &MCOP;, (Multimedia Communication Protocol, протокол связи мультимедиа-модулей), использующийся в &arts;. Интерфейсы &arts; описаны в &IDL; (Interface Definition Language, язык определения интерфейса). Модуль &mcopidl; считает файл &IDL; входом и генерирует заголовочный и исходный файлы C++ для создания класса интерфейса. Синтаксис команды: -mcopidl [ параметры ] имя файла +mcopidl [ параметры ] имя файла -Допустимые параметры: +Допустимые параметры: - каталог + каталог -Поиск в каталоге каталог включаемых файлов (include). +Поиск в каталоге каталог включаемых файлов (include). - имя + имя -Исключает структуру, интерфейс или перечисляемый тип с именем имя во время генерации кода. +Исключает структуру, интерфейс или перечисляемый тип с именем имя во время генерации кода. - + -Создайте также файлы .mcoptype/.mcopclass, содержащие информацию о типах для файла &IDL;. +Создайте также файлы .mcoptype/.mcopclass, содержащие информацию о типах для файла &IDL;. -Болееподробно &MCOP; и &IDL; рассматриваются в разделе Интерфейсы и &IDL;. +Болееподробно &MCOP; и &IDL; рассматриваются в разделе Интерфейсы и &IDL;. -- cgit v1.2.1