Core Graphics > CGImage > masking(_:)
インスタンスメソッド
masking(_:)
既存のイメージとイメージマスクからビットマップイメージを作成します。
宣言
パラメータ
| mask | マスク。マスクがイメージの場合、DeviceGray 色空間内になければならず、アルファ成分を持たず、イメージマスクまたはマスキング色でマスクされていない可能性があります。マスクが image パラメーターで指定されたイメージと同じサイズでない場合、マスクはイメージに合わせて拡大縮小されます。 |
戻り値
image を mask でマスクして作成したイメージ。CGImageRelease を呼び出してこのオブジェクトを解放する責任があなたにはあります。
議論
結果のイメージは、mask パラメータがイメージマスクかイメージであるかによって異なる。mask パラメータがイメージマスクの場合、イメージマスクのソースサンプルは逆アルファ値として機能します。すなわち、イメージマスク内のソースサンプルの値が S である場合、image 内の対応する領域は(1-S) のアルファ値を用いて宛先とブレンドされます。たとえば、S が 1 の場合、領域はペイントされず、S が 0 の場合領域は完全にペイントされます。
mask パラメータがイメージの場合、イメージを宛先上にブレンドするためのアルファマスクとして機能します。mask' のソースサンプルはアルファ値として機能します。マスク内のソースサンプルの値が S である場合、イメージ内の対応する領域は、S のアルファ値で宛先とブレンドされます。たとえば、S が 0 の場合、領域はペイントされず、S が 1 の場合、 地域は完全にペイントされます。