content: ;
  ;	HSP help manager用 HELPソースファイル
  ;	(先頭が「;」の行はコメントとして処理されます)
  ;
  
  %type
  拡張命令
  %ver
  3.7
  %note
  hsp3dish.asをインクルードすること。
  
  %date
  2022/06/02
  %author
  onitama
  %dll
  HSP3Dish
  %url
  http://hsp.tv/
  %port
  Win
  %group
  拡張入出力制御命令
  
  
  %index
  setreq
  システムリクエスト設定
  %prm
  type,val
  type(0) : 設定タイプ(SYSREQ_???)
  val(0)  : 設定する値
  %inst
  HSP3Dishランタイムに対して様々なシステム設定を行ないます。
  設定タイプ名で指定できるのは以下のシンボルです。
  ^p
  	設定タイプ名             読み書き(*)   内容
  ---------------------------------------------------------------------------
  	SYSREQ_MAXMODEL          RW            HGIMG3最大モデル数
  	SYSREQ_MAXOBJ            RW            HGIMG3/4最大オブジェクト数
  	SYSREQ_MAXTEX            RW            HGIMG3/4最大テクスチャ数
  	SYSREQ_MAXMOC            RW            HGIMG3最大MOC数
  	SYSREQ_DXMODE            RW            DirectXモード(Windowsのみ)
  	SYSREQ_DXHWND            R             DirectXウインドウハンドル(Windowsのみ)
  	SYSREQ_DXWIDTH           RW            DirectXフルスクリーンXサイズ(Windowsのみ)
  	SYSREQ_DXHEIGHT          RW            DirectXフルスクリーンYサイズ(Windowsのみ)
  	SYSREQ_COLORKEY          RW            DirectXカラーキー(Windowsのみ)
  	SYSREQ_RESULT            R             DirectX初期化結果(Windowsのみ)
  	SYSREQ_RESVMODE          R             DirectXビデオ初期化結果(Windowsのみ)
  	SYSREQ_PKTSIZE           RW            パケットサイズ(未使用)
  	SYSREQ_MAXEVENT          RW            HGIMG3/4最大イベント数
  	SYSREQ_PTRD3D            R             Direct3Dクラスポインタ(Windows/HGIMG3のみ)
  	SYSREQ_PTRD3DDEV         R             Direct3DDeviceクラスポインタ(Windows/HGIMG3のみ)
  	SYSREQ_MDLANIM           RW            モデルあたりのアニメーション最大数(HGIMG3)
  	SYSREQ_CALCNORMAL        RW            Xファイルモデル法線再計算スイッチ(HGIMG3)
  	SYSREQ_2DFILTER          RW            2D描画時のテクスチャ補間モード(HGIMG3)
  	SYSREQ_3DFILTER          RW            3D描画時のテクスチャ補間モード(HGIMG3)
  	SYSREQ_OLDCAM            RW            カメラ注視モードの動作(HGIMG3)
  	SYSREQ_QUATALG           RW            Xファイルモデルアニメーション補間モード(HGIMG3)
  	SYSREQ_DXVSYNC           RW            フルスクリーンモード時のVSYNC待ちモード(HGIMG3)
  	SYSREQ_DEFTIMER          RW            hgsyncの時間待ちモード(HGIMG3)
  	SYSREQ_NOMIPMAP          RW            テクスチャのMIPMAP生成モード(HGIMG3)
  	SYSREQ_DEVLOST           RW            DirectXデバイスの存在フラグ
  	SYSREQ_MAXEMITTER        RW            HGIMG3エミッター最大数
  	SYSREQ_THROUGHFLAG       RW            X方向のボーダー処理フラグ(HGIMG3)
  	SYSREQ_OBAQMATBUF        RW            OBAQ用マテリアルバッファ数(HGIMG3)
  	SYSREQ_2DFILTER2         RW            2D直接描画時のテクスチャ補間モード(HGIMG3)
  	SYSREQ_FPUPRESERVE       RW            FPU演算精度設定オプション(HGIMG3)
  	SYSREQ_CLSMODE           RW            背景のクリアフラグ
  	SYSREQ_CLSCOLOR          RW            背景クリア色
  	SYSREQ_CLSTEX            RW            背景クリアテクスチャID(HGIMG3)
  	SYSREQ_TIMER             R             ミリ秒単位のタイマー値
  	SYSREQ_PLATFORM          R             HSP3Dishを実行しているプラットフォーム
  	SYSREQ_FPS               R             フレームレート(HGIMG4)
  	SYSREQ_VSYNC             RW            VSync待ちモード(HGIMG4)
  	SYSREQ_MAXMATERIAL       RW            HGIMG4最大マテリアル数
  	SYSREQ_PHYSICS_RATE      RW            OBAQ用物理パラメーター(OBAQ)
  	SYSREQ_MAXOBAQ           RW            OBAQ用オブジェクト最大数(OBAQ)
  	SYSREQ_MAXLOG            RW            OBAQ用コリジョンログ最大数(OBAQ)
  	SYSREQ_DEFAULT_WEIGHT    RW            OBAQ用デフォルトWeight値(OBAQ)
  	SYSREQ_DEFAULT_MOMENT    RW            OBAQ用デフォルトMoment値(OBAQ)
  	SYSREQ_DEFAULT_DAMPER    RW            OBAQ用デフォルトDamper値(OBAQ)
  	SYSREQ_DEFAULT_FRICTION  RW            OBAQ用デフォルトFriction値(OBAQ)
  	SYSREQ_MESCACHE_MAX      RW            メッセージキャッシュ最大数(HSP3Dish)
  	SYSREQ_DLIGHT_MAX        RW            ディレクショナルライト最大数(HGIMG4)
  	SYSREQ_PLIGHT_MAX        RW            ポイントライト最大数(HGIMG4)
  	SYSREQ_SLIGHT_MAX        RW            スポットライト最大数(HGIMG4)
  	SYSREQ_LOGWRITE          RW            終了時のログ出力スイッチ(HGIMG4)
  	SYSREQ_FIXEDFRAME        RW            固定フレームレートスイッチ(HGIMG4)
  	SYSREQ_DRAWNUMOBJ        R             描画されたオブジェクト数(HGIMG4)
  	SYSREQ_DRAWNUMPOLY       R             描画されたポリゴン数(HGIMG4)
  	SYSREQ_USEGPBFONT        RW            gpbフォント使用スイッチ(HGIMG4)
  	SYSREQ_FIXMESALPHA       RW            文字描画alpha値固定モード(HSP3Dish)
  	SYSREQ_OLDBOXF           RW            従来のboxf描画モード(HSP3Dish)
  
  	(*)項目ごとに、読み(R)書き(W)の可否が異なります
  ^p
  
  ・SYSREQ_CLSMODE、SYSREQ_CLSCOLOR
  
  redraw 0による描画開始時に画面をクリアするかどうかを設定します。 SYSREQ_CLSMODEに1を設定した場合はクリア、0の場合はクリアを行ないません。 スクリプト内で画面のクリアを行なっている場合は、システム側で背景クリアをしない方が 処理速度の向上につながります。 SYSREQ_CLSCOLORでクリアする際の色コードを設定することができます。 色コードは、RGB24bit($rrggbb)を1つにした数値で設定します。
  
  ・SYSREQ_TIMER
  
  ミリ秒単位のタイマー値を返します。 プラットフォームごとに返される値は異なりますが、1ミリ秒につき1ずつ値が加算されていきます。
  
  ・SYSREQ_PLATFORM
  
  以下のHSP3Dishプラットフォーム値を返します。
  ^p
  	マクロ名            値  内容
  	-------------------------------------------
  	PLATFORM_WINDOWS    0   Windows版
  	PLATFORM_IOS        1   iOS版
  	PLATFORM_ANDROID    2   android版
  	PLATFORM_WEBGL      3   hsp3dish.js(WebGL/JavaScript)版
  	PLATFORM_LINUX      4   Linux版
  	PLATFORM_RASPBIAN   5   Raspberry Pi(raspbian)版
  ^p
  
  %href
  getreq
  
  
  %index
  getreq
  システムリクエスト取得
  %prm
  var,type
  var  : 結果が代入される変数名
  type : 設定タイプ(SYSREQ_???)
  %inst
  HSP3Dishランタイムが保持するシステム設定を取得して変数に代入します。
  設定タイプ名で指定できる名称は、setreq命令と同様です。
  
  %href
  setreq
  
  
  %index
  gfilter
  テクスチャ補間の設定
  %prm
  type
  type : 設定タイプ(FILTER_???)
  %inst
  HSP3Dishランタイムが描画を行なう際の、テクスチャ補間(フィルタリング)の設定を行ないます。
  設定タイプ名で指定できる名称は、以下の通りです。
  ^p
  	マクロ名        値      内容
  	-------------------------------------------
  	FILTER_NONE     0       補間なし(NEAREST)
  	FILTER_LINEAR   1       直線補間(LINEAR)
  	FILTER_LINEAR2  2       エリア補間(高度な補間処理)
  ^p
  フィルタリングの設定により、画像の拡大・縮小時のドット補間方法を 選ぶことができます。FILTER_NONEを指定することで、補間なし(ニアレスト) の状態になります。FILTER_LINEARは、直線(リニア)補間、FILTER_LINEAR2は より高度な補間方法(バイリニアなど)を選択します。 gfilter命令の設定は、以降のすべての描画命令に適用されます。 また、「redraw 0」による画面クリア時には、フィルタリング設定は FILTER_NONEにリセットされます。
  
  %href
  gcopy
  grotate
  gsquare
  celput
  
  
  %index
  mtlist
  ポイントIDリスト取得
  %prm
  var
  var  : 結果が代入される変数名
  %inst
  現在タッチされている情報を持つポイントIDリストを取得します。
  ポイントIDリストは、複数のポイントIDを返すもので、マルチタッチによる複数のポイントを含む情報になります。
  mtlist命令が実行されると、その時点で押されている(触れている)すべてのポイントID(整数値)を、varで指定した変数に配列として代入します。
  たとえば、ID0とID2、ID3の３つの情報があれば、var(0)に0、var(1)に2、var(2)に3という値が代入されることになります。
  代入されたポイントIDの数は、システム変数statに返されます。
  この命令で得られたポイントIDを使用して、mtinfo命令で詳細なタッチ情報を取得することができます。
  マルチタッチの情報を取得するためには、それぞれのデバイスでマルチタッチの設定を有効にする必要があります。
  また、Windows上では、Windows7以降のマルチタッチに対応したデバイスが必要になります。
  
  %href
  mtinfo
  
  
  %index
  mtinfo
  タッチ情報取得
  %prm
  var,id
  var  : 結果が代入される変数名
  id(0): ポイントID
  %inst
  指定されたポイントIDに関連付けられたタッチ情報を取得します。
  タッチ情報は、varで指定した変数に配列として代入されます。
  ^p
  	要素値  内容
  	-------------------------------------------
  	  0     タッチ状態(1=ON/0=OFF)
  	  1     タッチされたX座標
  	  2     タッチされたY座標
  	  3     タッチ識別用ID
  ^p
  つまり、var(1)にはタッチされたX座標が、var(0)にはタッチの状態(1ならば押されている)が代入されます。
  varで指定された変数は必ず整数型の配列変数として初期化されます。
  var(3)のタッチ識別用IDは、他のタッチと識別するための整数値です。この値は、デバイスごとに異なります。
  
  %href
  mtlist
  
  
  %index
  devinfo
  デバイス情報文字列取得
  %prm
  var,"name"
  var    : 結果が代入される変数名
  "name" : デバイス情報名
  %inst
  特定のOS、及びデバイスに依存した情報を取得します。
  文字列"name"で示された情報を、varで指定した変数に代入します。(代入される情報は文字列となります。)
  実行後に、正しく情報が取得された場合は、システム変数statが0以上になります。
  情報が存在しないか、エラーが発生した場合はシステム変数statがマイナスの値となります。
  
  %href
  devinfoi
  
  
  %index
  devinfoi
  デバイス情報値取得
  %prm
  var,"name"
  var    : 結果が代入される変数名
  "name" : デバイス情報名
  %inst
  特定のOS、及びデバイスに依存した情報を取得します。
  文字列"name"で示された情報を、varで指定した変数に代入します。(代入される情報は整数型の配列となります。)
  実行後に、正しく情報が取得された場合は、システム変数statが0以上になります。
  情報が存在しないか、エラーが発生した場合はシステム変数statがマイナスの値となります。
  
  %href
  devinfo
  
  
  %index
  devprm
  デバイス制御用のパラメーター設定
  %prm
  "name","value"
  "name" : パラメーター名を示す文字列
  "value" : 設定する文字列
  %inst
  devcontrol命令によりデバイス制御する際のパラメーター(付加情報)を設定します。
  実行後に、正しく実行が行なわれた場合は、システム変数statが0以上の値になります。
  パラメーターが存在しないか、エラーが発生した場合はシステム変数statがマイナスの値となります。
  
  %href
  devcontrol
  
  
  %index
  devcontrol
  デバイス制御を実行する
  %prm
  "command",p1,p2,p3
  "command" : コマンド名を示す文字列
  p1(0)     : 制御パラメーター1
  p2(0)     : 制御パラメーター2
  p3(0)     : 制御パラメーター3
  %inst
  特定のOS、及びデバイスに依存したデバイス制御を実行します。
  実行後に、正しく実行が行なわれた場合は、システム変数statが0以上の値になります。
  パラメーターが存在しないか、エラーが発生した場合はシステム変数statがマイナスの値となります。
  
  %href
  devprm
  
  
  %index
  setcls
  画面クリア設定
  %group
  拡張マルチメディア制御命令
  %prm
  mode,color
  mode(0)  : 画面クリアのモード
  color(0) : 画面クリア色(24bitRGBコード)
  %inst
  redraw 0による画面初期化時に行なわれる画面クリアのための設定を行ないます。
  mode値の設定により、画面クリアを行なうためのモードを設定します。
  CLSMODE_SOLIDまたは1を設定した場合はクリア、CLSMODE_NONEまたは0の場合はクリアを行ないません。
  スクリプト内で画面のクリアを行なっている場合は、システム側で背景クリアをしない方が処理速度の向上につながります。
  ^p
  	モード値  定義マクロ名         内容
  	-----------------------------------------------------------------
  	    0     CLSMODE_NONE         画面クリアを行なわない
  	    1     CLSMODE_SOLID        クリア色による画面クリアを行なう
  ^p
  colorでクリアする際の色を設定することができます。色は、rgbcolor命令のパラメーターと同様の24bitRGBコード($rrggbb)の数値で設定します。
  
  
  %href
  redraw
  rgbcolor
  
  
  %index
  celputm
  複数のセルをまとめて描画
  %group
  拡張マルチメディア制御命令
  %prm
  vxpos,vypos,vcelid,bufid,count
  vxpos    : 表示X座標が格納された整数型配列変数名
  vypos    : 表示Y座標が格納された整数型配列変数名
  vcelid   : セルIDが格納された整数型配列変数名
  bufid(0) : セルが格納されているバッファID
  count(1) : 配列変数から取り出す項目数
  %inst
  整数型の配列変数に代入された座標、セルIDをもとにcelputと同様の表示を配列要素ごとに実行します。
  配列に保存された複数の項目について、一度に処理が行なわれるため効率化と高速化につながります。
  countで配列変数から取り出す項目の数を指定します。配列変数からは、要素0から順番に値が取り出されます。
  vxposにはX座標、vyposにはY座標、vcelidにはセルIDが代入されている必要があります。
  セルIDがマイナス値の場合は、描画は行なわれません。
  celputm命令の実行後、実際に表示されたセルの数がシステム変数statに代入されます。
  
  %href
  celput
  
  
  %index
  httpload
  http通信の開始
  %group
  拡張入出力制御命令
  %prm
  "url","postdata"
  "url" : リクエストを行なうファイル名
  "postdata" : POSTを行なう際の文字列データ
  
  %inst
  指定されたURLに対して、http通信を開始します。
  この命令は、通信のリクエストを開始するだけで、すぐに結果は取得されません。
  通信の結果は、httpinfo命令を使用して正しくデータを受信したことを確認した上で、取得する必要があります。
  ^
  httploadは、通常は"url"の指定でリクエストを行なうURLスキーム(「http://www.onionsoft.net/about.html」のような文字列)を指定することで、HTTP通信を開始します。
  ^p
  ;例:
  ;	URLを指定して通信を開始する
  httpload "http://www.onionsoft.net/about.html"
  ^p
  CGIやWebAPIなどにアクセスするために、POST形式で通信を行なう場合は、"postdata"にパラメーター文字列を指定してください。
  ("postdata"の指定を省略した場合は、通常のGET形式によるHTTP通信が行なわれます。)
  ^p
  ;例:
  ;	URLを指定してPOST形式の通信を開始する
  httpload "http://www.onionsoft.net/hsp/beta/betabbs.cgi","mode=find&cond=and&log=0&word=script"
  ^p
  POST形式の通信は、"postdata"の形式や仕様については、CGIやhttpリクエストについての知識がある人に向けて用意されているものです。
  httpload命令が実行された後は、システム変数statにリクエスト処理が行なわれたかを示す数値が代入されます。
  システム変数statが、0の場合は正しくリクエストが完了しています。システム変数statが、0以外の場合は、エラーによりリクエストができなかったことを示しています。
  httpload命令で正常にhttp通信を開始した後は、httpinfo命令による受信確認とデータ取得処理をスクリプト側で行なう必要があります。
  。
  ^p
  ;例:
  	;	URLを指定して通信を開始する
  	httpload "http://www.onionsoft.net/about.html"
  	if stat : goto *bad	; 正しくリクエストができなかった
  *main
  	;	結果待ちのためのループ
  	httpinfo res,HTTPINFO_MODE		; 現在のモードを取得
  	if res = HTTPMODE_READY : goto *ok	; 通信が終了した
  	if res <= HTTPMODE_NONE : goto *bad	; エラーが発生した
  	await 50				; 時間待ちを行なう
  	goto *main
  *bad
  	;	エラー
  	httpinfo estr,HTTPINFO_ERROR		; エラー文字列を取得する
  	dialog "ERROR "+estr
  	stop
  *ok
  	;	完了
  	httpinfo buf,HTTPINFO_DATA		; 結果データを取得する
  	httpinfo size,HTTPINFO_SIZE		; データサイズを取得する
  ^p
  http通信によって取得されるデータは、変数が持つメモリに格納されます。
  大きなファイルを取得した場合は、そのサイズだけメモリが消費するので注意してください。
  あくまでも、メモリ上に取得できる範囲のサイズを想定した簡易的な通信の仕組みであることをご理解の上使用してください。
  Windows上であれば、HSPINETプラグインにより、さらに詳細なHTTP通信を行なうことが可能です。
  
  %href
  httpinfo
  
  
  %index
  httpinfo
  http通信の情報を取得
  %group
  拡張入出力制御命令
  %prm
  p1,p2
  p1    : データが代入される変数
  p2(0) : データの種別ID
  
  %inst
  http通信に関する情報を取得します。
  httpload命令による、http通信を行なった結果などを取得することができます。
  p2で指定された取得モードに対応する内容を、p1で指定された変数に代入します。
  取得モードの値は、以下の通りです。
  ^p
  	  種別ID              内容
  	------------------------------------------------------
  	HTTPINFO_MODE 0       現在の通信モード
  	HTTPINFO_SIZE 1       データサイズ
  	HTTPINFO_DATA 16      取得データ(*)
  	HTTPINFO_ERROR 17     エラー文字列(*)
  
  (*)の項目は、文字列型変数として代入されます。
  ^p
  受信データ(HTTPINFO_DATA)の読み出しを行なうと、受信データの内容はクリアされるので注意してください。
  無効な種別IDが指定された場合は、0または""(空の文字列)が返されます。
  ^
  通信モードの値は、以下の内容になっています。
  ^p
  	  通信モード値        内容
  	------------------------------------------------------
  	HTTPMODE_NONE         通信初期化エラー
  	HTTPMODE_READY        通信可能状態
  	HTTPMODE_REQUEST      リクエスト通信準備
  	HTTPMODE_SEND         リクエスト送信
  	HTTPMODE_DATAWAIT     通信結果待機中
  	HTTPMODE_DATAEND      通信終了
  	HTTPMODE_ERROR        エラー発生
  ^p
  
  %href
  httpload
  
  
  
  %index
  gmulcolor
  テクスチャ乗算値の設定
  %prm
  p1,p2,p3
  p1,p2,p3=0〜255(255) : 色コード（R,G,Bの輝度）
  %inst
  画像(テクスチャ)コピーを行なう際のカラー乗算値を指定します。
  p1,p2,p3がそれぞれ、R,G,Bの輝度になります。
  gcopy,gzoom,celput,grotate(画像使用時)などでコピーされる画像に対して、指定したR,G,B値が乗算されます。
  初期値は、RGBそれぞれ255が指定されています。テクスチャ乗算値を設定することにより、元の画像の色を変化させることができます。
  画像コピーの際に、gmode命令で指定されるコピーモードが0または1(アルファチャンネルを反映しない)の場合は、テクスチャ乗算値は無効になるので注意してください。
  テクスチャ乗算値は、mes命令による文字の描画、及びgsquare命令には反映されません。また、boxf,line命令など単色の描画には反映されません。
  
  %href
  color
  gcopy
  gzoom
  grotate
  gsquare
  celput
  
  
  
  
  %index
  viewcalc
  描画時の座標変換を設定
  %prm
  p1,p2,p3,p4,p5
  p1(0)   : 設定モード
  p2(0.0) : パラメーター1(実数)
  p3(0.0) : パラメーター2(実数)
  p4(0.0) : パラメーター3(実数)
  p5(0.0) : パラメーター4(実数)
  %inst
  2D描画時のX,Y座標に任意の計算を適用します。
  これにより、描画される表示物全体のスケーリングや移動、回転などを行うことができます。
  p1パラメーターで設定モードを指定します。
  設定モードにより、以降の設定される内容が変わります。
  ^p
  	マクロ名            値   内容
  	-----------------------------------------------------
  	vptype_off           0   座標変換なし(デフォルト)
  	vptype_translate     1   移動パラメーターを指定
  	vptype_rotate        2   回転パラメーターを指定
  	vptype_scale         3   スケールパラメーターを指定
  	vptype_3dmatrix      4   4×4マトリクスによる座標変換
  	vptype_2d            5   2D座標変換を設定
  	vptype_3d            6   3D座標変換を設定
  ^p
  vptype_2dは、基本的な2D座標変換を適用します。
  パラメーター1〜3で、X,Yのスケール(倍率)、回転角度(ラジアン単位)を設定することができます。
  ^p
  	viewcalc vptype_translate, 移動X, 移動Y
  	viewcalc vptype_2d, スケールX, スケールY, 回転角度(ラジアン)
  ^p
  vptype_3dは、3D空間上にマッピングして描画を適用します。
  移動、回転、スケールそれぞれのX,Y,Z値を指定することができます。
  ^p
  	viewcalc vptype_translate, 移動X, 移動Y, 移動Z
  	viewcalc vptype_rotate, 回転X, 回転Y, 回転Z
  	viewcalc vptype_scale, スケールX, スケールY, スケールZ
  	viewcalc vptype_3d, カメラ角度(FOV), NearZ値, FarZ値
  ^p
  vptype_3dmatrixは、4×4の行列(マトリクス)を指定して座標変換を行います。
  ユーザー自身でマトリクスを作成する場合に使用することができます。
  4×4のm00〜m33までのパラメーターを以下のように指定します。
  ^p
  	viewcalc vptype_translate, m00, m01, m02, m03
  	viewcalc vptype_rotate, m10, m11, m12, m13
  	viewcalc vptype_scale, m20, m21, m22, m23
  	viewcalc vptype_3dmatrix, m30, m31, m32, m33
  ^p
  viewcalc命令を設定した以降の描画に、座標変換が適用されます。
  画面の初期化時は、座標変換なし(vptype_off)が設定されています。
  vptype_3d及びvptype_3dmatrixにより変換設定した場合は、マウスの座標を正しく取得することができなくなるので注意してください。
  
  %href
  pos
  mes
  
  
  %index
  celbitmap
  変数バッファを画像データとして適用する
  %prm
  p1,var,p2
  p1(0)   : ウインドウID
  var     : イメージを置き換えるための配列変数
  p2(0)   : 動作オプション
  %inst
  変数バッファの内容を画像データとして指定されたオフスクリーンバッファを置き換えます。
  あらかじめ、buffer命令により作成したオフスクリーンバッファと、置き換えるための変数バッファを初期化する必要があります。
  オフスクリーンバッファは、buffer命令でscreen_offscreenのオプションを指定して作成してください。
  ^p
  	buffer 2,256,256,screen_offscreen
  ^p
  その後、バッファを置き換えるための変数バッファを作成します。
  dim命令により、１次元配列を初期化して作成してください。作成するサイズは、オフスクリーンバッファのXサイズ×Yサイズになります。
  ^p
  	dim bitmap, 256*256
  ^p
  これで、celbitmap命令を使用する準備が整いました。
  celbitmap命令により、オフスクリーンバッファのIDと配列変数を指定することで、変数バッファの内容がそのまま画像イメージとして適用されます。
  変数バッファは、1要素あたり1ドットとなります。1ドットは、32bitの要素をR,G,B,Aそれぞれ8bit単位で格納されるRGB形式のデータとなります。
  たとえば、「$ff204080」(16進数)を指定した場合は、A=$ff(255)、B=$20(32)、G=$40(64)、R=$80(128)となります。(カッコ内は10進数)
  画像データの置き換えは、コストの高い処理になるため、大きなサイズのイメージを置き換える場合、フレームレートが下がることがありますので注意してください。
  p2パラメーターにより、置き換えの形式や動作を指定することができます。
  ^p
   値  マクロ             動作
  ---------------------------------------------------------
    0  celbitmap_rgb      $aabbggrr形式でデータを保持する
    1  celbitmap_bgr      $aarrggbb形式でデータを保持する
    16 celbitmap_capture  描画画面の内容を変数に読み出す
  ^p
  
  通常は、OpenGLの標準に合わせたcelbitmap_rgbの形式が使用されます。オプションにcelbitmap_bgrを指定した場合は、DirectX標準に合わせたARGBの並びになります。
  celbitmap_captureを指定した場合は、描画先(ID0)の画面上のデータを配列変数に読み出します。(読み出しのサイズはオフスクリーンバッファのサイズになります)
  ※celbitmap_captureオプションは、実験的な実装です。現在は、Windows(DirectX版HGIMG4を除く)、Linux版でのみ使用できますのでご了承ください。
  
  
  %sample
  #include "hsp3dish.as"
  
  	buffer 2,256,256,screen_offscreen
  	gsel 0
  	dim bitmap,256*256
  	repeat 256*256
  	bitmap(cnt)=$ff00ffff
  	loop
  *main
  	redraw 0
  	celbitmap 2,bitmap
  	pos 0,0
  	celput 2
  	redraw 1
  	await 1000/30
  	goto *main
  %href
  buffer
  
  
  