MDX player
for UNIX-like environment
=========================


 UNIX-like ʴĶ (  DSP ǥХ ) ǡˤ X68k ¾Ĥ
 ƤFM ɤƸޤ
 ǽ YM2151 ߥ졼 (from MAME) λѤˤꡢꥸʥ
 ˶ᤤɤ뤳Ȥޤ
 ޤLinux Ǥ¢ FM  (OPL3) ѤդǽǤ

 YM2151 Υߥ졼դƤϡMAME ° ym2151.[ch] 
 (Jarek Burczynski <s0246@goblin.pjwstk.waw.pl> )㴳¤
 ΤѤƤޤ

 Linux (OSS, Alsa) ѥɥ饤Ф EsounD ѥɥ饤Ф¢Ƥޤ
 ޤʳǤ⡢ɸϤ˥ǡǤФȤǽǤΤǡŬ 
 player Ǽ뤳ȤǡʤĶǤդǽǤϤʤȻפޤ


INSTALL
=======

  Ŭʾ˥֤Ÿ

   % ./configure ; make ; make install

  Ƥ./configure --help ǡƼǽܤޤ
  ȤꤢϲդʤƤ⤭ưȻפޤ

   setuid 뤳Ȥǥƥݽ٤夬뵡ǽޤ
  20051015 ʹߤǤǤϡ̵Ǥ⤽ʤ˱դǤ褦ˤʤä
  ޤΤǡʤ٤ setuid ʤ褦ˤƤ

USAGE
=====

  % mdxplay (options) <mdx_filenames>

   MDX եդޤ--help  -h ǥץФޤ

  PDX ե뤬Сɤ߹Ǳդ˻ѤޤPDX ե
  ֤ϡ

   ȥǥ쥯ȥ
   mdx ե뤬֤Ƥǥ쥯ȥ
   ץ -p <dir> / --pdx-path <dir>
   Ķѿ PDX_PATH Ǽ

  νõޤ
  ܸ PDX եäɤ߹ʤ礬ޤʤ
  MDX եΥإåŬ˽񤭴ʤꤷƤ

  ʣ MDX եꤷϡդλ롢뤤
  Ctrl+C Ƕߤȡޥɥ饤μΥǡդޤ
  ʤȶʤδ֤η ( 500ms) Ǥ⤦ Ctrl+C 򲡤ȡդ
  Ǥޤ

  ̵¥롼פζʤǤ⡢ץ -l Ѥ뤳ȤǡŬʷ֤
  ưŪ˽λ (եɥ) 뤳Ȥޤ


 *********************************************************************
 *                                                                   *
 * ץब˽ϡäꥷƥबåϤǤ*
 *                 *γиξ头Ѳ*                  *
 *                                                                   *
 *********************************************************************


MDX File
========

  X68000/030 Ȥ personal workstation ư¢ɥ饤
  'MXDRV.X' ѤΥǡǤOPM(YM2151) ȸƤФ 4 ڥ졼
  8 Ʊȯ FM ȡADPCM (4bit,15kHz max) Ʊ椹
  ȤǤޤ
  ADPCM դƤϡ̤󶡤줿ѥɥ饤(PCM8)ʻѤ뤳
  ˤꡢƱ 8 κǽȤʤޤεǽѤ
  ǡ¿ޤ


NOTES
=====

  ʳǤ OPL3 μϤڤ˿褦ץȤäǤ
  ym2151.[ch] Τޤǽɤˡä̤ MDX player 
  ʤäƤޤޤ
  ʤäƤޤäʾ塢OPL3 ʬϼʧäƤ⤤Ǥɡ
  ϤߤʤΤ⤢ޤ椨

   X68000 XVI (24MHzPCM ⲻ¤) ǯ
  Ƥ䤬İ¤Ǥϡ OPM ߥ졼Ǥϡʤꡢ
  ȤܴۤʲʤΤǤϤʤȻפޤ

  PCM  FM ΥХ󥹤Ȥޤɡξˤ
  --fm-volume  --pcm-volume ŬĴƤ줾
  127 Ǻ粻̡0 ǺǾ̤Ǥ

   CPU ٤ݤȡܥȥܥޤΤȤƤ
  դΥߥ󥰤ϤʤϤǤɡ
  ϡޤΤĺΤʤǤȤ
  root Ǽ¹Ԥ setuid root ꤹȡäȤˤʤ
  ⤷ޤ

  Ǥޥȥ˲ФʤȱϡץȤ '-A'
  ȤΤѰդƤޤ2048 ХȤۤɥХåեݤơ
  Υ dsp device ˽񤭽Ф褦ˤʤޤ

  esd ˤбƤޤǡesd ưĶʤ鲿˻äƤäƤ
  ǤȻפޤ˥ͥåȥƩˤʤޤ

  esd ̵ǤOSS & Alsa ѤΥɥ饤 ( OPL3) ϼ
  ѰդƤޤΤǡĶǤϱդޤѥ
  ջ줾ǼưǧޤΤǡդƤϤˤɬפ
  ̵Ȼפޤ
  OSS ѤȤϱĤġLinux x86 Ķʳǥޥȥưɤݾڤ
  ¤Ǥͭޤstdout ǤơŬ native  wave player 
  ꤹ롢ȤƤޤ


