.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "ROC-COPY" "1" "2024" "Roc Toolkit 0.4" "Roc Toolkit"
.SH "نام (NAME)"
roc\-copy \- کپی صوت محلی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBroc\-copy\fP \fIOPTIONS\fP
.SH "توضیحات (DESCRIPTION)"
.sp
خواندن جریان صوتی از یک فایل، تبدیل آن و نوشتن آن در فایلی دیگر.
.SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
نمایش راهنما و خروج
.TP
.B  \-V\fP,\fB  \-\-version
نمایش نسخه و خروج
.TP
.B  \-v\fP,\fB  \-\-verbose
افزایش سطح جزئیات پیام‌ها (می‌تواند چندین بار استفاده شود)
.TP
.B  \-L\fP,\fB  \-\-list\-supported
فهرست کردن طرح‌واره‌ها (schemes) و قالب‌های پشتیبانی‌شده
.TP
.BI \-i\fP,\fB  \-\-input\fB= FILE_URI
شناسه URI فایل ورودی
.TP
.BI \-o\fP,\fB  \-\-output\fB= FILE_URI
شناسه URI فایل خروجی
.TP
.BI \-\-input\-format\fB= FILE_FORMAT
اجبار در تعیین قالب فایل ورودی
.TP
.BI \-\-output\-format\fB= FILE_FORMAT
اجبار در تعیین قالب فایل خروجی
.TP
.BI \-\-frame\-len\fB= TIME
مدت‌زمان فریم‌های داخلی، برحسب واحدهای TIME
.TP
.BI \-r\fP,\fB  \-\-rate\fB= INT
نرخ نمونه‌برداری خروجی، به هرتز (Hz)
.TP
.BI \-\-resampler\-backend\fB= ENUM
موتور بازنمونه‌برداری (resampler) (مقادیر ممکن: \(dqdefault\(dq، \(dqbuiltin\(dq، \(dqspeex\(dq، \(dqspeexdec\(dq، پیش‌فرض=\(gadefault\(aq)
.TP
.BI \-\-resampler\-profile\fB= ENUM
پروفایل بازنمونه‌برداری (مقادیر ممکن: \(dqlow\(dq، \(dqmedium\(dq، \(dqhigh\(dq، پیش‌فرض=\(gamedium\(aq)
.TP
.B  \-\-profiling
فعال‌سازی پروفایل‌بندی عملکرد (پیش‌فرض=غیرفعال)
.TP
.BI \-\-color\fB= ENUM
تنظیم حالت خروجی رنگی برای stderr (مقادیر ممکن: \(dqauto\(dq، \(dqalways\(dq، \(dqnever\(dq، پیش‌فرض=\(gaauto\(aq)
.UNINDENT
.SS "شناسه URI فایل (File URI)"
.sp
گزینه‌های \fB\-\-input\fP و \fB\-\-output\fP نیازمند یک شناسه URI فایل در یکی از قالب‌های زیر هستند:
.INDENT 0.0
.IP \(bu 2
\fBfile:///ABS/PATH\fP \-\- مسیر مطلق فایل
.IP \(bu 2
\fBfile://localhost/ABS/PATH\fP \-\- مسیر مطلق فایل (شکل جایگزین؛ فقط میزبان \(dqlocalhost\(dq پشتیبانی می‌شود)
.IP \(bu 2
\fBfile:/ABS/PATH\fP \-\- مسیر مطلق فایل (شکل جایگزین)
.IP \(bu 2
\fBfile:REL/PATH\fP \-\- مسیر نسبی فایل
.IP \(bu 2
\fBfile://\-\fP \-\- خروجی استاندارد (stdout)
.IP \(bu 2
\fBfile:\-\fP \-\- خروجی استاندارد (شکل جایگزین)
.UNINDENT
.sp
مثال‌ها:
.INDENT 0.0
.IP \(bu 2
\fBfile:///home/user/test.wav\fP
.IP \(bu 2
\fBfile://localhost/home/user/test.wav\fP
.IP \(bu 2
\fBfile:/home/user/test.wav\fP
.IP \(bu 2
\fBfile:./test.wav\fP
.IP \(bu 2
\fBfile:\-\fP
.UNINDENT
.sp
فهرست قالب‌های فایل پشتیبانی‌شده را می‌توان با استفاده از گزینهٔ \fB\-\-list\-supported\fP به دست آورد.
.sp
اگر گزینهٔ \fB\-\-output\fP تعیین نشود، نتایج تبدیل دور ریخته می‌شوند.
.sp
گزینه‌های \fB\-\-input\-format\fP و \fB\-\-output\-format\fP می‌توانند برای اجبار در تعیین قالب فایل استفاده شوند. اگر این گزینه تعیین نشود، قالب فایل به‌طور خودکار تشخیص داده می‌شود. این گزینه همواره برای stdin یا stdout الزامی است.
.sp
بخش مسیر در URI ارائه‌شده به‌صورت \fI\%percent\-decoded\fP کدگشایی می‌شود. برای راحتی، نویسه‌های کدگذاری‌نشده نیز مجاز هستند، به‌جز نویسهٔ \fB%\fP که همیشه باید به‌صورت \fB%25\fP کدگذاری شود.
.sp
برای مثال، فایل با نام \fB/foo/bar%/[baz]\fP می‌تواند با هر یک از این URIها مشخص شود: \fBfile:///foo%2Fbar%25%2F%5Bbaz%5D\fP و \fBfile:///foo/bar%25/[baz]\fP\&.
.SS "واحدهای زمان (Time units)"
.INDENT 0.0
.TP
.B \fITIME\fP باید یکی از قالب‌های زیر را داشته باشد:
123ns; 1.23us; 1.23ms; 1.23s; 1.23m; 1.23h;
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.sp
تبدیل نرخ نمونه‌برداری به 48k:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ roc\-copy \-vv \-\-rate=48000 \-i file:input.wav \-o file:output.wav
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
دور ریختن نتایج خروجی (مفید برای بنچمارک و سنجش کارایی):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ roc\-copy \-vv \-\-rate=48000 \-i file:input.wav
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
ورودی از stdin، خروجی به stdout:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ roc\-copy \-vv \-\-input\-format=wav \-i file:\- \e
    \-\-output\-format=wav \-o file:\- >./output.wav <./input.wav
.ft P
.fi
.UNINDENT
.UNINDENT
.SH "محیط (ENVIRONMENT)"
.sp
متغیرهای محیطی زیر پشتیبانی می‌شوند:
.INDENT 0.0
.TP
.B NO_COLOR
به‌طور پیش‌فرض، رنگی بودن ترمینال به‌صورت خودکار تشخیص داده می‌شود. این متغیر محیطی می‌تواند روی یک رشتهٔ غیرخالی تنظیم شود تا رنگی بودن ترمینال غیرفعال گردد. این متغیر اولویت پایین‌تری نسبت به گزینهٔ \fB\-\-color\fP دارد.
.TP
.B FORCE_COLOR
به‌طور پیش‌فرض، رنگی بودن ترمینال به‌صورت خودکار تشخیص داده می‌شود. این متغیر محیطی می‌تواند روی یک عدد صحیح مثبت تنظیم شود تا رنگی بودن ترمینال فعال/اجباری گردد. این متغیر اولویت پایین‌تری نسبت به متغیر \fBNO_COLOR\fP و گزینهٔ \fB\-\-color\fP دارد.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBroc\-recv(1)\fP، \fBroc\-send(1)\fP، وب‌سایت Roc در \fI\%https://roc\-streaming.org\fP
.SH "گزارش باگ‌ها (BUGS)"
.sp
لطفاً هرگونه باگ یافت‌شده را از طریق GitHub گزارش دهید (\fI\%https://github.com/roc\-streaming/roc\-toolkit\fP).
.SH "نویسندگان (AUTHORS)"
.sp
برای دیدن فهرست نگه‌دارندگان و مشارکت‌کنندگان، صفحهٔ نویسندگان را در وب‌سایت مشاهده کنید (\fI\%https://roc\-streaming.org/toolkit/docs/about_project/authors.html\fP).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2024, Roc Streaming authors
.\" Generated by docutils manpage writer.
.