content: ;
  ;	HSP help manager用 HELPソースファイル
  ;	(先頭が「;」の行はコメントとして処理されます)
  ;
  %ver
  3.7
  %date
  2021/05/31
  %group
  入出力制御命令
  
  %type
  ユーザー拡張命令
  
  %note
  hgimg4.as(hgimg4dx.as)およびmod_posteffect.asをインクルードすること。
  
  %author
  onitama
  %dll
  mod_posteffect
  %url
  https://hsp.tv/make/hgimg4.html
  %port
  Win
  %portinfo
  Windows/Linux/android/iOS等HGIMG4をサポートするシステム上で動作します。
  
  
  %index
  post_reset
  ポストエフェクト初期化
  %prm
  option
  option(0) : 初期化オプション
  %inst
  ポストエフェクトの初期化を行ないます。ポストエフェクトの初期化は、画面初期化時に１回だけ行います。
  mod_posteffectモジュールによるポストエフェクトは、必ずHGIMG4ランタイム上で実行する必要があります。
  optionで設定した内容によって初期化の内容が変わります。
  ^p
  	オプション値  内容
  	-------------------------------------------------------------------------
  	POST_RESET_OWNDRAW         ポストエフェクトの描画をユーザー自身で行う
  	POST_RESET_POSTLAYER       GUIレイヤーをポストエフェクトに含める
  ^p
  通常は、初期化オプションは省略しておいて問題ありません。
  ポストエフェクトの初期化が完了すると、ウインドウID1をポストエフェクト用の描画ウインドウとしてシステムが確保します。(また、エフェクト用のバッファとしてID64以降が使用されます。)
  通常は3Dで描画される画面(gpdraw命令で描画される画面)がポストエフェクトの対象となり、2D直接描画(mes命令など)は対象となりません。オプションにPOST_RESET_POSTLAYERを指定した場合は、2D直接描画も対象となります。
  ポストエフェクトを使用する際には、redraw 0〜redraw 1という画面更新の代わりに、post_drawstart〜post_drawendを使用して更新を行ってください。
  post_drawendが実行された際に、自動的にそれまで描画された画面に対してポストエフェクトを反映させます。
  オプションにPOST_RESET_OWNDRAWを指定した場合は、post_drawend実行時にポストエフェクトの描画を行いません。この場合は、ユーザー自身でウインドウID0を更新してポストエフェクトを描画を行う必要があります。
  %href
  post_select
  post_drawstart
  post_drawend
  
  
  %index
  post_select
  ポストエフェクトIDを指定
  %prm
  id
  id(0) : ポストエフェクトID
  %inst
  ポストエフェクトIDを指定して、画面の効果を有効にします。 
  必ずpost_reset命令によりポストエフェクトの初期化を行なっておく必要があります。
  ポストエフェクトIDは、以下のような値を指定することができます。
  ^p
  	ID               内容                オプション
  	-------------------------------------------------------------------------
  	POSTID_NONE      なし
  	POSTID_SEPIA     セピア
  	POSTID_GRAY      グレースケール
  	POSTID_BLUR      ぼかし              level(4.0)
  	POSTID_BLUR2     ぼかし(高品質)      level(6.0)
  	POSTID_MOSAIC    モザイク
  	POSTID_CONTRAST  コントラスト        level(2.0),bright(-0.2)
  	POSTID_SOBEL     輪郭抽出
  	POSTID_CRT       ブラウン管          湾曲率X(0.5),湾曲率Y(0.4)
  	POSTID_OLDFILM   古いフィルム
  	POSTID_GLOW      グロー              rate(64),bright(0.3)
  	POSTID_GLOW2     グロー(高品質/加算) rate(128),cutoff(0.5),level(10)
  	POSTID_GLOW3     グロー(高品質)      rate(128),cutoff(0.5),level(10)
  	POSTID_CUTOFF    カットオフ          ratio(0.8)
  ^p
  ポストエフェクトIDを有効にした後は、post_setprm命令により効果ごとのオプション値を設定することができます。(上表のオプション項目にあるパラメーターを指定できます。カッコ内はデフォルト値です。)
  %href
  post_reset
  post_setprm
  
  
  %index
  post_setprm
  ポストエフェクトオプションを指定
  %prm
  p1,p2,p3
  p1(0.0) : ポストエフェクトパラメーター1(実数)
  p2(0.0) : ポストエフェクトパラメーター2(実数)
  p3(0)   : ポストエフェクトパラメーター3(整数)
  %inst
  post_select命令で設定されたポストエフェクトに付随するオプション値を設定します。
  オプション値は、設定されたポストエフェクトの効果を調整することができるもので、ポストエフェクトの種類により設定可能なオプションが異なります。
  %href
  post_select
  
  
  %index
  post_drawstart
  ポストエフェクト用の画面描画開始
  %inst
  ポストエフェクトモジュール使用時に画面描画開始のタイミングを指定します。
  必ずpost_reset命令によりポストエフェクトの初期化を行なっておく必要があります。
  ポストエフェクトを使用する際には、redraw 0〜redraw 1という画面更新の代わりに、post_drawstart〜post_drawendを使用して更新を行ってください。
  %href
  post_drawend
  
  
  %index
  post_drawend
  ポストエフェクト用の画面描画終了
  %inst
  ポストエフェクトモジュール使用時に画面描画終了のタイミングを指定します。
  必ずpost_reset命令によりポストエフェクトの初期化を行なっておく必要があります。
  ポストエフェクトを使用する際には、redraw 0〜redraw 1という画面更新の代わりに、post_drawstart〜post_drawendを使用して更新を行ってください。
  %href
  post_drawstart
  
  
  %index
  post_getname
  ポストエフェクト名を取得
  %prm
  var
  var : 結果が代入される変数名
  %inst
  現在有効になっているポストエフェクトの名称をvarで指定された変数に代入します。
  ポストエフェクト名は文字列として代入されます。
  %href
  post_getmaxid
  post_select
  
  
  %index
  post_getmaxid
  ポストエフェクトID最大値を取得
  %prm
  var
  var : 結果が代入される変数名
  %inst
  varで指定された変数にポストエフェクトIDとして使用できる最大値を代入します。
  ポストエフェクトIDは、post_selectで指定するポストエフェクトの種別になります。
  %href
  post_getname
  post_select
  
  
  