نام (NAME)

mscore, musescore — ویرایشگر نُت موسیقی MuseScore 4

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

mscore [-deFfhIiLmnOPRstvw] [-b | --bitrate bitrate] [-c | --config-folder pathname] [-D | --monitor-resolution DPI] [-E | --install-extension extension file] [-j | --job file.json] [-M | --midi-operations file] [-o | --export-to file] [-p | --plugin name] [-r | --image-resolution DPI] [-S | --style style] [-T | --trim-image margin] [-x | --gui-scaling factor] [--debug] [--diff] [--dump-midi-in] [--dump-midi-out] [--experimental] [--export-score-parts] [--factory-settings] [--force] [--help] [--layout-debug] [--load-icons] [--long-version] [--new-score] [--no-fallback-font] [--no-midi] [--no-synthesizer] [--raw-diff] [--revert-settings] [--run-test-script] [--save-online] [--score-media] [--highlight-config] [--score-mp3] [--score-parts] [--score-parts-pdf] [--score-transpose] [--template-mode] [--test-mode] [--transpose] [--version] [file ...]

توضیحات (DESCRIPTION)

نرم‌افزار MuseScore یک برنامهٔ آزاد و متن‌باز دیداری (WYSIWYG)، چندسکویی و چندزبانه برای آهنگسازی و نُت‌نویسی است که تحت پروانه عمومی همگانی گنو (GPLv2) منتشر شده است.

اجرای mscore بدون هیچ گزینهٔ اضافی، برنامهٔ گرافیکی کامل MuseScore را اجرا کرده و تمام فایل‌های مشخص‌شده در خط فرمان را باز می‌کند.

گزینه‌ها به شرح زیر هستند:

-b | --bitrate bitrate

تنظیم بیت‌ریت خروجی MP3 بر حسب kbit/s

-c | --config-folder pathname

جایگزین کردن دایرکتوری پیکربندی و تنظیمات

-D | --monitor-resolution DPI

مشخص کردن وضوح مانیتور (لغو تشخیص خودکار)

-d | --debug

اجرای MuseScore در حالت اشکال‌زدایی (debug)

-E | --install-extension extension file

نصب یک فایل افزونه؛ SoundFontها به طور پیش‌فرض بارگذاری می‌شوند مگر اینکه -e نیز مشخص شده باشد

-e | --experimental

فعال‌سازی ویژگی‌های آزمایشی، مانند لایه‌ها

-F | --factory-settings

بازگردانی تمام تنظیمات، کلیدهای میانبر، فضاهای کاری، افزونه‌ها، ترجمه‌ها و غیره به مقادیر پیش‌فرض کارخانه؛ با گزینهٔ -R مقایسه شود

-f | --force

نادیده گرفتن هشدارهای خرابی نُت و عدم تطابق نسخه در “converter mode”

-h | --help

نمایش خلاصه‌ای از دستورالعمل‌های نحوهٔ استفاده

-I | --dump-midi-in

نمایش تمام ورودی‌های MIDI در کنسول

-i | --load-icons

بارگذاری آیکون‌ها از فایل‌سیستم؛ مناسب برای زمانی که می‌خواهید آیکون‌های MuseScore را ویرایش کرده و پیش‌نمایش تغییرات را ببینید

-j | --job file.json

پردازش یک عملیات تبدیل (بخش مثال‌ها (EXAMPLES) در زیر را ببینید)

-L | --layout-debug

اجرای MuseScore در حالت اشکال‌زدایی چیدمان (layout debug)

-M | --midi-operations file

مشخص کردن فایل عملیات وارد کردن MIDI (بخش مثال‌ها (EXAMPLES) در زیر را ببینید)

-m | --no-midi

غیرفعال کردن ورودی MIDI

-n | --new-score

شروع با راهنمای مرحله‌به‌مرحلهٔ «نُت جدید»، صرف‌نظر از فعال یا غیرفعال بودن آن در تنظیمات ترجیحی کاربر

-O | --dump-midi-out

نمایش تمام خروجی‌های MIDI در کنسول

