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é.