東方弾幕風ph3 β1〜専用
自機スクリプトフレームワークのような物体
「RAINS3」　概要と手引き


▼もくじ
0.--これは何？
1.--主な機能
2.--使い方
3.--素材利用に関して
4.--戯言
5.--更新履歴


▼0.これは何？
　スクリプト内で、自機及び装備をリアルタイムに変更することが出来る
　自機スクリプトのフレームワークのようなものです。
　それぞれの自機スクリプトは単体での動作も可能です。
　ScriptVersionV2（〜0.12m）用に作られた自機スクリプトフレームワーク
　「RAINS」のph3移植版となります。

　@Eventにも対応。共通の動作と各自機固有の動作をそれぞれ設定できます。

　共通データを完全に廃止しました。ユーザーイベントと自機オブジェクトのキー(Value)でやりとりを行います。


▼1.主な機能

（これらの機能に対応した自機スクリプトを、以下「RAINS3」と呼ぶことにします。）

◆スクリプト内での自機＆装備選択・変更機能
	ステージスクリプト内に自機・装備選択機能を実装すれば、
	選択した自機や装備にいつでも変更することが出来ます。
	また、自機だけではなく、装備のみを変更することも出来ます。

◆単体動作機能
	RAINS3に含まれる全ての自機・装備は、通常のスクリプトにおいて
	単体で使用することが出来ます。

◆「自機」と「装備」という仕切り
	これまでの自機フレームワークは、キャラが同じでも装備が異なると
	別の自機として扱われ、画像・効果音・スクリプトを余分に用意するようになっていましたが、
	RAINS3は装備が異なってもキャラが同じならスクリプトや画像などを共有することが出来ます。

◆RAINSの情報取得機能
	ステージ・敵スクリプト側から、使用中の自機ID（≠自機オブジェクトID）や装備の番号などを取得できます。

◆自機スクリプト認証機能
	自機＆ステージスクリプト間での相互認証により、
	RAINS3非対応のスクリプトで使用できなくしたり、
	逆にRAINS3以外の自機スクリプトをステージスクリプト側から拒否することが出来ます。

◆専用アイテム機能
	ステージ及び敵スクリプトから、自機スクリプトのユーザーイベントで呼び出され、
	自機サイドで動作するこのフレームワーク専用のアイテムを作成することが出来ます。
	アイテムの挙動や取得時の処理なども個別に設定可能です。

	ph3にはユーザー定義アイテムが実装される可能性がありますが、
	RAINS3で特定のステージスクリプト専用の自機を作り、
	自機＆ステージとアイテムの動作を連動させたい場合は
	ユーザー定義アイテムよりもこちらが良いと思い、この機能を残してあります。

◆画像先読み機能
	選択された自機が動作を開始する前に、画像データを先読みさせることが出来ます。
	同一フレーム内で一括で読み込むのではなく、数フレーム毎に1枚ずつ読み込むため、
	うまく使えば自機動作開始時の負荷を軽減することができるでしょう。


◆その他の機能
	・ライブラリ「libs.dnh」の機能を使うことで、
	　自機ショットに対する判定を持つ敵だけを追尾する誘導弾（ph3の機能で精度が大幅に向上）
	　実装がややこしい環状＆筒状のエフェクトの簡単な実装等が行えます。
	・素の状態では存在しない「決死結界」「凝った被撃墜演出」「ディゾルブスペル」などを
	　サポートしています。


▼2.使い方

　RAINS3は自機側とステージ・敵側で相互にデータのやり取りや認証を行うため、
　ステージスクリプトには「RAINS_Client_Stage.dnh」をインクルードさせて、
　@Initializeで「Initialize_RAINS3_Client」を実行してください。（実行しないと認証に失敗します）
　敵スクリプト側でRAINSの情報を参照したり、独自アイテムを放出させたい場合は
　「RAINS_Client_Enemy.dnh」を敵スクリプトにインクルードさせてください。
（自機の単体動作時は不要）

　自機の切り替えサンプルは、「RAINS3_ClientTest」内のステージスクリプトにあります。

　自機スクリプトに関しては、あらかじめ用意されているサンプル自機2機（×装備2種類ずつ）および
　共通スクリプト、RAINSスクリプトをそれぞれご覧ください。
　（「ファイルとスクリプトの構造.txt」に、スクリプトの構造と一覧が載っています。）

　◆使用上の注意
　　以下のユーザーイベント値はRAINS3のシステムで使用されるため、
　　NotifyEventAllで呼び出さないでください！
　　　
　　　EV_USER + 10001　〜　EV_USER + 10201


▼3.素材利用に関して

　「幻想装備機体」とは異なり、
　この配布データに含まれる画像・スクリプトは素材として利用できます。
　（効果音は「pinch.wav」のみ素材利用可能）


▼4.戯言

◆ToDo

　システムスクリプトとの連動機能
　・自機認証をステージスクリプトからではなく、システムスクリプトからも出来るようにする


▼5.更新履歴
（★…重要な更新）

★Ver0.1
　・自機画像の先読み機能を実装。
　　使い方次第で画像読み込み時の負荷を軽減することが出来ます。
　・ユーザーキー実装に伴うlibs.dnhのアップデート
　・libs.dnhにSetPolygon_Pipe2を追加。z座標を計算するタイプの筒状エフェクト設定関数
　★共通データを完全廃止。ユーザーイベントと自機オブジェクトのキーでやりとりを行うように

★Ver0.01α
　・最初のリリース



	"RAINS" and "RAINS3" are Created by 507@G-わんげプロジェクト