نام (NAME)

smwavset - برنامه‌ای برای مدیریت فایل‌های چندموجی SpectMorph

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

smwavset <command> [OPTIONS] [ <command specific args>... ]

توضیحات (DESCRIPTION)

smwavset یک ابزار خط فرمان برای مدیریت فایل‌های چندموجی (multi-wave) در SpectMorph است. به‌طور معمول، یک فایل چندموجی ابتدا مقداردهی اولیه می‌شود (با استفاده از دستور init)، سپس فایل‌های موجی مختلف با استفاده از دستور add اضافه می‌شوند. پس از انجام این کار، انکود کردن تمام موج‌ها می‌تواند با یک دستور واحد انجام شود، همانند دیکود کردن تمام موج‌ها.

گزینه‌ها (OPTIONS)

smwavset از نحو معمول خط فرمان گنو (GNU) پیروی می‌کند، که در آن گزینه‌های طولانی با دو خط تیره ('-') شروع می‌شوند.

-h, --help: نمایش پیام راهنمای کوتاه.
-v, --version: چاپ نسخه smwavset.
--args <arguments>: مشخص کردن آرگومان‌های اضافی برای ارسال به smenc/smplay. این می‌تواند شامل --args -O1 برای انکود، یا --args --no-sines برای دیکود باشد.
-d, --data-dir: برای انکود/دیکود، یک دایرکتوری داده تعیین می‌کند که فایل‌های .wav یا فهرستی از فایل‌های .wav (یا فایل‌های .sm) در آن قرار دارند. بسیار مهم است که wavsetهای مختلف، فایل‌های خود را در دایرکتوری‌های متفاوتی ذخیره کنند (در غیر این صورت، فایل‌های wav متعلق به یک wavset دیگر بازنویسی خواهند شد). بنابراین مشخص کردن یک دایرکتوری داده مناسب که برای هر wavset مجزا باشد، معمولاً ضروری است. مقدار پیش‌فرض /tmp است که فقط برای آزمایش مناسب است؛ باید اطمینان حاصل کنید که اسکریپت‌ها مقدار متفاوتی را تنظیم می‌کنند.
--format <field1>,<field2>,<field3>,...,<fieldN>: تنظیم قالب خروجی برای دستور list.
-j <jobs>: استفاده از <jobs> پردازش موازی برای انکود (برای سیستم‌های دارای بیش از یک پردازنده).

دستورات (COMMANDS)

init [ <options> ] <wavset>...: یک wavset جدید را مقداردهی اولیه می‌کند؛ همچنین می‌تواند بیش از یک wavset مشخص‌شده در خط فرمان را مقداردهی اولیه کند.
add [ <options> ] <wavset> <midi_note> <path>: یک فایل wave به wavset اضافه می‌کند، که در آن midi_note همان نوت میدی است که فایل wave برای آن ضبط شده است.
list [ <options> ] <wavset>: فایل‌های wave موجود در wavset را فهرست می‌کند. قالب خروجی برای دستور list می‌تواند با استفاده از گزینه format (فیلدهای جداشده با کاما) مشخص شود. برای مشاهده فهرستی از فیلدهای معتبر به بخش فیلدها (FIELDS) مراجعه کنید.
encode [ <options> ] <wset_filename> <smset_filename>: یک wavset را با استفاده از smenc انکود می‌کند.
decode [ <options> ] <smset_filename> <wset_filename>: یک wavset را با استفاده از smplay دیکود می‌کند.
delta [ <options> ] <wset_filename1>...<wset_filenameN>: تفاوت میان چندین wavset را محاسبه می‌کند. تفاوت میان wavset اول و دوم به عنوان مرجع (۱۰۰٪) در نظر گرفته می‌شود و سایر wavsetها در مقایسه با آن مرجع سنجیده می‌شوند.
link <smset>: این دستور تمام فایل‌های .sm را که توسط smset به آن‌ها ارجاع داده شده، در یک فایل بزرگ تجمیع می‌کند. این کار به عنوان مرحله نهایی هنگام ساخت سازها (instruments) مفید است.

فیلدها (FIELDS)

برای دستور list، فیلدهای معتبر عبارتند از:

midi-note: نوت میدی ورودی صوتی (۰-۱۲۷)
channel: کانال ورودی صوتی (۰ اولین کانال است)
filename: نام فایل ورودی صوتی
min-velocity: حداقل شدت ضربه (velocity) برای ورودی صوتی (۰-۱۲۷)
max-velocity: حداکثر شدت ضربه (velocity) برای ورودی صوتی (۰-۱۲۷)

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

smenc.1 https://testbit.eu/wiki/Smenc.1, smplay.1 https://testbit.eu/wiki/Smplay.1, smstrip.1 https://testbit.eu/wiki/Smstrip.1