نام (NAME)

roc-copy - کپی صوت محلی

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

roc-copy OPTIONS

توضیحات (DESCRIPTION)

خواندن جریان صوتی از یک فایل، تبدیل آن و نوشتن آن در فایلی دیگر.

گزینه‌ها (OPTIONS)

-h, --help: نمایش راهنما و خروج
-V, --version: نمایش نسخه و خروج
-v, --verbose: افزایش سطح جزئیات پیام‌ها (می‌تواند چندین بار استفاده شود)
-L, --list-supported: فهرست کردن طرح‌واره‌ها (schemes) و قالب‌های پشتیبانی‌شده
-i,--input=FILE_URI: شناسه URI فایل ورودی
-o,--output=FILE_URI: شناسه URI فایل خروجی
--input-format=FILE_FORMAT: اجبار در تعیین قالب فایل ورودی
--output-format=FILE_FORMAT: اجبار در تعیین قالب فایل خروجی
--frame-len=TIME: مدت‌زمان فریم‌های داخلی، برحسب واحدهای TIME
-r,--rate=INT: نرخ نمونه‌برداری خروجی، به هرتز (Hz)
--resampler-backend=ENUM: موتور بازنمونه‌برداری (resampler) (مقادیر ممکن: "default"، "builtin"، "speex"، "speexdec"، پیش‌فرض=`default')
--resampler-profile=ENUM: پروفایل بازنمونه‌برداری (مقادیر ممکن: "low"، "medium"، "high"، پیش‌فرض=`medium')
--profiling: فعال‌سازی پروفایل‌بندی عملکرد (پیش‌فرض=غیرفعال)
--color=ENUM: تنظیم حالت خروجی رنگی برای stderr (مقادیر ممکن: "auto"، "always"، "never"، پیش‌فرض=`auto')

شناسه URI فایل (File URI)

گزینه‌های --input و --output نیازمند یک شناسه URI فایل در یکی از قالب‌های زیر هستند:

file:///ABS/PATH -- مسیر مطلق فایل
file://localhost/ABS/PATH -- مسیر مطلق فایل (شکل جایگزین؛ فقط میزبان "localhost" پشتیبانی می‌شود)
file:/ABS/PATH -- مسیر مطلق فایل (شکل جایگزین)
file:REL/PATH -- مسیر نسبی فایل
file://- -- خروجی استاندارد (stdout)
file:- -- خروجی استاندارد (شکل جایگزین)

مثال‌ها:

file:///home/user/test.wav
file://localhost/home/user/test.wav
file:/home/user/test.wav
file:./test.wav
file:-

فهرست قالب‌های فایل پشتیبانی‌شده را می‌توان با استفاده از گزینهٔ --list-supported به دست آورد.

اگر گزینهٔ --output تعیین نشود، نتایج تبدیل دور ریخته می‌شوند.

گزینه‌های --input-format و --output-format می‌توانند برای اجبار در تعیین قالب فایل استفاده شوند. اگر این گزینه تعیین نشود، قالب فایل به‌طور خودکار تشخیص داده می‌شود. این گزینه همواره برای stdin یا stdout الزامی است.

بخش مسیر در URI ارائه‌شده به‌صورت percent-decoded کدگشایی می‌شود. برای راحتی، نویسه‌های کدگذاری‌نشده نیز مجاز هستند، به‌جز نویسهٔ % که همیشه باید به‌صورت %25 کدگذاری شود.

برای مثال، فایل با نام /foo/bar%/[baz] می‌تواند با هر یک از این URIها مشخص شود: file:///foo%2Fbar%25%2F%5Bbaz%5D و file:///foo/bar%25/[baz].

واحدهای زمان (Time units)

TIME باید یکی از قالب‌های زیر را داشته باشد:: 123ns; 1.23us; 1.23ms; 1.23s; 1.23m; 1.23h;

مثال‌ها (EXAMPLES)

تبدیل نرخ نمونه‌برداری به 48k:

$ roc-copy -vv --rate=48000 -i file:input.wav -o file:output.wav

دور ریختن نتایج خروجی (مفید برای بنچمارک و سنجش کارایی):

$ roc-copy -vv --rate=48000 -i file:input.wav

ورودی از stdin، خروجی به stdout:

$ roc-copy -vv --input-format=wav -i file:- \
    --output-format=wav -o file:- >./output.wav <./input.wav

محیط (ENVIRONMENT)

متغیرهای محیطی زیر پشتیبانی می‌شوند:

NO_COLOR: به‌طور پیش‌فرض، رنگی بودن ترمینال به‌صورت خودکار تشخیص داده می‌شود. این متغیر محیطی می‌تواند روی یک رشتهٔ غیرخالی تنظیم شود تا رنگی بودن ترمینال غیرفعال گردد. این متغیر اولویت پایین‌تری نسبت به گزینهٔ --color دارد.
FORCE_COLOR: به‌طور پیش‌فرض، رنگی بودن ترمینال به‌صورت خودکار تشخیص داده می‌شود. این متغیر محیطی می‌تواند روی یک عدد صحیح مثبت تنظیم شود تا رنگی بودن ترمینال فعال/اجباری گردد. این متغیر اولویت پایین‌تری نسبت به متغیر NO_COLOR و گزینهٔ --color دارد.

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

roc-recv(1)، roc-send(1)، وب‌سایت Roc در https://roc-streaming.org

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

لطفاً هرگونه باگ یافت‌شده را از طریق GitHub گزارش دهید (https://github.com/roc-streaming/roc-toolkit).

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

برای دیدن فهرست نگه‌دارندگان و مشارکت‌کنندگان، صفحهٔ نویسندگان را در وب‌سایت مشاهده کنید (https://roc-streaming.org/toolkit/docs/about_project/authors.html).

کپی‌رایت و تکثیر (COPYRIGHT)

2024, Roc Streaming authors