DRAnimateTileBitmap

DRAnimateTileBitmap　(ネイティブクラス)

このクラスはアニメーションタイル画像を描画するDRを扱うクラスです。
アニメーションタイルはマップチップベースの描画を行うのに適しています。

DR系クラスは描画に必要な情報を保持するクラスで、
INativeDrawResource での描画に対応したクラスを介して描画されます。
このクラスのインスタンスが消滅した時、
そのインスタンスへのリンクは強制的に解除されます。
描画に使用しているDRインスタンスを消滅させないようにしてください。

一番簡単にDRを画面に表示するには DRWindow クラスを使用します。

●継承

このクラスは継承をしていません。

●インターフェイスとインターフェイスメソッド

implements INativeDrawResource (C++レベルキャスト)IFGESDrawResource

●クラスメソッド

名前	概要
`SetViewFrameExPatternCount`	タイミングリストの数を設定します
`SetViewFrameExPattern`	タイミングリストを設定します

●クラスメンバメソッド

名前	概要
`SetAnimateTileBitmap`	アニメーションタイルを設定します
`SetDrawMode`	描画モードを設定します
`SetAlpha`	透過度を設定します
`SetTone`	色変換を設定します
`SetSrcArea`	描画内容の読み取り元を再設定します
`ShiftSrcXY`	描画内容の読み取り元をずらします
`GetTileSize`	タイルサイズを取得します
`GetAnimationLength`	アニメーションの長さを取得します

●クラス共有変数

このクラスはクラス共有変数を持っていません。

●インスタンス変数

このクラスはインスタンス変数を持っていません。

●C++レベル追加情報

クラスID： FGES_CLASSID_DRANIMATETILEBITMAP
クラス名： FGES_DRAnimateTileBitmap

DRAnimateTileBitmap::SetViewFrameExPatternCount

public static Bool SetViewFrameExPatternCount( INativeInteger patterncount)

   DRAnimateTile 系とイベントオブジェクトで使用するタイミングリストの数を設定します。
   このメソッドで確保したタイミングリストは対応するメソッドの frametiming 引数で
   32768～32768+patterncount-1 の範囲に割り当てられます。
   確保したタイミングリストの内容は SetViewFrameExPattern メソッドで設定します。

   このメソッドを呼び出すと既に設定されているタイミングリストは削除されます。

戻り値：設定に成功すると真を返します。

INativeInteger patterncount ：割り当てるタイミングリストの数(0～32768)

先頭へ

DRAnimateTileBitmap::SetViewFrameExPattern

public static Bool SetViewFrameExPattern( INativeInteger patternid, PIntArray timinglist)

   DRAnimateTile 系とイベントオブジェクトで使用するタイミングリストの内容を設定します。
   タイミングリストの内容はシーン番号ごとの切替時間をリストとして指定します。
   タイミングリストより表示対象のシーン数が多い場合はタイミングリストを循環解釈します。

   このメソッドで設定したタイミングリストは対応するメソッドの frametiming 引数で
   32768+タイミングリスト番号を指定することで適用することができます。
   このメソッドを使う前に SetViewFrameExPatternCount メソッドで要素を確保する必要があります。

戻り値：設定に成功すると真を返します。

INativeInteger patternid ：設定するタイミングリストの番号
PIntArray timinglist ：設定するタイミングリストの内容

先頭へ

DRAnimateTileBitmap::SetAnimateTileBitmap

public void SetAnimateTileBitmap( INativeInteger scenecnt, INativeBitmap bitmap,              INativeInteger frametiming, INativeInteger x, INativeInteger y,              INativeInteger width, INativeInteger height,              INativeInteger? drawmode=NULL, INativeInteger? alv=NULL,              INativeInteger? tone_color=NULL, INativeInteger? tone_rpow=NULL,              INativeInteger? tone_gpow=NULL, INativeInteger? tone_bpow=NULL,              INativeInteger? loop=NULL, INativeInteger? start_sceneid=NULL)

   このオブジェクトが描画するアニメーションタイルを設定します。
   アニメーションタイルは左から右に向かってアニメーションを配置します。
   指定した座標からシーン数分 width ずつ右にずらしながら設定され、
   frametiming フレーム経過する毎にシーンが切り替わります。
   最後のシーンまで描画した後は loop の指定によって動作が決定されます。

   frametiming に32768以上の値を指定した場合、タイミングリストのIDとして解釈します。

   このメソッドは指定されたビットマップオブジェクトに対してビットマップ共有を作成します。

