ICESOUND(1) دستورات کاربری ICESOUND(1) نام (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) لطفاً خطاها و مشکلات را در گزارش دهید. نویسندگان (AUTHORS) Brian Bidulock . برای مشاهده متن کامل اعلان حق نشر و مجوزهای تکثیر، گزینه --copying را ببینید. مجوز (LICENSE) مدیر پنجره IceWM تحت مجوز GNU Library General Public License منتشر شده است. برای مشاهده مجوزهای تکثیر، پرونده COPYING را در بسته توزیع بررسی کنید یا از گزینه --copying برای نمایش مجوزها استفاده نمایید. icewm 4.1.0 2026-08-06 ICESOUND(1)