Canvas.SaveLayer Methode

Definition

Namespace:: Android.Graphics

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
SaveLayer(RectF, Paint)	Dies verhält sich genauso wie save(), aber zusätzlich wird die Zeichnung zu einem Offscreen-Renderingziel zugewiesen und umgeleitet.
SaveLayer(RectF, Paint, SaveFlags)	Dies verhält sich genauso wie save(), aber zusätzlich wird die Zeichnung zu einer Offscreen-Bitmap zugewiesen und umgeleitet.
SaveLayer(Single, Single, Single, Single, Paint)	Der Einfachheit halber `#saveLayer(RectF, Paint)` werden die vier Float-Koordinaten des Begrenzungsrechtecks verwendet.
SaveLayer(Single, Single, Single, Single, Paint, SaveFlags)	Hilfsversion von saveLayer() mit vier Werten anstelle eines RectF.

SaveLayer(RectF, Paint)

Dies verhält sich genauso wie save(), aber zusätzlich wird die Zeichnung zu einem Offscreen-Renderingziel zugewiesen und umgeleitet.

[Android.Runtime.Register("saveLayer", "(Landroid/graphics/RectF;Landroid/graphics/Paint;)I", "GetSaveLayer_Landroid_graphics_RectF_Landroid_graphics_Paint_Handler")]
public virtual int SaveLayer(Android.Graphics.RectF? bounds, Android.Graphics.Paint? paint);

[<Android.Runtime.Register("saveLayer", "(Landroid/graphics/RectF;Landroid/graphics/Paint;)I", "GetSaveLayer_Landroid_graphics_RectF_Landroid_graphics_Paint_Handler")>]
abstract member SaveLayer : Android.Graphics.RectF * Android.Graphics.Paint -> int
override this.SaveLayer : Android.Graphics.RectF * Android.Graphics.Paint -> int

Parameter

bounds: RectF

Kann null sein. Die maximale Größe des Offscreen-Renderziels muss (in lokalen Koordinaten) sein.

paint: Paint

Dies wird kopiert und auf den Offscreen angewendet, wenn restore() aufgerufen wird.

Gibt zurück

Int32

wert, der an restoreToCount() übergeben werden soll, um dieses Save() auszugleichen

Attribute: RegisterAttribute

Hinweise

Dies verhält sich genauso wie save(), aber zusätzlich wird die Zeichnung zu einem Offscreen-Renderingziel zugewiesen und umgeleitet.

<strong>Hinweis:</strong> diese Methode ist sehr teuer, was mehr als doppelte Renderingkosten für enthaltene Inhalte verursacht. Vermeiden Sie die Verwendung dieser Methode nach Möglichkeit, und verwenden Sie stattdessen eine android.view.View#LAYER_TYPE_HARDWARE hardware layer Ansicht, um einen Xfermode- oder Farbfilter oder Alpha anzuwenden, da sie wesentlich besser als diese Methode ist.

Alle Zeichnungsaufrufe werden an ein neu zugeordnetes Offscreen-Renderingziel weitergeleitet. Nur wenn der Ausgleichsaufruf zur Wiederherstellung() erfolgt, ist dieser offscreen-Puffer, der auf das aktuelle Ziel der Canvas zurückgezeichnet wird (was möglicherweise eine vorherige Ebene sein kann, wenn diese Aufrufe geschachtelt sind).

Attribute von Paint - Paint#getAlpha() alpha, Paint#getXfermode() Xfermodeund Paint#getColorFilter() ColorFilter werden angewendet, wenn das Offscreen-Renderingziel zurückgezeichnet wird, wenn restore() aufgerufen wird.

Java Dokumentation für android.graphics.Canvas.saveLayer(android.graphics.RectF, android.graphics.Paint).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

SaveLayer(RectF, Paint, SaveFlags)

Dies verhält sich genauso wie save(), aber zusätzlich wird die Zeichnung zu einer Offscreen-Bitmap zugewiesen und umgeleitet.

[Android.Runtime.Register("saveLayer", "(Landroid/graphics/RectF;Landroid/graphics/Paint;I)I", "GetSaveLayer_Landroid_graphics_RectF_Landroid_graphics_Paint_IHandler")]
public virtual int SaveLayer(Android.Graphics.RectF? bounds, Android.Graphics.Paint? paint, Android.Graphics.SaveFlags saveFlags);

[<Android.Runtime.Register("saveLayer", "(Landroid/graphics/RectF;Landroid/graphics/Paint;I)I", "GetSaveLayer_Landroid_graphics_RectF_Landroid_graphics_Paint_IHandler")>]
abstract member SaveLayer : Android.Graphics.RectF * Android.Graphics.Paint * Android.Graphics.SaveFlags -> int
override this.SaveLayer : Android.Graphics.RectF * Android.Graphics.Paint * Android.Graphics.SaveFlags -> int