INativeInteger scenecnt ：設定するシーン数
INativeBitmap bitmap ：描画に使用する画像
INativeInteger frametiming ：各シーンを描画するフレーム数か、タイミングリストのID
INativeInteger x ：1枚目の描画に使用する画像領域の左端座標
INativeInteger y ：1枚目の描画に使用する画像領域の上端座標
INativeInteger width ：描画に使用する画像領域の横幅
INativeInteger height ：描画に使用する画像領域の縦幅
INativeInteger? drawmode=NULL ：描画方法。以下とオプションのOR結合。

識別名	内容
`DRBitmap::COPY`	画像の色と透過度で上書きします(デフォルト)
`DRBitmap::COPYC`	画像の色のみを上書きします
`DRBitmap::ALPHA`	画像を透過描画します
`DRBitmap::BLEND`	画像を半透明描画します
`DRBitmap::LAYER`	画像をレイヤー描画します
`DRBitmap::BACK`	画像を背後に描画します
`DRBitmap::ALPHABLEND`	画像を透過半透明描画します
`DRBitmap::LAYERBLEND`	画像をレイヤー半透明描画します
`DRBitmap::BACKBLEND`	画像を背後に半透明描画します
`DRBitmap::MIXALPHA`	画像を透過合成します
`DRBitmap::MIXBLEND`	画像を半透明合成します
`DRBitmap::MIXLAYER`	画像をレイヤー合成します
`DRBitmap::MIXBACK`	画像を背後に合成します
`DRBitmap::MIXALPHABLEND`	画像を透過半透明合成します
`DRBitmap::MIXLAYERBLEND`	画像をレイヤー半透明合成します
`DRBitmap::MIXBACKBLEND`	画像を背後に半透明合成します
`DRBitmap::COPYA`	画像をアルファコピーします
`DRBitmap::MULA`	画像をアルファ乗算します
`DRBitmap::REVMULA`	画像をアルファ逆乗算します
`DRBitmap::ADDA`	画像をアルファ加算します
`DRBitmap::SUBA`	画像をアルファ減算します
`DRBitmap::FILLA`	画像をアルファ設定します
`DRBitmap::BLENDALPHA`	画像をアルファのみブレンドします
`DRBitmap::COPYTONE`	画像を色変換して上書きします
`DRBitmap::TONE`	画像を色変換して色のみに描画します
`DRBitmap::ALPHATONE`	画像を色変換して透過描画します
`DRBitmap::LAYERTONE`	画像を色変換してレイヤー描画します
`DRBitmap::BACKTONE`	画像を色変換して背後に描画します
`DRBitmap::MIXTONE`	画像を色変換して合成します
`DRBitmap::MIXALPHATONE`	画像を色変換して透過合成します
`DRBitmap::MIXLAYERTONE`	画像を色変換してレイヤー合成します
`DRBitmap::MIXBACKTONE`	画像を色変換して背後に合成します
`DRBitmap::MULC`	画像を色のみ乗算します
`DRBitmap::REVMULC`	画像を色のみ逆乗算します
`DRBitmap::ADDC`	画像を色のみ加算します
`DRBitmap::SUBC`	画像を色のみ減算します
`DRBitmap::SCREEN`	画像をスクリーン描画します
`DRBitmap::OVERLAY`	画像をオーバーレイ描画します
`DRBitmap::HARDLIGHT`	画像をハードライト描画します
`DRBitmap::MULBLENDC`	画像を色のみ半透明乗算します
`DRBitmap::ADDBLENDC`	画像を色のみ半透明加算します
`DRBitmap::SUBBLENDC`	画像を色のみ半透明減算します
`DRBitmap::SCREENBLEND`	画像を半透明スクリーン描画します
`DRBitmap::OVERLAYBLEND`	画像を半透明オーバーレイ描画します
`DRBitmap::HARDLIGHTBLEND`	画像を半透明ハードライト描画します
`DRBitmap::MUL`	画像を乗算します
`DRBitmap::REVMUL`	画像を逆乗算します
`DRBitmap::ADD`	画像を加算します
`DRBitmap::SUB`	画像を減算します
`DRBitmap::MIXSCREEN`	画像をスクリーン合成します
`DRBitmap::MIXOVERLAY`	画像をオーバーレイ合成します
`DRBitmap::MIXHARDLIGHT`	画像をハードライト合成します
`DRBitmap::MULBLEND`	画像を半透明乗算します
`DRBitmap::ADDBLEND`	画像を半透明加算します
`DRBitmap::SUBBLEND`	画像を半透明減算します
`DRBitmap::MIXSCREENBLEND`	画像を半透明スクリーン合成します
`DRBitmap::MIXOVERLAYBLEND`	画像を半透明オーバーレイ合成します
`DRBitmap::MIXHARDLIGHTBLEND`	画像を半透明ハードライト合成します