-o | --export-to file

برون‌بری فایل داده‌شده (یا فایلی که در حال حاضر باز است) به فایل خروجی مشخص‌شده در file. نوع فایل به پسوند نام فایل ارائه‌شده بستگی دارد. این گزینه برنامه را به “converter mode” تغییر وضعیت داده و از رابط کاربری گرافیکی صرف‌نظر می‌کند.

-P | --export-score-parts

هنگام تبدیل به PDF با استفاده از گزینهٔ -o -، صفحات هر پارت (part) را به فایل PDF ایجادشده ضمیمه می‌کند. اگر نُت دارای هیچ پارتی نباشد، تمام پارت‌های پیش‌فرض به‌طور موقت و خودکار ایجاد خواهند شد.

-p | --plugin name

اجرای پلاگین مشخص‌شده

-R | --revert-settings

بازگردانی ترجیحات کاربر به پیش‌فرض کارخانه اما با حفظ کلیدهای میانبر، فضاهای کاری، افزونه‌ها، ترجمه‌ها و غیره؛ با -F مقایسه شود.

-r | --image-resolution DPI

تنظیم وضوح تصویر برای تبدیل به فایل‌های PNG..Pp پیش‌فرض: ۳۶۰ DPI (در واقع، مقدار “Resolution” از گروه گزینه‌های PNG در برگهٔ Export تنظیمات)

-S | --style style

ابتدا یک فایل سبک (style) بارگذاری می‌شود؛ برای استفاده همراه با گزینهٔ -o مفید است

-s | --no-synthesizer

غیرفعال کردن سینتی‌سایزر نرم‌افزاری توکار

-T | --trim-image margin

بریدن حاشیه‌های تصویرهای PNG و SVG صادرشده جهت حذف فضای خالی پیرامون پارتیتور. مقدار مشخص‌شدهٔ margin (بر حسب پیکسل) حفظ خواهد شد (برای تصویری با برش کاملاً چسبیده از 0 استفاده کنید). هنگام صدور به SVG، این گزینه تنها با پارتیتورهای تک‌صفحه‌ای کار می‌کند.

-t | --test-mode

تنظیم پرچم حالت آزمایشی برای تمام فایل‌ها

-v | --version

نمایش نام و نسخهٔ برنامه بدون راه‌اندازی رابط کاربری گرافیکی

-x | --gui-scaling factor

مقیاس‌بندی نمایش پارتیتور و سایر عناصر رابط گرافیکی با ضریب مشخص‌شده در factor ؛ در نظر گرفته‌شده برای استفاده در نمایشگرهای با تفکیک‌پذیری بالا

--diff

چاپ یک diff شرطی میان پارتیتورهای داده‌شده

--long-version

نمایش نام کامل، نسخه و بازنگری git برنامه بدون راه‌اندازی رابط کاربری گرافیکی

--no-fallback-font

عدم استفاده از Bravura به‌عنوان قلم موسیقی پشتیبان (fallback)

--raw-diff

چاپ یک diff خام میان پارتیتورهای داده‌شده

--run-test-script

اجرای آزمون‌های اسکریپت فهرست‌شده در آرگومان‌های خط فرمان

--save-online

بارگذاری پارتیتور(ها) در نشانی مبدأ (URL) آن. از پیش باید یک پارتیتور برخط در آن نشانی موجود باشد، و کاربر باید به حساب کاربری دارندهٔ آن وارد شده باشد. پارتیتور برخط با فایل بارگذاری‌شده جایگزین خواهد شد، اما عنوان و توضیحات صفحهٔ وب پارتیتور برخط تغییر نخواهد کرد.

--score-media

صادر کردن تمام رسانه‌ها (به‌جز MP3) برای پارتیتور داده‌شده به‌صورت یک سند یکتای JSON به stdout

--highlight-config

تنظیم برجسته‌سازی (highlight) روی svg، تولیدشده از پارتیتور داده‌شده

--score-mp3

تولید یک فایل MP3 برای پارتیتور داده‌شده و صادر کردن آن به‌صورت یک سند یکتای JSON به stdout

