Core Graphics > CGImage > copy(maskingColorComponents:)
インスタンスメソッド
copy(maskingColorComponents:)
指定された色の値で既存のビットマップイメージをマスクしてビットマップイメージを作成します。
宣言
パラメータ
| components | イメージをマスクする色または色の範囲を指定する色成分の配列。配列は 2N の値 { min[1]、max[1]、... min[N]、max[N]} を含んでいなければならず、ここで N は image の色空間での成分数です。components の各値は有効なイメージサンプル値でなければなりません。image が整数ピクセル成分を持つ場合、各値は[0 .. 2 ** bitsPerComponent - 1] の範囲内になければなりません(ここで bitsPerComponent は image の成分あたりのビット数です)。image に浮動小数点ピクセル成分がある場合、各値は有効な色成分である任意の浮動小数点数になります。 |
戻り値
components 配列で指定された色で image をマスクして作成されたイメージ。CGImageRelease を呼び出してこのオブジェクトを解放する責任があなたにはあります。
議論
色の値 {c[1], ... c[N]} ここで min[i] <= c[i] <= max[i] ですが、この色の値のイメージサンプルは 1 <= i <= N の場合完全にマスクされます(すなわち、ペイントされません)。これは、現在の塗りつぶしの色などのように、ペイントされていないサンプルの下のものがすべて表示されることを意味します。