Core Graphics > CGContext > clip(to:mask:)
インスタンスメソッド
clip(to:mask:)
指定された長方形内にマスクをマッピングし、グラフィックスコンテキストの現在のクリッピング領域と交差させます。
宣言
パラメータ
| rect | mask パラメータをそこにマッピングすべき長方形。 |
| mask | 画像または画像のマスク。mask がイメージの場合、DeviceGray 色空間内になければならず、アルファ成分がなく、イメージマスクやマスキングカラーでマスクされない可能性があります。 |
議論
mask パラメータがイメージマスクの場合、Core Graphics は draw(in:image:) 関数で見られる動作と全く同じ方法でクリップします。マスクは、描画するときに変更されない領域を示します。画像マスクのソースサンプルは、クリッピング領域のどの点が変更され、「逆アルファ」値として作用するかを決定します。イメージマスク内のソースサンプルの値が S である場合、現在のクリッピング領域内の対応する点に (1-S) のアルファ値が乗算されます。たとえば、S が 1 の場合、クリッピング領域の点は透明になります。S が 0 の場合、クリッピング領域の点は変更されません。
mask パラメータがイメージの場合、mask はアルファマスクのように動作し、現在のクリッピング領域とブレンドされます。mask のソースサンプルは、クリッピング領域のどの点が変更されるかを決定します。マスク内のソースサンプルの値が S である場合、現在のクリッピング領域内の対応する点に S のアルファ値が乗算されます。たとえば、S が 0 の場合、クリッピング領域の点は透明になります。S が 1 の場合、クリッピング領域の点は変更されません。