Dokumentacja referencyjna API do generowania obrazów przy użyciu sztucznej inteligencji w zestawie SDK aplikacji systemu Windows
Ważny
Dostępne w najnowszej wersji eksperymentalnego kanału zestawu SDK aplikacji systemu Windows.
Eksperymentalny kanał zestawu SDK aplikacji systemu Windows obejmuje interfejsy API i funkcje we wczesnych etapach programowania. Wszystkie interfejsy API w kanale eksperymentalnym podlegają rozbudowanym poprawkom i zmianom powodujących niezgodność i mogą zostać usunięte z kolejnych wersji w dowolnym momencie. Funkcje eksperymentalne nie są obsługiwane w środowiskach produkcyjnych i aplikacjach, które ich używają, nie mogą być publikowane w sklepie Microsoft Store.
- Funkcje tworzenia obrazów nie są dostępne w Chinach.
- Niezapakowane aplikacje nie są obsługiwane.
Dowiedz się więcej o interfejsach API zestawu SDK aplikacji systemu Windows do tworzenia obrazów, które, bazując na sztucznej inteligencji, obsługują następujące możliwości:
- Super rozdzielczość obrazu: skalowanie i wyostrzanie obrazów
- opis obrazu: tworzenie tekstu opisującego obraz
- Segmentacja obrazów: identyfikowanie obiektów na obrazie
Aby uzyskać więcej informacji, zobacz Rozpoczynanie pracy z obrazowaniem sztucznej inteligencji w zestawie SDK aplikacji systemu Windows.
Napiwek
Prześlij opinię na temat tego interfejsu API i jego funkcji, tworząc nowe zgłoszenie w repozytorium GitHub Windows App SDK (uwzględniając Imaging w tytule) lub odpowiadając na istniejące zgłoszenie.
Microsoft.Graphics.Imaging, przestrzeń nazw (namespace)
Udostępnia interfejsy API dla modeli uczenia maszynowego, które skaluje i wyostrzają obrazy.
Klasa ImageBuffer
public sealed class ImageBuffer : System.IDisposable
Reprezentuje nieskompresowaną mapę bitową umożliwiającą wydajną wymianę danych między procesami.
Uwagi
Usługa ImageBuffer może być używana z interfejsami API modelu sztucznej inteligencji, takimi jak TextRecognizer, które wymagają danych obrazu. Typowe użycie polega na utworzeniu elementu ImageBuffer na podstawie istniejącej mapy SoftwareBitmap.
Właściwość ImageBuffer.Buffer
public Windows.Storage.Streams.IBuffer Buffer { get; }
Pobiera bieżący bufor obrazu.
Wartość właściwości
Bieżący bufor obrazu.
Właściwość ImageBuffer.BufferLength
public uint BufferLength { get; }
Pobiera długość buforu obrazu.
Wartość właściwości
Długość buforu obrazu.
Metoda ImageBuffer.Close
// This member is not implemented in C#
Usuwa obiekt i skojarzone zasoby.
Uwagi
Nie zaimplementowano w języku C#.
Metoda ImageBuffer.CopyToBuffer(System.Byte[])
public void CopyToBuffer (byte[] values);
Kopiuje bieżący bufor do podanego buforu docelowego.
Parametry
Wartości
Wektor bajtów w buforze.
Metoda ImageBuffer.CreateBufferAttachedToBitmap(Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Graphics.Imaging.ImageBuffer CreateBufferAttachedToBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Utwórz nową usługę ImageBuffer z istniejącej mapy SotftwareBitmap, uzyskując element IMemoryBufferReference z obiektu mapy bitowej.
Parametry
softwareBitmap
SoftwareBitmap, z którego zostanie utworzony ImageBuffer.
Zwraca
Wartość ImageBuffer lub zero, jeśli jest to nieobsługiwany format.
Uwagi
Obiekt SoftwareBitmap jest zablokowany do momentu zakończenia operacji asynchronicznej i zniszczenia nowego ImageBuffer.
ImageBuffer.CreateCopyFromBitmap(Metoda Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Graphics.Imaging.ImageBuffer CreateCopyFromBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Utwórz nową usługę ImageBuffer z istniejącej mapy SotftwareBitmap, kopiując bazowe dane mapy bitowej.
Parametry
softwareBitmap
SoftwareBitmap, z którego zostanie utworzony ImageBuffer.
Zwraca
Wartość ImageBuffer lub zero, jeśli jest to nieobsługiwany format.
Uwagi
Obiekt SoftwareBitmap jest zablokowany do momentu zakończenia operacji asynchronicznej i zniszczenia nowego ImageBuffer.
ImageBuffer.CreateFromBuffer(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32) — metoda
public static Microsoft.Graphics.Imaging.ImageBuffer CreateFromBuffer (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height);
Parametry
bufor
format piksela
Szerokość
wysokość
Zwraca
ImageBuffer.CreateFromBufferWithStride(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32,System.UInt32) — metoda
public static Microsoft.Graphics.Imaging.ImageBuffer CreateFromBufferWithStride (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height, uint stride);
Parametry
bufor
format piksela
Szerokość
wysokość
kroczyć
Zwraca
Metoda ImageBuffer.CreateSoftwareBitmap
public Windows.Graphics.Imaging.SoftwareBitmap CreateSoftwareBitmap ();
Utwórz nową mapę SoftwareBit typu pikseli BGRA32 na podstawie danych pikseli przechowywanych w elemecie ImageBuffer.
Zwraca
Nowy SoftwareBitmap typu pikselowego BGRA32.
Właściwość ImageBuffer.Height
public uint Height { get; }
Pobiera wysokość obrazu w pikselach.
Wartość właściwości
Wysokość obrazu w pikselach.
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);
Inicjuje nowe wystąpienie klasy ImageBuffer.
Parametry
bufor
The ImageBuffer.
format piksela
Format pikseli obrazu.
Szerokość
Szerokość obrazu w pikselach.
wysokość
Wysokość obrazu w pikselach.
Właściwość ImageBuffer.PixelFormat
public Microsoft.Graphics.Imaging.PixelFormat PixelFormat { get; }
Pobiera format pikseli obrazu.
Wartość właściwości
Format pikseli obrazu.
Właściwość ImageBuffer.Width
public uint Width { get; }
Pobiera szerokość obrazu w pikselach.
Wartość właściwości
Szerokość obrazu w pikselach.
Klasa ImageObjectExtractor
public sealed class ImageObjectExtractor : System.IDisposable
Metoda ImageObjectExtractor.Close
// This member is not implemented in C#
Uwagi
Nie zaimplementowano w języku C#.
ImageObjectExtractor.CreateWithImageBufferAsync(Microsoft.Graphics.Imaging.ImageBuffer) metoda
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithImageBufferAsync (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer);
Parametry
bufor obrazu
Zwraca
Metoda ImageObjectExtractor.CreateWithSoftwareBitmapAsync(Windows.Graphics.Imaging.SoftwareBitmap)
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithSoftwareBitmapAsync (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Parametry
softwareBitmap
Zwraca
ImageObjectExtractor.GetImageBufferObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)
public Microsoft.Graphics.Imaging.ImageBuffer GetImageBufferObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parametry
wskazówka
Zwraca
ImageObjectExtractor.GetSoftwareBitmapObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint) metoda
public Windows.Graphics.Imaging.SoftwareBitmap GetSoftwareBitmapObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parametry
wskazówka
Zwraca
Metoda ImageObjectExtractor.IsAvailable
public static bool IsAvailable ();
Zwraca
Metoda ImageObjectExtractor.MakeAvailableAsync
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Zwraca
Klasa ImageObjectExtractorHint
public sealed class ImageObjectExtractorHint
Właściwość ImageObjectExtractorHint.ExcludePoints
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> ExcludePoints { get; }
Wartość właściwości
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);
Parametry
includeRects
zawierajPunkty
wyklucz punkty
Właściwość ImageObjectExtractorHint.IncludePoints
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> IncludePoints { get; }
Wartość właściwości
Właściwość ImageObjectExtractorHint.IncludeRects
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.RectInt32> IncludeRects { get; }
Wartość właściwości
Klasa ImageScaler
public sealed class ImageScaler : System.IDisposable
Metoda ImageScaler.Close
// This member is not implemented in C#
Uwagi
Nie zaimplementowano w języku C#.
metoda ImageScaler.CreateAsync
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageScaler> CreateAsync ();
Zwraca
Metoda ImageScaler.IsAvailable
public static bool IsAvailable ();
Zwraca
ImageScaler.MakeAvailableAsync, Metoda
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Zwraca
Właściwość ImageScaler.MaxSupportedScaleFactor
public int MaxSupportedScaleFactor { get; }
Wartość właściwości
Metoda ImageScaler.ScaleImageBuffer(Microsoft.Graphics.Imaging.ImageBuffer,System.Int32,System.Int32)
public Microsoft.Graphics.Imaging.ImageBuffer ScaleImageBuffer (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer, int width, int height);
Parametry
bufor obrazu
Szerokość
wysokość
Zwraca
Metoda ImageScaler.ScaleSoftwareBitmap(Windows.Graphics.Imaging.SoftwareBitmap,System.Int32,System.Int32)
public Windows.Graphics.Imaging.SoftwareBitmap ScaleSoftwareBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap, int width, int height);
Parametry
softwareBitmap
Szerokość
wysokość
Zwraca
Wyliczenie PixelFormat
public enum PixelFormat
Określa typy układów binarnych dla podstawowych danych bitmapy.
Pola typu enum
Niezdefiniowane: 0
Format binarny jest niezdefiniowany.
Rgb24: 1
Format binarny to 24 bity na piksel; Każde 8 bitów jest używane dla czerwonych, zielonych i niebieskich składników.
Argb32: 2
Format binarny 32 bity na piksel; każde 8 bitów jest używane dla składników alfa, czerwony, zielony i niebieski.
Rgba32: 3
Format binarny to 32 bity na piksel; Każdy z 8 bitów jest używany dla każdego składnika: czerwonego, zielonego, niebieskiego i alfa. Składniki kolorów są przechowywane w kolejności czerwonej, zielonej, niebieskiej i alfa.
Bgra32: 4
Format binarny to 32 bity na piksel; po 8 bitów jest używane dla składnika niebieskiego, zielonego, czerwonego i alfa. Składniki kolorów są przechowywane w kolejności niebieskiej, zielonej, czerwonej i alfa.
Szary8: 5
Format binarny to 16 bitów na piksel. Informacje o kolorze określają 65536 odcieni szarości.