Parameter

bounds: RectF

Kann null sein. Die maximale Größe der Offscreen-Bitmap muss (in lokalen Koordinaten) sein.

paint: Paint

Dies wird kopiert und auf den Offscreen angewendet, wenn restore() aufgerufen wird.

saveFlags: SaveFlags

siehe _SAVE_FLAG Konstanten, wird in der Regel #ALL_SAVE_FLAG aus Leistungsgründen empfohlen.

Gibt zurück

Int32

wert, der an restoreToCount() übergeben werden soll, um dieses Save() auszugleichen

Attribute: RegisterAttribute

Hinweise

Dies verhält sich genauso wie save(), aber zusätzlich wird die Zeichnung zu einer Offscreen-Bitmap zugewiesen und umgeleitet.

<strong>Hinweis:</strong> diese Methode ist sehr teuer, was mehr als doppelte Renderingkosten für enthaltene Inhalte verursacht. Vermeiden Sie diese Methode, insbesondere, wenn die bereitgestellten Grenzen groß sind. Es wird empfohlen, eine android.view.View#LAYER_TYPE_HARDWARE hardware layer Ansicht zu verwenden, um einen Xfermode, Farbfilter oder Alpha anzuwenden, da es viel besser als diese Methode ist.

Alle Zeichnungsaufrufe werden an eine neu zugeordnete Offscreen-Bitmap weitergeleitet. Nur wenn der Ausgleichsaufruf zur Wiederherstellung() erfolgt, ist dieser offscreen-Puffer, der auf das aktuelle Ziel der Canvas zurückgezeichnet wird (entweder der Bildschirm, die Zielbitmap oder die vorherige Ebene).

Attribute von Paint - Paint#getAlpha() alpha, Paint#getXfermode() Xfermodeund Paint#getColorFilter() ColorFilter werden angewendet, wenn die Offscreen-Bitmap zurückgezeichnet wird, wenn restore() aufgerufen wird.

Ab API-Ebene ist die einzige gültige Build.VERSION_CODES#PsaveFlagsAPI-Ebene#ALL_SAVE_FLAG. Alle anderen Flags werden ignoriert.

Dieses Element ist veraltet. Verwenden Sie stattdessen #saveLayer(RectF, Paint).

Java Dokumentation für android.graphics.Canvas.saveLayer(android.graphics.RectF, android.graphics.Paint, int).

Gilt für:

SaveLayer(Single, Single, Single, Single, Paint)

Der Einfachheit halber #saveLayer(RectF, Paint) werden die vier Float-Koordinaten des Begrenzungsrechtecks verwendet.

[Android.Runtime.Register("saveLayer", "(FFFFLandroid/graphics/Paint;)I", "GetSaveLayer_FFFFLandroid_graphics_Paint_Handler")]
public virtual int SaveLayer(float left, float top, float right, float bottom, Android.Graphics.Paint? paint);

[<Android.Runtime.Register("saveLayer", "(FFFFLandroid/graphics/Paint;)I", "GetSaveLayer_FFFFLandroid_graphics_Paint_Handler")>]
abstract member SaveLayer : single * single * single * single * Android.Graphics.Paint -> int
override this.SaveLayer : single * single * single * single * Android.Graphics.Paint -> int

Parameter

left: Single

top: Single

right: Single

bottom: Single

paint: Paint

Gibt zurück

Int32

Attribute: RegisterAttribute

Hinweise

Der Einfachheit halber #saveLayer(RectF, Paint) werden die vier Float-Koordinaten des Begrenzungsrechtecks verwendet.

Java Dokumentation für android.graphics.Canvas.saveLayer(float, float, float, float, android.graphics.Paint).

Gilt für:

SaveLayer(Single, Single, Single, Single, Paint, SaveFlags)

Hilfsversion von saveLayer() mit vier Werten anstelle eines RectF.

[Android.Runtime.Register("saveLayer", "(FFFFLandroid/graphics/Paint;I)I", "GetSaveLayer_FFFFLandroid_graphics_Paint_IHandler")]
public virtual int SaveLayer(float left, float top, float right, float bottom, Android.Graphics.Paint? paint, Android.Graphics.SaveFlags saveFlags);

[<Android.Runtime.Register("saveLayer", "(FFFFLandroid/graphics/Paint;I)I", "GetSaveLayer_FFFFLandroid_graphics_Paint_IHandler")>]
abstract member SaveLayer : single * single * single * single * Android.Graphics.Paint * Android.Graphics.SaveFlags -> int
override this.SaveLayer : single * single * single * single * Android.Graphics.Paint * Android.Graphics.SaveFlags -> int