Core Graphics > CGContext > init(data:width:height:bitsPerComponent:bytesPerRow:space:bitmapInfo:releaseCallback:releaseInfo:)
イニシャライザ
init(data:width:height:bitsPerComponent:
bytesPerRow:space:bitmapInfo:releaseCallback:
releaseInfo:)
指定されたコールバック関数を使用してビットマップグラフィックスコンテキストを作成します。
宣言
パラメータ
| data | 描画がレンダリングされるメモリ内の宛先へのポインタ。このメモリブロックのサイズは、少なくとも (bytesPerRow*height) バイトである必要があります。 この関数でビットマップのメモリを割り当てる場合は、NULL を渡して下さい。これにより、自分のメモリを管理することがなくなり、メモリリークの問題を軽減します。 |
| width | 必要なビットマップの幅(ピクセル単位)。 |
| height | 必要なビットマップの高さ(ピクセル単位)。 |
| bitsPerComponent | メモリ内のピクセルの各成分に使用するビット数。たとえば、32 ビットのピクセル形式と RGB 色空間の場合、成分ごとに 8 ビットの値を指定して下さい。サポートされているピクセル形式のリストについては、Quartz 2D プログラミングガイド の "Graphics Contexts" の章の "サポートされているピクセル形式" を参照してください。 |
| bytesPerRow | ビットマップの 1 行あたりに使用するメモリのバイト数。data パラメータが NULL の場合、値 0 を渡すと、自動的に値が計算されます。 |
| colorspace | ビットマップコンテキストに使用する色空間。インデックス付き色空間は、ビットマップグラフィックスコンテキストではサポートされていないことに注意してください。 |
| bitmapInfo | ビットマップがアルファチャンネルを含むか、アルファチャンネルのピクセル内の相対位置、およびピクセルコンポーネントが浮動小数点数か整数値かを示す情報を含むかどうかを指定する定数です。アルファチャネル情報を指定する定数は、 CGImageAlphaInfo 型で宣言されますが、このパラメータに安全に渡すことができます。また、CGBitmapInfo 型に関連する他の定数を渡すこともできます。 色空間、ピクセルあたりのビット数、ピクセルコンポーネントあたりのビット数、およびビットマップ情報を指定する方法の例については、グラフィックスコンテキスト を参照してください。 |
| releaseCallback | カスタムリリース関数は、ビットマップデータを解放するときに呼び出す関数です。この関数の構文については、CGBitmapContextReleaseDataCallback データ型の説明を参照してください。このパラメーターには NULL を指定できます。 |
| releaseInfo | カスタムリリースの呼び出しに渡したいデータへのポインタ。 |
戻り値
新しいビットマップコンテキスト。コンテキストを作成できなかった場合は NULL。あなたには CGContextRelease を使用してこのオブジェクトを解放する責任があります。
議論
このコンテキストに描画すると、Core Graphics は、指定されたメモリブロック内のビットマップデータとして図面をレンダリングします。
新しいビットマップコンテキストのピクセル形式は、成分あたりのビット数、色空間、およびアルファオプション(CGBitmapInfo 定数で表される) の 3 つのパラメータによって決定されます。アルファ値は、描画されるときのピクセルの不透明度を決定します。