--score-parts

تولید داده‌های بخش‌ها (parts) برای پارتیتور داده‌شده و ذخیرهٔ آن‌ها در فایل‌های mscz جداگانه

--score-parts-pdf

تولید داده‌های بخش‌ها برای پارتیتور داده‌شده و صادر کردن آن به‌صورت یک سند یکتای JSON به stdout

--score-transpose

ترانسپوز (انتقال گام) پارتیتور داده‌شده و صادر کردن داده‌ها به یک فایل یکتای JSON، و چاپ آن در stdout

--template-mode

ذخیرهٔ فایل‌ها در حالت الگو (برای نمونه بدون اندازهٔ صفحه)

--transpose

ترانسپوز کردن پارتیتور داده‌شده (تنها در صورتی که گزینهٔ -o نیز تنظیم شده باشد)، سپس صادر کردن فایل داده‌شده مطابق با گزینهٔ -o

نرم‌افزار MuseScore از گزینه‌های خودکار خط فرمان Qt پشتیبانی می‌کند (پایین را ببینید).

فایل‌ها (FILES)

/usr/share/mscore-4.7/ شامل داده‌های پشتیبانی برنامه است (دموها، سازها، بومی‌سازی، افزونه‌های سراسری سیستم، soundfontها، سبک‌ها، آکوردها، الگوها و کاغذدیواری‌ها). در بسته‌های دبیان (Debian)، به جای آن soundfontهای سراسری سیستم به ترتیب در /usr/share/sounds/sf2/, /usr/share/sounds/sf3/ یا /usr/share/sounds/sfz/ نصب می‌شوند.

داده‌های مختص هر کاربر (اکستنشن‌ها، افزونه‌ها، soundfontها، سبک‌ها، الگوها) و فایل‌ها (تصاویر، پارتیتورها) معمولاً در زیرشاخه‌هایی درون $XDG_DOCUMENTS_DIR/MuseScore3/ نصب می‌شوند، اما می‌توان آن‌ها را در پیکربندی تغییر داد. توجه داشته باشید که نسخه‌های snapshot، آلفا و بتا در تمام این مسیرها به جای MuseScore3 از MuseScore3Development استفاده می‌کنند.

$XDG_CONFIG_HOME/MuseScore/MuseScore3.ini شامل ترجیحات کاربر، فهرست فایل‌های اخیراً استفاده‌شده و مکان آن‌ها، اندازه و موقعیت پنجره‌ها و غیره است. برای مسیرهای نسخهٔ توسعه به موارد بالا مراجعه کنید.

$XDG_DATA_HOME/MuseScore/MuseScore3/ شامل فایل‌های بومی‌سازی به‌روزشده بارگیری‌شده از داخل برنامه، اطلاعات افزونه‌ها، پارتیتورهای کش‌شده، اطلاعات احراز هویت برای وبگاه جامعهٔ musescore.com, اطلاعات نشست (session)، تنظیمات سینتی‌سایزر، سرکلیدها و میزان‌نماهای سفارشی و کلیدهای میان‌بر است. برای مسیرهای نسخهٔ توسعه به موارد بالا مراجعه کنید.

مثال‌ها (EXAMPLES)

تبدیل یک پارتیتور به PDF از خط فرمان:

انتقال گام (transpose) و سپس تبدیل پارتیتور به PDF از خط فرمان:

-o 'My Transposed Score.pdf' --transpose '{"mode": "by_interval",
"direction": "up", "transposeInterval": 12,
"transposeKeySignatures": true}' 'My Score.mscz'

انتقال گام به پارتیتوری دیگر از خط فرمان:

-o 'My Transposed Score.mscz' --transpose '{"mode": "diatonically",
"direction": "down", "transposeInterval": 3,
"useDoubleSharpsFlats": true}' 'My Score.mscz'

اجرای یک کار دسته‌ای (batch job) برای تبدیل چندین سند:

این کار مستلزم آن است که فایل job.json در دایرکتوری کاری فعلی دارای محتوایی مشابه موارد زیر باشد:

