post_reset

ポストエフェクト初期化

post_reset option

option(0) : 初期化オプション

(プラグイン / モジュール : mod_posteffect)

解説

ポストエフェクトの初期化を行ないます。ポストエフェクトの初期化は、画面初期化時に1回だけ行います。
mod_posteffectモジュールによるポストエフェクトは、必ずHGIMG4ランタイム上で実行する必要があります。
optionで設定した内容によって初期化の内容が変わります。

	オプション値  内容
	-------------------------------------------------------------------------
	POST_RESET_OWNDRAW         ポストエフェクトの描画をユーザー自身で行う
	POST_RESET_POSTLAYER       GUIレイヤーをポストエフェクトに含める

通常は、初期化オプションは省略しておいて問題ありません。
ポストエフェクトの初期化が完了すると、ウインドウID1をポストエフェクト用の描画ウインドウとしてシステムが確保します。(また、エフェクト用のバッファとしてID64以降が使用されます。)
通常は3Dで描画される画面(gpdraw命令で描画される画面)がポストエフェクトの対象となり、2D直接描画(mes命令など)は対象となりません。オプションにPOST_RESET_POSTLAYERを指定した場合は、2D直接描画も対象となります。
ポストエフェクトを使用する際には、redraw 0~redraw 1という画面更新の代わりに、post_drawstartpost_drawendを使用して更新を行ってください。
post_drawendが実行された際に、自動的にそれまで描画された画面に対してポストエフェクトを反映させます。
オプションにPOST_RESET_OWNDRAWを指定した場合は、post_drawend実行時にポストエフェクトの描画を行いません。この場合は、ユーザー自身でウインドウID0を更新してポストエフェクトを描画を行う必要があります。

関連項目

post_selectポストエフェクトIDを指定(mod_posteffect)
post_drawstartポストエフェクト用の画面描画開始(mod_posteffect)
post_drawendポストエフェクト用の画面描画終了(mod_posteffect)

サンプル逆引き (3)

boxf_snake.hsp
light_test5eff.hsp
posteffect.hsp

情報

プラグイン / モジュールmod_posteffect
バージョン3.7
作成日2021/05/31
著作者onitama
URLhttps://hsp.tv/make/hgimg4.html
備考hgimg4.as(hgimg4dx.as)およびmod_posteffect.asをインクルードすること。
タイプユーザー拡張命令
グループ入出力制御命令
対応環境
  • Windows 版 HSP
移植のヒントWindows/Linux/android/iOS等HGIMG4をサポートするシステム上で動作します。
hs ファイルhsphelp\mod_posteffect.hs