Transformpygame.mask画像のマスク処理を行うためのpygameモジュール。引数に設定したSurfaceオブジェクトのマスク処理結果を戻り値として返します。Surfaceに設定した閾値を基にして、マスク処理結果を作成します。二次元ビットマスクを表すpygameオブジェクト。ピクセルを正確に素早く特定するのに便利なモジュールです。Maskオブジェクトでは、1ピクセル当たり1ビットのビットフラグを使って、該当するピクセルの位置を記録します。このモジュールはpygameのver1.8で新たに実装されました。1.8.pygame.mask.from_surface引数に設定したSurfaceオブジェクトのマスク処理結果を戻り値として返します。MaskSurfaceオブジェクトの透明な部分にはビットフラグが設定されず、不透明な部分にはビットフラグが設定されます。各ピクセルの透明度については、指定したthreshold引数よりも大きいかで判定をします。Surfaceオブジェクトに透過色が設定されている場合は、threshold引数を使ったピクセルの抽出は行われません。used.pygame.mask.from_thresholdSurfaceに設定した閾値を基にして、マスク処理結果を作成します。Maskこの命令は、from_surface命令よりも多くの機能を持っています。Surfaceオブジェクトが一つだけ引数に設定された場合、color引数の閾値内の全てのピクセルにビットフラグが設定されます。任意に設定できるothersurface引数が設定されている場合は、Surfaceオブジェクトとothersurfaceオブジェクトで同じ位置にあるピクセルの色を比較し、それが閾値内であればビットフラグが設定されます。Mask.pygame.mask.Mask二次元ビットマスクを表すpygameオブジェクト。Maskオブジェクトのサイズを戻り値として返します。(x,y)座標にビットフラグが設定されていた場合、0以外の値を戻り値として返します。Maskオブジェクト上の、引数に指定した(x,y)座標にビットフラグを設定します。Maskオブジェクトをオフセット値を加えた上で比較し、ビットフラグ座標が重複している場合はその重複位置を戻り値として返します。重複していない場合はNone値を戻り値として返します。重複している'ピクセル'座標の数を戻り値として返します。ピクセルの重複している座標を抽出してMaskオブジェクトを作り、戻り値として返します。全てのビットを1に設定します。全てのビットを0に設定します。Maskオブジェクトの全てのビットを反転させます。Maskオブジェクトの大きさを変更します。別のMaskオブジェクトのビットフラグ情報を重ね書きします。別のMaskオブジェクトを基にして、ビットフラグ情報を削除します。ビットフラグが設定されているピクセルの数を戻り値として返します。Maskオブジェクトに記録されているピクセルの重心となる位置を戻り値として返します。ピクセルの向きを戻り値として返します。Maskオブジェクトと別のMaskオブジェクトの畳み込み積分を戻り値として返します。ピクセルが連なっている範囲を基に、Maskオブジェクトを作成します。ピクセルが連なっている範囲を基に、Maskオブジェクトの一覧を作成します。ピクセルが連なっている範囲の外枠部分の一覧を、rectオブジェクト型の戻り値として返します。pixels.Mask.get_sizeMaskオブジェクトのサイズを戻り値として返します。width,heightMask.get_at(x,y)座標にビットフラグが設定されていた場合、0以外の値を戻り値として返します。0)座標は画面の左上になります。Surfaces.Mask.set_atMaskオブジェクト上の、引数に指定した(x,y)座標にビットフラグを設定します。y.Mask.set_at((x,y),value)Mask.overlapMaskオブジェクトをオフセット値を加えた上で比較し、ビットフラグ座標が重複している場合はその重複位置を戻り値として返します。重複していない場合はNone値を戻り値として返します。(x,y)オフセットを指定すると、下記のように指定分の座標をずらした上で重複位置を調べます。(オフセットにはマイナスの値も設定できます。:Mask.overlap_area重複している'ピクセル'座標の数を戻り値として返します。numpixels引数として渡した別のmaskオブジェクトと比較し、重複するピクセル座標の数を調べることができます。この命令を使用して、二つのMaskオブジェクトの衝突の向きや衝突している数を調べることができます。有限差分法を使って衝突範囲の傾斜を計算することで、衝突近似を調べることもできます。Mask.overlap_area(othermask,(x,y-1))Mask.overlap_maskピクセルの重複している座標を抽出してMaskオブジェクトを作り、戻り値として返します。MaskMaskオブジェクトと他のMaskオブジェクトを比較し、ピクセルが重複している座標を抽出してMaskオブジェクトを作成します。作成されたMaskオブジェクトの大きさは、元のMaskオブジェクトと変わりません。othermask.Mask.fill全てのビットを1に設定します。Mask.fill()Maskオブジェクトの全てのピクセルにビットフラグを設定します。1.Mask.clear全てのビットを0に設定します。Mask.clear()Maskオブジェクトの全てのピクセルのビットフラグを削除します。0.Mask.invertMaskオブジェクトの全てのビットを反転させます。Mask.invert()Maskオブジェクトのビットを反転させます。ビットフラグが立っているピクセルはフラグが解除され、ビットフラグが立っていないピクセルはフラグが設定されます。pixels.Mask.scaleMaskオブジェクトの大きさを変更します。Mask指定した大きさのMaskオブジェクトを新規に作成し、戻り値として返します。size.Mask.draw別のMaskオブジェクトのビットフラグ情報を重ね書きします。offset)ビット単位でOR処理を実行し、別のMaskオブジェクトのビットフラグ情報を重ね書きします。Mask.Mask.erase別のMaskオブジェクトを基にして、ビットフラグ情報を削除します。offset)別のMaskオブジェクトにビットフラグが設定されている場合、同じ位置のビットフラグを全て削除します。Mask.Mask.countビットフラグが設定されているピクセルの数を戻り値として返します。pixelsMaskオブジェクトで、ビットフラグが設定されているピクセルの数を戻り値として返します。Mask.Mask.centroidMaskオブジェクトに記録されているピクセルの重心となる位置を戻り値として返します。y)Maskオブジェクトに記録されているピクセルの重心となる位置を調べます。重心位置はタプル型の値として取得されます。実行時にMaskオブジェクトが空の場合は、(0,0)の値が取得されます。(0,0).Mask.angleピクセルの向きを戻り値として返します。theta画像上のフラグが設定されているピクセルのおおよその向きを、-90度から90度の範囲内で調べます。ピクセルの位置が連なっている場合に、この命令は最も効果的に動きます。Maskオブジェクトが空の場合は、0.0の値が取得されます。...]Maskオブジェクト上で最初に検出されたピクセル連結範囲について、その輪郭を現す座標一覧を戻り値として返します。Maskオブジェクト上にピクセルが連なっている範囲がある場合にのみ、この命令は有効でしょう。任意に設定できるevery引数を使うことで、ピクセルを一定数飛ばして輪郭を作ることもできます。引数に10と設定すると、10個ごとのピクセル座標の一覧が戻り値として返ります。outline.Mask.convolveMaskオブジェクトと別のMaskオブジェクトの畳み込み積分を戻り値として返します。self.outputmask引数が設定されている場合は、引数として渡したMaskオブジェクトにビットフラグ情報が上書きされ、戻り値として返ります。outputmask引数を設定しなかった場合はMaskオブジェクトが新規に作成されます。created.Mask.connected_componentピクセルが連なっている範囲を基に、Maskオブジェクトを作成します。MaskSAUFアルゴリズムを使用して、Maskオブジェクト上でピクセルが連なっている範囲を調べます。この命令では、8点のピクセルが連なっているかどうかをチェックします。既定では、画像の中で最も大きい連結範囲が戻り値として返ります。追加で特定のピクセル位置座標を指定することもでき、そうすることで指定座標を含んだ連結範囲を取得することができます。その場合、指定した座標が連結範囲に含まれていないと、空のMaskオブジェクトが戻り値として返ります。作成されたMaskオブジェクトの大きさは、元のMaskオブジェクトと同じものになります。connectivity)」と記載されていますが、1点のみの場合でも連結範囲として検出されるようです。Mask.Mask.connected_componentsピクセルが連なっている範囲を基に、Maskオブジェクトの一覧を作成します。[Masks]ピクセルが連なっている範囲を基に、Maskオブジェクトの一覧を作成します。連結範囲を検出する際の最小のピクセル数を引数に設定することで、細かいノイズを除外することができます。noise.Mask.get_bounding_rectsピクセルが連なっている範囲の外枠部分の一覧を、rectオブジェクト型の戻り値として返します。Rectsビットフラグの設定されたピクセルが連なっている範囲の、外枠部分をRect型の値として取得します。取得された外枠の形状は、ピクセルの連なりが全て中に入る大きさになります。本サイトはpygameのサイトを翻訳したものであり、pygameに関する著作権は全てそちらに帰属しています。本サイトは現在翻訳中のため、未翻訳の項目が存在します。誤訳が判明した場合、より分かりやすい言い回しが見つかった場合、原文が変更された場合などにより、本サイトの内容は予告なく変更されることがあります。翻訳の内容には誤りがある可能性があります。本サイトの記述内容によって不利益が発生した場合も、サイト管理人は一切の責任を負いません。