Core Graphics > CGContext
クラス
CGContext
Quartz 2D の描画環境
概観
CGContext 型は、Quartz 2D 描画の宛先を表します。グラフィックスコンテキストには、描画パラメータと、ページ上のペイントを宛先にレンダリングするために必要なすべてのデバイス固有の情報を含み、宛先がアプリケーション内のウィンドウであるかどうか、ビットマップイメージ、PDF ドキュメント、またはプリンタであるかどうかが含まれます。
シンボル
ビットマップグラフィックスコンテキストの作成
init?(data: UnsafeMutableRawPointer?, width: Int, height: Int, bitsPerComponent: Int, bytesPerRow: Int, space: CGColorSpace, bitmapInfo: UInt32)
ビットマップグラフィックスコンテキストを作成します。
init?(data: UnsafeMutableRawPointer?, width: Int, height: Int, bitsPerComponent: Int, bytesPerRow: Int, space: CGColorSpace, bitmapInfo: UInt32, releaseCallback: CGBitmapContextReleaseDataCallback?, releaseInfo: UnsafeMutableRawPointer?)
指定されたコールバック関数を使用してビットマップグラフィックスコンテキストを作成します。
CGBitmapContextReleaseDataCallback
ビットマップコンテキストに関連するデータを解放するために使用される呼び出し関数。
PDF グラフィックスコンテキストの作成
init?(CFURL, mediaBox: UnsafePointer<CGRect>?, CFDictionary?)
URL ベースの PDF グラフィックスコンテキストを作成します。
init?(consumer: CGDataConsumer, mediaBox: UnsafePointer<CGRect>?, CFDictionary?)
PDF グラフィックスコンテキストを作成します。
PDF コンテキストの作成時に指定する補助情報辞書のキー。
座標空間どうしの変換
var userSpaceToDeviceSpaceTransform: CGAffineTransform
ユーザー空間座標をデバイスの空間座標にマッピングするアフィン変換を返します。
func convertToDeviceSpace(CGPoint)
ユーザー空間座標からデバイスの空間座標に変換された点を返します。
func convertToUserSpace(CGPoint)
デバイスの空間座標からユーザー空間座標に変換された点を返します。
func convertToDeviceSpace(CGRect)
ユーザー空間座標からデバイスの空間座標に変換された長方形を返します。
func convertToUserSpace(CGRect)
デバイスの空間座標からユーザー空間座標に変換された長方形を返します。
func convertToDeviceSpace(CGSize)
ユーザー空間座標からデバイスの空間座標に変換されたサイズを返します。
func convertToUserSpace(CGSize)
デバイスの空間座標からユーザー空間座標に変換されたサイズを返します。
現在のグラフィックパスの構築
func beginPath()
グラフィックスコンテキストに新しい空のパスを作成します。
func move(to: CGPoint)
指定された点に新しいサブパスを開始します。
func addLine(to: CGPoint)
現在の点から指定された点に線分を追加します。
func addLines(between: [CGPoint])
接続された直線の線分のシーケンスを現在のパスに追加します。
func addRect(CGRect)
現在のパスに長方形のパスを追加します。
func addRects([CGRect])
現在のパスに一連の長方形のパスを追加します。
func addEllipse(in: CGRect)
指定された長方形の内側に収まる楕円を追加します。
func addArc(center: CGPoint, radius: CGFloat, startAngle: CGFloat, endAngle: CGFloat, clockwise: Bool)
現在のパスに、半径と角度で指定された円弧を追加します。
func addArc(tangent1End: CGPoint, tangent2End: CGPoint, radius: CGFloat)
半径と 2 つの接線で指定された円弧を現在のパスに追加します。
func addCurve(to: CGPoint, control1: CGPoint, control2: CGPoint)
指定された終点と制御点を使用して、現在のパスに 3 次ベジェ曲線を追加します。
func addQuadCurve(to: CGPoint, control: CGPoint)
指定された終点と制御点を使用して、現在のパスに 2 次ベジェ曲線を追加します。
func addPath(CGPath)
以前に作成されたパスオブジェクトをグラフィックスコンテキストの現在のパスに追加します。
func closePath()
現在のパスのサブパスを閉じて終了します。
var path: CGPath?
グラフィックスコンテキスト内の現在のパス情報から構築されたパスオブジェクトを返します。
func replacePathWithStrokedPath()
グラフィックスコンテキストのパスを、ストロークされたバージョンのパスに置き換えます。
現在のグラフィックパスを調べる
var boundingBoxOfPath: CGRect
現在のパスを含む最小の長方形を返します。
var currentPointOfPath: CGPoint
空でないパス内の現在の点を返します。
var isPathEmpty: Bool
現在のパスにサブパスが含まれているかどうかを示します。
func pathContains(CGPoint, mode: CGPathDrawingMode)
指定された点が現在のパスに含まれているかどうかを確認します。
現在のグラフィックパスを描画する
func drawPath(using: CGPathDrawingMode)
指定された描画モードを使用して現在のパスを描画します。
パスをレンダリングする際のオプション。
func fillPath(using: CGPathFillRule)
指定された塗りつぶし規則によって決定されるように、現在のパス内の領域をペイントします。
func strokePath()
現在のパスに沿って線を描画します。
図形の描画
func clear(CGRect)
透明な長方形を描画します。
func fill(CGRect)
指定された長方形内に含まれる領域を、現在のグラフィックス状態の塗りつぶし色を使用して塗りつぶします。
func fill([CGRect])
指定された長方形内に含まれる領域を、現在のグラフィックス状態の塗りつぶし色を使用して塗りつぶします。
func fillEllipse(in: CGRect)
現在のグラフィックス状態の塗りつぶし色を使用して、指定された長方形の内部に収まる楕円の領域を塗りつぶします。
func stroke(CGRect)
長方形のパスを塗ります。
func stroke(CGRect, width: CGFloat)
指定された線の幅を使用して長方形のパスを塗ります。
func strokeEllipse(in: CGRect)
指定された長方形の内側に収まる楕円を描きます。
func strokeLineSegments(between: [CGPoint])
一連の線分を描きます。
画像と PDF コンテンツの描画
func draw(CGImage, in: CGRect, byTiling: Bool)
指定された領域に画像を描画します。
func drawPDFPage(CGPDFPage)
現在のグラフィックスコンテキストに PDF ページのコンテンツを描画します。
var interpolationQuality: CGInterpolationQuality
グラフィックスコンテキストの現在の補間品質のレベルを返します。
画像をレンダリングするための補間品質のレベル。
グラデーションとシェーディングの描画
func drawLinearGradient(CGGradient, start: CGPoint, end: CGPoint, options: CGGradientDrawingOptions)
指定された開始点と終了点によって定義された線に沿って変化するグラデーションの塗りを描画します。
func drawRadialGradient(CGGradient, startCenter: CGPoint, startRadius: CGFloat, endCenter: CGPoint, endRadius: CGFloat, options: CGGradientDrawingOptions)
指定された開始円と終了円によって定義される領域に沿って変化するグラデーションの塗りを描画します。
グラデーションの描画位置。
func drawShading(CGShading)
コンテキストのクリッピングパスを指定されたシェーディングで塗りつぶします。
テキストの描画
var textMatrix: CGAffineTransform
現在のテキスト行列を返します。
var textPosition: CGPoint
テキストが描画される位置を返します。
グラフィックスコンテキストでフォントとフォントサイズを設定します。
| 旧式 |
|---|
func setCharacterSpacing(CGFloat)
現在の文字間隔を設定します。
func setFont(CGFont)
グラフィックスコンテキスト内でプラットフォームのフォントを設定します。
func setFontSize(CGFloat)
現在のフォントサイズを設定します。
func setTextDrawingMode(CGTextDrawingMode)
現在のテキスト描画モードを設定します。
テキストをレンダリングするモード。
func setAllowsFontSmoothing(Bool)
グラフィックスコンテキストのフォントスムージングを許可するかどうかを設定します。
func setAllowsFontSubpixelPositioning(Bool)
グラフィックスコンテキストのサブピクセル配置を許可するかどうかを設定します。
func setAllowsFontSubpixelQuantization(Bool)
グラフィックスコンテキストのサブピクセル量子化を許可するかどうかを設定します。
func setShouldSmoothFonts(Bool)
グラフィックスコンテキストでフォントスムージングを有効または無効にします。
func setShouldSubpixelPositionFonts(Bool)
グラフィックスコンテキストでのサブピクセルの配置を有効または無効にします。
func setShouldSubpixelQuantizeFonts(Bool)
グラフィックスコンテキストでサブピクセル量子化を有効または無効にします。
現在のテキスト位置にグリフの配列を表示します。
| 旧式 |
|---|
func showGlyphs([CGGlyph], at: [CGPoint])
対応する位置のセットにグリフのセットを描画します。
指定した位置にグリフの配列を表示します。
| 旧式 |
|---|
さまざまなオフセットを持つグリフの配列を描画します。
| 旧式 |
|---|
現在のテキスト位置、現在のテキスト行列で指定された点で文字配列を表示します。
| 旧式 |
|---|
指定した位置に文字列を表示します。
| 旧式 |
|---|
Core Graphics レイヤーの描画
func draw(CGLayer, at: CGPoint)
指定された点にレイヤーオブジェクトの内容を描画します。
func draw(CGLayer, in: CGRect)
レイヤーオブジェクトの内容を指定された長方形に描画します。
塗り、ストローク、影の色の設定
func setFillColor(CGColor)
CGColor を使用して、グラフィックスコンテキストで現在の塗りの色を設定します。
func setFillColor(UnsafePointer<CGFloat>)
現在の塗りつぶしの色を設定します。
func setFillColor(cyan: CGFloat, magenta: CGFloat, yellow: CGFloat, black: CGFloat, alpha: CGFloat)
現在の塗りつぶし色を DeviceCMYK の色空間の値に設定します。
func setFillColor(gray: CGFloat, alpha: CGFloat)
現在の塗りつぶしの色を DeviceGray の色空間内の値に設定します。
func setFillColor(red: CGFloat, green: CGFloat, blue: CGFloat, alpha: CGFloat)
現在の塗りつぶしの色を DeviceRGB 色空間の値に設定します。
func setFillColorSpace(CGColorSpace)
グラフィックスコンテキストでの塗りつぶしの色空間を設定します。
func setShadow(offset: CGSize, blur: CGFloat)
グラフィックスコンテキストでの陰影付けを有効にします。
func setShadow(offset: CGSize, blur: CGFloat, color: CGColor?)
色付きでグラフィックスコンテキストを陰影付けできます。
func setStrokeColor(CGColor)
CGColor を使用して、コンテキスト内の現在のストロークの色を設定します。
func setStrokeColor(UnsafePointer<CGFloat>)
現在のストロークの色を設定します。
func setStrokeColor(cyan: CGFloat, magenta: CGFloat, yellow: CGFloat, black: CGFloat, alpha: CGFloat)
現在のストロークの色を DeviceCMYK の色空間の値に設定します。
func setStrokeColor(gray: CGFloat, alpha: CGFloat)
現在のストロークの色を DeviceGray の色空間の値に設定します。
func setStrokeColor(red: CGFloat, green: CGFloat, blue: CGFloat, alpha: CGFloat)
現在のストロークの色を DeviceRGB の色空間の値に設定します。
func setStrokeColorSpace(CGColorSpace)
グラフィックスコンテキスト内のストロークの色空間を設定します。
func setStrokePattern(CGPattern, colorComponents: UnsafePointer<CGFloat>)
指定されたグラフィックスコンテキストでストロークパターンを設定します。
func setAlpha(CGFloat)
グラフィックスコンテキストで描画されるオブジェクトの不透明度を設定します。
現在のクリッピングパスを操作する
func clip(using: CGPathFillRule)
現在のクリッピングパスを変更します。
func clip(to: CGRect)
クリッピングパスを、現在のクリッピングパスと指定された長方形で定義された領域との交差に設定します。
func clip(to: [CGRect])
クリッピングパスを、現在のクリッピングパスと長方形の配列で定義された領域との交差に設定します。
func clip(to: CGRect, mask: CGImage)
指定された長方形内にマスクをマッピングし、グラフィックスコンテキストの現在のクリッピング領域と交差させます。
var boundingBoxOfClipPath: CGRect
クリッピングパスの境界となるボックスを返します。
透明なレイヤーの操作
func beginTransparencyLayer(in: CGRect, auxiliaryInfo: CFDictionary?)
指定された長方形で内容が囲まれた透明なレイヤーを開始します。
func beginTransparencyLayer(auxiliaryInfo: CFDictionary?)
透明なレイヤーを開始します。
func endTransparencyLayer()
透明なレイヤーを終了します。
現在の変換行列の操作
var ctm: CGAffineTransform
現在の変換行列を返します。
func rotate(by: CGFloat)
コンテキスト内でユーザー座標系を回転します。
func scaleBy(x: CGFloat, y: CGFloat)
コンテキスト内のユーザー座標系のスケールを変更します。
func translateBy(x: CGFloat, y: CGFloat)
コンテキスト内のユーザー座標系の原点を変更します。
func concatenate(CGAffineTransform)
指定された行列を使用してコンテキスト内のユーザー座標系を変換します。
パス描画オプションの設定
func setAllowsAntialiasing(Bool)
グラフィックスコンテキストのアンチエイリアスを許可するかどうかを設定します。
func setFlatness(CGFloat)
グラフィックスコンテキストでカーブしたパスの精度を設定します。
func setLineCap(CGLineCap)
グラフィックスコンテキストで描かれた線の端点のスタイルを設定します。
func setLineDash(phase: CGFloat, lengths: [CGFloat])
破線を描くためのパターンを設定します。
func setLineJoin(CGLineJoin)
グラフィックスコンテキスト内の接続された線の結合のスタイルを設定します。
func setLineWidth(CGFloat)
グラフィックスコンテキスト用の線の幅を設定します。
func setMiterLimit(CGFloat)
グラフィックスコンテキスト内の接続された線の結合の留め継ぎ制限を設定します。
func setPatternPhase(CGSize)
コンテキストのパターンフェーズを設定します。
func setFillPattern(CGPattern, colorComponents: UnsafePointer<CGFloat>)
指定されたグラフィックスコンテキストで塗りつぶしパターンを設定します。
func setShouldAntialias(Bool)
グラフィックスコンテキストのアンチエイリアスをオンまたはオフに設定します。
グラフィックス状態の保存と復元
func saveGState()
現在のグラフィックス状態のコピーをコンテキストのグラフィックス状態のスタックにプッシュします。
func restoreGState()
現在のグラフィックス状態を、最も最近保存された状態に設定します。
グラフィックスコンテキストの管理
func flush()
ウィンドウコンテキスト内のすべての保留中の描画操作を強制的に宛先デバイスにすぐレンダリングします。
func synchronize()
更新用のウィンドウコンテキストをマークします。
func setBlendMode(CGBlendMode)
グラフィックスコンテキストでサンプル値を合成する方法を設定します。
func setRenderingIntent(CGColorRenderingIntent)
現在のグラフィックス状態でレンダリングインテントを設定します。
ビットマップのグラフィックスコンテキストを管理する
これらのプロパティとメソッドは、"ビットマップのグラフィックスコンテキストの作成" にリストされているイニシャライザを使用して作成された CGContext オブジェクトとともに使用する場合にのみ有効です。
var bitmapInfo: CGBitmapInfo
ビットマップのグラフィックスコンテキストに関連付けられたビットマップ情報を取得します。
var alphaInfo: CGImageAlphaInfo
コンテキストに関連付けられたアルファ情報を返します。これは、ビットマップコンテキストがアルファ成分をどのように処理するかを示します。
var bitsPerComponent: Int
ビットマップコンテキストの成分ごとのビットを返します。
var bitsPerPixel: Int
ビットマップコンテキストのピクセルごとのビットを返します。
var bytesPerRow: Int
ビットマップコンテキストの 1 行あたりのバイト数を返します。
var colorSpace: CGColorSpace?
ビットマップコンテキストの色空間を返します。
var data: UnsafeMutableRawPointer?
ビットマップコンテキストに関連付けられたイメージデータへのポインタを返します。
var height: Int
ビットマップコンテキストの高さをピクセル単位で返します。
var width: Int
ビットマップコンテキストの幅をピクセル単位で返します。
func makeImage()
ビットマップのグラフィックスコンテキスト内のピクセルデータから CGImage を作成して返します。
PDF グラフィックスコンテキストの管理
これらのメソッドは、"PDF グラフィックスコンテキストの作成" にリストされているイニシャライザを使用して作成された CGContext オブジェクトとともに使用する場合にのみ有効です。
func beginPDFPage(CFDictionary?)
PDF グラフィックスコンテキストで新しいページを開始します。
func endPDFPage()
PDF グラフィックスコンテキストで現在のページを終了します。
func addDestination(CFString, at: CGPoint)
PDF グラフィックスコンテキストの現在のページ内のポイントがクリックされたときにジャンプ先を設定します。
func setDestination(CFString, for: CGRect)
現在の PDF ページ内の長方形がクリックされたときにジャンプ先を設定します。
func setURL(CFURL, for: CGRect)
PDF グラフィックスコンテキストで長方形に関連付けられた URL を設定します。
func addDocumentMetadata(CFData?)
カスタムメタデータを PDF ドキュメントに関連付けます。
func closePDF()
PDF 文書を閉じます。
ページに基づいたグラフィックスコンテキストの管理
func beginPage(mediaBox: UnsafePointer<CGRect>?)
ページに基づいたグラフィックスコンテキストで新しいページを開始します。
func endPage()
ページに基づいたグラフィックスコンテキストで現在のページを終了します。
Core Foundation の型での操作
class var typeID: CFTypeID
グラフィックスコンテキストの型 ID を返します。
定数
どの領域がパスの内部にあるかを決定するためのルールで、fillPath(using:) と clip(using:) メソッドで使用されます。
以下も見よ
関連した文書