API-referentie voor door AI-ondersteunde tekstherkenning (OCR) in de Windows App SDK
Belangrijk
Deze functie is nog niet beschikbaar. Het wordt naar verwachting verzonden in een aankomende experimentele release in de kanalen en van de Windows App SDK.
De Windows App SDK experimenteel kanaal bevat API's en functies in vroege ontwikkelingsfasen. Alle API's in het experimentele kanaal zijn onderhevig aan uitgebreide revisies en ingrijpende wijzigingen en kunnen op elk moment worden verwijderd uit latere releases. Ze worden niet ondersteund voor gebruik in productieomgevingen en apps die gebruikmaken van experimentele functies kunnen niet worden gepubliceerd naar de Microsoft Store.
Meer informatie over de Windows App SDK API's, ondersteund door kunstmatige intelligentie (AI), waarmee tekst (tekens, woorden, regels, veelhoekige tekstgrenzen en betrouwbaarheidsniveaus voor elke overeenkomst) in afbeeldingen kunnen worden gedetecteerd en geëxtraheerd naar leesbare tekenstromen.
Zie Aan de slag met Tekstherkenning (OCR) in de Windows App SDKvoor meer informatie.
Fooi
Geef feedback over deze API's en hun functionaliteit door een nieuw probleem te maken in de GitHub-opslagplaats van de Windows App SDK. (Zorg ervoor dat u OCR- in de titel opneemt!)
Microsoft.Windows.Vision-naamruimte
Biedt API's voor machine learning-modellen waarmee de tekstinhoud van afbeeldingen wordt geanalyseerd.
DetectedLineStyle (enum)
public enum DetectedLineStyle
Hiermee geeft u de lijnstijlen op die kunnen worden herkend.
Velden
Handgeschreven: 0
De tekstregel is handgeschreven.
Overige: 1
De tekstregel is niet handgeschreven.
Enumeratie OrientationDetectionOptions
public enum OrientationDetectionOptions
Hiermee specificeert u de tekstoriëntaties die kunnen worden herkend.
Velden
Geen: 0
Oriëntatie wordt niet herkend.
DetectOrientation: 1
De oriëntatie wordt herkend.
RecognizedLine-klasse
public sealed class RecognizedLine
Vertegenwoordigt één regel herkende tekst.
Style-eigenschap van RecognizedLine
public Microsoft.Windows.Vision.RecognizedLineStyle Style { get; }
Verkrijgt de herkende lijnstijl.
Eigenschapswaarde
de erkende lijnstijl.
Opmerkingen
Bevat of de regel tekst handgeschreven is of niet en het niveau van de herkenningsbetrouwbaarheid.
De eigenschap RecognizedLine.Text
public string Text { get; }
Hiermee haalt u de tekst van de herkende regel op.
Eigenschapswaarde
De tekst van de herkende zin.
Opmerkingen
Alle woorden samengevoegd met spaties.
Eigenschap RecognizedLine.Words
public Microsoft.Windows.Vision.RecognizedWord[] Words { get; }
De woorden in de herkende regel.
Eigenschapswaarde
De woorden in de herkende regel.
RecognizedLineStyle-struct
public struct RecognizedLineStyle
Geeft de stijl weer van de herkende lijn.
Velden
Vertrouwen
Het betrouwbaarheidsniveau van de lijnstijlherkenning.
Naam
De naam van de lijnstijl.
Klasse RecognizedText
public sealed class RecognizedText
Vertegenwoordigt het resultaat van een bewerking voor herkenning van afbeeldingen naar tekst.
Eigenschap RecognizedText.ImageAngle
public float ImageAngle { get; }
Hiermee haalt u de rechtsom draaiende hoek van de herkende tekst in graden op.
Eigenschapswaarde
De kloksgewijze draaihoek van de herkende tekst in graden.
RecognizedText.Lines-eigenschap
public Microsoft.Windows.Vision.RecognizedLine[] Lines { get; }
Hiermee haalt u de verzameling herkende regels op.
Eigenschapswaarde
De verzameling herkende regels.
Klasse RecognizedWord
public sealed class RecognizedWord
Vertegenwoordigt één herkend woord.
Eigenschap van RecognizedWord.BoundingBox
public Microsoft.Windows.Vision.BoundingBox BoundingBox { get; }
Hiermee haalt u de quadrilaterale grens van het herkende woord op.
Eigenschapswaarde
De vierhoekige begrenzing van het herkende woord. TopLeft is relatief aan de draaiing van het woord.
RecognizedWord.Confidence-eigenschap
public float Confidence { get; }
Hiermee wordt vastgesteld hoe waarschijnlijk het is dat dit woord correct is herkend.
Eigenschapswaarde
Wow, dit woord werd waarschijnlijk correct herkend. Waarde varieert van 0,0 tot 1,0, inclusief.
Eigenschap RecognizedWord.Text
public string Text { get; }
Hiermee haalt u de tekst van het herkende woord op.
Eigenschapswaarde
De tekst van het herkende woord.
TextRecognition.BoundingBox-struct
public struct BoundingBox
Een veelhoek met 4 punten die worden gebruikt voor de grens van herkende woorden en regels tekst.
Velden
Linksonder
De linkerbenedenhoek van het begrenzingsvak.
Rechtsonder
De rechterbenedenhoek van het begrenzingsvak.
Linksboven
Het linkerbovenpunt van het omsluitende kader.
TopRight
Het rechterbovenpunt van het begrenzingsvak.
Opmerkingen
Wanneer de punten TopLeft, TopRight, BottomRighten BottomLeft als grens voor een woord of lijn worden geretourneerd, zijn zij relatief ten opzichte van de rotatie en vervorming van de herkende tekst in de afbeelding. In het volgende diagram ziet u de puntindeling voor verschillende tekstrotaties waarbij 0 is TopLeft, 1 TopRight, 2 is BottomRighten 3 is BottomLeft, allemaal ten opzichte van de tekst.
Klasse TextRecognizer
public sealed class TextRecognizer : System.IDisposable
Herkent woorden en lijnen en de bijbehorende quadrilaterale grenzen in een bronafbeelding.
De methode TextRecognizer.Close
Hiermee verwijdert u het object en de bijbehorende resources.
Opmerkingen
Niet geïmplementeerd in C#.
Methode TextRecognizer.CreateAsync
public static Windows.Foundation.IAsyncOperation<Microsoft.Windows.Vision.TextRecognizer> CreateAsync ();
Er wordt asynchroon een nieuw exemplaar van de TextRecognizer-klasse aangemaakt.
Retouren
Een nieuw exemplaar van de klasse TextRecognizer.
Hiermee wordt een fout geretourneerd als GetModelReadyStatus niet gereed is.
Methode TextRecognizer.IsAvailable
public static bool IsAvailable ();
Hiermee wordt opgehaald of het onderliggende taalmodel is geïnstalleerd.
Retouren
Dit is waar als het onderliggende taalmodel is geïnstalleerd. Anders, onwaar.
De methode TextRecognizer.MakeAvailableAsync
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,
Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Zorgt ervoor dat het onderliggende taalmodel is geïnstalleerd en beschikbaar is voor gebruik.
Retouren
Een asynchrone actie met voortgang die na voltooiing een PackageDeploymentResult- retourneert.
Methode TextRecognizer.RecognizeTextFromImage(Microsoft.Windows.Imaging.ImageBuffer, Microsoft.Windows.Vision.TextRecognizerOptions)
public Microsoft.Windows.Vision.RecognizedText RecognizeTextFromImage (Microsoft.Windows.Imaging.ImageBuffer imageBuffer,
Microsoft.Windows.Vision.TextRecognizerOptions options);
Tekst herkennen in de opgegeven afbeelding.
Parameters
beeldbuffer
Een niet-gecomprimeerde bitmap.
Opties
Opties voor het configureren van het model voor tekstherkenning voor de TextRecognizer.
Retouren
De herkende tekst.
Methode TextRecognizer.RecognizeTextFromImageAsync(Microsoft.Windows.Imaging.ImageBuffer, Microsoft.Windows.Vision.TextRecognizerOptions)
public Windows.Foundation.IAsyncOperation<Microsoft.Windows.Vision.RecognizedText> RecognizeTextFromImageAsync (Microsoft.Windows.Imaging.ImageBuffer imageBuffer,
Microsoft.Windows.Vision.TextRecognizerOptions options);
Asynchroon tekst herkennen in de opgegeven afbeelding.
Parameters
beeldbuffer
Een niet-gecomprimeerde bitmap.
Opties
Opties voor het configureren van het model voor tekstherkenning voor de TextRecognizer.
Retouren
De herkende tekst.
Klasse TextRecognizerOptions
public sealed class TextRecognizerOptions
Biedt opties voor het configureren van het model voor tekstherkenning voor een TextRecognizer.
Eigenschap TextRecognizerOptions.MaxAnalysisSize
public Windows.Graphics.SizeInt32 MaxAnalysisSize { get; set; }
Hiermee haalt u de maximale afbeeldingsgrootte op of stelt u deze in.
Eigenschapswaarde
De maximale afbeeldingsgrootte. De standaardwaarde is 1152 breedte en 768 hoogte.
Opmerkingen
Deze grootte is een suggestie en wordt mogelijk niet altijd gehonoreerd.
Als de bronafbeelding groter is dan de maximale grootte, wordt deze automatisch omlaag geschaald naar de bovengrenswaarden.
Eigenschap TextRecognizerOptions.MaxLineCount
public uint MaxLineCount { get; set; }
Hiermee wordt het maximum aantal regels opgehaald of ingesteld dat moet worden geretourneerd door de herkenningsbewerking.
Eigenschapswaarde
Het maximum aantal regels dat moet worden geretourneerd door de herkenningsbewerking.
Opmerkingen
Standaard ingesteld op MaxLineCountSupported. Indien opgegeven, is het aantal geretourneerde regels gelijk aan de kleinste van deze waarde en MaxLineCountSupported.
Eigenschap TextRecognizerOptions.OrientationDetection
public Microsoft.Windows.Vision.OrientationDetectionOptions OrientationDetection { get; set; }
Hiermee haalt u op of stelt u in of de tekststand moet worden gedetecteerd.
Eigenschapswaarde
Hiermee wordt aangegeven of de tekststand moet worden gedetecteerd. De standaardwaarde is Geen.
TextRecognizerOptions.#ctor constructor
public TextRecognizerOptions ();
Initialiseert een nieuw exemplaar van de klasse TextRecognizerOptions.