ISurfaceHolder.LockCanvas メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
LockCanvas() |
サーフェス内のピクセルの編集を開始します。 |
LockCanvas(Rect) |
同様 |
LockCanvas()
サーフェス内のピクセルの編集を開始します。
[Android.Runtime.Register("lockCanvas", "()Landroid/graphics/Canvas;", "GetLockCanvasHandler:Android.Views.ISurfaceHolderInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Android.Graphics.Canvas? LockCanvas ();
[<Android.Runtime.Register("lockCanvas", "()Landroid/graphics/Canvas;", "GetLockCanvasHandler:Android.Views.ISurfaceHolderInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member LockCanvas : unit -> Android.Graphics.Canvas
戻り値
キャンバス サーフェスに描画するために使用します。
- 属性
注釈
サーフェス内のピクセルの編集を開始します。 返された Canvas を使用して、サーフェスのビットマップに描画できます。 サーフェスが作成されていない場合、または編集できない場合は、null が返されます。 通常、Surface がいつ使用できるようになるかを調べるには、 を実装 Callback#surfaceCreated Callback.surfaceCreated
する必要があります。
Surface のコンテンツは unlockCanvas() と lockCanvas() の間で保持されることはありません。このため、Surface 領域内のすべてのピクセルを書き込む必要があります。 このルールの唯一の例外は、ダーティ四角形が指定されている場合です。その場合、ダーティピクセル以外のピクセルは保持されます。
Surface の準備ができていないときに繰り返し呼び出す場合 (前 Callback#surfaceCreated Callback.surfaceCreated
または後 Callback#surfaceDestroyed Callback.surfaceDestroyed
)、CPU の消費を回避するために、呼び出しは低速のレートに調整されます。
null が返されない場合、この関数は、描画中にサーフェスを作成、破棄、または変更できないようにSurfaceView
、対応する#unlockCanvasAndPost
呼び出しまでロックを内部的に保持します。 これは、 で描画スレッド Callback#surfaceDestroyed Callback.surfaceDestroyed
と特別な同期を行う必要がないように、Surface に直接アクセスするよりも便利です。
の android.view.SurfaceHolder.lockCanvas()
Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
適用対象
LockCanvas(Rect)
同様#lockCanvas()
ですが、ダーティ四角形を指定できます。
[Android.Runtime.Register("lockCanvas", "(Landroid/graphics/Rect;)Landroid/graphics/Canvas;", "GetLockCanvas_Landroid_graphics_Rect_Handler:Android.Views.ISurfaceHolderInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Android.Graphics.Canvas? LockCanvas (Android.Graphics.Rect? dirty);
[<Android.Runtime.Register("lockCanvas", "(Landroid/graphics/Rect;)Landroid/graphics/Canvas;", "GetLockCanvas_Landroid_graphics_Rect_Handler:Android.Views.ISurfaceHolderInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member LockCanvas : Android.Graphics.Rect -> Android.Graphics.Canvas
パラメーター
- dirty
- Rect
変更されるサーフェスの領域。
戻り値
キャンバス サーフェスに描画するために使用します。
- 属性
注釈
同様#lockCanvas()
ですが、ダーティ四角形を指定できます。 その四角形内のすべてのピクセルを書き込む必要があります。ただし、ダーティ四角形の外側のピクセルは、lockCanvas() の次の呼び出しによって保持されます。
の android.view.SurfaceHolder.lockCanvas(android.graphics.Rect)
Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。