Riferimento API per le funzionalità di creazione dell'immagine di intelligenza artificiale nel SDK per app di Windows
Suggerimento
Fornire commenti e suggerimenti su queste API e sulle relative funzionalità creando un nuovo problema nel repository GitHub SDK per app di Windows. (Assicurarsi di includere Imaging nel titolo!)
Informazioni sulle API di SDK per app di Windows, supportate dall'intelligenza artificiale, che possono essere ridimensionate e nitide (risoluzione con risoluzione superiore delle immagini) e identificare gli oggetti all'interno di un'immagine (segmentazione immagine).
Per altri dettagli, vedere Introduzione all'imaging di intelligenza artificiale nella SDK per app di Windows.
Importante
Questa funzionalità non è ancora disponibile. È previsto che venga fornito in una prossima versione sperimentale del canale di SDK per app di Windows.
Il canale sperimentale SDK per app di Windows include API e funzionalità nelle fasi iniziali dello sviluppo. Tutte le API nel canale sperimentale sono soggette a revisioni estese e modifiche di rilievo e possono essere rimosse dalle versioni successive in qualsiasi momento. Non sono supportate per l'uso in ambienti di produzione e le app che usano funzionalità sperimentali non possono essere pubblicate in Microsoft Store.
Spazio dei nomi Microsoft.Graphics.Imaging
Fornisce API per i modelli di Machine Learning che ridimensionano e affinano le immagini.
Classe ImageBuffer
public sealed class ImageBuffer : System.IDisposable
Rappresenta una bitmap non compressa per un'interscambio di dati tra processi efficiente.
Osservazioni
ImageBuffer può essere usato con le API del modello di intelligenza artificiale, ad esempio TextRecognizer che richiedono dati di immagine. L'utilizzo tipico comporta la creazione di un oggetto ImageBuffer da un SoftwareBitmap esistente.
Proprietà ImageBuffer.Buffer
public Windows.Storage.Streams.IBuffer Buffer { get; }
Ottiene il buffer di immagini corrente.
Valore della proprietà
Buffer dell'immagine corrente.
Proprietà ImageBuffer.BufferLength
public uint BufferLength { get; }
Ottiene la lunghezza del buffer di immagini.
Valore della proprietà
Lunghezza del buffer dell'immagine.
Metodo ImageBuffer.Close
// This member is not implemented in C#
Elimina l'oggetto e le risorse associate.
Metodo ImageBuffer.CopyToBuffer(System.Byte[])
public void CopyToBuffer (byte[] values);
Copia il buffer corrente nel buffer di destinazione specificato.
Parametri
valori
Vettore di byte nel buffer.
Il metodo ImageBuffer.CreateBufferAttachedToBitmap(Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Graphics.Imaging.ImageBuffer CreateBufferAttachedToBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Creare un nuovo oggetto ImageBuffer da un oggetto SotftwareBitmap esistente ottenendo un oggetto IMemoryBufferReference dall'oggetto bitmap.
Parametri
softwareBitmap
SotftwareBitmap da cui creare ImageBuffer.
Rendiconto
ImageBuffer o Null se è un formato non supportato.
Osservazioni
Il SoftwareBitmap è bloccato fino al completamento dell'operazione asincrona e alla distruzione del nuovo ImageBuffer.
Metodo ImageBuffer.CreateCopyFromBitmap(Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Graphics.Imaging.ImageBuffer CreateCopyFromBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Creare un nuovo oggetto ImageBuffer da un oggetto SotftwareBitmap esistente copiando i dati bitmap sottostanti.
Parametri
softwareBitmap
SotftwareBitmap da cui creare ImageBuffer.
Rendiconto
ImageBuffer o Null se è un formato non supportato.
Osservazioni
Il SoftwareBitmap è bloccato fino al completamento dell'operazione asincrona e alla distruzione del nuovo ImageBuffer.
Il metodo "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);
Parametri
buffer
formato dei pixel
Larghezza
altezza
Rendiconto
Metodo ImageBuffer.CreateFromBufferWithStride(Windows.Storage.Streams.IBuffer, Microsoft.Graphics.Imaging.PixelFormat, System.UInt32, System.UInt32, System.UInt32)
public static Microsoft.Graphics.Imaging.ImageBuffer CreateFromBufferWithStride (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height, uint stride);
Parametri
buffer
formato dei pixel
Larghezza
altezza
passo
Rendiconto
Metodo CreateSoftwareBitmap di ImageBuffer
public Windows.Graphics.Imaging.SoftwareBitmap CreateSoftwareBitmap ();
Creare un nuovo SoftwareBitmap del tipo di pixel BGRA32 dai dati pixel archiviati in un oggetto ImageBuffer.
Rendiconto
Il nuovo SoftwareBitmap del tipo di pixel BGRA32.
Proprietà ImageBuffer.Height
public uint Height { get; }
Ottiene l'altezza dell'immagine, in pixel.
Valore della proprietà
Altezza dell'immagine, in pixel.
Costruttore ImageBuffer.#ctor(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32)
public ImageBuffer (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height);
Inizializza una nuova istanza della classe ImageBuffer.
Parametri
buffer
The ImageBuffer.
formato dei pixel
Formato dei pixel dell'immagine.
Larghezza
Larghezza dell'immagine, in pixel.
altezza
Altezza dell'immagine, in pixel.
Proprietà ImageBuffer.PixelFormat
public Microsoft.Graphics.Imaging.PixelFormat PixelFormat { get; }
Ottiene il formato dei pixel dell'immagine.
Valore della proprietà
Formato dei pixel dell'immagine.
Proprietà ImageBuffer.Width
public uint Width { get; }
Ottiene la larghezza dell'immagine, espressa in pixel.
Valore della proprietà
Larghezza dell'immagine, in pixel.
Classe ImageObjectExtractor
public sealed class ImageObjectExtractor : System.IDisposable
Metodo Chiudi di ImageObjectExtractor
// This member is not implemented in C#
Metodo ImageObjectExtractor.CreateWithImageBufferAsync(Microsoft.Graphics.Imaging.ImageBuffer)
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithImageBufferAsync (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer);
Parametri
imageBuffer
Rendiconto
Metodo ImageObjectExtractor.CreateWithSoftwareBitmapAsync(Windows.Graphics.Imaging.SoftwareBitmap)
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithSoftwareBitmapAsync (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Parametri
softwareBitmap
Rendiconto
Metodo ImageObjectExtractor.GetImageBufferObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)
public Microsoft.Graphics.Imaging.ImageBuffer GetImageBufferObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parametri
suggerimento
Rendiconto
Metodo ImageObjectExtractor.GetSoftwareBitmapObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)
public Windows.Graphics.Imaging.SoftwareBitmap GetSoftwareBitmapObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parametri
suggerimento
Rendiconto
Metodo ImageObjectExtractor.IsAvailable
public static bool IsAvailable ();
Rendiconto
Metodo ImageObjectExtractor.MakeAvailableAsync
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Rendiconto
Classe ImageObjectExtractorHint
public sealed class ImageObjectExtractorHint
Proprietà ImageObjectExtractorHint.ExcludePoints
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> ExcludePoints { get; }
Valore della proprietà
Costruttore ImageObjectExtractorHint.#ctor(Windows.Foundation.Collections.IVector{Windows.Graphics.RectInt32},Windows.Foundation.Collections.IVector{Windows.Graphics.PointInt32},Windows.Foundation.Collections.IVector{Windows.Graphics.PointInt32})
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);
Parametri
includeRects
includePoints
escludiPunti
Proprietà IncludePoints di ImageObjectExtractorHint
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> IncludePoints { get; }
Valore della proprietà
Proprietà ImageObjectExtractorHint.IncludeRects
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.RectInt32> IncludeRects { get; }
Valore della proprietà
Classe ImageScaler
public sealed class ImageScaler : System.IDisposable
Metodo ImageScaler.Close
// This member is not implemented in C#
Metodo ImageScaler.CreateAsync
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageScaler> CreateAsync ();
Rendiconto
Metodo ImageScaler.IsAvailable
public static bool IsAvailable ();
Rendiconto
Metodo "ImageScaler.MakeAvailableAsync"
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Rendiconto
Proprietà ImageScaler.MaxSupportedScaleFactor
public int MaxSupportedScaleFactor { get; }
Valore della proprietà
Metodo 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);
Parametri
imageBuffer
Larghezza
altezza
Rendiconto
Metodo 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);
Parametri
softwareBitmap
Larghezza
altezza
Rendiconto
Enumerazione PixelFormat
public enum PixelFormat
Specifica i tipi di layout binari per i dati bitmap sottostanti.
Campi di enumerazione
Non definito: 0
Il formato binario non è definito.
Rgb24: 1
Il formato binario è di 24 bit per pixel; 8 bit ciascuno vengono usati per i componenti rosso, verde e blu.
Argb32: 2
Formato binario a 32 bit per pixel; 8 bit ciascuno viene usato per i componenti alfa, rosso, verde e blu.
Rgba32: 3
Il formato binario è di 32 bit per pixel; 8 bit ciascuno viene usato per i componenti rosso, verde, blu e alfa. I componenti di colore vengono archiviati in ordine rosso, verde, blu e alfa.
Bgra32: 4
Il formato binario è di 32 bit per pixel; 8 bit ciascuno viene usato per i componenti blu, verde, rosso e alfa. I componenti di colore vengono archiviati in ordine blu, verde, rosso e alfa.
Grigio8: 5
Il formato binario è di 16 bit per pixel. Le informazioni sul colore specificano 65536 sfumature di grigio.