SMINSTBUILDER(1)           sminstbuilder Manual Page          SMINSTBUILDER(1)



نام (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>

Revision 601                      2011-08-05                  SMINSTBUILDER(1)