Sdílet prostřednictvím


Referenční dokumentace pro rozhraní API pro AI zobrazování v sadě Windows App SDK

Důležitý

K dispozici v nejnovější experimentální verzi Windows App SDK.

Experimentální kanál sady Windows App SDK zahrnuje rozhraní API a funkce v počátečních fázích vývoje. Všechna rozhraní API v experimentálním kanálu podléhají rozsáhlým revizem a zásadním změnám a je možné je kdykoli odebrat z následujících verzí. Experimentální funkce nejsou podporovány pro použití v produkčních prostředích a aplikacích, které je používají, nelze publikovat do Microsoft Storu.

  • Funkce Popis obrázku nejsou k dispozici v pevninské Číně.
  • Samostatné aplikace se nepodporují.

Seznamte se se sadou Windows App SDK rozhraní API zaměřených na zobrazování, podporovaná umělou inteligencí (AI), která podporují následující funkce:

  • Zvýšení rozlišení obrázku: škálování a zvýraznění obrázků
  • popis obrázku: vytváření textu, který popisuje obrázek
  • Segmentace obrazu: identifikace objektů v obraze

Další podrobnosti najdete v tématu Začínáme se službou AI imaging v sadě Windows App SDK.

Spropitné

Poskytněte zpětnou vazbu k těmto rozhraním API a jejich funkcím vytvořením nového problému v úložišti GitHub sady Windows App SDK (včetně image v názvu) nebo reagováním na existující problém.


Obor názvů Microsoft.Graphics.Imaging

Poskytuje rozhraní API pro modely strojového učení, které škálují a zostřují obrázky.

Třída ImageBuffer

public sealed class ImageBuffer : System.IDisposable

Představuje nekomprimovaný rastrový obrázek pro efektivní předávání dat mezi procesy.

Poznámky

ImageBuffer lze použít s rozhraními API modelu AI, jako je textRecognizer, která vyžadují data obrázku. Typické použití zahrnuje vytvoření ImageBufferu z existující mapy SoftwareBitmap.

ImageBuffer.Buffer – vlastnost

public Windows.Storage.Streams.IBuffer Buffer { get; }

Získává aktuální obrazový buffer.

Hodnota vlastnosti

Aktuální vyrovnávací paměť obrázku.

ImageBuffer.BufferLength – vlastnost

public uint BufferLength { get; }

Získá délku vyrovnávací paměti obrázku.

Hodnota vlastnosti

Délka vyrovnávací paměti obrázku.

Metoda ImageBuffer.Close

// This member is not implemented in C#

Odstraní objekt a přidružené prostředky.

Poznámky

V jazyce C# není implementováno.

Metoda ImageBuffer.CopyToBuffer(System.Byte[])

public void CopyToBuffer (byte[] values);

Zkopíruje aktuální vyrovnávací paměť do zadané cílové vyrovnávací paměti.

Parametry
hodnoty

Vektor bajtů v bufferu.

Metoda ImageBuffer.CreateBufferAttachedToBitmap(Windows.Graphics.Imaging.SoftwareBitmap)

public static Microsoft.Graphics.Imaging.ImageBuffer CreateBufferAttachedToBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);

Vytvořte nový ImageBuffer z existující SotftwareBitmap získáním IMemoryBufferReference z rastrového objektu.

Parametry
softwarový bitmapový obrázek

SoftwareBitmap pro vytvoření z ImageBufferu.

Návraty

ImageBuffer nebo null, pokud se jedná o nepodporovaný formát.

Poznámky

SoftwareBitmap se uzamkne, dokud se asynchronní operace neskončila a nový ImageBuffer se zničí.

Metoda ImageBuffer.CreateCopyFromBitmap(Windows.Graphics.Imaging.SoftwareBitmap)

public static Microsoft.Graphics.Imaging.ImageBuffer CreateCopyFromBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);

Vytvořte nový ImageBuffer z existující sotftwareBitmap zkopírováním podkladových rastrových dat.

Parametry
softwarový bitmapový obrázek

SoftwareBitmap pro vytvoření z ImageBufferu.

Návraty

ImageBuffer nebo null, pokud se jedná o nepodporovaný formát.

Poznámky

SoftwareBitmap se uzamkne, dokud se asynchronní operace neskončila a nový ImageBuffer se zničí.

Metoda ImageBuffer.CreateFromBuffer(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32)

public static Microsoft.Graphics.Imaging.ImageBuffer CreateFromBuffer (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height);
Parametry
vyrovnávací paměť
formát pixelu
šířka
výška
Návraty

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
vyrovnávací paměť
formát pixelu
šířka
výška
výrazný krok
Návraty

Metoda ImageBuffer.CreateSoftwareBitmap