オプション：これらのフラグは同時使用できます。

識別名	内容
`DRBitmap::DM_HMIRROR`	左右反転
`DRBitmap::DM_VMIRROR`	上下反転

INativeInteger? alv=NULL ：半透明描画時の透過度
INativeInteger? tone_color=NULL ：色変換する時の色
INativeInteger? tone_rpow=NULL ：色変換する時の赤影響力(0～256)
INativeInteger? tone_gpow=NULL ：色変換する時の緑影響力(0～256)
INativeInteger? tone_bpow=NULL ：色変換する時の青影響力(0～256)
INativeInteger? loop=NULL ：アニメーションのループモードを指定します。

識別名	動作
0	最後のシーンの描画時間が経過すると非表示になります。
`DRAnimateBitmap::ROTATION`	最後のシーンの描画時間が経過すると最初のシーンからループ再生します。(デフォルト)
`DRAnimateBitmap::ROUNDTRIP`	最後のシーンの描画時間が経過すると逆再生し、最初のシーンまで戻るとループします。
`DRAnimateBitmap::ONEPLAY`	最後のシーンに到達すると以降最後のシーンを描画し続けます。
`DRAnimateBitmap::ONEROUND`	最後のシーンの描画時間が経過すると逆再生し、最初のシーンまで戻ると以降最初のシーンを描画し続けます。

INativeInteger? start_sceneid=NULL ：再生開始するシーンIDを指定します。
空参照を指定した場合は0として扱います。

先頭へ

DRAnimateTileBitmap::SetDrawMode

public void SetDrawMode( INativeInteger drawmode)

このドローリソースの描画方法を設定します。

INativeInteger drawmode ：設定する描画方法。以下のいずれかとオプションのOR結合。

識別名	内容
`DRBitmap::COPY`	画像の色と透過度で上書きします
`DRBitmap::COPYC`	画像の色のみを上書きします
`DRBitmap::ALPHA`	画像を透過描画します
`DRBitmap::BLEND`	画像を半透明描画します
`DRBitmap::LAYER`	画像をレイヤー描画します
`DRBitmap::BACK`	画像を背後に描画します
`DRBitmap::ALPHABLEND`	画像を透過半透明描画します
`DRBitmap::LAYERBLEND`	画像をレイヤー半透明描画します
`DRBitmap::BACKBLEND`	画像を背後に半透明描画します
`DRBitmap::MIXALPHA`	画像を透過合成します
`DRBitmap::MIXBLEND`	画像を半透明合成します
`DRBitmap::MIXLAYER`	画像をレイヤー合成します
`DRBitmap::MIXBACK`	画像を背後に合成します
`DRBitmap::MIXALPHABLEND`	画像を透過半透明合成します
`DRBitmap::MIXLAYERBLEND`	画像をレイヤー半透明合成します
`DRBitmap::MIXBACKBLEND`	画像を背後に半透明合成します
`DRBitmap::COPYA`	画像をアルファコピーします
`DRBitmap::MULA`	画像をアルファ乗算します
`DRBitmap::REVMULA`	画像をアルファ逆乗算します
`DRBitmap::ADDA`	画像をアルファ加算します
`DRBitmap::SUBA`	画像をアルファ減算します
`DRBitmap::FILLA`	画像をアルファ設定します
`DRBitmap::BLENDALPHA`	画像をアルファのみブレンドします
`DRBitmap::COPYTONE`	画像を色変換して上書きします
`DRBitmap::TONE`	画像を色変換して色のみに描画します
`DRBitmap::ALPHATONE`	画像を色変換して透過描画します
`DRBitmap::LAYERTONE`	画像を色変換してレイヤー描画します
`DRBitmap::BACKTONE`	画像を色変換して背後に描画します
`DRBitmap::MIXTONE`	画像を色変換して合成します
`DRBitmap::MIXALPHATONE`	画像を色変換して透過合成します
`DRBitmap::MIXLAYERTONE`	画像を色変換してレイヤー合成します
`DRBitmap::MIXBACKTONE`	画像を色変換して背後に合成します
`DRBitmap::MULC`	画像を色のみ乗算します
`DRBitmap::REVMULC`	画像を色のみ逆乗算します
`DRBitmap::ADDC`	画像を色のみ加算します
`DRBitmap::SUBC`	画像を色のみ減算します
`DRBitmap::SCREEN`	画像をスクリーン描画します
`DRBitmap::OVERLAY`	画像をオーバーレイ描画します
`DRBitmap::HARDLIGHT`	画像をハードライト描画します
`DRBitmap::MULBLENDC`	画像を色のみ半透明乗算します
`DRBitmap::ADDBLENDC`	画像を色のみ半透明加算します
`DRBitmap::SUBBLENDC`	画像を色のみ半透明減算します
`DRBitmap::SCREENBLEND`	画像を半透明スクリーン描画します
`DRBitmap::OVERLAYBLEND`	画像を半透明オーバーレイ描画します
`DRBitmap::HARDLIGHTBLEND`	画像を半透明ハードライト描画します
`DRBitmap::MUL`	画像を乗算します
`DRBitmap::REVMUL`	画像を逆乗算します
`DRBitmap::ADD`	画像を加算します
`DRBitmap::SUB`	画像を減算します
`DRBitmap::MIXSCREEN`	画像をスクリーン合成します
`DRBitmap::MIXOVERLAY`	画像をオーバーレイ合成します
`DRBitmap::MIXHARDLIGHT`	画像をハードライト合成します
`DRBitmap::MULBLEND`	画像を半透明乗算します
`DRBitmap::ADDBLEND`	画像を半透明加算します
`DRBitmap::SUBBLEND`	画像を半透明減算します
`DRBitmap::MIXSCREENBLEND`	画像を半透明スクリーン合成します
`DRBitmap::MIXOVERLAYBLEND`	画像を半透明オーバーレイ合成します
`DRBitmap::MIXHARDLIGHTBLEND`	画像を半透明ハードライト合成します

