         Winamp Input Plugin for PSX SPU Event Log File
                  Version 0.1 by Takashi Yano

                         Jul. 15, 2006
                 Copyright (C) by Takashi Yano
                   <takashi.yano@nifty.ne.jp>


1. はじめに Introduction

このソフトウェアは、商用ゲーム機 SONY PlayStation(R) のエミュ
レータ用のSPU (Sound Processing Unit) Plugin である Eternal SPU
Pluginが出力するSPUログファイルを再生するためのものであり、
Nullsoft Winamp の Input Pluginとして動作します。

This software is an input plugin for Nullsoft Winamp. This
plugin enables to play SPU event log file generated by Eternal
SPU Plugin, which is one of SPU plugins for SONY PlayStation(R)
emulators.


2. 配布ファイル Files

  in_psspu.dll: Plugin本体 program body
  readme.txt  : 説明書 (このファイル)

  in_psspu.dll: Program body
  readme.txt  : Manual (This file)


3. 動作環境 Environment

本ソフトウェアを動作させるには、別途、
  1) Nullsoft Winamp 2 または 5
  2) Eternal SPU Plugin または他の同等の SPU Plugin
が必要になります。SPU PluginはSPUrender()をサポートしているもの
を推奨します。SPUrender()をサポートしないSPU Pluginでは、Winamp
Output Pluginを経由した再生が出来ず、SPU Pluginによる直接再生と
なるため、機能的な制限が発生します。特に理由が無い限り、最新版の
Eterna SPU Pluginを使用することをお勧めいたします。

This software requires both of:
  1) Nullsoft Winamp 2 or 5
  2) Eternal SPU Plugin or compatible
The SPU plugin which supports SPUrender() is recommended. In
case without SPUrender(), some functional restrictions are
caused since sound data is directly played by SPU plugin
without going through Winamp Output Plugin. The latest Eternal
SPU Plugin is strongly recommended for normal use.


4. インストール Installation

Input Plugin本体 (in_psspu.dll) とSPU Plugin (spuEternal.dll) の
両方をWinampのPluginsフォルダに入れてください。SPU Pluginは必ず
"spuEternal.dll"というファイル名でなくてはなりません。正しくイン
ストールされればWinamp の Preferences でInput Plug-insのリストに
表示されるはずです。

Put both of input plugin body (in_psspu.dll) and SPU Plugin
(spuEternal.dll) into Winamp Plugins folder. The file name of
SPU Plugin have to be "spuEternal.dll". It would appear in
Input Plug-ins List of Winamp Preferences dialog if properly
installed.


5. 使い方 Usage
5.1 基本的な使い方 Basic Usage

通常の使い方をする限りにおいて、特に説明は必要ないでしょう。一点
だけ通常のInput Pluginと違うのは、標準Visualization表示エリアに
SPUのVoiceチャネルのレベル表示が可能な点です。これは、Skinとして
旧Winamp 2.x形式のものが使われていて、かつ、Visualizationをオフ
に設定した場合に表示されます。左から24本のバーがVoiceチャネル0〜
23、一番右側のバーがXA/CDDAのレベルになります。

SPUログファイルのファイル名は、
  1) *.spu
  2) *.spu.gz (gzip圧縮形式)
のいずれかにして下さい。gzip圧縮形式のファイル名は、*.spu でも問
題ありません。

No explanation will be necessary in normal use. Only one
difference from normal input plugin is that the voice channel
levels can be displayed on standard visualization area. It
appears when the visualization is off and the skin is for
winamp 2.x. The left 24 bars are the level of voice channel 0-
23 and the right one bar is for XA/CDDA level.

The name of SPU event log file should be:
  1) *.spu
  2) *.spu.gz (compressed by gzip)
*.spu is also allowed even if it is a compressed log file.


5.2 高度な使い方 Advanced Usage

WinampのPreferencesからconfigureによって開かれるダイアログボック
スにて特殊な設定を行うことが出来ます。通常の再生においては、特に
設定を行う必要はありません。また、ここで行う設定は、Winampを起動
している間だけ保持されます。Winampを再起動すると、全ての設定は初
期値に戻ります。

なお、この設定ダイアログボックスは、再生開始操作、または、停止操
作をマウスの右ボタンを押しながら行うことでも開くことが出来ます。

