alCopyModeColorKey

カラーキー コピーモードを設定

alCopyModeColorKey color1, color2

color1	: キー範囲下限 RGB 値
color2	: キー範囲上限 RGB 値

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

解説

画像コピー時に透過色として扱う色の範囲を設定します。

color 引数は、R, G, B の値を 1 つの整数値にまとめた形式で、16 進数表記のそれぞれの桁の意味は 0xRRGGBB となります。(COLORREF 型とは異なります。) モジュールに内蔵のマクロ RGBA(R, G, B) を使用すると、値を簡単に記述できます。

たとえば、下記のコードは、紫色 (255, 0, 255) のみを透明色としてコピーするモードを設定します。

alCopyModeColorKey 0xff00ff, 0xff00ff

設定したコピーモードは、下記の命令に適用されます。

alCopyImageToImage
alCopyImageToScreen
alCopyScreenToImage
alStretchImageToImage
alStretchImageToScreen
alStretchScreenToImage

目的の処理が完了したら、alResetCopyMode 命令でデフォルトのコピーモードに戻すことができます。

コピーモードは、描画先の HSP Screen ID, 仮想イメージ ID を問わずに適用されます。

関連項目

alResetCopyModeコピーモードをリセット(Artlet2D)

サンプル逆引き (1)

xsample_alphapaint.hsp

情報

プラグイン / モジュールArtlet2D
バージョン1.01 R2
作成日2010/02/04
著作者S.Programs
URLhttp://sprocket.babyblue.jp/
備考a2d.hsp をインクルードしてください。
タイプユーザー拡張命令
グループコピーモード
対応環境
  • Windows 版 HSP
移植のヒント実行環境に GDI+ (gdiplus.dll) が必要です。
hs ファイルdoclib\Artlet2D\a2dhelp.hs