オプション：これらのフラグは同時使用できます。

識別名	内容
`DRBitmap::DM_HMIRROR`	左右反転
`DRBitmap::DM_VMIRROR`	上下反転

先頭へ

DRAnimateTileBitmap::SetAlpha

public void SetAlpha( INativeInteger alv)

   このドローリソースを半透明描画する場合の透過度を設定します。
   現在の描画モードが透過度を必要としない場合、設定はされますが表面上の変化はありません。

INativeInteger alv ：設定する透過度(0～255)

先頭へ

DRAnimateTileBitmap::SetTone

public void SetTone( INativeInteger tone_color,              INativeInteger tone_rpow, INativeInteger tone_gpow, INativeInteger tone_bpow)

   このドローリソースを色変換描画する場合の色を設定します。
   現在の描画モードが色変換を必要としない場合、設定はされますが表面上の変化はありません。

INativeInteger tone_color ：色変換に使う色
INativeInteger tone_rpow ：色変換する時の赤影響力(0～256)
INativeInteger tone_gpow ：色変換する時の緑影響力(0～256)
INativeInteger tone_bpow ：色変換する時の青影響力(0～256)

先頭へ

DRAnimateTileBitmap::SetSrcArea

public void SetSrcArea( INativeInteger? x, INativeInteger? y,              INativeInteger? width=NULL, INativeInteger? height=NULL)

   このドローリソースを描画する場合に使用する画像の読み取り元座標を再設定します。

INativeInteger? x ：1枚目の描画に使用する画像領域の左端座標。
      空参照を指定した場合、現在の値を維持します。
INativeInteger? y ：1枚目の描画に使用する画像領域の上端座標。
      空参照を指定した場合、現在の値を維持します。
INativeInteger? width=NULL ：描画に使用する画像領域の横幅。
      空参照を指定した場合、現在の値を維持します。
INativeInteger? height=NULL ：描画に使用する画像領域の縦幅。
      空参照を指定した場合、現在の値を維持します。

先頭へ

DRAnimateTileBitmap::ShiftSrcXY

public void ShiftSrcXY( INativeInteger x, INativeInteger y)

このドローリソースを描画する場合に使用する画像の読み取り元座標をずらします。

INativeInteger x ：X軸の読み取り元移動量(ピクセル単位)
INativeInteger y ：Y軸の読み取り元移動量(ピクセル単位)

先頭へ

DRAnimateTileBitmap::GetTileSize

public Bool GetTileSize(editable INativeInteger? width,editable INativeInteger? height)const

   現在設定されているタイルサイズを取得します。

戻り値：取得に成功すると真を返します。

editable INativeInteger? width ：[出力]タイルの横幅を出力するオブジェクト。
      空参照を指定した場合、無視します。
editable INativeInteger? height ：[出力]タイルの縦幅を出力するオブジェクト。
      空参照を指定した場合、無視します。

先頭へ

DRAnimateTileBitmap::GetAnimationLength

public Integer GetAnimationLength()const

現在の設定でのアニメーションの長さを取得します。

戻り値：現在の設定でのアニメーションの長さを返します。

先頭へ

[前へ] [目次へ] [次へ]

最終更新 2023/09/11