public Windows.Graphics.Imaging.SoftwareBitmap CreateSoftwareBitmap ();

Vytvořte novou mapu SoftwareBitmap typu pixelů BGRA32 z dat pixelů uložených v imageBufferu.

Návraty

Nový SoftwareBitmap typu BGRA32.

ImageBuffer.Height – vlastnost

public uint Height { get; }

Získá výšku obrázku v pixelech.

Hodnota vlastnosti

Výška obrázku v pixelech

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);

Inicializuje novou instanci ImageBuffer třídy.

Parametry
vyrovnávací paměť

The ImageBuffer.

formát pixelu

Formát pixelu obrázku.

šířka

Šířka obrázku v pixelech.

výška

Výška obrázku v pixelech

ImageBuffer.PixelFormat – vlastnost

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

Získá formát pixelu obrázku.

Hodnota vlastnosti

Formát pixelu obrázku.

ImageBuffer.Width – vlastnost

public uint Width { get; }

Získá šířku obrázku v pixelech.

Hodnota vlastnosti

Šířka obrázku v pixelech.

třída ImageObjectExtractor

public sealed class ImageObjectExtractor : System.IDisposable

Metoda ImageObjectExtractor.Close

// This member is not implemented in C#
Poznámky

V jazyce C# není implementováno.

Metoda ImageObjectExtractor.CreateWithImageBufferAsync(Microsoft.Graphics.Imaging.ImageBuffer)

public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithImageBufferAsync (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer);
Parametry
imageBuffer
Návraty

Metoda ImageObjectExtractor.CreateWithSoftwareBitmapAsync(Windows.Graphics.Imaging.SoftwareBitmap)

public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithSoftwareBitmapAsync (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Parametry
softwarový bitmapový obrázek
Návraty

Metoda ImageObjectExtractor.GetImageBufferObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)

public Microsoft.Graphics.Imaging.ImageBuffer GetImageBufferObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parametry
hint
Návraty

Metoda ImageObjectExtractor.GetSoftwareBitmapObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)

public Windows.Graphics.Imaging.SoftwareBitmap GetSoftwareBitmapObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parametry
hint
Návraty

Metoda ImageObjectExtractor.IsAvailable

public static bool IsAvailable ();
Návraty

Metoda ImageObjectExtractor.MakeAvailableAsync

public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Návraty

ImageObjectExtractorHint – třída

public sealed class ImageObjectExtractorHint

ImageObjectExtractorHint.ExcludePoints – vlastnost

public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> ExcludePoints { get; }
Hodnota vlastnosti

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
includePoints
excludePoints

ImageObjectExtractorHint.IncludePoints – vlastnost

public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> IncludePoints { get; }
Hodnota vlastnosti

ImageObjectExtractorHint.IncludeRects – vlastnost

public System.Collections.Generic.IReadOnlyList<Windows.Graphics.RectInt32> IncludeRects { get; }
Hodnota vlastnosti

Třída ImageScaler

public sealed class ImageScaler : System.IDisposable

Metoda ImageScaler.Close

// This member is not implemented in C#
Poznámky

V jazyce C# není implementováno.

Metoda ImageScaler.CreateAsync

public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageScaler> CreateAsync ();
Návraty

Metoda ImageScaler.IsAvailable

public static bool IsAvailable ();
Návraty

Metoda ImageScaler.MakeAvailableAsync

public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Návraty

ImageScaler.MaxSupportedScaleFactor vlastnost

public int MaxSupportedScaleFactor { get; }
Hodnota vlastnosti

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
imageBuffer
šířka
výška
Návraty

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
softwarový bitmapový obrázek
šířka
výška
Návraty

PixelFormat – výčet

public enum PixelFormat

Určuje typy binárních rozložení podkladových rastrových dat.

Výčtové pole
Nedefinováno: 0

Binární formát není definován.

Rgb24: 1

Binární formát je 24 bitů na pixel; Pro červené, zelené a modré komponenty se používají 8 bitů.

Argb32: 2

Binární formát o 32 bitech na pixel, přičemž 8 bitů je použito pro alfa, červenou, zelenou a modrou složku.

Rgba32: 3

Binární formát je 32 bitů na pixel; Každý z nich se používá pro červené, zelené, modré a alfa komponenty. Barevné komponenty jsou uloženy v červeném, zeleném, modrém a alfa pořadí.

Bgra32: 4

Binární formát je 32 bitů na pixel; 8 bitů se používá pro modré, zelené, červené a alfa komponenty. Barevné komponenty jsou uložené v modrém, zeleném, červeném a alfa pořadí.

Šedá8: 5

Binární formát je 16 bitů na pixel. Informace o barvě určují 65536 odstínů šedé.