View source for Modules/ndp/ndp player/Usage

Before using any functions of this module, you must call <tt>NDP_Initialize()</tt> first.

=== Music ===
You can play back music generated with the [https://ndp.squares.net/web NDP editor] (the music is created using the MML language). The editor is currently only available in Japanese.

MSXgl use .NDP binary file data. It can be generated from the editor pressing <tt>ALT+F</tt> (ファイル) then <tt>ALT+B</tt> (名前を付けて曲データをBSAVE形式で保存).

This binary file include a 7 bytes header used by BASIC's BSAVE/BLOAD instructions. You have to either cut this header or just pass the starting address of binary data offset by 7 bytes.

Example: <syntaxhighlight lang="C">
#include "mymusic.h" // NDP file converted to .H file using MSXbin

void main()
{
   /* ... */
   NDP_SetMusicData(g_MusicData); // or g_MusicData+7 if data include header
   NDP_Play();
   /* ... */
}
</syntaxhighlight>

=== SFX ===
For sound effects, you have to export .NDS file from the [https://ndp.squares.net/web NDP editor]. It can be generated from the editor pressing <tt>ALT+F</tt> (ファイル) then <tt>ALT+S</tt>. Like .NDP files, .NDS files contain the 7-byte header that must be removed or skipped.

Frist, you must call the <tt>NDP_SetSFXData()</tt> with the address of the NDS sound bank. They you can play an sound using its index into the bank (from 0 to <tt>NDP_GetSFXNumber()-1</tt>).

Example: <syntaxhighlight lang="C">
#include "mysoundbank.h" // NDS file converted to .H file using MSXbin

void main()
{
   /* ... */
   NDP_SetSFXData(g_SFXData); // or g_SFXData+7 if data include header
   NDP_PlaySFX(0); // play first sound
   /* ... */
}
</syntaxhighlight>