API-ref voor AI-imaging in de Windows App SDK
Belangrijk
Beschikbaar in de nieuwste experimentele kanaal versie van de Windows App SDK.
Het experimentele kanaal van de Windows App SDK bevat API's en functies in een vroeg stadium van ontwikkeling. Alle API's in het experimentele kanaal zijn onderhevig aan uitgebreide revisies en ingrijpende wijzigingen en kunnen te allen tijde uit volgende releases worden verwijderd. Experimentele functies worden niet ondersteund voor gebruik in productieomgevingen en apps die deze gebruiken, kunnen niet worden gepubliceerd naar de Microsoft Store.
- Imaging-functies zijn niet beschikbaar in China.
- Uitgepakte apps worden niet ondersteund.
Meer informatie over de Windows App SDK imaging-API's, ondersteund door kunstmatige intelligentie (AI), die de volgende mogelijkheden ondersteunen:
- Superresolutie van afbeeldingen: afbeeldingen schalen en verscherpen
- Beschrijving van afbeelding: tekst produceren die de afbeelding beschrijft
- afbeeldingssegmentatie: objecten in een afbeelding identificeren
Zie Aan de slag met AI-imaging in de Windows App SDK-voor meer informatie.
Advies
Geef feedback over deze API's en hun functionaliteit door een nieuw probleem te maken in de GitHub-opslagplaats van de Windows App SDK (inclusief Imaging in de titel) of door te reageren op een bestaand probleem.
Microsoft.Graphics.Imaging-naamruimte
Biedt API's voor machine learning-modellen die afbeeldingen schalen en verscherpen.
ImageBuffer-klasse
public sealed class ImageBuffer : System.IDisposable
Vertegenwoordigt een ongecomprimeerde bitmap voor efficiënte marshaling tussen processen.
Opmerkingen
ImageBuffer kan worden gebruikt met AI-model-API's zoals TextRecognizer waarvoor afbeeldingsgegevens zijn vereist. Typisch gebruik omvat het maken van een ImageBuffer op basis van een bestaande SoftwareBitmap.
ImageBuffer.Buffer-eigenschap
public Windows.Storage.Streams.IBuffer Buffer { get; }
Hiermee haalt u de huidige afbeeldingsbuffer op.
Eigenschapswaarde
De huidige afbeeldingsbuffer.
ImageBuffer.BufferLength-eigenschap
public uint BufferLength { get; }
Hiermee haalt u de lengte van de afbeeldingsbuffer op.
Eigenschapswaarde
De lengte van de afbeeldingsbuffer.
De methode ImageBuffer.Close
// This member is not implemented in C#
Hiermee verwijdert u het object en de bijbehorende resources.
Opmerkingen
Niet geïmplementeerd in C#.
Methode ImageBuffer.CopyToBuffer(System.Byte[])
public void CopyToBuffer (byte[] values);
Kopieert de huidige buffer naar de opgegeven doelbuffer.
Parameterwaarden
waarden
Vector van bytes in de buffer.
Methode ImageBuffer.CreateBufferAttachedToBitmap(Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Graphics.Imaging.ImageBuffer CreateBufferAttachedToBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Maak een nieuwe ImageBuffer op basis van een bestaande SotftwareBitmap door een IMemoryBufferReference op te halen uit het bitmapobject.
Parameterwaarden
softwareBitmap
De SotftwareBitmap waaruit de ImageBuffer moet worden gemaakt.
Retouren
De ImageBuffer of null als het een niet-ondersteunde indeling is.
Opmerkingen
De SoftwareBitmap is vergrendeld totdat de asynchrone bewerking is voltooid en de nieuwe ImageBuffer wordt vernietigd.
Methode ImageBuffer.CreateCopyFromBitmap(Windows.Graphics.Imaging.SoftwareBitmap)
public static Microsoft.Graphics.Imaging.ImageBuffer CreateCopyFromBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Maak een nieuwe ImageBuffer op basis van een bestaande SotftwareBitmap door de onderliggende bitmapgegevens te kopiëren.
Parameterwaarden
softwareBitmap
De SotftwareBitmap waaruit de ImageBuffer moet worden gemaakt.
Retouren
De ImageBuffer of null als het een niet-ondersteunde indeling is.
Opmerkingen
De SoftwareBitmap is vergrendeld totdat de asynchrone bewerking is voltooid en de nieuwe ImageBuffer wordt vernietigd.
Methode 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);
Parameterwaarden
buffer
pixelformaat
Breedte
hoogte
Retouren
Methode 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);
Parameterwaarden
buffer
pixelformaat
Breedte
hoogte
schrijden
Retouren
Methode ImageBuffer.CreateSoftwareBitmap
public Windows.Graphics.Imaging.SoftwareBitmap CreateSoftwareBitmap ();
Maak een nieuwe SoftwareBitmap van pixeltype BGRA32 op basis van de pixelgegevens die zijn opgeslagen in een ImageBuffer.
Retouren
De nieuwe SoftwareBitmap van pixeltype BGRA32.
De eigenschap ImageBuffer.Height
public uint Height { get; }
Hiermee haalt u de hoogte van de afbeelding in pixels op.
Eigenschapswaarde
De hoogte van de afbeelding, in pixels.
ImageBuffer.#ctor(Windows.Storage.Streams.IBuffer,Microsoft.Graphics.Imaging.PixelFormat,System.UInt32,System.UInt32) constructor
public ImageBuffer (Windows.Storage.Streams.IBuffer buffer, Microsoft.Graphics.Imaging.PixelFormat pixelFormat, uint width, uint height);
Initialiseert een nieuw exemplaar van de klasse ImageBuffer.
Parameterwaarden
buffer
De ImageBuffer.
pixelformaat
De pixelindeling van de afbeelding.
Breedte
De breedte van de afbeelding, in pixels.
hoogte
De hoogte van de afbeelding, in pixels.
Eigenschap ImageBuffer.PixelFormat
public Microsoft.Graphics.Imaging.PixelFormat PixelFormat { get; }
Haalt de pixelindeling van de afbeelding op.
Eigenschapswaarde
De pixelindeling van de afbeelding.
Eigenschap ImageBuffer.Width
public uint Width { get; }
Hiermee wordt de breedte van de afbeelding in pixels opgehaald.
Eigenschapswaarde
De breedte van de afbeelding, in pixels.
Klasse ImageObjectExtractor
public sealed class ImageObjectExtractor : System.IDisposable
Methode ImageObjectExtractor.Close
// This member is not implemented in C#
Opmerkingen
Niet geïmplementeerd in C#.
Methode ImageObjectExtractor.CreateWithImageBufferAsync(Microsoft.Graphics.Imaging.ImageBuffer)
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithImageBufferAsync (Microsoft.Graphics.Imaging.ImageBuffer imageBuffer);
Parameterwaarden
beeldbuffer
Retouren
Methode ImageObjectExtractor.CreateWithSoftwareBitmapAsync(Windows.Graphics.Imaging.SoftwareBitmap)
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageObjectExtractor> CreateWithSoftwareBitmapAsync (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap);
Parameterwaarden
softwareBitmap
Retouren
Methode ImageObjectExtractor.GetImageBufferObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)
public Microsoft.Graphics.Imaging.ImageBuffer GetImageBufferObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parameterwaarden
hint
Retouren
Methode ImageObjectExtractor.GetSoftwareBitmapObjectMask(Microsoft.Graphics.Imaging.ImageObjectExtractorHint)
public Windows.Graphics.Imaging.SoftwareBitmap GetSoftwareBitmapObjectMask (Microsoft.Graphics.Imaging.ImageObjectExtractorHint hint);
Parameterwaarden
hint
Retouren
De methode ImageObjectExtractor.IsAvailable
public static bool IsAvailable ();
Retouren
Methode `ImageObjectExtractor.MakeAvailableAsync`
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Retouren
Klasse ImageObjectExtractorHint
public sealed class ImageObjectExtractorHint
Eigenschap ExcludePoints van ImageObjectExtractorHint
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> ExcludePoints { get; }
Eigenschapswaarde
ImageObjectExtractorHint.#ctor(Windows.Foundation.Collections.IVector{Windows.Graphics.RectInt32},Windows.Foundation.Collections.IVector{Windows.Graphics.PointInt32},Windows.Foundation.Collections.IVector{Windows.Graphics.PointInt32}) constructor
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);
Parameterwaarden
includeRects
punten opnemen
puntenUitsluiten
De eigenschap ImageObjectExtractorHint.IncludePoints
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.PointInt32> IncludePoints { get; }
Eigenschapswaarde
De eigenschap ImageObjectExtractorHint.IncludeRects
public System.Collections.Generic.IReadOnlyList<Windows.Graphics.RectInt32> IncludeRects { get; }
Eigenschapswaarde
ImageScaler-klasse
public sealed class ImageScaler : System.IDisposable
ImageScaler.Close-methode
// This member is not implemented in C#
Opmerkingen
Niet geïmplementeerd in C#.
De ImageScaler.CreateAsync-methode
public static Windows.Foundation.IAsyncOperation<Microsoft.Graphics.Imaging.ImageScaler> CreateAsync ();
Retouren
Methode ImageScaler.IsAvailable
public static bool IsAvailable ();
Retouren
De methode ImageScaler.MakeAvailableAsync
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Retouren
De eigenschap ImageScaler.MaxSupportedScaleFactor
public int MaxSupportedScaleFactor { get; }
Eigenschapswaarde
Methode 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);
Parameterwaarden
beeldbuffer
Breedte
hoogte
Retouren
ImageScaler.ScaleSoftwareBitmap-methode(Windows.Graphics.Imaging.SoftwareBitmap,System.Int32,System.Int32)
public Windows.Graphics.Imaging.SoftwareBitmap ScaleSoftwareBitmap (Windows.Graphics.Imaging.SoftwareBitmap softwareBitmap, int width, int height);
Parameterwaarden
softwareBitmap
Breedte
hoogte
Retouren
PixelFormat enum
public enum PixelFormat
Hiermee geeft u de typen binaire indelingen voor de onderliggende bitmapgegevens.
Enum-velden
Niet gedefinieerd: 0
Binaire indeling is niet gedefinieerd.
Rgb24: 1
De binaire indeling is 24 bits per pixel; 8 bits worden elk gebruikt voor de rode, groene en blauwe componenten.
Argb32: 2
De binaire indeling 32 bits per pixel; 8 bits worden elk gebruikt voor de alfa-, rode, groene en blauwe componenten.
Rgba32: 3
De binaire indeling is 32 bits per pixel; 8 bits worden elk gebruikt voor de rode, groene, blauwe en alfa-componenten. De kleuronderdelen worden opgeslagen in rode, groene, blauwe en alfa-volgorde.
Bgra32: 4
De binaire indeling is 32 bits per pixel; 8 bits worden elk gebruikt voor de blauwe, groene, rode en alfa-componenten. De kleuronderdelen worden opgeslagen in blauwe, groene, rode en alfa-volgorde.
Grijs8: 5
Het binaire formaat is 16 bits per pixel. De kleurinformatie geeft 65536 grijstinten aan.