Core Graphics > CGImage > cropping(to:)
インスタンスメソッド
cropping(to:)
既存のビットマップイメージの下位領域内に含まれるデータを使用してビットマップイメージを作成します。
宣言
パラメータ
| rect | イメージをそこから作成する領域を座標で指定した長方形。 |
戻り値
イメージの下位イメージを指定する CGImage オブジェクト。rect パラメータがイメージにない領域を定義している場合 NULL を返します。
議論
下位イメージを作成するには、以下のタスクを実行します。
- rect パラメータは、integral 関数を呼び出して積分境界に調整されます。
- 次に rect は、(0,0) を原点とする長方形と交差し、size は image パラメーターで指定されたイメージのサイズと同じです。
- 結果の長方形内のピクセルは読み取られ、長方形内の最初のピクセルが下位イメージの原点として処理されます。
W および H がそれぞれイメージの幅および高さである場合、点(0,0) はイメージデータの最初のピクセルに対応します。 点(W-1,0) はイメージデータの最初の行の最後のピクセルであり、(0、H-1) はイメージデータの最後の行の最初のピクセルであり、(W-1、H-1) はイメージデータの最後の行の最後のピクセルです。
結果のイメージは元のイメージへの参照を保持し、つまり、この関数を呼び出した後に元のイメージを解放することができます。