.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "ICESOUND 1" .TH ICESOUND 1 2026-08-06 "icewm\ 4.1.0" "دستورات کاربری" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" .IX Header "NAME" icesound \- پخش فایل‌های صوتی هنگام وقوع رویدادهای گرافیکی در IceWM .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBicesound\fR [\fIگزینه‌ها\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" مدیر پنجره \&\fBicewm\fR\|(1) در پاسخ به اقدامات جالب مانند باز شدن یا بسته شدن پنجره برنامه‌ها، جابه‌جایی بین فضاهای کاری و غیره، به اصطلاح رویدادهای رابط گرافیکی (GUI events) تولید می‌کند. رویدادهای گرافیکی یکی از ویژگی‌های پنجره ریشه X (یا root window) هستند. \&\fBicewm\fR\|(1) هر زمان که یک رویداد گرافیکی جدید رخ می‌دهد این ویژگی را به‌روزرسانی می‌کند. برنامه‌های علاقه‌مند می‌توانند به تغییرات این ویژگی گوش فرا دهند. نزدیک به بیست رویداد گرافیکی مختلف تعریف شده است. .PP برنامه \&\fBicesound\fR با پخش فایل‌های صوتی به این رویدادهای گرافیکی پاسخ می‌دهد. این فایل‌های صوتی فایل‌های \fI.wav\fR واقع در یک زیردایرکتوری \fIsounds\fR در یکی از دایرکتوری‌های پیکربندی \fBicewm\fR\|(1) هستند. .PP برنامه \&\fBicesound\fR از چندین رابط صوتی رایج پشتیبانی می‌کند که عبارتند از: ALSA، OSS و libAO. این رابط‌ها باید هنگام پیکربندی فعال شده باشند. ALSA، OSS و libAO همگی نیازمند پشتیبانی از libsndfile هستند که یک کتابخانه بسیار رایج برای خواندن فایل‌های صوتی است. .IP \fBALSA\fR 4 .IX Item "ALSA" رابط \&\fBALSA\fR برنامه‌نویسی نسبتاً پیچیده‌ای دارد و کار می‌کند، اما ممکن است به آزمایش‌های بیشتری نیاز داشته باشد. این رابط در هر زمان حداکثر یک صدا را پخش می‌کند. .IP \fBLibAO\fR 4 .IX Item "LibAO" کتابخانه \&\fBLibAO\fR یک کتابخانه خروجی صوتی چندسکویی است که پوششی مناسب روی تعداد زیادی از رابط‌های صوتی متداول فراهم می‌کند. این کتابخانه یک فایل پیکربندی ساده دارد که در صفحه راهنمای \fBlibao.conf\fR\|(5) مستند شده است. .IP \fBOSS\fR 4 .IX Item "OSS" سیستم صوتی باز یا \fIOpen Sound System (OSS)\fR یک رابط صوتی چندسکویی است که به‌طور کامل توسط \&\fBicesound\fR پشتیبانی می‌شود. .PP هنگامی که چندین رابط صوتی در دسترس باشند، \&\fBicesound\fR تمام آن‌ها را بررسی می‌کند تا به رابطی که می‌تواند به آن متصل شود برسد و سپس از آن استفاده می‌کند. به‌طور پیش‌فرض، اولویت به این ترتیب است: \fBAO\fR، \fBALSA\fR، \fBOSS\fR. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .SS "گزینه‌های اختصاصی (SPECIFIC OPTIONS)" .IX Subsection "SPECIFIC OPTIONS" .IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4 .IX Item "-d, --display=DISPLAY" نمایشگر X11 مورد استفاده توسط \fBicewm\fR\|(1) (پیش‌فرض: \f(CW$DISPLAY\fR). .IP "\fB\-s\fR, \fB\-\-sample\-dir\fR=\fIDIRECTORY\fR" 4 .IX Item "-s, --sample-dir=DIRECTORY" دایرکتوری حاوی فایل‌های صوتی را مشخص می‌کند. مقدار پیش‌فرض عبارت است از: \&\fR\f(CI$HOME\fR\fI/.config/icewm/sounds\fR، \fI\fR\f(CI$HOME\fR\fI/.icewm/sounds\fR، \fICFGDIR/sounds\fR و \fILIBDIR/sounds\fR. خروجی \f(CW\*(C`icewm \-\-directories\*(C'\fR را ببینید. .IP "\fB\-i\fR, \fB\-\-interface\fR={\fBAO\fR|\fBALSA\fR|\fBOSS\fR}[,{\fBAO\fR|\fBALSA\fR|\fBOSS\fR}]*" 4 .IX Item "-i, --interface={AO|ALSA|OSS}[,{AO|ALSA|OSS}]*" رابط‌های خروجی صوتی را مشخص می‌کند. یک یا چند مورد از: \fBAO\fR، \&\fBALSA\fR، \fBOSS\fR که با کاما (\f(CW\*(C`,\*(C'\fR) جدا شده‌اند. .IP "\fB\-D\fR, \fB\-\-device\fR=\fIDEVICE\fR" 4 .IX Item "-D, --device=DEVICE" فقط برای سازگاری با نسخه‌های پیشین: دستگاه پیش‌فرض. لطفاً یکی از گزینه‌های \fB\-A\fR، \fB\-O\fR یا \fB\-S\fR را ترجیح دهید. .IP "\fB\-O\fR, \fB\-\-oss\fR=\fIDEVICE\fR" 4 .IX Item "-O, --oss=DEVICE" دستگاه OSS را مشخص می‌کند (پیش‌فرض: \fI/dev/dsp\fR). .IP "\fB\-A\fR, \fB\-\-alsa\fR=\fIDEVICE\fR" 4 .IX Item "-A, --alsa=DEVICE" دستگاه ALSA را مشخص می‌کند (پیش‌فرض: \f(CW\*(C`default\*(C'\fR). .IP "\fB\-z\fR, \fB\-\-snooze\fR=\fIMILLISECONDS\fR" 4 .IX Item "-z, --snooze=MILLISECONDS" فاصله زمانی تعویق (snooze) بین رویدادهای صوتی را بر حسب میلی‌ثانیه مشخص می‌کند. پیش‌فرض ۵۰۰ میلی‌ثانیه است. .IP "\fB\-p\fR, \fB\-\-play\fR=\fISOUND\fR" 4 .IX Item "-p, --play=SOUND" صدای داده‌شده (نام یا شماره) را پخش کرده و خارج می‌شود. .IP "\fB\-l\fR, \fB\-\-list\-files\fR" 4 .IX Item "-l, --list-files" مسیرهای فایل‌های صوتی موجود را فهرست کرده و خارج می‌شود. .IP \fB\-\-list\-sounds\fR 4 .IX Item "--list-sounds" نام‌های فایل‌های صوتی پشتیبانی‌شده را فهرست کرده و خارج می‌شود. .IP \fB\-\-list\-interfaces\fR 4 .IX Item "--list-interfaces" رابط‌های صوتی پشتیبانی‌شده را فهرست کرده و خارج می‌شود. .IP "\fB\-o\fR, \fB\-\-output=FILE\fR" 4 .IX Item "-o, --output=FILE" هدایت تمام خروجی‌ها به \fIFILE\fR. علامت مدک ابتدای مسیر یا متغیرهای محیطی بسط داده می‌شوند. .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" حالت پرگو؛ هنگام وقوع رویدادهای صوتی اطلاعاتی را چاپ می‌کند. .SS "گزینه‌های عمومی (GENERAL OPTIONS)" .IX Subsection "GENERAL OPTIONS" .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" چاپ توضیح مختصری از نحوه استفاده در \fIstdout\fR و خروج. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" چاپ نسخه برنامه در \fIstdout\fR و خروج. .IP "\fB\-C\fR, \fB\-\-copying\fR" 4 .IX Item "-C, --copying" چاپ مجوزهای تکثیر برنامه در \fIstdout\fR و خروج. .SH "وضعیت خروج (EXIT STATUS)" .IX Header "EXIT STATUS" .IP \fB0\fR 4 .IX Item "0" موفقیت‌آمیز. .IP \fB1\fR 4 .IX Item "1" خطای عمومی. .IP \fB2\fR 4 .IX Item "2" خطای خط فرمان. .IP \fB3\fR 4 .IX Item "3" خطای زیرسیستم‌ها (مانند عدم امکان اتصال به سرور). .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBicewm\fR\|(1), \&\fBlibao.conf\fR\|(5), \&\fBpadsp\fR\|(1), \&\fBaplay\fR\|(1), \&\fBalsamixer\fR\|(1). .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUGS" لطفاً خطاها و مشکلات را در گزارش دهید. .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Brian Bidulock . .PP برای مشاهده متن کامل اعلان حق نشر و مجوزهای تکثیر، گزینه \fB\-\-copying\fR را ببینید. .SH "مجوز (LICENSE)" .IX Header "LICENSE" مدیر پنجره \&\fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است. برای مشاهده مجوزهای تکثیر، پرونده \fICOPYING\fR را در بسته توزیع بررسی کنید یا از گزینه \fB\-\-copying\fR برای نمایش مجوزها استفاده نمایید.