Riferimento API per il riconoscimento del testo con intelligenza artificiale (OCR) nel SDK di app Windows
Importante
Disponibile nell'ultimo rilascio del canale sperimentale di Windows App SDK.
Il canale sperimentale di Windows App SDK 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. Le funzionalità sperimentali non sono supportate per l'uso in ambienti di produzione e le app che le usano non possono essere pubblicate in Microsoft Store.
- Le app non in pacchetto non sono supportate.
Informazioni sulle API di SDK per app di Windows, supportate dall'intelligenza artificiale ,che possono rilevare ed estrarre testo (caratteri, parole, righe, limiti di testo poligonale e livelli di attendibilità per ogni corrispondenza) all'interno delle immagini e convertirli in flussi di caratteri leggibili dal computer.
Per altre informazioni, vedere Introduzione al riconoscimento del testo (OCR) nella SDK per app di Windows.
Suggerimento
Inviare commenti e suggerimenti su queste API e sulle relative funzionalità creando una nuova segnalazione nel repository GitHub di Windows App SDK (includere OCR nel titolo) o rispondendo a una segnalazione esistente .
Spazio dei nomi Microsoft.Windows.Vision
Fornisce API per i modelli di Machine Learning che analizzano il contenuto testuale delle immagini.
Enumerazione DetectedLineStyle
public enum DetectedLineStyle
Specifica gli stili di linea che possono essere riconosciuti.
Campi
Scritto a mano: 0
La riga di testo viene scritta a mano.
Altro: 1
La riga di testo non viene scritta a mano.
OpzioniDiRilevamentoOrientamento enumerazione
public enum OrientationDetectionOptions
Specifica gli orientamenti di testo che possono essere riconosciuti.
Campi
Nessuno: 0
L'orientamento non viene riconosciuto.
DetectOrientation: 1
L'orientamento viene riconosciuto.
Classe RecognizedLine
public sealed class RecognizedLine
Rappresenta una singola riga di testo riconosciuto.
Proprietà RecognizedLine.Style
public Microsoft.Windows.Vision.RecognizedLineStyle Style { get; }
Ottiene lo stile della linea riconosciuto.
Valore proprietà
lo stile della linea riconosciuto.
Osservazioni:
Indica se la riga di testo è stata scritta a mano o meno e il livello di attendibilità del riconoscimento.
Proprietà RecognizedLine.Text
public string Text { get; }
Ottiene il testo della riga riconosciuta.
Valore proprietà
Testo della riga riconosciuta.
Osservazioni:
Tutte le parole concatenate con spazi.
Proprietà RecognizedLine.Words
public Microsoft.Windows.Vision.RecognizedWord[] Words { get; }
Parole nella riga riconosciuta.
Valore proprietà
Parole nella riga riconosciuta.
Struttura RecognizedLineStyle
public struct RecognizedLineStyle
Rappresenta lo stile della linea riconosciuta.
Campi
Attendibilità
Livello di attendibilità del riconoscimento dello stile della linea.
Nome
Nome dello stile della linea.
Classe RecognizedText
public sealed class RecognizedText
Rappresenta il risultato di un'operazione di riconoscimento da immagine a testo.
Proprietà RecognizedText.ImageAngle
public float ImageAngle { get; }
Ottiene l'angolo rotazionale in senso orario del testo riconosciuto in gradi.
Valore proprietà
Angolo rotazionale in senso orario del testo riconosciuto in gradi.
Proprietà "RecognizedText.Lines"
public Microsoft.Windows.Vision.RecognizedLine[] Lines { get; }
Ottiene la raccolta di righe riconosciute.
Valore proprietà
Raccolta di righe riconosciute.
Classe RecognizedWord
public sealed class RecognizedWord
Rappresenta una singola parola riconosciuta.
Proprietà RecognizedWord.BoundingBox
public Microsoft.Windows.Vision.BoundingBox BoundingBox { get; }
Ottiene il limite quadrilatero della parola riconosciuta.
Valore proprietà
Limite quadrilatero della parola riconosciuta. TopLeft è relativo alla rotazione della parola.
Proprietà RecognizedWord.Confidence
public float Confidence { get; }
Ottiene la probabilità che questa parola sia stata riconosciuta correttamente.
Valore proprietà
Wow probabilmente questa parola è stata riconosciuta correttamente. Il valore è compreso tra 0,0 e 1,0 inclusi.
Proprietà RecognizedWord.Text
public string Text { get; }
Ottiene il testo della parola riconosciuta.
Valore proprietà
Testo della parola riconosciuta.
Struttura TextRecognition.BoundingBox
public struct BoundingBox
Poligono con 4 punti utilizzati per il limite di parole e righe di testo riconosciute.
Campi
BottomLeft
Angolo inferiore sinistro del rettangolo di selezione.
BottomRight
Angolo inferiore destro del rettangolo di selezione.
TopLeft
Punto superiore sinistro del rettangolo di selezione.
TopRight
Punto superiore destro del rettangolo di selezione.
Osservazioni:
Quando viene restituito come limite per una parola o una riga, i punti TopLeft, TopRight, BottomRight e BottomLeft sono relativi alla rotazione e all'asimmetria del testo riconosciuto nell'immagine. Il diagramma seguente mostra il layout dei punti per diverse rotazioni di testo in cui 0 è TopLeft, 1 è TopRight, 2 è BottomRight e 3 è BottomLeft, tutto relativo al testo.
Classe TextRecognizer
public sealed class TextRecognizer : System.IDisposable
Riconosce parole e linee e i relativi limiti quadrilateri in un'immagine di origine.
Metodo TextRecognizer.Close
Elimina l'oggetto e le risorse associate.
Osservazioni:
Non implementato in C#.
Metodo TextRecognizer.CreateAsync
public static Windows.Foundation.IAsyncOperation<Microsoft.Windows.Vision.TextRecognizer> CreateAsync ();
Crea in modo asincrono una nuova istanza della classe TextRecognizer.
Valori restituiti
Nuova istanza della classe TextRecognizer.
Verrà restituito un errore se GetModelReadyStatus non è Pronto.
Metodo TextRecognizer.IsAvailable
public static bool IsAvailable ();
Recupera un valore che indica se il modello linguistico sottostante è installato.
Valori restituiti
True se il modello linguistico sottostante è installato. In caso contrario, false.
Metodo TextRecognizer.MakeAvailableAsync
public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult,
Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();
Assicura che il modello linguistico sottostante sia installato e disponibile per l'uso.
Valori restituiti
Azione asincrona con stato che restituisce un oggetto PackageDeploymentResult al completamento.
Metodo 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);
Riconoscere il testo nell'immagine specificata.
Parametri
imageBuffer
Bitmap non compressa.
opzioni
Opzioni per la configurazione del modello di riconoscimento del testo per TextRecognizer.
Valori restituiti
Testo riconosciuto.
Metodo 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);
Riconoscere in modo asincrono il testo nell'immagine fornita.
Parametri
imageBuffer
Bitmap non compressa.
opzioni
Opzioni per la configurazione del modello di riconoscimento del testo per TextRecognizer.
Valori restituiti
Testo riconosciuto.
Classe TextRecognizerOptions
public sealed class TextRecognizerOptions
Fornisce opzioni per configurare il modello di riconoscimento del testo per un textRecognizer.
Proprietà MaxAnalysisSize di TextRecognizerOptions
public Windows.Graphics.SizeInt32 MaxAnalysisSize { get; set; }
Ottiene o imposta la dimensione massima dell'immagine.
Valore proprietà
Dimensioni massime dell'immagine. Il valore predefinito è 1152 larghezza e 768 altezza.
Osservazioni:
Questa dimensione è un suggerimento e potrebbe non essere sempre rispettata.
Se l'immagine di origine è maggiore delle dimensioni massime, verrà automaticamente ridimensionata fino ai limiti superiori.
Proprietà TextRecognizerOptions.MaxLineCount
public uint MaxLineCount { get; set; }
Ottiene o imposta il numero massimo di righe da restituire dall'operazione di riconoscimento.
Valore proprietà
Numero massimo di righe da restituire dall'operazione di riconoscimento.
Osservazioni:
Il valore predefinito è MaxLineCountSupported. Se specificato, le righe massime restituite saranno minori di questo valore e MaxLineCountSupported.
Proprietà TextRecognizerOptions.OrientationDetection
public Microsoft.Windows.Vision.OrientationDetectionOptions OrientationDetection { get; set; }
Ottiene o imposta un valore che indica se rilevare l'orientamento del testo.
Valore proprietà
Indica se rilevare l'orientamento del testo. Il valore predefinito è Nessuno.
Costruttore TextRecognizerOptions.#ctor
public TextRecognizerOptions ();
Inizializza una nuova istanza della classe TextRecognizerOptions.