.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.1.
.TH SOUND-GAMBIT "1" "مارس 2022" "sound-gambit version 0.6-1-g779bdd4" "دستورهای کاربری"
.SH "نام (NAME)"
sound-gambit \- محدودکننده اوج (Peak Limiter) فایل صوتی
.SH "خلاصه دستور (SYNOPSIS)"
.B sound-gambit
[ \fI\,OPTIONS \/\fR] \fI\,<src> <dst>\/\fR
.SH "توضیحات (DESCRIPTION)"
دستور sound\-gambit یک محدودکننده اوج دیجیتال (Digital Peak Limiter) برای فایل‌های صوتی است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-auto\-gain\fR
مشخص کردن بهره (gain) نسبت به نقطه اوج
.TP
\fB\-i\fR, \fB\-\-input\-gain\fR <db>
بهره ورودی برحسب دسی‌بل (dB) (پیش‌فرض: 0)
.TP
\fB\-T\fR, \fB\-\-true\-peak\fR
نمونه‌برداری فراتر (oversample)، استفاده از آستانه true\-peak
.TP
\fB\-t\fR, \fB\-\-threshold\fR <dBFS>
آستانه برحسب dBFS/dBTP (پیش‌فرض: \fB\-1\fR)
.TP
\fB\-r\fR, \fB\-\-release\-time\fR <ms>
زمان رهاسازی (release\-time) برحسب میلی‌ثانیه (پیش‌فرض: 10)
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش اطلاعات پردازش
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ اطلاعات نسخه و خروج
.PP
این ابزار با اعمال یک محدودکننده دیجیتال اوج صدا از نوع پیش‌نگر (look\-ahead limiter) بر روی فایل ورودی، دامنه خروجی را به آستانه مشخص‌شده محدود می‌کند.
.PP
فایل مقصد دارای مشخصاتی یکسان با فایل مبدأ (نرخ نمونه‌برداری، کانال‌ها، عمق بیت) خواهد بود و فراداده‌های فایل نیز کپی می‌شوند.
این الگوریتم به‌صورت درجا (in\-place) عمل نمی‌کند؛ بنابراین فایل‌های ورودی و خروجی باید مجزا باشند.
خواندن از طریق ورودی/خروجی استاندارد (standard\-I/O) پشتیبانی می‌شود؛ بدین منظور از «\-» به‌عنوان نام فایل استفاده کنید.
.PP
پیش از پردازش، امکان اعمال بهره ورودی (input\-gain) اضافی وجود دارد. محدوده مجاز \fB\-10\fR تا +30 دسی‌بل است.
.PP
هنگامی که auto\-gain فعال باشد، بهره ورودی نسبت به آستانه داده‌شده سنجیده می‌شود و میزان کاهش بهره مؤثر (gain\-reduction) اعمالی را مشخص می‌کند.
اگر بهره ورودی صفر باشد، فایل تنها تا آستانه تعیین‌شده نرمال‌سازی (normalize) خواهد شد.
.PP
محدوده آستانه \fB\-10\fR تا 0 dBFS است و محدودکننده اجازه نخواهد داد حتی یک نمونه بالاتر از این سطح قرار گیرد.
.PP
زمان رهاسازی (release\-time) می‌تواند از 1 میلی‌ثانیه تا 1 ثانیه تنظیم شود. این محدودکننده استفاده از زمان‌های آزادسازی کوتاه را حتی روی سیگنال‌هایی با بسامد پایین و دامنه بالا میسر می‌کند. هرگونه کاهش بهره ناشی از این سیگنال‌ها به‌طور خودکار زمان نگه‌داشت (hold time) تمدیدشده‌ای خواهد داشت تا از دنبال‌شدن شکل موج توسط محدودکننده و ایجاد اعوجاج (distortion) بیش از حد جلوگیری شود. اوج‌های کوتاهی که بر روی سیگنال قرار گرفته‌اند، همچنان با همان زمان رهاسازی تنظیم‌شده توسط این گزینه مدیریت می‌شوند.
.PP
این الگوریتم بر پایه zita\-audiotools اثر Fons Adriaensen توسعه یافته است.
.SH "مثال‌ها (EXAMPLES)"
sound\-gambit \-i 3 \-t \-1.2 my\-music.wav my\-louder\-music.wav
.PP
ffmpeg \-i file.mp3 \-f wav \- | sound\-gambit \-v \-T \- output.wav
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به <https://github.com/x42/sound\-gambit/issues>
.br
وبگاه: <https://github.com/x42/sound\-gambit>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(co GPL 2021 Robin Gareus <robin@gareus.org>