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 が返されない場合、この関数は、対応する #unlockCanvasAndPost 呼び出しまで内部的にロックを保持し、描画中にサーフェスを作成、破棄、または変更する SurfaceView を防ぎます。 これは、Surfaceに直接アクセスするよりも便利な場合があります。Callback#surfaceDestroyed Callback.surfaceDestroyedで描画スレッドと特別な同期を行う必要はありません。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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
変更されるSurfaceの領域。
返品
キャンバス サーフェスに描画するために使用します。
- 属性
注釈
#lockCanvas()と同じように、ダーティ四角形を指定できます。 その四角形内のすべてのピクセルを書き込む必要があります。ただし、ダーティ四角形の外側のピクセルは、lockCanvas() の次の呼び出しによって保持されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。