نام (NAME)

sminstbuilder - برنامه‌ای برای ساخت سازهای .smset از نمونه‌های صوتی

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

sminstbuilder دایرکتوری...

توضیحات (DESCRIPTION)

دستور sminstbuilder یک اسکریپت است که تمام مراحل لازم برای ساخت یک ساز .smset (جهت استفاده در طرح‌های دگرگونی SpectMorph) از نمونه‌های صوتی را به صورت خودکار انجام می‌دهد. انجام دستی تمامی مراحلی که sminstbuilder انجام می‌دهد با استفاده از smenc، smwavset، smtool، imiscutter و smsampleedit امکان‌پذیر است، اما sminstbuilder فرآیند ساخت یک ساز را بسیار راحت‌تر می‌کند.

ایده اصلی این است که برای هر ساز یک دایرکتوری، و در هر دایرکتوری یک فایل با نام "config" وجود داشته باشد. هر آنچه که sminstbuilder باید درباره ساز بداند در فایل "config" قرار می‌گیرد. دستورات در ادامه در بخش CONFIG مستند شده‌اند.

گزینه‌ها (OPTIONS)

دستور sminstbuilder فهرستی از یک یا چند دایرکتوری ساز را به عنوان ورودی دریافت می‌کند. هر ساز باید دارای یک فایل "config" باشد.

پیکربندی سازنده (BUILDER CONFIG)

دستور sminstbuilder فایل "sminstbuilder.cfg" را هنگام راه‌اندازی می‌خواند. این فایل حاوی گزینه‌هایی است که مختص به ساز خاصی نیستند. این گزینه‌ها عبارتند از:

cache 0/1: هنگام ساخت سازها، ممکن است لازم باشد یک نمونه صوتی یکسان بارها و بارها (هم‌زمان با تغییر سایر پارامترها) کدگذاری شود. از آنجا که smenc کند است، این کار می‌تواند زمان زیادی ببرد. اگر cache روی 1 تنظیم شود، sminstbuilder از smenccache برای کدگذاری استفاده خواهد کرد، و اگر همان نمونه قبلاً کدگذاری شده باشد، نتیجه از ~/.smenccache گرفته می‌شود که بسیار سریع‌تر از اجرای مجدد smenc است.
jobs n_jobs: از آنجا که کدگذاری هزینه‌بر و سنگین است، توزیع وظایف کدگذار روی پردازنده‌های چند‌هسته‌ای معمولاً مطلوب است. اگر پردازنده چند‌هسته‌ای دارید، مقدار n_jobs را بر روی تعداد هسته‌ها تنظیم کنید (یعنی ۱ برای تک‌هسته‌ای، ۲ برای دو‌هسته‌ای و ...).
output-dir directory: پس از ساخت موفقیت‌آمیز یک ساز، sminstbuilder ساز را در این دایرکتوری کپی می‌کند. این مسیر باید با استفاده از یک مسیر مطلق (و نه مسیر نسبی) مشخص شود.

پیکربندی (CONFIG)

auto-loop <percent>: تنظیم یک حلقه یک‌فریمی که در همان نقطه (تعیین‌شده توسط <percent>) آغاز شده و پایان می‌یابد.
auto-tune: کوک کردن ساز با استفاده از داده‌های بازه (40%..60%) برای استخراج بسامد واقعی.
auto-volume <percent>: نرمال‌سازی حجم صدای صوتی، با استفاده از حجم صدا در حدود <percent> به عنوان مرجع.
auto-volume-from-loop: نرمال‌سازی حجم صدای صوتی، با استفاده از حجم صدای بخش حلقه‌شده به عنوان مرجع.
cut
dir: تنظیم دایرکتوری داده نسبت به دایرکتوری ساز.
sample <midi-note> <filename>: افزودن نمونه صوتی از فایل <filename> به ساز. مقدار <midi-note> باید بر روی نتی که ضبط شده است، به صورت عددی بین 0 و 127 تنظیم شود.
samples <start-midi-note> <end-midi-note>: افزودن مجموعه‌ای از نمونه‌های صوتی به ساز. فایل‌های نمونه باید به‌صورت note-<N>.wav نام‌گذاری شوند، که در آن <N> نت MIDI است که از <start-midi-note> تا <end-midi-note> شمارش می‌شود.
set-markers: تنظیم نشانگرها از روی فایل نشانگر.
tune-all-frames: کوک کردن تمام فریم‌های ساز. این کار تغییرات جزئی بسامد را که برای اکثر سازها امری طبیعی است حذف می‌کند، بنابراین ممکن است خروجی مصنوعی به نظر برسد.

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

smenc.1 https://testbit.eu/wiki/Smenc.1, smtool.1 https://testbit.eu/wiki/Smtool.1, smwavset.1 https://testbit.eu/wiki/Smwavset.1