USING OPL3
==========

  ץ༫Τ setuid root Ƥ뤫root ¤ĥ桼
  ¹Ԥ뤫줫Ǥʤ¤ OPL3 ǤϱսޤI/O ľ
  Ƥ뤿Ǥ

  4 ڥ졼⡼ɤǤ⡢ 2 ĤΥͥ 2 ڥ졼
  Ĥ餷Ƥޤ⤽ OPL3  4 ڥ졼ǤƱ 6 
  ФʤǤĤ˲äƹ 2 ڤ 6 ФΤ
  ǼǤ > YAMAHA

  --fm-waveform ʤƥץդƤߤޤOPL3 äƤ
  ȷ 0  7 ϰϤ٤ޤ
  εǽȤȡPSG ʶʤդϵդ˴ʲ뤳Ȥ
  Ǥޤ--no-fm-voice --fm-waveform 6 뤤 --psg ꤷ
  ߤƤ
  â٥ײ̵꤬뤵ޤΤǡޤ򤷤ʤ
  ޤ

  ˰̵̣ --opl2 Ȥץ 2 ڥ졼ʲİȤ
  ǤޤȤϤOPL2 ǤϻȤʤǤɡ

  /dev/dmfm ˤбƤߤäΤǤᤳ줬ưĶʤ


OTHER INFORMATIONS
==================

  MDX ǡκԤˤäƤϡߴ꤫饪ꥸʥ X68k
  ʳǤκ⤤ä㤤ޤ⤳ mdxplay Ǥ
  Ū˰ۤʤ벻Ǳդ뤳Ȥˤʤ櫓Ǥ顢Ԥΰտ
  ̵⡼ɤǤ
  櫓ǤΤǡդϤοǤİ

  ƥŪݤȤ򤷤ʤϡmdxplay ΤФ
  setuid root ʤȤǤ
  â OPL3 ѤƤαդǤʤʤޤ
  塼󥰤Ĵʤʤޤޤ̤˹ʤȱ
  ʤǤɡ

   "Alarm" ɽƱդ⤻ˤ˽λƤޤȤޤ
  ߥ󥰤ʤäǤƵưޤ礦

  ʤtop  CPU ͭΨĴ٤Ƥ⡢mdxplay 米ƤޤΤ
  ɽ줿ͤϿѤʤǲ
  -s դɸϤǤФݤˤϡsleep طνԤ
  Τǡtop ͤǧǤǽޤ

  äȽŤʡȤϡpcm8.h  PCM8_MASTER_PCM_RATE 
  ŬͤˤƤߤƤ11025 ζܤʤȤ
  פޤɡ
  ʤߤˡ486DX2  50MHz Ǥϡ11025 Hz ǤǤȤۤۡ


DISCLAIMER
==========

  ܥץѤѼԤȯʤ֤˴ؤƤ⡢
  ԤǤ䤪ӴطԤϰڤդ餤ͤޤ
  ǤΤȤǤѤ
  ۾ GPL2 ˽ޤƱ COPYING 򻲾ȤƲ

  Ū˥ƥ񤷤ƤޤԴ뤤ϲ줿
  ǡɤ߹ǽꡢˤȽǤˡ̵ʾ塢
  ʥǥХåԲǽǤ
  Ʊˡ¹Ի setuid root Ƥ硢Զ礬ȯ
  ﳲΤΤȤʤ뤳Ȥͽۤޤפʥǡݻ
  פʥӥ󶡤Ƥ륷ƥࡢ˥ͥåȥ³줿
  ƥǤưϤʤ٤򤱤Ʋ


ym2151.[ch]
===========

  Ʊ ym2151.c  ym2151.h ϡJarek Burczynski
  <s0246@goblin.pjwstk.waw.pl> ᤬ "MAME" Ѥ줿Τ
  ܥƥѤ˼㴳ΤǤMAME ΤӤ۾
  ĤƤϡxmame project homepage <http://xmame.retrogames.com/> 
  ȤƤ


AVAILABILITY
============

  mdxplay κǿǤϡʲ URL é֤ƤϤǤ

             http://member.nifty.ne.jp/Breeze/index.html


REFERENCES
==========

  ɤƱʪޤ¿ͤ:

  Programmer's Guide to Yamaha YMF 262/OPL3 FM Music Synthesizer
               ( Vladimir Arnost, QA-Software <xarnos00@dcse.fee.vutbr.cz> )
  Programming the AdLib/Sound Blaster FM Music Chips
               ( Jeffrey S. Lee <jlee@smylex.uucp> )
  mdxform.doc  (   )
  MXDRVWIN.PAS ( Moonlight <monlight@tkb.att.ne.jp> )
  Linux I/O ݡȥץߥ
               ( Riku Saikkonen <rjs@spider.compart.fi> )
               ( ܸ:  <kei@sm.sony.co.jp> )
  Inside X68000
               ( Masahiko Kuwano, SOFTBANK, 1992 )


AUTHORS
=======

 Original authors in X68k:
  milk.K, K.MAEKAWA, Missy.M

 Linux / UNIX port:
  NAGANO Daisuke < breeze.nagano@nifty.ne.jp >
  http://member.nifty.ne.jp/Breeze/index.html

 YM2151 Emulator:
  Jarek Burczynski <s0246@goblin.pjwstk.waw.pl>