[
  {
    "in": "Reunion.mscz",
    "out": "Reunion-coloured.pdf",
    "plugin": "colornotes.qml"
  },
  {
    "in": "Reunion.mscz",
    "out": [
      "Reunion.pdf",
      [ "Reunion (part for ", ").pdf" ],
      "Reunion.musicxml",
      "Reunion.mid"
    ]
  },
  {
    "in": "Reunion.mscz",
    "out": "Reunion-transposed.mscz",
    "transpose":
	{
	  "mode": "by_interval",
	  "direction": "up",
	  "transposeInterval": 12,
	  "transposeKeySignatures": true
	}
  },
  {
    "in": "Reunion.mscz",
    "out": "Reunion-transposed.pdf",
    "transpose":
	{
	  "mode": "diatonically",
	  "direction": "down",
	  "transposeInterval": 2,
	  "useDoubleSharpsFlats": true
	}
  },
  {
    "in": "Piece with excerpts.mscz",
    "out": [
      "Piece with excerpts (Partitura).pdf",
      [ "Piece with excerpts (part for ", ").pdf" ],
      "Piece with excerpts.mid"
    ]
  }
]

بخش آخر این کار، به عنوان مثال، موجب می‌شود فایل‌هایی مانند “Piece with excerpts (part for Violin).pdf” در کنار پارتیتور رهبر ارکستر و یک فایل MIDI با صدای ارکستر کامل تولید شوند، در حالی که بخش معادل در تبدیل Reunion در سکوت نادیده گرفته خواهد شد (زیرا برای قطعهٔ Reunion که یک دموی MuseScore است، هیچ گزیده‌ای تعریف نشده است).

https://musescore.org/sites/musescore.org/files/midi_import_options_0.xml یک نمونه فایل عملیات واردسازی MIDI برای گزینهٔ -M است..Sh "خطاها (DIAGNOSTICS)"
The mscore utility exits 0 on success, and >0 if an error occurs.

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

fluidsynth(1), midicsv(1), timidity(1), qtoptions(7)

https://handbook.musescore.org

کتابچه راهنمای برخط، دفترچه راهنمای کامل کاربر

https://musescore.org/forum

انجمن پشتیبانی

https://handbook.musescore.org/appendix/command-line-usage

مستندات تکمیلی پیرامون گزینه‌های خط فرمان

http://doc.qt.io/qt-5/qguiapplication.html#supported-command-line-options

مستندات گزینه‌های خودکار خط فرمان Qt

استانداردها (STANDARDS)

MuseScore تلاش می‌کند استانداردهای زیر را پیاده‌سازی کند:

• MusicXML 4.0 (قالب تبادل پارتیتور)
• SF2 (SoundFont 2.01)
• SF3 (SoundFont با نمونه‌های فشرده‌شده با OGG Vorbis)
• SMuFL (Standard Music Font Layout 1.4)

تاریخچه (HISTORY)

MuseScore در سال ۲۰۰۲ از سکوئنسر MusE منشعب شد و از آن زمان تاکنون به برجسته‌ترین نرم‌افزار متن‌باز نت‌نویسی تبدیل شده است.

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

MuseScore توسط MuseScore Limited توسعه داده می‌شود.

این صفحهٔ راهنما توسط mirabilos ⟨tg@debian.org⟩ نوشته شده است.

هشدارها (CAVEATS)

گزینه‌های خودکار خط فرمان Qt پیش از آن‌که برنامه فرصت پردازش گزینه‌ها را پیدا کند، از بردار آرگومان‌ها حذف می‌شوند؛ این بدان معناست که فراخوانی‌ای مانند

هیچ شانسی برای کارکرد صحیح ندارد، زیرا -reverse ابتدا توسط Qt حذف می‌شود.

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

MuseScore از /etc/papersize پیروی نمی‌کند.

احتمالاً موارد بیشتری نیز وجود دارد؛ سامانهٔ ردیابی اشکالات پروژه را بررسی کنید (ر.ک. همچنین ببینید (SEE ALSO)).