Some special settings are in the configuratin dialog box of
Winamp input plug-ins. All setting are initialized to default
values in starting up.

This dialog can also be opened if the right mouse button is
held down in starting/stopping playing.


Tempo: (default: 1.0)
SPU EventをSPU Pluginに渡すレートを調整します。結果的に再生速度
が変化します。0.5倍から2倍までが設定できます。ただし、再生速度を
変更した場合、ストリーム音声(XA, VAGストリーム)については不自然
な音になることがあります。

Use Winamp Output: (default: on)
Winamp Outputを使った(通常の)再生を行うかどうかを設定します。
Winamp Outputを使うには、SPU PluginがSPUrender()に対応している必
要があります。使用中のSPU PluginがSPUrender()をサポートしない場
合、本項目は設定できません。

Ch.Vol. on analyzer: (default: off)
標準Visualization表示のスペクトルアナライザ表示の代わりに、SPUの
Voiceチャネルのレベル表示を行います。Visualizationモードがoffの
時に表示されるレベル表示と同じですが、"Use Winamp Output"がoffの
時やSPU PluginがSPUrender()をサポートしない場合には、スペクトル
アナライザが表示されなくなるので、その代替として表示するようにす
るモードです。"Use Winamp Output"やSPU Pluginの設定の際に、自動
的に推奨設定になります。

SPU Pluginの選択: (default: Plugins\spuEternal.dll)
WinampのPlugins フォルダにあるspuEternal.dllに代えて、指定した
SPU Pluginを使用できるようになります。選択直後に、SPU Pluginの設
定画面が開かれますので、必要なら設定を変更してください。

Control Volume using SPU Main Volume: (defult: on)
"Use Winamp Output"がoffの時のSPU Pluginによる直接再生時の音量制
御方法についての設定です。onの時は、SPUのMain Volumeを使って、音
量、パン(左右バランス)を制御します。offの時は、全Voiceチャネルそ
れぞれのVolumeを一斉に制御することで、音量、パン(左右バランス)を
制御します。Main Volumeをきちんと実装していないSPU Pluginでも音
量制御が出来るようにするための設定です。ただし、各Voiceチャネル
のVolumeは、リバーブ機構の前に位置するため、制御時、リバーブが不
自然になる場合があります。"Use Winamp Output"がonの時は、Winamp
内部の音量制御機構を使うため、本設定は出来ません。

Default:
全ての設定を起動時の初期値に戻します。


6. 本ソフトウェアの取り扱いについて About this Software

本ソフトウェアは、フリーソフトウェアとします。本ソフトウェアの使
用に当たって、作者はいかなる料金の支払いをも要求しません。また、
作者は本ソフトウェアを使用した結果についていかなる責任をも負いま
せん。不具合の修正の責務も負いません。
再配布は、オリジナルのアーカイブのままの形であれば自由に行って構
いません。改変したものを配布する場合には、改変箇所を明示するとと
もに、本ソフトウェアがオリジナルであることを明らかにして下さい。

This software is a free software. The author of this software
never requests any fee for use of this software. The author is
not responsible for any result on use of this software. The
author has no obligation to fix even if some problem exist in
the software.
The redistribution is allowed as long as it is the original
archive. In the case of redistribution of modified version,
please clarify the original and the modification points.


7. 著作権 Copyright

本ソフトウェアの著作権は、作者である下記の者が保有します。

  矢野 隆 (Takashi Yano)
  takashi.yano@nifty.ne.jp

Copyright (C) Takashi Yano <takashi.yano@nifty.ne.jp>
All rights reserved.


8. その他 Miscellaneous

・PlayStationは Sony Computer Entertainment Inc.の登録商標です。
・Winampは、Nullsoft社が開発したフリーソフトウェアの名称です。
・Eternal SPU PluginはPSX SPU Plugin Development Projectが開発した
  PlayStationエミュレータ用SPU Pluginの名称です。

- PlayStation is a registered trademark of Sony Computer
  Entertainment Inc.
- Winamp is a name of free software developed by Nullsoft Inc.
- Eternal SPU Plugin is a SPU Plugin for PlayStation emulator
  developed by PSX SPU Plugin Development Project.


9. 来歴 History

Version 0.1:
・公開初版 First release