SKSurface Klasse
Definition
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.
Stellt das Back-End/die Ergebnisse der Zeichnung auf einen Zeichenbereich dar.
public class SKSurface : SkiaSharp.SKObject- Vererbung
Beispiele
var info = new SKImageInfo(256, 256);
using (var surface = SKSurface.Create(info)) {
SKCanvas canvas = surface.Canvas;
canvas.Clear(SKColors.White);
// configure our brush
var redBrush = new SKPaint {
Color = new SKColor(0xff, 0, 0),
IsStroke = true
};
var blueBrush = new SKPaint {
Color = new SKColor(0, 0, 0xff),
IsStroke = true
};
for (int i = 0; i < 64; i += 8) {
var rect = new SKRect(i, i, 256 - i - 1, 256 - i - 1);
canvas.DrawRect(rect, (i % 16 == 0) ? redBrush : blueBrush);
}
}
Im obigen Beispiel wird Folgendes erzeugt:
Hinweise
Die Oberfläche stellt das Back-End/die Ergebnisse der Zeichnung auf einen Zeichenbereich dar. Bei der Rasterzeichnung ist die Oberfläche Pixel, aber (z. B. beim Zeichnen in eine PDF- oder Canvas) speichert die Oberfläche die aufgezeichneten Befehle.For raster drawing, the surface will be pixels, but (for example) when drawing into a PDF or SKPicture canvas, the surface stores the recorded commands.
Die Oberfläche hat immer keine Nullabmessungen. Wenn eine Anforderung für eine neue Oberfläche vorhanden ist und eine der angeforderten Dimensionen null ist, wird " <langword="null" /> zurückgegeben.
Nachdem Sie eine Oberfläche mit einer seiner Create Methoden erstellt haben, können Sie in den zeichenbereich zeichnen, der von der Canvas Eigenschaft zurückgegeben wird. Sobald die Zeichnung abgeschlossen ist, können Sie eine SKImage abrufen, indem Sie die Snapshot Methode aufrufen.
Eigenschaften
| Name | Beschreibung |
|---|---|
| Canvas |
Ruft den Zeichenbereich für diese Oberfläche ab, der zum Zeichnen verwendet werden kann. |
| Context |
Ruft den GPU-Aufzeichnungskontext ab, der dieser Oberfläche zugeordnet ist. |
| Handle |
Dient zum Abrufen oder Festlegen des Handles auf das zugrunde liegende systemeigene Objekt. (Geerbt von SKObject) |
| IgnorePublicDispose |
Ruft einen Wert ab, der angibt, ob der Aufruf der Öffentlichen Dispose() no-opwerden soll. (Geerbt von SKNativeObject) |
| IsDisposed |
Ruft einen Wert ab, der angibt, ob das Objekt bereits verworfen wurde. (Geerbt von SKNativeObject) |
| OwnsHandle |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Objekt sein Handle besitzt und das systemeigene Objekt zerstören soll, wenn es verworfen wird. (Geerbt von SKNativeObject) |
| SurfaceProperties |
Ruft die Surface-Eigenschaftskonfiguration ab. |
Methoden
| Name | Beschreibung |
|---|---|
| Create(GRContext, Boolean, SKImageInfo, Int32, GRSurfaceOrigin, SKSurfaceProperties, Boolean) |
Erstellt eine neue Oberfläche, deren Inhalt auf ein Offscreen-Renderziel gezeichnet wird, das von der Oberfläche zugewiesen wird. |
| Create(GRContext, Boolean, SKImageInfo, Int32, GRSurfaceOrigin) |
Erstellt eine neue Oberfläche, deren Inhalt auf ein Offscreen-Renderziel gezeichnet wird, das von der Oberfläche zugewiesen wird. |
| Create(GRContext, Boolean, SKImageInfo, Int32, SKSurfaceProperties) |
Erstellt eine neue Oberfläche, deren Inhalt auf ein Offscreen-Renderziel gezeichnet wird, das von der Oberfläche zugewiesen wird. |
| Create(GRContext, Boolean, SKImageInfo, Int32) |
Erstellt eine neue Oberfläche, deren Inhalt auf ein Offscreen-Renderziel gezeichnet wird, das von der Oberfläche zugewiesen wird. |
| Create(GRContext, Boolean, SKImageInfo, SKSurfaceProperties) |
Erstellt eine neue Oberfläche, deren Inhalt auf ein Offscreen-Renderziel gezeichnet wird, das von der Oberfläche zugewiesen wird. |
| Create(GRContext, Boolean, SKImageInfo) |
Erstellt eine neue Oberfläche, deren Inhalt auf ein Offscreen-Renderziel gezeichnet wird, das von der Oberfläche zugewiesen wird. |
| Create(GRContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType, SKColorSpace, SKSurfaceProperties) |
Umschließt ein bereits vorhandenes Back-End-3D-API-Renderziel als Oberfläche. |
| Create(GRContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType, SKColorSpace) |
Umschließt ein bereits vorhandenes Back-End-3D-API-Renderziel als Oberfläche. |
| Create(GRContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType, SKSurfaceProperties) |
Umschließt ein bereits vorhandenes Back-End-3D-API-Renderziel als Oberfläche. |
| Create(GRContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType) |
Umschließt ein bereits vorhandenes Back-End-3D-API-Renderziel als Oberfläche. |
| Create(GRContext, GRBackendRenderTarget, SKColorType, SKSurfaceProperties) |
Umschließt ein bereits vorhandenes Back-End-3D-API-Renderziel als Oberfläche. |
| Create(GRContext, GRBackendRenderTarget, SKColorType) |
Umschließt ein bereits vorhandenes 3D-API-Renderziel als Oberfläche. |
| Create(GRContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType, SKColorSpace, SKSurfaceProperties) |
Umschließt eine bereits vorhandene Back-End-3D-API-Textur als Oberfläche. |
| Create(GRContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType, SKColorSpace) |
Umschließt eine bereits vorhandene Back-End-3D-API-Textur als Oberfläche. |
| Create(GRContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType, SKSurfaceProperties) |
Umschließt eine bereits vorhandene Back-End-3D-API-Textur als Oberfläche. |
| Create(GRContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType) |
Umschließt eine bereits vorhandene Back-End-3D-API-Textur als Oberfläche. |
| Create(GRContext, GRBackendTexture, GRSurfaceOrigin, SKColorType, SKSurfaceProperties) |
Umschließt eine bereits vorhandene Back-End-3D-API-Textur als Oberfläche. |
| Create(GRContext, GRBackendTexture, GRSurfaceOrigin, SKColorType) |
Umschließt eine bereits vorhandene Back-End-3D-API-Textur als Oberfläche. |
| Create(GRContext, GRBackendTexture, SKColorType, SKSurfaceProperties) |
Umschließt eine bereits vorhandene Back-End-3D-API-Textur als Oberfläche. |
| Create(GRContext, GRBackendTexture, SKColorType) |
Umschließt eine bereits vorhandene 3D-API-Textur als Oberfläche. |
| Create(GRRecordingContext, Boolean, SKImageInfo, Int32, GRSurfaceOrigin, SKSurfaceProperties, Boolean) |
Erstellt eine GPU-beschleunigte Oberfläche mit allen Optionen, einschließlich Mipmap-Unterstützung. |
| Create(GRRecordingContext, Boolean, SKImageInfo, Int32, GRSurfaceOrigin) |
Erstellt eine GPU-beschleunigte Oberfläche mit Multisampling und angegebenem Ursprung. |
| Create(GRRecordingContext, Boolean, SKImageInfo, Int32, SKSurfaceProperties) |
Erstellt eine GPU-beschleunigte Oberfläche mit Multisampling und Eigenschaften. |
| Create(GRRecordingContext, Boolean, SKImageInfo, Int32) |
Erstellt eine GPU-beschleunigte Oberfläche mit Multisampling-Unterstützung. |
| Create(GRRecordingContext, Boolean, SKImageInfo, SKSurfaceProperties) |
Erstellt eine GPU-beschleunigte Oberfläche mit den angegebenen Bildinformationen und -eigenschaften. |
| Create(GRRecordingContext, Boolean, SKImageInfo) |
Erstellt eine GPU-beschleunigte Oberfläche mit den angegebenen Bildinformationen. |
| Create(GRRecordingContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType, SKColorSpace, SKSurfaceProperties) |
Erstellt eine Oberfläche, die ein GPU-Back-End-Renderziel mit Farbraum und Eigenschaften umschließt. |
| Create(GRRecordingContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType, SKColorSpace) |
Erstellt eine Oberfläche, die ein GPU-Back-End-Renderziel mit Farbraum umschließt. |
| Create(GRRecordingContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType, SKSurfaceProperties) |
Erstellt eine Oberfläche, die ein GPU-Back-End-Renderziel mit Ursprung und Eigenschaften umschließt. |
| Create(GRRecordingContext, GRBackendRenderTarget, GRSurfaceOrigin, SKColorType) |
Erstellt eine Oberfläche, die ein GPU-Back-End-Renderziel mit dem angegebenen Ursprung umschließt. |
| Create(GRRecordingContext, GRBackendRenderTarget, SKColorType, SKSurfaceProperties) |
Erstellt eine Oberfläche, die ein GPU-Back-End-Renderziel mit Oberflächeneigenschaften umschließt. |
| Create(GRRecordingContext, GRBackendRenderTarget, SKColorType) |
Erstellt eine Oberfläche, die ein GPU-Back-End-Renderziel umschließt. |
| Create(GRRecordingContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType, SKColorSpace, SKSurfaceProperties) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur mit allen Optionen umschließt. |
| Create(GRRecordingContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType, SKColorSpace) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur mit Multisampling und Farbraum umschließt. |
| Create(GRRecordingContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType, SKSurfaceProperties) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur mit Multisampling und Eigenschaften umschließt. |
| Create(GRRecordingContext, GRBackendTexture, GRSurfaceOrigin, Int32, SKColorType) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur mit Multisampling umschließt. |
| Create(GRRecordingContext, GRBackendTexture, GRSurfaceOrigin, SKColorType, SKSurfaceProperties) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur mit Ursprung und Eigenschaften umschließt. |
| Create(GRRecordingContext, GRBackendTexture, GRSurfaceOrigin, SKColorType) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur mit dem angegebenen Ursprung umschließt. |
| Create(GRRecordingContext, GRBackendTexture, SKColorType, SKSurfaceProperties) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur mit Oberflächeneigenschaften umschließt. |
| Create(GRRecordingContext, GRBackendTexture, SKColorType) |
Erstellt eine Oberfläche, die eine GPU-Back-End-Textur umschließt. |
| Create(SKImageInfo, Int32, SKSurfaceProperties) |
Erstellt eine neue Oberfläche aus den angegebenen Bildparametern und Oberflächeneigenschaften. |
| Create(SKImageInfo, Int32) |
Erstellt eine neue Oberfläche aus den angegebenen Bildparametern. |
| Create(SKImageInfo, IntPtr, Int32, SKSurfaceProperties) |
Erstellt eine neue Oberfläche aus den angegebenen Bildparametern, den bereitgestellten Puffer- und Oberflächeneigenschaften. |
| Create(SKImageInfo, IntPtr, Int32, SKSurfaceReleaseDelegate, Object, SKSurfaceProperties) |
Erstellt eine neue Oberfläche mit den angegebenen Bildparametern mithilfe eines bereitgestellten Puffers. |
| Create(SKImageInfo, IntPtr, Int32, SKSurfaceReleaseDelegate, Object) |
Erstellt eine neue Oberfläche mit den angegebenen Bildparametern mithilfe eines bereitgestellten Puffers. |
| Create(SKImageInfo, IntPtr, Int32) |
Erstellt eine neue Oberfläche mit den angegebenen Bildparametern mithilfe eines bereitgestellten Puffers. |
| Create(SKImageInfo, IntPtr, SKSurfaceProperties) |
Erstellt eine neue Oberfläche aus den angegebenen Bildparametern und Oberflächeneigenschaften. |
| Create(SKImageInfo, IntPtr) |
Erstellt eine neue Oberfläche mit den angegebenen Bildparametern mithilfe eines bereitgestellten Puffers. |
| Create(SKImageInfo, SKSurfaceProperties) |
Erstellt eine neue Oberfläche aus den angegebenen Bildparametern und Oberflächeneigenschaften. |
| Create(SKImageInfo) |
Erstellt eine neue Oberfläche mit den angegebenen Bildparametern. |
| Create(SKPixmap, SKSurfaceProperties) |
Erstellt eine neue Oberfläche mit den angegebenen Pixmap- und Oberflächeneigenschaften. |
| Create(SKPixmap) |
Erstellt eine neue Oberfläche mit der angegebenen pixmap. |
| CreateNull(Int32, Int32) |
Erstellt eine neue Oberfläche ohne Hintergrundpixel. |
| Dispose() |
Gibt alle von diesem SKNativeObjectRessourcen verwendeten Ressourcen frei. (Geerbt von SKNativeObject) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den SKSurface verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. |
| DisposeInternal() |
Löst einen Dispose-Wert aus, der den Wert von IgnorePublicDispose. (Geerbt von SKNativeObject) |
| DisposeManaged() |
Implementiert durch abgeleitete SKObject Typen, um verwaltete Objekte zu zerstören. (Geerbt von SKObject) |
| DisposeNative() |
Implementiert durch abgeleitete SKObject Typen, um systemeigene Objekte zu zerstören. (Geerbt von SKObject) |
| DisposeUnownedManaged() |
Implementiert durch abgeleitete SKObject Typen zum Verwerfen von verwalteten Objekten, die nicht im Besitz dieser Instanz sind. (Geerbt von SKObject) |
| Draw(SKCanvas, Single, Single, SKPaint) |
Zeichnet diese Oberfläche an der angegebenen Position auf den angegebenen Zeichenbereich. |
| Draw(SKCanvas, Single, Single, SKSamplingOptions, SKPaint) |
Zeichnet diese Oberfläche an der angegebenen Position auf den angegebenen Zeichenbereich. |
| Draw(SKCanvas, SKPoint, SKSamplingOptions, SKPaint) |
Zeichnet die Oberfläche an der angegebenen Position mit den angegebenen Samplingoptionen und Farben auf den angegebenen Zeichenbereich. |
| Flush() |
Stellt sicher, dass alle ausstehenden Draw-Vorgänge an die GPU übermittelt werden. |
| Flush(Boolean, Boolean) |
Stellt sicher, dass alle ausstehenden Draw-Vorgänge mit angegebenen Optionen an die GPU übermittelt werden. |
| PeekPixels() |
Gibt die Pixel zurück, wenn sie verfügbar sind. |
| PeekPixels(SKPixmap) |
Gibt die Pixmap der Oberfläche zurück. |
| ReadPixels(SKImageInfo, IntPtr, Int32, Int32, Int32) |
Kopiert die Pixel aus der Oberfläche in den angegebenen Puffer. |
| Snapshot() |
Erstellt eine Momentaufnahme der Oberfläche und gibt sie als Bild zurück. |
| Snapshot(SKRectI) |
Erstellt ein Bild aus dem angegebenen Bereich der Oberfläche. |
