NRTDRV MAN EN SYNTAX HEADERS

From MSX MUSIC WIKI
Revision as of 17:29, 19 July 2018 by Kumokosi (talk | contribs) (Created page with "==Headers== Header gives definition to whole song. Header names are not case sensitive. "_" (underscore) and "-" (minus sign) are treated as same. (For example, "#OCTA_X" an...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Headers

Header gives definition to whole song.

Header names are not case sensitive. "_" (underscore) and "-" (minus sign) are treated as same. (For example, "#OCTA_X" and "#Octa-X" are equivalent.)

Error if you define contradictory limitations at a time. (For example "#OPM_WAIT" and "#OPM_NOWAIT" cannot be fined at a time.)

If you declare more than 2 times, last one is valid.

  1. CAPITAL_REV

Revert meaning of capitals and small cases of MML. (T means tempo, O means octave, R means rest, CDEFGAB means music scales and p means panpot etc.)

Track name cannot be reverted.

  1. COMPOSER <str>

Define composer name.

  1. COUNT <num>

Define resolution of whole-note (absolute note value or counts). Range is 16-384 and 192 is default value. It should not be defined normally.

Smaller this value you set, lighter the load of the driver. There are lower precision and more difficult to express nuances though.

Indivisible counts, smaller than 0 are not valid. Be careful not to be synchronized when you play music.

[example] #COUNT 192(as default)

Note value Absolute note value(counts) 音楽的音長 絶対音長(カウント数) ------------------------------------ 1 #192 2 #96 4 #48 6 #32 8 #24 16 #12 24 #8 32 #6 48 #4 64 #3 96 #2 128 #1.5 ※実際の発音は1カウント Actually sounds as 1count


Actually played withhyghin 1count 192 #1

Every time you play 128th note, 0.5 counts of the gap increased.

  1. DETUNE_EXP

D command of OPM track enables -16384 - 16383 (if this header is not used, range of D command is limited from -128 to 127).

This command uses K command inside program with D command, K command is not available.

PSG track is not affected.

  1. DETUNE_OFFSET_OPM <num>

Set offset value of detune to all of OPM tracks. Range is -32 to 32 and 0 is default.

This value is valid in all tracks of OPM and internally added when you use D command.

NRTDRV uses 438Hz as default OPM pitch but if you use this header and define "5" it works with 440Hz pitch.

  1. DETUNE_OFFSET_PSG <num>

Set offset value of detune to all of PSG tracks. Range is -32 to 32 and 0 is default.

This value is valid in all tracks of PSG and internally added when you use D command.

  1. FILENAME <str>

Define file name of music data which is included in archive after compile. If you omit this header, same name of MML file are defined and you do not need it usually.

It is limited 8 characters of alphabets or numerals. This is not case sensitive and suffix cannot be defined (fixed to *.NRD).

Use it when your MML file has long file name and you want change file name to short one.

  1. J_TIMES <num>

Defines scale factor of fast forwarding with j command. Range is 2 to 100 and 100 is default.

If load of CPUs get higher while fast forwarding, decrease this value.

  1. J_KEYON

Enables key on while fast forwarding with j command. Sounds are made with big volume and check your master volume of your environment.

Key on is valid soon after fast forwarding ended as default settings and music is not played as you want at a time to start fast forwarding. Use #J_KEYON header to avoid such a situation.

  1. J_KEYOFF

Disables key on while fast forwarding with j command. Key on is valid soon after fast forwarding ended as default settings and music is not played as you want at a time to start fast forwarding.

You do not need it usually because #J_KEYOFF is set as default. If you want enable key on while fast forwarding, use #J_KEYON header.


continue