API-Referenz für KI-Imageerstellungsfeatures im Windows App SDK
Tipp
Geben Sie Feedback zu diesen APIs und deren Funktionalität, indem Sie ein neues Problem im GitHub-Repository des Windows App SDK erstellen. (Stellen Sie sicher, dass Sie die Imageerstellung in den Titel aufnehmen!)
Erfahren Sie mehr über die Windows App SDK-APIs , die von künstlicher Intelligenz (AI) unterstützt werden, die Bilder sowohl skalieren als auch schärfen (Bild-Superauflösung) sowie Objekte innerhalb eines Bilds (Image Segmentation) identifizieren können.
Weitere Informationen finden Sie unter "Erste Schritte mit KI-Imageerstellung" im Windows App SDK.
Wichtig
Dieses Feature ist noch nicht verfügbar. Es wird erwartet, dass es in einer bevorstehenden experimentellen Kanalversion des Windows App SDK ausgeliefert wird.
Der experimentelle Kanal des Windows App SDK enthält APIs und Features in frühen Entwicklungsphasen. Alle APIs im experimentellen Kanal unterliegen umfangreichen Überarbeitungen und Breaking Changes und können jederzeit aus nachfolgenden Versionen entfernt werden. Sie werden nicht für die Verwendung in Produktionsumgebungen unterstützt, und Apps, die experimentelle Features verwenden, können nicht im Microsoft Store veröffentlicht werden.
Microsoft.Graphics.Imaging-Namespace
Stellt APIs für Machine Learning-Modelle bereit, die Bilder skalieren und schärfen.
ImageBuffer-Klasse
public sealed class ImageBuffer : System.IDisposable
Stellt eine nicht komprimierte Bitmap für eine effiziente prozessübergreifende Marshalling dar.
Hinweise
ImageBuffer kann mit AI-Modell-APIs wie TextRecognizer verwendet werden, die Bilddaten erfordern. Die typische Verwendung umfasst das Erstellen eines ImageBuffers aus einer vorhandenen SoftwareBitmap.
ImageBuffer.Buffer-Eigenschaft
public Windows.Storage.Streams.IBuffer Buffer { get; }
Ruft den aktuellen Bildpuffer ab.
Eigenschaftswert
Der aktuelle Bildpuffer.
ImageBuffer.BufferLength-Eigenschaft
public uint BufferLength { get; }
Ruft die Länge des Bildpuffers ab.
Eigenschaftswert
Die Länge des Bildpuffers.
ImageBuffer.Close-Methode
// This member is not implemented in C#
Entfernt das Objekt und die zugeordneten Ressourcen.
ImageBuffer.CopyToBuffer(System.Byte[])-Methode
public void CopyToBuffer (byte[] values);
Kopiert den aktuellen Puffer in den bereitgestellten Zielpuffer.
Parameter
values
Größe des -Puffers in Byte.
ImageBuffer.CreateBufferAttachedToBitmap(Windows.Graphics.Imaging.SoftwareBitmap)-Methode
public static Microsoft.Graphics.Imaging.ImageBuffer CreateBufferAttachedToBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Erstellen Sie einen neuen ImageBuffer aus einer vorhandenen SotftwareBitmap, indem Sie ein IMemoryBufferReference aus dem Bitmapobjekt abrufen.
Parameter
softwareBitmap
The SotftwareBitmap to create the ImageBuffer from.
Gibt zurück
Der ImageBuffer oder null, wenn es sich um ein nicht unterstütztes Format handelt.
Hinweise
Die SoftwareBitmap ist gesperrt, bis der asynchrone Vorgang abgeschlossen ist und der neue ImageBuffer zerstört wird.
ImageBuffer.CreateCopyFromBitmap(Windows.Graphics.Imaging.SoftwareBitmap)-Methode
public static Microsoft.Graphics.Imaging.ImageBuffer CreateCopyFromBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Erstellen Sie einen neuen ImageBuffer aus einer vorhandenen SotftwareBitmap, indem Sie die zugrunde liegenden Bitmapdaten kopieren.
Parameter
softwareBitmap
The SotftwareBitmap to create the ImageBuffer from.
Gibt zurück
Der ImageBuffer oder null, wenn es sich um ein nicht unterstütztes Format handelt.
Hinweise
Die SoftwareBitmap ist gesperrt, bis der asynchrone Vorgang abgeschlossen ist und der neue ImageBuffer zerstört wird.
ImageBuffer.CreateFromBuffer(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32)-Methode
public static Microsoft.Graphics.Imaging.ImageBuffer CreateFromBuffer (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height);
Parameter
Puffer
pixelFormat
width
height
Gibt zurück
ImageBuffer.CreateFromBufferWithStride(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32,System.UInt32)-Methode
public static Microsoft.Graphics.Imaging.ImageBuffer CreateFromBufferWithStride (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height, uint stride);
Parameter
Puffer
pixelFormat
width
height
Stride
Gibt zurück
ImageBuffer.CreateSoftwareBitmap-Methode
public Windows.Graphics.Imaging.SoftwareBitmap CreateSoftwareBitmap ();
Erstellen Sie eine neue SoftwareBitmap vom Pixeltyp BGRA32 aus den Pixeldaten, die in einem ImageBuffer gespeichert sind.
Gibt zurück
Die neue SoftwareBitmap vom Pixeltyp BGRA32.
ImageBuffer.Height-Eigenschaft
public uint Height { get; }
Die Höhe des Bilds in Pixeln.
Immobilienwert
Die Höhe des Bilds in Pixel.
ImageBuffer.#ctor(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32)-Konstruktor
public ImageBuffer (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height);
Initialisiert eine neue Instanz der ImageBuffer-Klasse.
Parameter
Puffer
The ImageBuffer.
pixelFormat
Das Pixelformat des Bilds.
width
Die Breite des Bilds in Pixel.
height
Die Höhe des Bilds in Pixel.
ImageBuffer.PixelFormat-Eigenschaft
public Microsoft.Graphics.Imaging.PixelFormat PixelFormat { get; }
Ruft das Pixelformat des Bilds ab.
Immobilienwert
Das Pixelformat des Bilds.
ImageBuffer.Width-Eigenschaft
public uint Width { get; }
Die Breite des Bilds in Pixeln.
Eigenschaftswert
Die Breite des Bilds in Pixel.
ImageObjectExtractor-Klasse
public sealed class ImageObjectExtractor : System.IDisposable
ImageObjectExtractor.Close-Methode
// This member is not implemented in C#
ImageObjectExtractor.CreateWithImageBufferAsync(Microsoft.Graphics.Imaging.ImageBuffer)-Methode
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithImageBufferAsync (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer);
Parameter
imageBuffer
Gibt zurück
ImageObjectExtractor.CreateWithSoftwareBitmapAsync(Windows.Graphics.Imaging.SoftwareBitmap)-Methode
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithSoftwareBitmapAsync (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Parameter
softwareBitmap
Gibt zurück
ImageObjectExtractor.GetImageBufferObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)-Methode
public Microsoft.Graphics.Imaging.ImageBuffer GetImageBufferObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parameter
Hinweis
Gibt zurück
ImageObjectExtractor.GetSoftwareBitmapObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)-Methode
public Windows.Graphics.Imaging.SoftwareBitmap GetSoftwareBitmapObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parameter
Hinweis
Gibt zurück
ImageObjectExtractor.IsAvailable-Methode
public static bool IsAvailable ();
Gibt zurück
ImageObjectExtractor.MakeAvailableAsync-Methode
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Gibt zurück
ImageObjectExtractorHint-Klasse
public sealed class ImageObjectExtractorHint
ImageObjectExtractorHint.ExcludePoints-Eigenschaft
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> ExcludePoints { get; }
Eigenschaftswert
ImageObjectExtractorHint.#ctor(Windows.Foundation.Collections.IVector{Windows.Graphics.RectInt32},Windows.Foundation.Collections.IVector{Windows.Graphics.PointInt32},Windows.Foundation.Collections.IVector{Windows.Graphics.PointInt32})-Konstruktor
public ImageObjectExtractorHint (System.Collections.Generic.IList<Windows.Graphics.RectInt32> includeRects, System.Collections.Generic.IList<Windows.Graphics.PointInt32> includePoints, System.Collections.Generic.IList<Windows.Graphics.PointInt32> excludePoints);
Parameter
includeRects
includePoints
excludePoints
ImageObjectExtractorHint.IncludePoints-Eigenschaft
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> IncludePoints { get; }
Eigenschaftswert
ImageObjectExtractorHint.IncludeRects-Eigenschaft
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.RectInt32> IncludeRects { get; }
Eigenschaftswert
ImageObjectRemover-Klasse
public sealed class ImageObjectRemover : System.IDisposable
ImageObjectRemover.Close-Methode
// This member is not implemented in C#
ImageObjectRemover.CreateAsync-Methode
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectRemover> CreateAsync ();
Gibt zurück
ImageObjectRemover.IsAvailable-Methode
public static bool IsAvailable ();
Gibt zurück
ImageObjectRemover.MakeAvailableAsync-Methode
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Gibt zurück
ImageObjectRemover.RemoveFromImageBuffer(Microsoft.Graphics.Imaging.ImageBuffer,Microsoft.Graphics.Imaging.ImageBuffer)-Methode
public Microsoft.Graphics.Imaging.ImageBuffer RemoveFromImageBuffer (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer, Microsoft.Graphics.Imaging.ImageBuffer imageBufferMask);
Parameter
imageBuffer
imageBufferMask
Gibt zurück
ImageObjectRemover.RemoveFromSoftwareBitmap(Windows.Graphics.Imaging.SoftwareBitmap,Windows.Graphics.Imaging.SoftwareBitmap)-Methode
public Windows.Graphics.Imaging.SoftwareBitmap RemoveFromSoftwareBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap, Windows.Graphics.Imaging.SoftwareBitmap softwareBitmapMask);
Parameter
softwareBitmap
softwareBitmapMask
Gibt zurück
ImageScaler-Klasse
public sealed class ImageScaler : System.IDisposable
ImageScaler.Close-Methode
// This member is not implemented in C#
ImageScaler.CreateAsync-Methode
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageScaler> CreateAsync ();
Gibt zurück
ImageScaler.IsAvailable-Methode
public static bool IsAvailable ();
Gibt zurück
ImageScaler.MakeAvailableAsync-Methode
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Gibt zurück
ImageScaler.MaxSupportedScaleFactor-Eigenschaft
public int MaxSupportedScaleFactor { get; }
Eigenschaftswert
ImageScaler.ScaleImageBuffer(Microsoft.Graphics.Imaging.ImageBuffer,System.Int32,System.Int32)-Methode
public Microsoft.Graphics.Imaging.ImageBuffer ScaleImageBuffer (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer, int width, int height);
Parameter
imageBuffer
width
height
Gibt zurück
ImageScaler.ScaleSoftwareBitmap(Windows.Graphics.Imaging.SoftwareBitmap,System.Int32,System.Int32)-Methode
public Windows.Graphics.Imaging.SoftwareBitmap ScaleSoftwareBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap, int width, int height);
Parameter
softwareBitmap
width
height
Gibt zurück
PixelFormat-Aufzählung
public enum PixelFormat
Gibt die Typen von binären Layouts für die zugrunde liegenden Bitmapdaten an.
Enumerationsfeld
Undefiniert: 0
Binärformat ist nicht definiert.
Rgb24: 1
Das Binärformat beträgt 24 Bit pro Pixel; 8 Bits werden jeweils für die roten, grünen und blauen Komponenten verwendet.
Argb32: 2
Gibt an, dass das Format 64 Bit pro Pixel ist, wobei jeweils 16 Bit für die Alphakomponente sowie die rote, grüne und die blaue Komponente verwendet werden.
Rgba32: 3
Das Binärformat beträgt 32 Bit pro Pixel. 8 Bits werden jeweils für die roten, grünen, blauen und Alpha-Komponenten verwendet. Die Farbkomponenten werden in roter, grüner, blauer und alphaner Reihenfolge gespeichert.
Bgra32: 4
Das Binärformat beträgt 32 Bit pro Pixel. 8 Bits werden jeweils für die Blau-, Grün-, Rot- und Alphakomponenten verwendet. Die Farbkomponenten werden in blauer, grüner, roter und alphaner Reihenfolge gespeichert.
Grau8: 5
Das Binärformat beträgt 16 Bit pro Pixel. Die Farbinformationen gibt 65536 Grautöne an.
SegmentationPoint-Struktur
public struct SegmentationPoint
Felder
Typ
x
j
SegmentationPointType-Aufzählung
public enum SegmentationPointType