Difference between revisions of "NRTDRV OFFLINE MANUAL EN"

From MSX MUSIC WIKI
Jump to: navigation, search
(Preparation)
(Tags: Mobile edit, Mobile web edit)
 
(20 intermediate revisions by the same user not shown)
Line 6: Line 6:
  
 
NRTDRV −Sound Driver for X1 Offline Manual
 
NRTDRV −Sound Driver for X1 Offline Manual
------------------------------
 
 
            
 
            
 
(C)2009-2017 NRTDRV developers
 
(C)2009-2017 NRTDRV developers
                                                  http://nrtdrv.sakura.ne.jp/
+
http://nrtdrv.sakura.ne.jp/
  
 
Produced by [Gordon](bla)
 
Produced by [Gordon](bla)
 
Programmed & Text Written by [Narucchi](naruto) and 293(hex125)
 
Programmed & Text Written by [Narucchi](naruto) and 293(hex125)
  
==What is this?==
+
[WikiNote]Translation & edit by MSX MUSIC WIKI editors
  
This is a music driver for OPM+PSG on SHARP X1 and cross MML compiler on Windows.
 
  
It supports 16 sounds of FM and 3 sounds of PSG with I/O port shifted FM sound board.
 
  
Of course, it supports non-modified FM sound board or internal FM sound chip of X1turboZ. You can use 8 sounds of FM and 3 sounds of PSG, in this case.
+
INDEX
  
You can play only PSG on X1turbo with internal Z80 CTC.
+
:[[NRTDRV_MAN_EN_WHATISTHIS|What is this?]](translation done)
  
NRTDRV plays full of 16 FM sounds and 3 PSG sounds, by supporting sound emulators such as "hoot" or "ASLPLAY(CLI) on Windows only.
+
:[[NRTDRV_MAN_EN_PREPARATION|Preparation]](translation done)
  
We hope this music driver to be called as "en ar tee" driver.
+
:[[NRTDRV_MAN_EN_FILES|Files]](translation done)
  
------------------------------------------------------------------------------
+
:[[NRTDRV_MAN_EN_HOWTOUSE|How to use]](translation done)
  
**When you modify I/O address, refer these sites below.
+
:[[NRTDRV_MAN_EN_SETTINGS|Settings]](translation done 18/07/03)
  
:-X1 Center
+
:[[NRTDRV_MAN_EN_TOOLS|Tools]](translation done 18/07/05)
 http://www.x1center.org/
 
  
:-NRTDRV
+
:[[NRTDRV_MAN_EN_ONLINESEARCH|Online Search]](translation done 18/07/08)
 http://nrtdrv.sakura.ne.jp/
 
  
If you modify FM sound board, plase do it at your own risk. We, NRTDRV development team any person related to this NRTDRV project, cannot give any guarantees. Don't ask and don't send claims to X1 Center as well.
+
:[[NRTDRV_MAN_EN_HOOTLIBGEN|hoot Library generation]](translation done 18/07/11)
  
== Preparation ==
+
:[[NRTDRV_MAN_EN_DSKIMGGEN|NRDSEL disk image generation]](translation done 18/07/12)
  
Previously get these files below. Select one from hoot, ASLPLAY, nrdplay or MDPlayer according to your purpose.
+
:[[NRTDRV_MAN_EN_NRTDRVINI|About NRTDRV.ini]]
  
===hoot... - Sound Hardware Emulator===
+
:[[NRTDRV_MAN_EN_SYNTAX|Syntax]]
 http://dmpsoft.s17.xrea.com/hoot/
 
  
hoot is a sound emulator and replayer. It plays generated data on Windows.
+
::[[NRTDRV_MAN_EN_SYNTAX_MUSICALSCALE|Musical scale]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_NUMERALS|Numerals]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_HEADERS|Headers]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_MMLTRACKS|MML tracks]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_PRESETTONE|Preset tone definition]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_PRESETHEADER|Preset header definition]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_MMLCOMMAND|MML commands]]
 +
:::[[NRTDRV_MAN_EN_SYNTAX_MMLCOMMAND_NOTES|Notes of MML commands]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_OPMTONE|OPM tone definition]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_OPMTABLE|OPM table (software envelope) definition]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_PSGTONE|PSG tone definition]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_PSGENVELOPE|PSG envelope definition]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_LYRICS|Lyrics definition]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_DRIVERMACROD|Driver macros]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_COMPILERMACROS|Compiler macros]]
 +
::[[NRTDRV_MAN_EN_SYNTAX_TONEDOUBLER|Tone doubler definition]]
  
Make "hoot" folder beside NRTDRV.EXE and put all files of hoot archive from the link above. It is used to play NRTDRV data and should be separated from other hoot environment for ordinary use. (hoot.xml might be overridden if you use multiple hoot environment).
+
:[[NRTDRV_MAN_EN_KNOWNPROBLEMS|Known problems/Specification]]
  
