Freigeben über


API-Referenz für KI-Imageerstellung im Windows App SDK

Wichtig

Im neuesten experimentellen Kanal-Release für das Windows App SDK verfügbar.

Der experimentelle Kanal des Windows App SDK umfasst 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. Experimentelle Features werden nicht für die Verwendung in Produktionsumgebungen und Apps unterstützt, die sie verwenden, können nicht im Microsoft Store veröffentlicht werden.

  • Bildgebungsfunktionen sind in China nicht verfügbar.
  • Entpackte Apps werden nicht unterstützt.

Erfahren Sie mehr über die Windows App SDK Imaging-APIs, die durch künstliche Intelligenz (KI) unterstützt werden und die folgenden Funktionen bieten:

  • Bild-Superauflösung: Skalieren und Schärfen von Bildern
  • Bildbeschreibung: Erstellen von Text, der das Bild beschreibt
  • Bildsegmentierung: Identifizieren von Objekten innerhalb eines Bilds

Weitere Informationen finden Sie unter "Erste Schritte mit KI-Imageerstellung" 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 (einschließlich Imaging- im Titel) oder indem Sie auf ein vorhandenes Problemreagieren.


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 Puffers ().

ImageBuffer.Close-Methode

// This member is not implemented in C#

Entfernt das Objekt und die zugeordneten Ressourcen.

Hinweise

In C# nicht implementiert.

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.

Eigenschaftswert

Die Höhe des Bilds in Pixeln.

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 ImageCell-Klasse.

Parameter
Puffer

The ImageBuffer.

pixelFormat

Das Format der Pixeldaten.

width

Die Breite des Bilds in Pixeln.

height

Die Höhe des Bilds in Pixeln.

ImageBuffer.PixelFormat-Eigenschaft

public Microsoft.Graphics.Imaging.PixelFormat PixelFormat { get; }

Ruft das Pixelformat des Bilds ab.

Eigenschaftswert

Das Format der Pixeldaten.

ImageBuffer.Width-Eigenschaft

public uint Width { get; }

Die Breite des Bilds in Pixeln.

Eigenschaftswert

Die Breite des Bilds in Pixeln.

ImageObjectExtractor-Klasse

public sealed class ImageObjectExtractor : System.IDisposable

ImageObjectExtractor.Close-Methode

// This member is not implemented in C#
Hinweise

In C# nicht implementiert.

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

ImageScaler-Klasse

public sealed class ImageScaler : System.IDisposable

ImageScaler.Close-Methode

// This member is not implemented in C#
Hinweise

In C# nicht implementiert.

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
Nicht definiert (0)

Binärformat ist nicht definiert.

Rgb24: 1

Gibt an, dass das Format 24 Bit pro Pixel ist, wobei jeweils 8 Bits für die rote, grüne und die blaue Komponente verwendet werden.

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

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. Die Farbkomponenten werden in roter, grüner, blauer und alphaner Reihenfolge gespeichert.

Bgra32: 4

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. Die Farbkomponenten werden in blauer, grüner, roter und alphaner Reihenfolge gespeichert.

Gray8: 5

Das Binärformat beträgt 16 Bit pro Pixel. Die Farbinformationen gibt 65536 Grautöne an.