نام (NAME)

icesound - پخش فایل‌های صوتی هنگام وقوع رویدادهای گرافیکی در IceWM

خلاصه دستور (SYNOPSIS)

icesound [گزینه‌ها]

توضیحات (DESCRIPTION)

مدیر پنجره icewm(1) در پاسخ به اقدامات جالب مانند باز شدن یا بسته شدن پنجره برنامه‌ها، جابه‌جایی بین فضاهای کاری و غیره، به اصطلاح رویدادهای رابط گرافیکی (GUI events) تولید می‌کند. رویدادهای گرافیکی یکی از ویژگی‌های پنجره ریشه X (یا root window) هستند. icewm(1) هر زمان که یک رویداد گرافیکی جدید رخ می‌دهد این ویژگی را به‌روزرسانی می‌کند. برنامه‌های علاقه‌مند می‌توانند به تغییرات این ویژگی گوش فرا دهند. نزدیک به بیست رویداد گرافیکی مختلف تعریف شده است.

برنامه icesound با پخش فایل‌های صوتی به این رویدادهای گرافیکی پاسخ می‌دهد. این فایل‌های صوتی فایل‌های .wav واقع در یک زیردایرکتوری sounds در یکی از دایرکتوری‌های پیکربندی icewm(1) هستند.

برنامه icesound از چندین رابط صوتی رایج پشتیبانی می‌کند که عبارتند از: ALSA، OSS و libAO. این رابط‌ها باید هنگام پیکربندی فعال شده باشند. ALSA، OSS و libAO همگی نیازمند پشتیبانی از libsndfile هستند که یک کتابخانه بسیار رایج برای خواندن فایل‌های صوتی است.

ALSA: رابط ALSA برنامه‌نویسی نسبتاً پیچیده‌ای دارد و کار می‌کند، اما ممکن است به آزمایش‌های بیشتری نیاز داشته باشد. این رابط در هر زمان حداکثر یک صدا را پخش می‌کند.
LibAO: کتابخانه LibAO یک کتابخانه خروجی صوتی چندسکویی است که پوششی مناسب روی تعداد زیادی از رابط‌های صوتی متداول فراهم می‌کند. این کتابخانه یک فایل پیکربندی ساده دارد که در صفحه راهنمای libao.conf(5) مستند شده است.
OSS: سیستم صوتی باز یا Open Sound System (OSS) یک رابط صوتی چندسکویی است که به‌طور کامل توسط icesound پشتیبانی می‌شود.

هنگامی که چندین رابط صوتی در دسترس باشند، icesound تمام آن‌ها را بررسی می‌کند تا به رابطی که می‌تواند به آن متصل شود برسد و سپس از آن استفاده می‌کند. به‌طور پیش‌فرض، اولویت به این ترتیب است: AO، ALSA، OSS.

گزینه‌ها (OPTIONS)

گزینه‌های اختصاصی (SPECIFIC OPTIONS)

-d, --display=DISPLAY: نمایشگر X11 مورد استفاده توسط icewm(1) (پیش‌فرض: $DISPLAY).
-s, --sample-dir=DIRECTORY: دایرکتوری حاوی فایل‌های صوتی را مشخص می‌کند. مقدار پیش‌فرض عبارت است از: $HOME/.config/icewm/sounds، $HOME/.icewm/sounds، CFGDIR/sounds و LIBDIR/sounds. خروجی "icewm --directories" را ببینید.
-i, --interface={AO|ALSA|OSS}[,{AO|ALSA|OSS}]*: رابط‌های خروجی صوتی را مشخص می‌کند. یک یا چند مورد از: AO، ALSA، OSS که با کاما (",") جدا شده‌اند.
-D, --device=DEVICE: فقط برای سازگاری با نسخه‌های پیشین: دستگاه پیش‌فرض. لطفاً یکی از گزینه‌های -A، -O یا -S را ترجیح دهید.
-O, --oss=DEVICE: دستگاه OSS را مشخص می‌کند (پیش‌فرض: /dev/dsp).
-A, --alsa=DEVICE: دستگاه ALSA را مشخص می‌کند (پیش‌فرض: "default").
-z, --snooze=MILLISECONDS: فاصله زمانی تعویق (snooze) بین رویدادهای صوتی را بر حسب میلی‌ثانیه مشخص می‌کند. پیش‌فرض ۵۰۰ میلی‌ثانیه است.
-p, --play=SOUND: صدای داده‌شده (نام یا شماره) را پخش کرده و خارج می‌شود.
-l, --list-files: مسیرهای فایل‌های صوتی موجود را فهرست کرده و خارج می‌شود.
--list-sounds: نام‌های فایل‌های صوتی پشتیبانی‌شده را فهرست کرده و خارج می‌شود.
--list-interfaces: رابط‌های صوتی پشتیبانی‌شده را فهرست کرده و خارج می‌شود.
-o, --output=FILE: هدایت تمام خروجی‌ها به FILE. علامت مدک ابتدای مسیر یا متغیرهای محیطی بسط داده می‌شوند.
-v, --verbose: حالت پرگو؛ هنگام وقوع رویدادهای صوتی اطلاعاتی را چاپ می‌کند.

گزینه‌های عمومی (GENERAL OPTIONS)

-h, --help: چاپ توضیح مختصری از نحوه استفاده در stdout و خروج.
-V, --version: چاپ نسخه برنامه در stdout و خروج.
-C, --copying: چاپ مجوزهای تکثیر برنامه در stdout و خروج.

وضعیت خروج (EXIT STATUS)

0: موفقیت‌آمیز.
1: خطای عمومی.
2: خطای خط فرمان.
3: خطای زیرسیستم‌ها (مانند عدم امکان اتصال به سرور).

همچنین ببینید (SEE ALSO)

icewm(1), libao.conf(5), padsp(1), aplay(1), alsamixer(1).

گزارش باگ‌ها (BUGS)

لطفاً خطاها و مشکلات را در https://github.com/ice-wm/icewm/issues گزارش دهید.

نویسندگان (AUTHORS)

Brian Bidulock <mailto:bidulock@openss7.org>.

برای مشاهده متن کامل اعلان حق نشر و مجوزهای تکثیر، گزینه --copying را ببینید.

مجوز (LICENSE)

مدیر پنجره IceWM تحت مجوز GNU Library General Public License منتشر شده است. برای مشاهده مجوزهای تکثیر، پرونده COPYING را در بسته توزیع بررسی کنید یا از گزینه --copying برای نمایش مجوزها استفاده نمایید.