Make "x1" folder under hoot folder as well. When you extract whole folder structure, both of "hoot" and "x1" directories are made.
+
:[[NRTDRV_MAN_EN_HOWTOPLAYX1|How to play on real machines or X1 emulators]]
  
Newer version of hoot after 2009/05/17 is needed to play 16 sounds of OPM. Versions before 2008/12/31 does not support 16 sounds of OPM and need to add #OPM8 header in MML. It makes the data playable with limitation under 8 FM sounds and 3 PCM sounds (same as normal environment) in this case.
+
:[[NRTDRV_MAN_EN_SPECIALTHANKS|Special thanks]]
 
 
hoot.xml is automatically generated and overridden when do compile MML. Original hoot.xml is backed up as hoot_bak.xml.
 
 
 
===ASLPLAY(CLI)===
 
http://prgterrace.wiki.fc2.com/wiki/ASLPLAY%2528CLI%29
 
 
 
ASLPLAY is a sound emulator and replayer. It plays generated data on Windows or real devices. It can record the data as NLG or S98 format files.
 
 
 
Make "aslplay" folder beside NRTDRV.EXE and put aslplay.exe in it.
 
 
 
===nrdplay===
 
http://realchip.yui.ne.jp/nbv4/nrdplay_161230.zip
 
 
 
It is replayer supported NBV4 + AE-TTL-232R. It is used to play data directly with NBV4.
 
 
 
Make "nrdplay" folder beside NRTDRV.EXE and put all files from the link above.
 
 
 
Note:Refer PDF files in nrdplay archives when you need to know details about connections between PC and NBV4 or settings. The official site of NRTDRV provides almost same information in the page of "AE-TTL-232R+NBV4 with NRTDRV".
 
 
 
===MDPlayer===
 
 https://github.com/kuma4649/MDPlayer/
 
 
 
MDPlayer is a sound emulator and replayer. It plays generated data on Windows or real devices.
 
 
 
Put all files in appropriate folder and select the place of MDPlayer in NRTDRV menu.
 
 
 
===Pasmo===
 
http://pasmo.speccy.org/#down
 
 
 
Pasmo is a Z80 assembler. It is used to generate data.
 
 
 
Put "pasmo.exe" in the archive from the link "Windows executable" above and put it into the folder same as NRTDRV.EXE.
 
 
 
Use version 0.5.x, because version 0.6.x occurs error and cannot compile. Version 0.5.4.beta2 is recommended.
 
 
 
===7-Zip===
 
http://sevenzip.sourceforge.jp/download.html
 
 
 
7-zip is a zip archiver. It is used to generate hoot archive.
 
 
 
Put "7za.exe" in the archive from the link "7zip command line version" above and put it into the folder same as NRTDRV.EXE. "7z.exe", which included in Windows version is good as well.
 
 
 
We could not complete development of this compiler without these applications. We appreciate to authors. Thanks.
 
 
 
==Files==
 
==How to use==
 
==Settings==
 
==Tools==
 
==Online Search==
 
==hoot Library generation==
 
==NRDSEL disk image generation==
 
==About NRTDRV.ini==
 
==Syntax==
 
===Musical scale===
 
===Numerals===
 
===Headers===
 
===MML tracks===
 
===Preset tone definition===
 
===Preset header definition===
 
===MML commands===
 
===OPM tone definition===
 
===OPM table (software envelope) definition===
 
===PSG tone definition===
 
===PSG envelope definition===
 
===Driver macros===
 
===Compiler macros===
 
===Tone doubler definition===
 
 
 
==Known problems/Specification==
 
==How to play on real machines or X1 emulators==
 
==Special thanks==
 

Latest revision as of 05:14, 17 August 2018

[Note from Wiki editor] This is initial translation of OFFLINE manual. NRTDRV provides latest documents as ONLINE manual, so this translation might have some old specifications. Afrer initial translation, we shall modify it as a latest one same as ONLINE manual.

NRTDRV offline manual(2018/3/3)

NRTDRV −Sound Driver for X1 Offline Manual

(C)2009-2017 NRTDRV developers http://nrtdrv.sakura.ne.jp/

Produced by [Gordon](bla) Programmed & Text Written by [Narucchi](naruto) and 293(hex125)

[WikiNote]Translation & edit by MSX MUSIC WIKI editors


INDEX

What is this?(translation done)
Preparation(translation done)
Files(translation done)
How to use(translation done)
Settings(translation done 18/07/03)
Tools(translation done 18/07/05)
Online Search(translation done 18/07/08)
hoot Library generation(translation done 18/07/11)
NRDSEL disk image generation(translation done 18/07/12)
About NRTDRV.ini
Syntax
Musical scale
Numerals
Headers
MML tracks
Preset tone definition
Preset header definition
MML commands
Notes of MML commands
OPM tone definition
OPM table (software envelope) definition
PSG tone definition
PSG envelope definition
Lyrics definition
Driver macros
Compiler macros
Tone doubler definition
Known problems/Specification
How to play on real machines or X1 emulators
Special thanks